Connecteur

NetBox

Identifiant d'API, saisi client par client.

Outil open-source de gestion d'infrastructure réseau (DCIM/IPAM) — inventaire des baies, équipements et plages d'adresses IP, très répandu chez les MSP et équipes réseau. Vigicap lit le nombre d'équipements recensés dans le module DCIM (et, à titre indicatif, le nombre d'adresses IP dans l'IPAM) pour évaluer l'objectif ReCyF « Inventaire des actifs ».

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

L'accès se crée dans NetBox, pas dans Vigicap. Vigicap ne demande jamais le mot de passe d'un administrateur : il attend un identifiant d'API que vous créez, que vous voyez, et que vous pouvez révoquer sans nous.

Où le générer

Créez un jeton dans NetBox : menu utilisateur (en haut à droite) > API Tokens > Add a token (ou Admin > API Tokens selon la version). Le jeton n'est affiché qu'une seule fois — copiez-le immédiatement.

Rôle minimal

Un jeton d'API dont la case « Write enabled » est décochée — NetBox le restreint alors aux opérations de lecture — rattaché à un utilisateur ne portant que les permissions d'objet dcim.view_device et ipam.view_ipaddress.

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

Ce qu'il faut saisir dans Vigicap

Les champs exacts du formulaire de connexion, dans l'ordre où ils apparaissent. Les valeurs marquées « secret » ne ressortent jamais vers le navigateur : elles sont chiffrées au repos et supprimées à la déconnexion.

Le formulaire commence par l'adresse de l'instance, saisie à part des champs ci-dessous. Le catalogue public ne publie pas encore si ce connecteur en demande une, ni à quoi elle ressemble — cette liste est donc exacte pour tout le reste, et muette sur ce premier champ.

Jeton APIsecret
Menu utilisateur > API Tokens > Add a token — jeton en écriture non requis, lecture seule suffit.
Jeton API NetBox

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.

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

Objectifs ReCyF pré-remplis

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

#1 Recensement des systèmes d'information

Lecture seule

Les lectures sont en lecture seule : Vigicap n'écrit rien dans l'outil en lisant.

Ce qui est lu, ce qui est conservé, combien de temps et avec quels droits : le même registre, connecteur par connecteur, dans l'inventaire des données.

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.

Les marques et logos cités appartiennent à leurs titulaires respectifs et identifient les outils avec lesquels Vigicap est compatible — voir les mentions légales.