Cyberwatch Cyberwatch

Intégrez Cyberwatch pour récupérer les données de gestion des vulnérabilités

Le connecteur Cyberwatch permet de récupérer les données d'inventaire d'assets et de vulnérabilités détectées par votre plateforme Cyberwatch directement dans OverView.

Objectif

Le connecteur Cyberwatch permet de récupérer les informations suivantes :

  • Inventaire des assets (serveurs, postes de travail, équipements réseau)
  • Vulnérabilités détectées avec leurs références CVE
  • Score de conformité et priorités de correction

Prérequis

  • Accès à votre instance Cyberwatch
  • Permissions d'administrateur pour accéder aux données d'inventaire
  • Capacité à générer des clés API

Informations à fournir dans OverView

ChampDescription
URL de l'APIURL de base de votre instance Cyberwatch (ex: https://cyberwatch.example.com)
Clé APIClé API pour l'authentification
API SecretSecret API pour l'authentification

Paramètres

Ces paramètres sont facultatifs. Conservez leur valeur par défaut sauf besoin particulier.

ParamètreDescriptionDéfaut
Vérifier le SSLVérifier le certificat SSL lors de la connexion à l'APIDésactivé

Procédure

Générer des identifiants API dans Cyberwatch

  1. Connectez-vous à votre instance Cyberwatch.
  2. Allez à Profile > API Keys.
  3. Cliquez sur "View my API keys" ou "+ Add" pour créer une nouvelle clé.
  4. Générez les identifiants API :
    • API Access Key ID : Identifiant généré automatiquement.
    • API Secret Access Key : Secret généré automatiquement.
  5. Optionnellement, exportez les identifiants sous la forme d'un fichier api.conf pour référence.
  6. Copiez immédiatement l'API Access Key ID et l'API Secret Access Key.
  7. Pour OverView, assurez-vous que la clé API dispose d'un accès "Read only".

Récupérer l'URL API

  1. L'URL API est l'URL de base de votre instance Cyberwatch.
  2. Exemple : https://cyberwatch.example.com ou https://app.cyberwatch.io pour la version SaaS.

Configurer le connecteur dans OverView

  1. Dans OverView, allez à Data Sources Settings > Sources.
  2. Sélectionnez Cyberwatch et cliquez sur Configure.
  3. Renseignez les trois champs requis :
    • API URL : URL de base de votre instance Cyberwatch.
    • API Key : Votre API Access Key ID.
    • API Secret : Votre API Secret Access Key.
  4. Cliquez sur Save Configuration.
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é à Cyberwatch.

Où déposer les fichiers ?

Bucket : s3://cyberwatch/

Exemple : s3://cyberwatch/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.

Documentation officielle

Pour plus d'informations, consultez la documentation API Cyberwatch.

Permissions requises

Les identifiants API doivent disposer des permissions suivantes :

  • Accès en lecture à l'inventaire des assets
  • Accès en lecture aux vulnérabilités et détections
  • Accès en lecture aux rapports de conformité