Tanium

Le connecteur Tanium importe dans OverView l'inventaire des endpoints gérés par Tanium. Il interroge en lecture seule l'API GraphQL Tanium Gateway avec un token d'API, sur Tanium Cloud comme sur une plateforme Tanium installée sur site.

Le connecteur lit les données déjà collectées par le Tanium Data Service : il ne pose aucune question en temps réel aux endpoints et n'ajoute donc pas de charge sur votre parc. Les données remontées dépendent des modules Tanium dont vous disposez et des permissions accordées :

• Socle : nom, domaine, numéro de série, fabricant, système d'exploitation, adresses IP et MAC, utilisateur principal, date de dernière remontée
• Endpoint Management : logiciels installés
• Comply : vulnérabilités (CVE) détectées sur chaque endpoint

Un module pour lequel le token n'a pas de permission est ignoré : l'import se poursuit avec les autres données.

Prérequis

• Un compte administrateur Tanium autorisé à créer des rôles, des utilisateurs et des tokens d'API
• Tanium Cloud : un flux HTTPS autorisé depuis les adresses IP sortantes d'OverView vers https://<customerName>-api.cloud.tanium.com. Le support OverSOC vous communique ces adresses
• Tanium sur site : un OverView OutPost déployé dans votre réseau et un flux HTTPS autorisé de la VM OutPost vers le serveur Tanium

Informations à fournir dans OverView

Procédure

Créer le rôle

1. Dans la console Tanium, allez dans Administration > Permissions > Roles.
2. Créez un rôle dédié à OverView, par exemple OverView Connector.
3. Accordez-lui les permissions listées dans Permissions requises, uniquement pour les modules que vous possédez.

Les rôles prédéfinis de Tanium sont conçus pour les utilisateurs de la console. Un rôle dédié limite le token aux seules lectures dont OverView a besoin.

Créer le compte de service

1. Allez dans Administration > Permissions > Users et créez un utilisateur dédié, par exemple overview-connector.
2. Attribuez-lui le rôle créé à l'étape précédente.
3. Dans ses Computer Groups, retirez No Computers et ajoutez All Computers, ou les groupes d'ordinateurs à remonter dans OverView.

Le token n'accède qu'aux endpoints des computer groups de son utilisateur. Sans computer group, l'import aboutit mais ne remonte aucun endpoint.

Générer le token d'API

Un token d'API hérite de toutes les permissions de l'identité qui le crée. Générez-le depuis le compte de service, ou depuis un persona limité au rôle créé plus haut.

1. Allez dans Administration > Permissions > API Tokens, puis cliquez sur New API Token.
2. Remplissez le formulaire :
   • Notes : un libellé explicite, par exemple OverView
   • Expiration : la durée de validité autorisée par votre politique de sécurité, 365 jours au maximum
   • Trusted IP addresses : les adresses IP sortantes d'OverView pour Tanium Cloud, ou l'adresse IP LAN de la VM OutPost pour une plateforme sur site
3. Cliquez sur Save.
4. Copiez le token, préfixe token- compris, et conservez-le en lieu sûr : il ne sera plus affiché.

Tanium refuse les appels d'un token qui ne proviennent pas d'une de ses adresses de confiance. Pour une plateforme sur site, l'adresse IP LAN de la VM OutPost s'affiche sur la bannière console de l'hyperviseur.

Un token d'API Tanium ne se renouvelle pas. Avant son expiration, générez-en un nouveau et remplacez-le dans OverView.

Configurer le connecteur dans OverView

1. Dans OverView, allez dans Data Sources Settings > Sources.
2. Sélectionnez Tanium et cliquez sur Configure.
3. Pour une plateforme Tanium sur site, choisissez votre OutPost comme point de collecte.
4. Renseignez l'API URL et l'API Token.
5. Cliquez sur Save Configuration.

Permissions requises

Le connecteur effectue uniquement des lectures. Le socle est obligatoire, les autres lignes ne concernent que les modules que vous possédez.

Documentation officielle

• Tanium : authentification à l'API
• Tanium : permissions pour les intégrations
• Tanium : notes de version de Tanium Gateway