Gestion des packages

Aperçu des packages

Une configuration de package inclut des paramètres, une commande, un script et tout autre fichier nécessaire pour orchestrer une action sur un point de terminaison géré. Vous pouvez déployer un package à partir de la grille Question Results (Résultats de la question) en initiant le workflow de déploiement d’une action.

Le service Tanium Client s’exécute avec les permissions du compte LocalSystem ou compte racine, afin qu’il puisse exécuter presque toutes les instructions de ligne de commande disponibles à un utilisateur Administrateur qui est connecté au endpoint. Par conséquent, même si les utilisateurs connectés ne disposent pas de droits d’administration, un utilisateur de Tanium Console peut déployer des actions sur le endpoint qui visent à installer, mettre à jour ou supprimer des applications client tant que ces applications remplissent les conditions suivantes :

Les applications sont installées à partir d’une ligne de commande en utilisant les permissions du compte LocalSystem (Windows) ou racine (non Windows).
Les applications sont configurées pour supprimer toute interaction avec un utilisateur final connecté à un endpoint cible au moment de l’installation.
Les applications peuvent être personnalisées dynamiquement lors de l’installation, si nécessaire, via des options, commutateurs ou fichiers d’entrée transmis au programme d’installation de l’application.

Si les fichiers exécutables, scripts et fichiers de configuration requis ne comportent pas ces caractéristiques nativement, vous pouvez utiliser un outil de packaging logiciel commercial tel qu’Installshield, ou une application open source telle que Nullsoft Scriptable Install System, pour créer une nouvelle version du programme d’installation.

Vous pouvez utiliser Tanium Core Platform pour assurer le suivi du nombre d’applications installées, ainsi que pour savoir si ces applications sont utilisées. Par conséquent, avant d’installer un nouveau logiciel ou de mettre à niveau des versions du logiciel existant, vérifiez que votre organisation détient le nombre requis de licences ou répond aux critères d’utilisation acceptable pour distribuer et installer de manière centralisée le logiciel commercial ou open source aux endpoints au sein de votre organisation.

Votre compte d’utilisateur requiert un rôle disposant de la permission Write Package (Écrire le package) pour créer, modifier ou supprimer des configurations de package. Le rôle réservé Admin Administrateur ou Administrateur de contenu dispose de cette permission.

Afficher les détails du package

Dans le menu principal, accédez à Administration (Administration) > Content (Contenu) > Packages (Packages).
La grille Packages (Packages) affiche la plupart des attributs qui sont décrits dans le T : Tableau 1.
(Facultatif) Pour afficher les attributs que la grille masque par défaut, cliquez sur Customize Columns (Personnaliser les colonnes) et sélectionnez les attributs.
(Facultatif) Utilisez les filtres pour trouver des packages spécifiques :
- Filter by text (Filtrer par texte) : pour filtrer la grille selon la valeur Name (Nom) ou Command (Commande) du package, saisissez une chaîne de texte dans le champ Filter items (Filtrer les éléments).
- Filter by attribute (Filtrer par attribut) : filtrez la grille selon un ou plusieurs attributs, tels que l’attribution du Content Set (Content Set). Développez la section Filters (Filtres), cliquez sur Add (Ajouter), sélectionnez un attribut et un opérateur, saisissez une chaîne de texte qui contient tout ou une partie de la valeur d’attribut, puis cliquez sur Apply (Appliquer). Si vous ajoutez plusieurs filtres d’attributs, l’opérateur booléen AND (ET) s’applique. Une fois que vous avez fini de spécifier les attributs, cliquez sur Apply All (Appliquer tout) pour filtrer la grille.
Pour afficher tous les attributs d’un package spécifique, sélectionnez un package et cliquez sur Edit (Modifier) . Le T : Tableau 1 décrit les attributs du package.

Modifier un package

La best practice consiste à ne pas modifier les packages prédéfinis fournis par les Content Packs Tanium. Pour obtenir plus de détails, reportez-vous à la section Conseil 4 : limiter les personnalisations du contenu Tanium. Contacter l’assistance Tanium si la modification des packages fournis par Tanium est nécessaire. Sinon, vous pouvez également cloner les packages fournis par Tanium (reportez-vous à la section Cloner un package) et modifier les copies. Vous pouvez également modifier les packages personnalisés que vous avez créés à partir de zéro.

