Collecter les journaux Tanium Patch
Ce document explique comment ingérer des journaux Tanium Patch dans Google Security Operations à l'aide de la fonctionnalité d'exportation AWS S3 native de Tanium Connect. Tanium Patch génère des données sur le déploiement des correctifs, la conformité et les failles au format JSON, qui peuvent être exportées directement vers S3 à l'aide de Tanium Connect sans nécessiter de fonctions Lambda personnalisées. L'analyseur transforme les données JSON de l'évaluation au format UDM (Unified Data Model) de Google SecOps. Il commence par normaliser les noms de clés, extrait les données de la structure JSON, puis mappe les champs pertinents aux attributs UDM, y compris les détails de la faille, les informations sur le résultat de sécurité et les détails de l'élément, comme le nom d'hôte et le système d'exploitation.
Avant de commencer
Assurez-vous de remplir les conditions suivantes :
- Une instance Google SecOps
- Tanium Core Platform 7.0 ou version ultérieure
- Module Tanium Patch installé et configuré
- Module Tanium Connect installé avec une licence valide
- Accès privilégié à la console Tanium avec des droits d'administrateur
- Accès privilégié à AWS (S3, IAM)
Configurer le compte de service Tanium Patch
- Connectez-vous à la console Tanium.
- Accédez à Modules > Patch.
- Cliquez sur Paramètres en haut à droite.
- Dans la section Compte de service, configurez les éléments suivants :
- Utilisateur du compte de service : sélectionnez un utilisateur disposant des autorisations Patch appropriées.
- Vérifiez que le compte dispose du rôle "Connect User".
- Cliquez sur Enregistrer pour appliquer la configuration du compte de service.
Collecter les conditions préalables pour Tanium Patch
- Connectez-vous à la console Tanium en tant qu'administrateur.
- Accédez à Administration > Autorisations > Utilisateurs.
Créez ou identifiez un utilisateur de compte de service disposant des rôles suivants :
- Administrateur de correctifs ou Utilisateur de correctifs en lecture seule.
- Connect User (Connecter l'utilisateur).
- Accès aux groupes d'ordinateurs surveillés (recommandé : groupe Tous les ordinateurs).
Configurer un bucket AWS S3 et IAM pour Google SecOps
- Créez un bucket Amazon S3 en suivant ce guide de l'utilisateur : Créer un bucket.
- Enregistrez le nom et la région du bucket pour référence ultérieure (par exemple,
tanium-patch-logs). - Créez un utilisateur en suivant ce guide de l'utilisateur : Créer un utilisateur IAM.
- Sélectionnez l'utilisateur créé.
- Sélectionnez l'onglet Identifiants de sécurité.
- Cliquez sur Create Access Key (Créer une clé d'accès) dans la section Access Keys (Clés d'accès).
- Sélectionnez Service tiers comme Cas d'utilisation.
- Cliquez sur Suivant.
- Facultatif : ajoutez une balise de description.
- Cliquez sur Créer une clé d'accès.
- Cliquez sur Télécharger le fichier CSV pour enregistrer la clé d'accès et la clé d'accès secrète pour une utilisation ultérieure.
- Cliquez sur OK.
- Sélectionnez l'onglet Autorisations.
- Cliquez sur Ajouter des autorisations dans la section Stratégies d'autorisation.
- Sélectionnez Ajouter des autorisations.
- Sélectionnez Associer directement des règles.
- Recherchez et sélectionnez la règle AmazonS3FullAccess.
- Cliquez sur Suivant.
- Cliquez sur Ajouter des autorisations.
Configurer la destination AWS S3 de Tanium Connect
- Connectez-vous à la console Tanium.
- Accédez à Modules > Connect.
- Cliquez sur Créer une connexion.
- Fournissez les informations de configuration suivantes :
- Nom : saisissez un nom descriptif (par exemple,
Patch Data to S3 for SecOps). - Description : description facultative (par exemple,
Export Patch compliance and deployment data to AWS S3 for Google SecOps ingestion). - Activer : sélectionnez cette option pour activer l'exécution de la connexion selon une planification.
- Nom : saisissez un nom descriptif (par exemple,
- Cliquez sur Suivant.
Configurer la source de connexion
- Dans la section Source, fournissez les informations de configuration suivantes :
- Type de source : sélectionnez Question enregistrée.
- Question enregistrée : sélectionnez l'une des questions enregistrées suivantes concernant Patch :
- Patch - Deployment Results pour l'état du déploiement de correctifs.
- Correctif - Correctifs manquants pour les données de conformité des failles.
- Correctif - Correctifs installés pour l'inventaire des correctifs installés.
- Patch - Patch List (Correctif - Liste des correctifs) pour obtenir l'état complet des correctifs.
- Groupe d'ordinateurs : sélectionnez Tous les ordinateurs ou des groupes d'ordinateurs spécifiques à surveiller.
- Intervalle d'actualisation : définissez un intervalle approprié pour la collecte de données (par exemple, 1 heure).
- Cliquez sur Suivant.
Configurer la destination AWS S3
- Dans la section Destination, fournissez les détails de configuration suivants :
- Type de destination : sélectionnez AWS S3.
- Nom de la destination : saisissez un nom unique (par exemple,
Google SecOps Patch S3 Destination). - Clé d'accès AWS : saisissez la clé d'accès AWS du fichier CSV téléchargé à l'étape de configuration d'AWS S3.
- Clé d'accès secrète AWS : saisissez la clé d'accès secrète AWS du fichier CSV téléchargé à l'étape de configuration d'AWS S3.
- Nom du bucket : saisissez le nom de votre bucket S3 (par exemple,
tanium-patch-logs). - Région : sélectionnez la région AWS où se trouve votre bucket S3.
- Préfixe de clé : saisissez un préfixe pour les objets S3 (par exemple,
tanium/patch/).
- Cliquez sur Suivant.
Configurer des filtres
- Dans la section Filtres, configurez les options de filtrage des données :
- Envoyer uniquement les nouveaux éléments : sélectionnez cette option pour n'envoyer que les nouveaux résultats depuis la dernière exportation.
- Filtres de colonne : ajoutez des filtres basés sur des attributs de correctif spécifiques si nécessaire (par exemple, filtrez par gravité du correctif ou état du déploiement).
- Cliquez sur Suivant.
Formater les données pour AWS S3
- Dans la section Format, configurez le format de données :
- Format : sélectionnez JSON.
- Options :
- Inclure les en-têtes : désélectionnez cette option pour éviter les en-têtes dans la sortie JSON.
- Inclure les cellules vides : sélectionnez cette option selon vos préférences.
- Options avancées :
- Nommage des fichiers : utilisez le nommage par défaut basé sur l'horodatage.
- Compression : sélectionnez Gzip pour réduire les coûts de stockage et le temps de transfert.
- Cliquez sur Suivant.
Planifier la connexion
- Dans la section Planification, configurez la planification de l'exportation :
- Activer la planification : sélectionnez cette option pour activer les exportations planifiées automatiques.
- Type de planification : sélectionnez Récurrente.
- Fréquence : sélectionnez Toutes les heures pour exporter régulièrement les données de correctif.
- Heure de début : définissez l'heure de début appropriée pour la première exportation.
- Cliquez sur Suivant.
Enregistrer et valider la connexion
- Vérifiez la configuration de la connexion sur l'écran récapitulatif.
- Cliquez sur Save (Enregistrer) pour créer la connexion.
- Cliquez sur Tester la connexion pour vérifier la configuration.
- Si le test réussit, cliquez sur Exécuter maintenant pour effectuer une exportation initiale.
- Surveillez l'état de la connexion sur la page Présentation de Connect.
Configurer un flux dans Google SecOps pour ingérer les journaux Tanium Patch
- Accédez à Paramètres > Gestion des données > Flux. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > Flux.
- Cliquez sur + Ajouter un flux.
- Dans le champ Nom du flux, saisissez un nom pour le flux (par exemple,
Tanium Patch logs). - Sélectionnez Amazon S3 V2 comme Type de source.
- Sélectionnez Tanium Patch comme type de journal.
- Cliquez sur Suivant.
- Spécifiez les valeurs des paramètres d'entrée suivants :
- URI S3 :
s3://tanium-patch-logs/tanium/patch/ - Options de suppression de la source : sélectionnez l'option de suppression de votre choix.
- Âge maximal du fichier : incluez les fichiers modifiés au cours d'un certain nombre de jours. La valeur par défaut est de 180 jours.
- ID de clé d'accès : clé d'accès utilisateur permettant d'accéder au bucket S3.
- Clé d'accès secrète : clé secrète de l'utilisateur ayant accès au bucket S3.
- Espace de noms de l'élément : espace de noms de l'élément.
- Libellés d'ingestion : libellé appliqué aux événements de ce flux.
- URI S3 :
- Cliquez sur Suivant.
- Vérifiez la configuration de votre nouveau flux d'actualités sur l'écran Finaliser, puis cliquez sur Envoyer.
Table de mappage UDM
| Champ du journal | mappage UDM | Logique |
|---|---|---|
| Bulletins | principal.asset.vulnerabilities.vendor_vulnerability_id |
La valeur est extraite du champ "Bulletins" du journal brut, pour l'index correspondant du champ "Titre". Si la valeur est "Aucun", le champ n'est pas mappé. |
| ComputerName | principal.hostname |
La valeur est extraite du champ "ComputerName" du journal brut. |
| ComputerName | principal.asset.hostname |
La valeur est extraite du champ "ComputerName" du journal brut. |
| CVEID | principal.asset.vulnerabilities.cve_id |
La valeur est extraite du champ "CVEIDs" du journal brut, pour l'index correspondant du champ "Title". Si la valeur est "Aucun", le champ n'est pas mappé. |
| KBArticles | principal.asset.vulnerabilities.vendor_knowledge_base_article_id |
La valeur est extraite du champ "KBArticles" du journal brut, pour l'index correspondant du champ "Title". Si la valeur est vide, le champ n'est pas mappé. |
| KBArticles | security_result.summary |
La valeur est extraite du champ "KBArticles" du journal brut, pour l'index correspondant du champ "Title". Si la valeur est vide, le champ n'est pas mappé. |
| OSType | principal.asset.platform_software.platform |
Si la valeur contient "Windows", la plate-forme est définie sur "WINDOWS". Si la valeur contient "Linux", la plate-forme est définie sur "LINUX". Si la valeur contient "Mac", la plate-forme est définie sur "MAC". |
| Gravité | principal.asset.vulnerabilities.severity |
La valeur est extraite du champ "Gravité" du journal brut, pour l'index correspondant du champ "Titre". Si la valeur est "Critical", la gravité est définie sur "HIGH". Si la valeur est "Important", la gravité est définie sur "MEDIUM". Sinon, la gravité est définie sur "UNKNOWN_SEVERITY". |
| Gravité | principal.asset.vulnerabilities.severity_details |
La valeur est extraite du champ "Gravité" du journal brut, pour l'index correspondant du champ "Titre". Si la valeur est "Critique" ou "Important", les détails de la gravité sont définis sur la valeur du journal brut. |
| Titre | principal.asset.vulnerabilities.name |
La valeur est extraite du champ "Title" du journal brut. |
| Titre | security_result.description |
La valeur est extraite du champ "Title" du journal brut, pour l'index correspondant du champ "InstallStatus". Si la valeur de "InstallStatus" n'est pas "Installed", la description est définie sur la valeur du journal brut. |
| - | metadata.event_timestamp |
La valeur est extraite du champ "create_time" du journal brut. |
| - | metadata.event_type |
La valeur est définie sur "SCAN_HOST". |
| - | metadata.log_type |
La valeur est extraite du champ "log_type" du journal brut. |
| - | metadata.product_name |
La valeur est définie sur "Patch". |
| - | metadata.vendor_name |
La valeur est définie sur "Tanium". |
| - | principal.asset.vulnerabilities.vendor |
La valeur est définie sur "Tanium". |
| - | security_result.category |
La valeur est définie sur "DATA_AT_REST". |
Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.