Connecteur

WithSecure Elements

Identifiant d'API, saisi client par client.

Protection des postes et serveurs (anciennement F-Secure). Vigicap lit, pour chaque appareil, son état de protection et l'état de ses correctifs, pour évaluer les objectifs ReCyF « antivirus » et « gestion des correctifs ». Les agents qui ne remontent plus rien sont comptés à part et exclus du calcul : cette source ne sait rien de ces machines. Les appareils dont la gestion des correctifs est désactivée sont exclus du calcul des correctifs.

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

L'accès se crée dans WithSecure Elements, 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 Elements Security Center : Management > API clients (ou Identifiants d'API) > créez un client en lecture seule, avec la portée « connect.api.read ». Relevez le Client ID et le Client Secret ; le secret n'est affiché qu'une fois. Aucune URL n'est à saisir.

Rôle minimal

Dans WithSecure Elements Security Center, créez des identifiants d'API (Management API credentials) en lecture seule et n'accordez que la portée « connect.api.read ». Ce connecteur n'appelle que POST /as/token.oauth2 et GET /devices/v1/devices : il ne lit ni les événements de sécurité, ni les détails des menaces, et n'exécute aucune action sur les appareils.

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.

Client ID
Identifiant du client d'API créé dans Elements Security Center.
Client Secretsecret
Affiché une seule fois à la création du client d'API.

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 2 objectifs du référentiel ANSSI ReCyF. Elle les PROPOSE : un niveau n'est retenu qu'une fois validé par un consultant.

#5 Maîtrise des systèmes d'information
#9 Protection des systèmes d'information contre les codes malveillants

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

L'API est publique et documentée, mais elle n'est accessible qu'avec un abonnement payant dont l'éditeur ne délivre pas de version d'essai : il n'existe aucune instance que nous puissions obtenir pour l'exécuter. Ce n'est pas « pas encore fait » — il faudrait qu'un client nous prête son tenant.

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