Pour modifier l’attribution du Content Set pour plusieurs packages qui doivent appartenir au même Set, reportez-vous à la section Déplacer des packages entre les Content Sets.

Dans le menu principal, accédez à Administration (Administration) > Content (Contenu) > Packages (Packages).
Utilisez les fonctions de tri de colonne et de recherche pour trouver le package que vous souhaitez modifier.
Cliquez sur la valeur Display Name (Nom d’affichage) du package. Sélectionnez la ligne du package et cliquez sur Edit (Modifier).
Effectuez la configuration comme décrit dans le T : Tableau 1 et cliquez sur Save (Enregistrer).

Déplacer des packages entre les Content Sets

Vous pouvez déplacer des packages entre les Content Sets si nécessaire, afin d’adapter les modifications apportées à la configuration de contrôle d’accès basé sur les rôles (RBAC) de votre déploiement Tanium. Par exemple, vous pouvez vouloir déplacer certains packages vers un Content Set auquel seuls les utilisateurs hautement privilégiés peuvent accéder.

Dans le menu principal, accédez à Administration (Administration) > Content (Contenu) > Packages (Packages).
Sélectionnez le package et cliquez sur Move to Content Set (Déplacer vers le Content Set).
Sélectionnez un Content Set et cliquez sur Confirm (Confirmer).

Dans le menu principal, accédez à Administration (Administration) > Content (Contenu) > Packages (Packages).
Sélectionnez le package et sélectionnez Move to Content Set (Déplacer vers le Content Set) > <content_set_name>.

Re-télécharger des fichiers de package

Le serveur Tanium stocke les fichiers de package dans son cache. Si des versions de fichier mises à jour sont disponibles, ou si vous téléchargez de nouveau les versions de fichier actuelles, vous pouvez les télécharger manuellement vers le serveur Tanium afin qu’il déploie les fichiers corrects aux endpoints. Notez que le serveur tente automatiquement de re-télécharger les fichiers sur plusieurs minutes si le téléchargement initial a échoué pour un package.

Dans le menu principal, accédez à Administration (Administration) > Content (Contenu) > Packages (Packages) et sélectionnez le package pour lequel vous souhaitez télécharger des fichiers.
Pour télécharger les fichiers d’un package associé à une action, accédez à Administration (Administration) > Actions (Actions) > Action History (Historique des actions), sélectionnez l’action et cliquez sur Show Status (Afficher le statut).
Cliquez sur Status (Statut).
Une fenêtre contextuelle affiche le statut.
Cliquez sur Re-Download (Re-télécharger) pour chaque fichier que vous souhaitez re-télécharger, ou cliquez sur Re-Download All (Re-télécharger tout) pour re-télécharger tous les fichiers.

Conseil : Si vous souhaitez que le serveur TaniumTaaS vérifie et télécharge automatiquement les versions mises à jour des fichiers de package distants, définissez un intervalle Check for update (Vérifier les mises à jour) dans la configuration du package (reportez-vous à la section Fichiers).

Cloner un package

Le clonage est utile lorsque vous devez :

Créer une version modifiée d’un package prédéfini à partir d’un content pack Tanium.

Ne modifiez pas le package Tanium original.
Créez un nouveau package avec des paramètres qui diffèrent légèrement de ceux d’un package existant. Cela est souvent plus facile que de créer un nouveau package à partir de zéro.

Procédez comme suit pour cloner un package :

Dans le menu principal, accédez à Administration (Administration) > Content (Contenu) > Packages (Packages).
Utilisez les fonctions de tri de colonne et de recherche pour trouver le package que vous souhaitez cloner.
Sélectionnez le package et cliquez sur Clone (Cloner).
Configurez les paramètres décrits dans le T : Tableau 1 et cliquez sur Save (Enregistrer).

Créer un package

Dans le menu principal, accédez à Administration (Administration) > Content (Contenu) > Packages (Packages).
Cliquez sur New Package (Nouveau package), configurez les paramètres suivants et cliquez sur Save (Enregistrer).

