DocumentaciónAide

Créer une intégration

Enregistrez un système de votre entreprise (SIEM, EDR, inventaire ou autre) pour qu'il envoie ses événements à la plateforme.

Sur cette page

Une intégration représente un système externe qui envoie des informations à la plateforme : par exemple, votre Wazuh de production ou votre scanner de vulnérabilités. Lors de sa création, vous choisissez ce qu'apporte ce système et, si vous le souhaitez, l'adresse à laquelle il enverra ses événements est générée immédiatement.

Avant de commencer

  • Vous devez avoir le rôle Administrateur dans votre entreprise. Avec un autre rôle, le bouton Nouvelle intégration est désactivé et, au survol de la souris, il indique Seul un administrateur peut créer des intégrations.

  • Ayez sous la main l'adresse de l'API du système (si vous voulez tester la connexion depuis la plateforme) et ses identifiants, s'il en exige.

Étapes

  1. Ouvrez Paramètres → Intégrations.

  2. Cliquez sur Nouvelle intégration (ou Créer une intégration si vous n'en avez encore aucune).

  3. Renseignez les données du système :

    • Nom : la façon dont vous le reconnaîtrez dans la plateforme, par exemple « Wazuh production ».

    • Catégorie : SIEM, SOC, EDR, Scanner de vulnérabilités, Inventaire / CMDB, CRM, Centre de services (ITSM), Supervision, Argunis Monitoring ou Autre.

    • Fournisseur : le produit, par exemple wazuh. Sous le champ apparaissent des suggestions selon la catégorie (par exemple, pour SIEM : wazuh, splunk, sentinel, qradar, elastic) ; cliquez sur l'une d'elles pour l'utiliser. Vous pouvez aussi en saisir une autre. La valeur est enregistrée en minuscules.

    • URL de base (facultatif) : l'adresse de l'API du système. Elle sert à tester la connexion.

    • Chemin de santé (facultatif) : le chemin interrogé lors du test de connexion, par exemple /health. Si vous le laissez vide, c'est l'URL de base qui est interrogée.

  4. Dans Authentification, choisissez comment la plateforme s'identifie auprès du système et renseignez les champs correspondants. Nous l'expliquons dans Identifiants d'accès. Si le système se contente d'envoyer des événements et que vous n'avez pas besoin de tester la connexion, laissez Sans authentification.

  5. Dans Ce qu'apporte cette intégration, cochez ce que le système enverra : Actifs pour l'inventaire, Alertes, Incidents ou Vulnérabilités. Par défaut, Alertes est coché.

  6. Si vous voulez que le plus grave soit traité sans attendre, cochez Ouvrir automatiquement un incident pour les événements critiques : les alertes et incidents de gravité critique sont escaladés automatiquement en incident.

  7. Laissez Recevoir des événements par webhook coché si le système enverra ses événements à la plateforme (cas normal). Cela génère une URL et un secret de signature. Si vous le décochez, vous pourrez l'activer plus tard depuis la carte.

  8. Cliquez sur Enregistrer. Le bouton s'active lorsque vous avez saisi le Nom et le Fournisseur.

Si vous avez laissé Recevoir des événements par webhook coché, l'enregistrement ouvre la fenêtre Webhook activé avec l'URL et le Secret de signature. Le secret n'est affiché qu'une seule fois : copiez-le avant de fermer. Poursuivez avec Activer le webhook et envoyer des événements.

Ne cochez Actifs pour l'inventaire que pour les systèmes d'inventaire ou de découverte. Si cette case n'est pas cochée, les événements de type actif sont enregistrés, mais n'ajoutent pas d'actifs découverts.

Ensuite

Le message Intégration créée. s'affiche et une nouvelle carte apparaît dans l'onglet Intégrations, avec l'état Active. La carte affiche :

  • La catégorie et le fournisseur.

  • Ce qu'elle apporte (ou Aucune capacité cochée) et Incident automatique, si vous l'avez coché.

  • Authentification, avec l'indice de l'identifiant enregistré.

  • Webhook : Actif ou Désactivé.

  • Dernier événement et Dernière synchronisation (au début, Jamais).

  • URL de base et URL du webhook, avec un bouton pour la copier.

Lorsque le système envoie son premier événement, Dernier événement est mis à jour et l'événement apparaît dans Événements reçus.

Voir aussi

Rechercher dans SofIA Gouvernance

Saisissez au moins 2 caractères pour rechercher dans SofIA Gouvernance.

↑↓ naviguer · Enter ouvrir · Esc fermer