VigicapConnector
GitHub
API credential, entered client by client.
SaaS software forge (or self-hosted GitHub Enterprise Server) where a company's developers, or its vendor's, work. Vigicap reads how many members the organisation has, whether it requires a second factor and how many members lack one, to assess the ReCyF objective on multi-factor authentication. This reading covers the GitHub organisation's accounts, not the company's accounts as a whole.
01
What to create in the tool
The access is created in GitHub, not in Vigicap. Vigicap never asks for an administrator's password: it expects an API credential that you create, that you can see, and that you can revoke without us.
Where to generate it
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.
Minimum role
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.
Taken from the vendor's own role model, and checked before publication.
02
What to enter in Vigicap
The exact fields of the connection form, in the order they appear. Values marked “secret” never travel back to the browser: they are encrypted at rest and deleted on disconnection.
The form starts with the instance address, entered separately from the fields below. The public catalogue does not yet publish whether this connector needs one, or what it looks like — so this list is exact about everything else, and silent about that first field.
- 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
03
Per-client routing
The connection is made client by client: one credential per client, entered on that client's record. Nothing is shared between two clients, and disconnecting one leaves the other untouched.
04
What it does, and what it does not do
ReCyF objectives it pre-fills
A reading feeds one objective of the ANSSI ReCyF framework. It PROPOSES it: the level only counts once a consultant has confirmed it.
- #10 Gestion des identités et des accès des utilisateurs aux systèmes d'informationManagement of user identities and of user access to the information systems
Read-only
The reads are read-only: Vigicap writes nothing into the tool while reading it.
What is read, what is kept, for how long and with which rights: the same register, connector by connector, in the data inventory.
Verification
This connector has been run end to end against a real instance of the tool, not merely tested against a mock.
The trademarks and logos mentioned belong to their respective owners and identify the tools Vigicap is compatible with — see the legal notice.