T : Tableau 1 : Recommandations de configuration de package
Paramètres	Recommandations
Nom du package	Spécifiez un nom de configuration pour identifier le package.
Nom affiché	(Facultatif) Spécifiez un nom à afficher pour le package sur la page Packages (Packages) et Action Deployment (Déploiement des actions). Si vous ne saisissez pas de valeur, la valeur pour Package Name (Nom du package) est le Display Name (Nom d’affichage) par défaut.
Content set (Content Set)	Attribuez le package à un Content Set. La liste affiche tous les Content Sets pour lesquels vous disposez de la permission Write Package (Écrire le package). Si vous ne sélectionnez pas de Content Set, le Set Default (Par défaut) est attribué.
Commande	Spécifiez la commande à exécuter sur le endpoint. Pour en savoir plus sur les commandes et les scripts pour les packages paramétrés, reportez-vous à la section Exemple : Packages paramétrés. Pour en savoir plus sur les commandes et les scripts pour les packages alimentés par sensor, reportez-vous à la section Exemple : Packages alimentés par capteur.
Délai d’expiration de commande et délai d’expiration de téléchargement	Ces délais d’expiration affectent l’état (Completed (Terminé), Expired (Expiré) ou Failed (Échec)) d’une action qui utilise le package. Le Download Timeout (Délai d’expiration de téléchargement) est la durée disponible pour télécharger les fichiers de package. Le Command Timeout (Délai d’expiration de commande) est la durée disponible pour l’exécution de la commande. Pour en savoir plus sur tous les paramètres qui déterminent les états d’action, reportez-vous à la section Afficher le résumé et le statut des actions.
Ignorer le verrouillage de l’action	Activez les endpoints pour exécuter des actions qui incluent ce package, indépendamment du fait que le verrouillage d’action soit activé ou non pour ces endpoints. Utilisez cette option dans des packages qui favorisent l’hygiène. Pour plus de détails, reportez-vous à la section Gestion des verrouillages d’action.
Lancer ce package dans un groupe de processus	(Nécessite les serveurs Tanium Core Platform et les Tanium Clients pour exécuter la version 7.2 ou ultérieure). Exécutez la commande de package dans un groupe de processus. Lorsque la commande termine ou expire, le groupe de processus et tous les processus descendants restants sont tués. Par défaut, vous ne pouvez pas configurer ce paramètre. Pour le rendre configurable, dans le menu principal, accédez à Administration (Administration) > Configuration (Configuration) > Platform Settings (Paramètres de la plateforme) et réglez allow_process_group_flag_edit (autoriser_modification_drapeau_groupe_processus) sur 1. Lorsque vous créez un nouveau package via la console Tanium, le paramètre est activé par défaut. Cependant, pour activer le paramètre dans un package importé, vous devez définir <process_group_flag> sur 1 dans le fichier du contenu avant l’importation ou configurer allow_process_group_flag_edit dans la console Tanium après l’importation.
Fichiers	Pour sélectionner des fichiers pour le package, sélectionnez une option dans la liste déroulante Add (Ajouter) : Local File (Fichier local) : chargez un fichier depuis votre ordinateur hôte local en faisant un glisser-déposer ou en cliquant sur Browse for File (Rechercher un fichier). Lorsque vous le chargez, un hash SHA-256 est généré. Remote File (Fichier distant) : complétez le champ File Address (Adresse du fichier), saisissez la valeur Name (Nom) du fichier, sélectionnez une option Check for update (Rechercher des mises à jour) et, éventuellement, saisissez un hash SHA-256. Tous les fichiers liés à des packages sont stockés dans un sous-répertoire du répertoire d’installation du serveur Tanium.
Entrées de paramètres	(Packages paramétrés uniquement) Développez la section Parameters (Paramètres) et, pour chaque paramètre, effectuez les étapes suivantes. Pour en savoir plus sur les types de paramètres et leurs réglages, reportez-vous à la section Paramétrer les paramètres d’entrée. Sélectionnez Add Parameter (Ajouter un paramètre) > <Type>. Sélectionnez un format d’heure pour n’importe quel paramètre basé sur une date ou une heure : Local Time (Heure locale) (par défaut) est l’heure locale du système que vous utilisez pour accéder à Tanium Console Temps universel coordonné (UTC) Ce paramètre s’applique uniquement aux paramètres de date-heure que vous voyez lors de la configuration du package. Le paramètre n’est pas enregistré avec la configuration du package. Configurez les paramètres pour le type d’entrée sélectionné.
Requête de vérification	Configurez une question d’aperçu qui indique si une action ayant utilisé le package a produit les résultats attendus sur les endpoints. Lorsque vous exécutez l’action, la page Action Status (Statut de l’action) affiche les états de vérification et la section Client Status Details (Détails du statut du client) affiche les endpoints pour lesquels l’action est vérifiée : reportez-vous à la section États d’action. Vous devez disposer de la permission Read Sensor (Lecture du sensor) sur le Content Set réservé pour pouvoir émettre la Verification Query (Requête de vérification). Cliquez sur Add (Ajouter), utilisez l’onglet Filter Bar (Barre de filtres), Filter Builder (Générateur de filtres) ou Manual Group (Groupe statique) pour créer la partie de filtrage de la question, puis cliquez sur Confirm (Confirmer). Spécifiez un délai pour l’échec de la vérification. L’horloge commence lorsque l’action se termine. Si l’action n’est pas vérifiée avant son expiration, le Tanium Client indique que l’état de l’action est Failed (Échec).

