Glossaire

Vous trouverez ici une liste de termes et concepts spécifiques à Git, GitHub et GitGuardian que nous utilisons dans notre documentation.

Auteur vs Committer

D'après les définitions Git :

• L'auteur (author) est la personne qui a écrit le travail à l'origine
• Le committer est la personne qui a appliqué le plus récemment un ensemble de modifications, par exemple en utilisant des commandes comme rebase ou cherry-pick

Commit

Un commit est un objet Git. Il s'agit « d'un changement individuel apporté à un fichier (ou ensemble de fichiers) ». Voir le glossaire GitHub pour une définition plus précise.
Les commits incluent généralement un message de commit, qui fournit une brève description des modifications apportées, la date du commit, et l'auteur et le committer du commit, qui peuvent être deux utilisateurs distincts.

Auteur du commit

L'utilisateur Git qui réalise le commit.

SHA du commit

Identifiant unique d'un commit créé par Git. C'est un hash de checksum de 40 caractères. Par commodité, seuls les 7 premiers caractères sont généralement affichés.

Webhooks personnalisés

Les webhooks personnalisés vous permettent de construire des intégrations dédiées pour recevoir différents types d'événements (comme les incidents) depuis GitGuardian. Ils fournissent un moyen d'intégrer vos différents services au pipeline d'alertes GitGuardian.

Contributeur GitHub

Un contributeur est un utilisateur GitHub qui n'a pas l'accès collaborateur à un dépôt mais qui a contribué à un projet et a vu une pull request qu'il a ouverte fusionnée dans le dépôt.

Événements GitHub

Chaque interaction entre un utilisateur et GitHub est journalisée dans un Événement GitHub. La liste complète des types d'événements est disponible ici Elle contient des informations utiles, telles que :

• l'actor, l'utilisateur GitHub qui a déclenché l'événement (dans le cas d'un PushEvent, c'est-à-dire lors du push de plusieurs commits sur GitHub, l'actor est aussi désigné comme pusher)
• l'identifiant de l'organisation, si l'événement s'est produit sur une organisation GitHub
• le payload qui dépend du type d'événement
• le repo sur lequel l'événement s'est produit
• le type

Organisation GitHub

Les organisations GitHub sont un groupe d'utilisateurs multiples qui reflètent typiquement la structure de votre organisation réelle. GitGuardian peut monitorer autant d'organisations GitHub que vous voulez et scanner leur activité associée.

Utilisateurs Git vs Utilisateurs GitHub

Un commit, tel que défini dans le protocole Git, contient à la fois un author et un committer, définis par leur adresse email et leur nom. Par exemple "Author Name <user@example.com>" est un utilisateur git valide (soit committer, soit auteur). Cet email est configuré au niveau du protocole git, sur les ordinateurs de vos développeurs, en utilisant les commandes :

git config --global user.name "FIRST_NAME LAST_NAME"

git config --global user.email "MY_NAME@MY_DOMAIN.com"

En plus de cela, GitHub ajoute parfois un auteur et/ou un committer GitHub, s'il a réussi à lier l'utilisateur git à un utilisateur GitHub existant, sur la base des adresses email. Dans ce cas, le commit contient également un login GitHub comme auteur et/ou committer.

Patch et diff

Un patch/diff est un concept git qui représente la différence en termes de modifications entre deux commits, ou des modifications sauvegardées. Le diff décrit visuellement ce qui a été ajouté ou supprimé d'un fichier depuis son dernier commit.

Push event

Un Push Event est déclenché à chaque fois que plusieurs commits sont poussés sur GitHub, depuis un dépôt local, et son payload contient donc une liste de commits. C'est le principal type d'événement que nous monitorons, car c'est celui contenant les commits, reflétant les changements dans le code.

Dépôt

D'après la définition de GitHub, un dépôt (repository) est l'élément le plus basique de GitHub. Le plus simple est de l'imaginer comme un dossier de projet. Un dépôt contient tous les fichiers d'un projet (incluant la documentation), et stocke l'historique de révision de chaque fichier. Les dépôts peuvent avoir plusieurs collaborateurs et être publics ou privés.

Secret

Un secret est l'un des éléments suivants : clés API, chaînes de connexion à une base de données, certificats.