Vigicap
Connecteur
Domotz
Un seul identifiant au niveau de l'agence, pour tout le portefeuille.
Supervision réseau et découverte d'équipements. Une seule clé lit l'ensemble de vos collecteurs : ce qui est réellement présent sur le réseau de chaque site, et non ce qui a été déclaré.
01
Ce qu'il faut créer dans l'outil
L'accès se crée dans Domotz, 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
Portail Domotz > Settings > API Keys. Relevez aussi la « server reference » indiquée à côté de la clé : c'est l'URL de votre cellule, et elle diffère d'un compte à l'autre.
Rôle minimal
Clé d'API « Full Access ». Domotz ne propose que deux types de clé — « Full Access API Key » et « Agent Activation only API Key » — et la seconde ne sait qu'activer des collecteurs : aucune clé en lecture seule n'existe. La clé qui permet ces lectures permet donc aussi d'écrire dans l'ensemble de l'API publique.
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
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.
- Clé d'APIsecret
03
Le routage par client
L'identifiant, lui, ne se répète pas : un seul, saisi une fois au niveau de l'agence, couvre tout le portefeuille — c'est la différence que l'on sent avec quarante clients plutôt qu'avec quatre.
04
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.