T : Tableau 2 : Recommandations de configuration de package
Paramètres	Recommandations
Nom du package	Un nom de configuration qui identifie le package.
Nom affiché	Ce nom apparaît sur la page Packages (Packages) et la page Deploy Action (Déployer une action).
Content set (Content Set)	L’attribution du Content Set. La liste affiche tous les Content Sets pour lesquels vous disposez de la permission Write Package (Écrire le package).
Commande	Spécifiez la commande à exécuter sur le endpoint. Pour les packages alimentés par sensor, utilisez le lien Add sensor variable (Ajouter une variable de sensor) pour insérer une référence à un sensor. Lorsque la commande s’exécute, la valeur de retour du sensor est remplacée par la variable. Lorsque vous voulez tuer un processus actuellement exécuté sur un endpoint, il est utile d’utiliser une commande de sensor. Le sensor Running Processes (Processus en cours d’exécution) renvoie une liste de tous les processus en cours d’exécution sur chaque endpoint. Vous pouvez déployer un package directement à partir d’une question qui utilise le sensor Running Processes (Processus en cours d’exécution) pour supprimer l’un des processus identifiés.
Délai d’expiration de commande et délai d’expiration de téléchargement	Ces délais d’expiration affectent l’état (Completed (Terminé), Expired (Expiré) ou Failed (Échec)) d’une action qui utilise le package. Le Download Timeout (Délai d’expiration de téléchargement) est la durée disponible pour télécharger les fichiers de package. Le Command Timeout (Délai d’expiration de commande) est la durée disponible pour l’exécution de la commande. Pour en savoir plus sur tous les paramètres qui déterminent les états d’action, reportez-vous à la section Afficher le résumé et le statut des actions.
Ignorer le verrouillage de l’action	Activez les endpoints pour exécuter des actions qui incluent ce package, indépendamment du fait que le verrouillage d’action soit activé ou non pour ces endpoints. Utilisez cette option dans des packages qui favorisent l’hygiène. Pour plus de détails, reportez-vous à la section Gestion des verrouillages d’action.
Lancer ce package dans un groupe de processus	(Nécessite les serveurs Tanium Core Platform et les Tanium Clients pour exécuter la version 7.2 ou ultérieure). Exécutez la commande de package dans un groupe de processus. Lorsque la commande termine ou expire, le groupe de processus et tous les processus descendants restants sont tués. Par défaut, vous ne pouvez pas configurer ce paramètre. Pour le rendre configurable, dans le menu principal, accédez à Administration (Administration) > Management (Gestion) > Global Settings (Paramètres globaux) et réglez allow_process_group_flag_edit (autoriser_modification_drapeau_groupe_processus) sur 1. Lorsque vous créez un nouveau package via la console Tanium, le paramètre est activé par défaut. Cependant, pour activer le paramètre dans un package importé, vous devez définir <process_group_flag> sur 1 dans le fichier du contenu avant l’importation ou configurer allow_process_group_flag_edit dans la console Tanium après l’importation.
Fichiers	Pour sélectionner des fichiers pour le package, ouvrez la liste déroulante Add (Ajouter) et sélectionnez l’une des options suivantes : Local File (Fichier local) : parcourez et sélectionnez un fichier sur votre ordinateur hôte local. Lorsque vous le chargez, un hash SHA-256 est généré. Remote File (Fichier distant) : complétez le champ File Address (Adresse du fichier), saisissez la valeur Name (Nom) du fichier, sélectionnez une option Check for update (Rechercher des mises à jour) et, éventuellement, saisissez un hash SHA-256. Tous les fichiers liés à des packages sont stockés dans un sous-répertoire du répertoire d’installation du serveur Tanium.
Entrées de paramètres	(Packages paramétrés uniquement) Ouvrez la liste déroulante Add Parameter (Ajouter un paramètre), sélectionnez l’un des paramètres suivants et configurez-le comme décrit : Case à cocher — L’utilisateur active un paramètre en cochant une case. La valeur 0 ou 1 est saisie dans la variable. Retourne 1 si coché et 0 si non coché. Date, Date et heure, Plage de dates—L’utilisateur sélectionne une date et une heure ou une plage. Le format d’horodatage est Epoch en millisecondes. Pour une plage, l’utilisateur spécifie deux dates-heures séparées par un Pipe. Liste déroulante — L’utilisateur sélectionne une seule option dans une liste. Liste — L’utilisateur sélectionne une ou plusieurs valeurs. Plusieurs valeurs sont séparées par un Pipe. Numérique — L’utilisateur saisit un nombre. L’entrée peut être contrôlée avec un minimum et des maximums. Vous pouvez spécifier une taille d’incrément pour exiger que l’entrée soit divisible par la valeur spécifiée. L’intervalle d’instantané correspond à la quantité par laquelle un nombre augmente ou diminue en appuyant sur le bouton haut ou bas respectivement. La valeur pour Step Size (Taille d’incrément) doit être un multiple de la valeur pour Snap Interval (intervalle d’instantané), sauf si l’intervalle d’instantané est égal à 0. Le nombre sélectionné par l’utilisateur est entré dans la variable. Intervalle numérique — L’utilisateur sélectionne un nombre et un élément dans une liste. L’élément de la liste a une valeur numérique. La valeur saisie dans la variable est le résultat de la multiplication. Par exemple, si un utilisateur sélectionne 2 et sélectionne Haut (avec une valeur Haut de 3), la valeur est 6 dans la variable. Plug-in — Non destiné à la plupart des utilisateurs. Contacter l’assistance Tanium pour en savoir plus sur ce paramètre. Séparateur — Un séparateur est une façon graphique de séparer les sections du formulaire des entrées utilisateur. Zone de texte — L’utilisateur saisit une grande quantité de texte. Le texte est entré dans la variable. Saisie texte — L’utilisateur saisit une entrée de texte. Les entrées autorisées peuvent être contrôlées avec des expressions régulières. L’entrée utilisateur est entrée dans la variable. Heure — L’utilisateur sélectionne une heure dans une liste déroulante. L’entrée peut être soumise à des restrictions.
Requête de vérification	Configurez une question d’aperçu qui indique si une action ayant utilisé le package a produit les résultats attendus sur les endpoints. Lorsque vous exécutez l’action, la page Action Summary (Résumé des actions) affiche les états de vérification et la section Client Status Details (Détails du statut du client) affiche les endpoints pour lesquels l’action est vérifiée : reportez-vous à la section États d’action. Vous devez disposer de la permission Read Sensor (Lecture du sensor) sur le Content Set réservé pour pouvoir émettre la Verification Query (Requête de vérification). Cliquez sur Add (Ajouter) et utilisez l’onglet Filter Bar (Barre de filtres) ou Filter Builder (Générateur de filtres) pour créer la partie de filtrage de la question. Passez en revue les résultats de Preview (Aperçu) et cliquez sur Apply (Appliquer). Spécifiez un délai pour l’échec de la vérification. L’horloge commence lorsque l’action se termine. Si l’action n’est pas vérifiée avant son expiration, le Tanium Client indique que l’état de l’action est Failed (Échec).

