Rapid7 InsightVM
Intégrez Rapid7 InsightVM pour récupérer votre inventaire d'actifs et les vulnérabilités détectées
Le connecteur Rapid7 InsightVM permet de récupérer votre inventaire d'actifs et les vulnérabilités détectées sur ceux-ci depuis la Rapid7 Command Platform directement dans OverView pour une vue consolidée de votre posture de sécurité.
Objectif
Le connecteur Rapid7 InsightVM permet de récupérer les informations suivantes :
- Inventaire des actifs (hostname, adresse IP, adresse MAC, système d'exploitation)
- Vulnérabilités détectées sur chaque actif, avec leur score CVSS, leurs identifiants CVE et leur sévérité
- Ports évalués lors du scan
- Identifiant de l'agent Rapid7, sites et tags des actifs
Prérequis
- Accès à la Rapid7 Command Platform
- Un utilisateur Vulnerability Management (InsightVM) doté du rôle Read Only, avec accès aux sites contenant les actifs à importer
- La version cloud d'InsightVM — le connecteur utilise l'InsightVM Cloud API, et non l'API d'une Security Console on-premise
Informations à fournir dans OverView
| Champ | Description |
|---|---|
| Clé API | Clé API générée dans la Rapid7 Command Platform |
| Région | Région de données de votre plateforme (us, us2, us3, eu, ca, au, ap, aps2, me1) |
Paramètres
Ces paramètres sont facultatifs. Conservez leur valeur par défaut sauf besoin particulier.
| Paramètre | Description | Défaut |
|---|---|---|
| Inclure les vulnérabilités inchangées | Activé par défaut. Si désactivé, seules les vulnérabilités nouvelles et corrigées sont récupérées | Activé |
| Inclure les identifiants uniques | Activé par défaut. Récupère les identifiants matériels et système collectés sur l'actif, comme l'identifiant de l'agent Rapid7 | Activé |
Procédure
Préparer un utilisateur dédié
Créez dans Vulnerability Management (InsightVM) un utilisateur dédié à l'intégration et attribuez-lui le rôle Read Only, en lui donnant accès aux sites contenant les actifs à importer. L'attribution des rôles est effectuée par un Global Administrator. Consultez la documentation Rapid7 sur la gestion des utilisateurs pour le détail des étapes.
Générer une clé API
- Connectez-vous à la Rapid7 Command Platform avec cet utilisateur.
- Dans le menu de gauche, cliquez sur Administration.
- Cliquez sur API Key Management.
- Cliquez sur Generate New User Key.
- Sélectionnez l'organisation et saisissez un nom pour la clé (ex : "OverView Connector").
- Générez la clé, puis copiez-la immédiatement — elle ne peut plus être affichée une fois la fenêtre fermée.
La clé hérite des permissions de l'utilisateur qui la détient, ce qui maintient l'intégration limitée à un accès en lecture.
Identifier votre région
Votre région correspond au préfixe de l'URL de n'importe quel produit Rapid7 auquel vous avez accès. Pour une URL commençant par eu., la région à renseigner est eu.
Configurer le connecteur dans OverView
- Dans OverView, accédez à Data Sources Settings > Sources.
- Sélectionnez Rapid7 et cliquez sur Configure.
- Renseignez les champs requis :
- API Key
- Region
- Cliquez sur Save Configuration.
Consulter la documentation InsightVM Cloud API
Permissions requises
La clé API s'authentifie via le header X-Api-Key et ne nécessite qu'un accès en lecture. Les deux endpoints ci-dessous sont appelés avec la même clé.
| Données récupérées | Endpoint | Prérequis |
|---|---|---|
| Actifs et vulnérabilités détectées sur ceux-ci | POST /vm/v4/integration/assets | Accès en lecture aux sites contenant les actifs |
| Définitions des vulnérabilités (CVSS, CVE, description, remédiation) | POST /vm/v4/integration/vulnerabilities | Même clé |
Un utilisateur Read Only ne voit que les sites et asset groups auxquels il a accès. Tout site non attribué à cet utilisateur sera absent de l'import.
Bonnes pratiques de sécurité
- Utilisez un utilisateur dédié à l'intégration OverView plutôt qu'un compte personnel
- N'accordez qu'un accès en lecture seule — OverView n'écrit jamais sur votre plateforme Rapid7
- Privilégiez une user key plutôt qu'une organization key : une organization key donne accès à l'ensemble des produits Rapid7 de l'organisation, bien au-delà de ce dont le connecteur a besoin
- Renouvelez la clé régulièrement selon la politique de sécurité de votre organisation
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é à Rapid7 InsightVM.
Bucket : s3://rapid7/
Exemple : s3://rapid7/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.