Connecteur

KnowBe4

Identifiant d'API, saisi client par client.

Plateforme SaaS de sensibilisation à la sécurité (Security Awareness Training) largement déployée par les MSP : campagnes de formation affectées aux collaborateurs et simulations de phishing. Vigicap lit l'API Reporting en lecture seule pour évaluer l'objectif ReCyF « Sensibilisation » — nombre de campagnes, taux de complétion des formations et taux de clic sur les simulations. Le contenu pédagogique, la fréquence des campagnes et la couverture réelle de l'effectif ne sont pas vérifiés.

Bêta

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

L'accès se crée dans KnowBe4, 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

Dans la console KnowBe4 : cliquez sur votre adresse e-mail (en haut à droite) > Account Settings > Account Integrations > API, puis « Create New API Token » dans l'onglet Reporting API. L'URL est celle de l'API de votre région : https://eu.api.knowbe4.com (Europe) ou https://us.api.knowbe4.com (États-Unis) — seules ces deux régions sont documentées publiquement.

Rôle minimal

Jeton généré dans la console « Reporting API » uniquement (et non « User Event API ») : l'API Reporting ne déclare que des opérations GET et ne peut donc rien écrire. KnowBe4 n'offre en revanche aucun périmètre plus fin — ce jeton lit l'ensemble des données de formation et de phishing du compte.

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.

Clé API Reportingsecret
Account Settings > Account Integrations > API > Reporting API > Create New API Token. Cette clé est en lecture seule.
Jeton de l'API Reporting KnowBe4

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.

#4 Intégration de la sécurité numérique dans la gestion des ressources humaines

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é écrit d'après l'API documentée de l'éditeur et n'a pas encore été exécuté contre une instance réelle. Il est signalé « Bêta » partout où il apparaît.

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