Exporter ou importer des packages

Les procédures suivantes décrivent comment exporter et importer les configurations de packages spécifiques ou de tous les packages.

Développez et testez le contenu dans l’environnement de votre laboratoire avant d’importer ce contenu dans votre environnement de production.

Exporter des packages

Exportez des configurations de packages sous forme de fichier CSV pour consulter leurs paramètres dans une application qui prend en charge ce format. Si votre compte d’utilisateur dispose d’un rôle avec la permission Export Content (Exporter le contenu), vous pouvez également exporter des packages sous forme de fichier JSON pour les importer dans un autre serveur Tanium. Le rôle réservé Administrateur comporte cette permission. Le fichier d’exportation contient uniquement les paramètres de configuration, pas les fichiers associés.

Si vous souhaitez exporter ou importer d’autres types de contenu en plus des packages, reportez-vous à la section Gérer les services partagés et le contenu.

Dans le menu principal, accédez à Administration (Administration) > Content (Contenu) > Packages (Packages).
Sélectionnez des lignes dans la grille pour exporter uniquement des packages spécifiques. Si vous souhaitez exporter tous les packages, ignorez cette étape.
Cliquez sur Export (Exporter) .
(Facultatif) Modifiez le File Name (Nom de fichier) d’exportation par défaut.
Le suffixe du fichier (.csv ou .json) change automatiquement en fonction de la sélection du format.
Sélectionnez une option pour Export Data (Exporter les données) : L’option All (Tous) pour tous les packages de la grille, ou Selected (Sélectionnés) pour les packages sélectionnés uniquement.
Sélectionnez le Format (Format) du fichier : JSON ou CSV.
Cliquez sur Export (Exporter).
TaaSLe serveur Tanium exporte le fichier vers le dossier des téléchargements sur le système que vous utilisez pour accéder à Tanium Console.

