Connecteur

GitHub

Identifiant d'API, saisi client par client.

Forge logicielle en SaaS (ou GitHub Enterprise Server auto-hébergé) où travaillent les développeurs d'une entreprise ou de son prestataire. Vigicap lit le nombre de membres de l'organisation, si celle-ci exige un second facteur et combien de membres en sont dépourvus, pour évaluer l'objectif ReCyF « authentification multifacteur ». Cette lecture porte sur les comptes de l'organisation GitHub, et non sur l'ensemble des comptes de l'entreprise.

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

L'accès se crée dans GitHub, 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 d'accès personnel à portée fine (Settings > Developer settings > Personal access tokens > Fine-grained), rattaché à l'organisation du client, avec la permission « Members: read-only ». Saisissez le nom de l'organisation dans le champ prévu. Laissez l'URL vide (ou https://github.com) pour GitHub.com ; pour GitHub Enterprise Server, indiquez l'URL de votre instance.

Rôle minimal

Un jeton d'accès personnel à portée fine, en lecture seule sur l'organisation (permission « Members: read-only »), ou un jeton classique portant uniquement `read:org`. Ce connecteur n'appelle que GET /orgs/{org} et GET /orgs/{org}/members. Important : seul un PROPRIÉTAIRE de l'organisation peut lire la liste des membres sans second facteur ; avec un autre compte, GitHub renvoie une liste vide au lieu d'un refus, et Vigicap signale alors que la couverture n'est pas lisible plutôt que d'annoncer une couverture totale.

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 d'accès personnelsecret
Jeton à portée fine en lecture seule sur l'organisation, ou jeton classique avec read:org.
github_pat_… ou ghp_…
Organisation
Le nom de l'organisation GitHub, tel qu'il apparaît dans l'URL.
mon-entreprise

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.

#10 Gestion des identités et des accès des utilisateurs aux 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.