runZero
Collectez l'inventaire des assets et services exposés détectés par runZero
Le connecteur runZero vous permet de récupérer les données de découverte d'assets et de visibilité réseau depuis votre instance runZero.
Objectif
Le connecteur runZero permet de récupérer les informations suivantes :
- Inventaire des assets découverts
- Services et ports exposés
- Équipements non gérés
Prérequis
- Accès à une instance runZero
- Token API runZero généré
- Permissions d'accès API configurées
Informations à fournir dans OverView
| Champ | Description |
|---|---|
| URL de l'API | URL de l'API runZero (ex: https://api.runzero.com) |
| Clé API | Clé API runZero |
Paramètres
Ces paramètres sont facultatifs. Conservez leur valeur par défaut sauf besoin particulier.
| Paramètre | Description | Défaut |
|---|---|---|
| Utiliser uniquement les derniers scans | Utiliser uniquement les données des derniers scans | Désactivé |
Configuration
Générer un Export Token runZero
- Connectez-vous à votre instance runZero.
- Accédez à la page Organizations depuis le menu principal.
- Sélectionnez l'organisation que vous voulez intégrer avec OverView.
- Cliquez sur Edit organization.
- Allez à la section Export tokens.
- Cliquez sur Create a new export token.
- Donnez-lui un nom descriptif (ex: OverView Connector).
- Cliquez sur Create.
- Copiez immédiatement la valeur du token (elle n'apparaîtra qu'une seule fois). Les Export tokens ont le format
XT_...et sont en lecture seule.
Note : Pour l'intégration OverView, les Export Tokens sont recommandés car ils fournissent un accès en lecture seule aux données de découverte d'assets. D'autres types de tokens (Organization API Token, Account API Token) sont également disponibles pour différents cas d'usage.
Configurer le connecteur dans OverView
- Dans OverView, accédez à Data Sources Settings > Sources.
- Sélectionnez runZero et cliquez sur Configure.
- Renseignez tous les champs requis :
- API URL : https://api.runzero.com (ou votre URL d'instance)
- API Key : Votre Export Token
- Cliquez sur Save Configuration.
Référence : runZero API - Leveraging the API
Permissions requises
La clé API doit disposer des permissions minimales suivantes :
- Accès en lecture à l'inventaire des assets
- Accès aux informations de services et ports
- Accès aux résultats de scans réseau
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é à runZero.
Bucket : s3://runzero/
Exemple : s3://runzero/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.