Importer des packages

Vous devez disposer des permissions Import Signed Content (Importer le contenu signé) et Read Package (Lire le package) pour pouvoir importer des packages. Le rôle réservé Administrateur ou Administrateur de contenu peut importer tous les packages.

Vous pouvez importer des fichiers de configuration de package au format JSON ou XML.

Signez numériquement le fichier de package et assurez-vous qu’une clé publique est en place pour valider la signature. Reportez-vous à la section Authentification des fichiers de contenu.
Dans le menu principal, accédez à Administration (Administration) > Configuration (Configuration) > Solutions (Solutions).
Faites défiler l’écran jusqu’à la section Content (Contenu) et cliquez sur Import Content (Importer le contenu).
Cliquez sur Choose File (Choisir un fichier), sélectionnez le fichier de package et cliquez sur Open (Ouvrir).
Cliquez sur Import (Importer).
Si les noms d’objet dans le fichier sont les mêmes que pour les objets existants, la console Tanium détaille les conflits et fournit des options de résolution pour chacun d’eux.
Sélectionnez les résolutions pour tout conflit. Pour obtenir des conseils, reportez-vous aux sections Conflits et Best practices.
Cliquez sur Import (Importer) et cliquez sur Close (Fermer) lorsque l’importation est terminée.
Effectuez les étapes restantes uniquement pour les packages importés qui font référence à d’autres fichiers. Vous devez télécharger manuellement ces fichiers sur le serveur Tanium, car le fichier que vous avez importé contient uniquement les configurations de package, pas les fichiers associés.
Dans le menu principal, accédez à Administration (Administration) > Content (Contenu) > Packages (Packages).
Pour chaque package que vous avez importé, sélectionnez le package, cliquez sur Status (Statut), puis cliquez sur Re-Download All (Re-télécharger tout) pour télécharger les fichiers référencés.
Si le serveur Tanium ne peut pas accéder à l’emplacement d’un fichier, déplacez le fichier vers un emplacement accessible, modifiez le champ File Address (Adresse du fichier) dans la configuration du package (reportez-vous à la section Modifier un package), puis recommencez cette étape.

Copier les détails de configuration du package

Copiez les informations de la page Packages (Packages) dans votre presse-papiers pour coller les informations dans un message, un fichier texte ou une feuille de calcul. Chaque ligne de la grille est une chaîne de valeurs séparées par des virgules (CSV).

Dans le menu principal, accédez à Administration (Administration) > Content (Contenu) > Packages (Packages).
Effectuez l’une des étapes suivantes :
- Copy row information (Copier les informations de la ligne) : sélectionnez une ou plusieurs lignes et cliquez sur Copy (Copier) .
- Copy cell information (Copier les informations de la cellule) : survolez la cellule, cliquez sur Options (Options) , puis cliquez sur Copy (Copier) .