Aller au contenu principal
Retour au catalogue des connecteurs

Connecteur

Wazuh

Identifiant d'API, saisi client par client.

Wazuh est une plateforme SIEM/XDR open source. Vigicap s'authentifie sur l'API du serveur Wazuh (port 55000 par défaut) et lit la répartition des agents (actifs, déconnectés, jamais connectés) : la part d'agents actifs, qui remontent effectivement leurs journaux, sert de preuve à la fois pour la journalisation centralisée et pour la détection des incidents.

01

Ce qu'il faut créer dans l'outil

L'accès se crée dans Wazuh, pas dans Vigicap.

Où le générer

Créez un utilisateur API dédié dans Wazuh (le rôle en lecture seule 'agent:read' suffit) depuis Wazuh Dashboard > Administration > Sécurité, ou via wazuh-apid. Important : l'instance doit présenter un certificat TLS valide et reconnu — le certificat auto-signé fourni par défaut par Wazuh sera refusé par Vigicap (aucune option pour désactiver la vérification TLS, par sécurité).

Rôle minimal

Utilisateur API dédié dont la seule policy RBAC autorise l'action « agent:read » sur les ressources « agent:id:* » et « agent:group:* » — aucune autre action n'est nécessaire.

Formulation reprise du modèle de rôles de l'éditeur, et vérifiée avant publication.

02

Ce qu'il faut saisir dans Vigicap

  • Nom d'utilisateur APIsecret

    Compte API Wazuh dédié, en lecture seule si possible.

    wazuh-vigicap

  • Mot de passesecret

    Mot de passe associé à ce compte API.

03

Le routage par client

La connexion se fait client par client : un identifiant par client, saisi sur la fiche de ce client. Rien n'est partagé entre deux clients, et déconnecter l'un n'affecte pas l'autre.

04

Ce qu'il fait, et ce qu'il ne fait pas

Contrôles ISO 27001 couverts

Les relevés de ce connecteur alimentent ${n} mesures de l'Annexe A — dérivées des objectifs ReCyF ci-dessus, pas saisies à la main.

  • 5.7 Renseignement sur les menaces
  • 8.7 Protection contre les programmes malveillants
  • 8.15 Journalisation
  • 8.16 Activités de surveillance
  • 8.17 Synchronisation des horloges

Objectifs ReCyF pré-remplis

Une lecture alimente 2 objectifs du référentiel ANSSI ReCyF. Elle les PROPOSE : un niveau n'est retenu qu'une fois validé par un consultant.

  • #12 Identification et réaction aux incidents de sécurité
  • #20 Supervision de la sécurité des systèmes d'information

Lecture seule

Vigicap n'écrit rien dans l'outil en lisant.

Comment Vigicap traite vos accès.

Vérification

Ce connecteur a été exécuté de bout en bout contre une instance réelle de l'outil, pas seulement testé contre une simulation.

Ce que ce connecteur lit, précisément

  • La répartition des agents du serveur Wazuh : actifs, déconnectés, jamais connectés. Les trois catégories sont lues séparément.
  • La part d'agents actifs — ceux qui remontent effectivement leurs journaux — sert de preuve à la fois pour la journalisation centralisée et pour la détection des incidents.
  • Deux objectifs ReCyF, depuis une seule mesure : c'est le seul connecteur de cette liste dans ce cas.

Ce qu'il ne lit pas

Le contenu des journaux, les règles de détection et les alertes. Vigicap s'authentifie sur l'API du serveur Wazuh (port 55000 par défaut) et lit un décompte d'agents — rien du flux lui-même ne transite.

Ce que ces signaux ne prouvent pas

  • Des agents actifs prouvent que des journaux arrivent. Ils ne prouvent ni que les bonnes sources sont couvertes, ni que les règles de détection sont adaptées, ni que quelqu'un lit le résultat.
  • « Jamais connecté » est la catégorie la plus instructive des trois : elle compte des agents déclarés qui n'ont jamais rien remonté, ce qu'un simple taux d'activité masquerait.
Pourquoi deux objectifs depuis une seule lecture ?
Parce qu'un agent qui remonte ses journaux est à la fois une preuve de journalisation et un prérequis de détection. L'honnêteté consiste à dire que c'est la même mesure vue deux fois, pas deux mesures.
Faut-il ouvrir le port 55000 vers Vigicap ?
L'API du serveur doit être joignable. Le port est celui par défaut ; une instance qui l'a changé fonctionne tout autant.