XM Cyber
Connectez OverView à XM Cyber pour récupérer vos équipements, vos identités Active Directory et Azure, les logiciels installés et les CVE du module Vulnerability Risk Management
Le connecteur XM Cyber permet à OverView de récupérer directement depuis votre tenant XM Cyber vos équipements, identités, logiciels installés et vulnérabilités, pour une vue consolidée de votre exposition.
Objectif
Le connecteur XM Cyber récupère les informations suivantes :
- Équipements — machines couvertes par un sensor, machines agentless et ordinateurs Active Directory, avec leur hostname, FQDN, adresses IP et MAC, matériel, système d'exploitation, version du sensor et site
- Identités — utilisateurs Active Directory, utilisateurs Azure et service principals Azure, avec leurs indicateurs de privilège, leur statut MFA et les attributs de politique de mot de passe
- Logiciels installés et leurs CVE, issus du module Vulnerability Risk Management (VRM), avec les données de sévérité CVSS, EPSS et KEV
- En option, les hosts vus par le Passive Discovery Scan — les machines qu'aucun sensor ne couvre, avec leur adresse MAC et leurs ports en écoute
Prérequis
- Accès à la console XM Cyber avec les droits de création de clés API dans System Config
- Le module Vulnerability Risk Management (VRM) activé sur votre tenant, pour les logiciels installés et les CVE
- Le module Passive Discovery Scan activé sur votre tenant, si vous souhaitez récupérer les hosts non managés qu'il découvre
Informations à fournir à OverView
Contactez le support OverSOC pour configurer ce connecteur. Vous devrez fournir :
| Champ | Description |
|---|---|
| Tenant | Le nom de votre tenant seul, ex. acme — pas une URL. L'URL de la console https://acme.clients.xmcyber.com en est déduite |
| API Key | La clé API créée dans la procédure ci-dessous |
| Domain | Uniquement si votre déploiement n'est pas sur le domaine SaaS public. Par défaut clients.xmcyber.com |
Les options suivantes peuvent également être définies, et peuvent être laissées à leur valeur par défaut :
| Option | Défaut | Description |
|---|---|---|
| Include identities | Activé | Récupérer les comptes Active Directory et Azure |
| Include VRM | Activé | Récupérer les logiciels installés et les CVE du module VRM |
| Include Passive Discovery Scan | Désactivé | Récupérer les hosts vus sur le réseau sans sensor. Cette option importe tous les hosts observés sur le réseau, ce qui peut augmenter sensiblement le volume de votre parc |
Permissions requises
Le connecteur est strictement en lecture seule. La clé API a besoin d'un accès en lecture :
- à l'entity inventory — équipements et identités
- au module Vulnerability Risk Management (VRM) — logiciels installés et CVE
- au Passive Discovery Scan, uniquement si vous activez cette option
Positionner toutes les permissions sur Read lors de la création de la clé, comme décrit ci-dessous, couvre l'ensemble de ces accès. N'accordez jamais de permissions en écriture.
Procédure
Créer une clé API dans XM Cyber
- Connectez-vous à votre console XM Cyber sur
https://<tenant>.clients.xmcyber.com. - Accédez à System Config > Integrations.
- Dans XM Cyber API keys, cliquez sur View / generate API keys.
- Cliquez sur Create New API Key.
- Renseignez les informations de la clé :
- Application name — ex. « OverView Connector »
- Description — ex. « Export en lecture seule de l'inventaire et des vulnérabilités vers OverView »
- Key duration — choisissez la durée de validité autorisée par votre politique de sécurité
- Cliquez sur Continue to Permissions.
- Positionnez toutes les permissions sur Read.
- Enregistrez la clé, puis copiez-la et transmettez-la à OverView avec le nom de votre tenant.
La clé API n'est affichée qu'une seule fois, à la création. Si vous quittez la page sans la copier, vous devrez en créer une nouvelle.
La clé est créée avec une durée de validité fixe. Les imports échoueront une fois cette durée écoulée : renouvelez la clé avant sa date d'expiration et transmettez la nouvelle clé à OverView.
Bonnes pratiques de sécurité
- Créez une clé API dédiée à l'intégration OverView plutôt que de réutiliser une clé partagée avec un autre outil.
- Attribuez uniquement des permissions en lecture seule — OverView n'a besoin que de lire les données d'inventaire, d'identité et de vulnérabilité.
- Conservez la clé API en lieu sûr : elle n'est affichée qu'une seule fois et ne peut pas être récupérée ensuite.
- Renouvelez la clé régulièrement, conformément à la politique de sécurité de votre organisation, et avant sa date d'expiration.
Documentation officielle
XM Cyber ne publie pas de référence API publique. La documentation de l'API est disponible depuis la console XM Cyber ou auprès de votre contact support XM Cyber.
Alternative : import par fichiers via DropPoint
L'accès API décrit plus haut est la méthode recommandée pour ce connecteur. Lorsqu'il n'est pas disponible (réseau cloisonné, version ou licence sans API, export déjà produit par ailleurs), OverView accepte des exports de fichiers, à déposer dans le bucket dédié à XM Cyber.
Bucket : s3://xmcyber/
Exemple : s3://xmcyber/export.csv
La procédure est décrite dans le guide OverView DropPoint : génération des credentials, configuration du client, puis envoi des fichiers depuis l'interface web OverView, l'AWS CLI ou un SDK. Les exemples y sont préremplis avec ce bucket lorsque vous suivez ce lien.