À propos de l’authentification auprès de GitHub
Pour maintenir votre compte sécurisé, vous devez vous authentifier avant de pouvoir accéder à certaines des ressources sur GitHub Enterprise Server. Quand vous vous authentifiez auprès de GitHub Enterprise Server, vous fournissez ou confirmez des informations d’identification qui vous sont propres pour prouver que vous êtes exactement qui vous déclarez être.
Vous pouvez accéder à vos ressources dans GitHub Enterprise Server de différentes façons : dans le navigateur, avec GitHub Desktop ou une autre application de bureau, avec l’API ou par le biais de la ligne de commande. Chaque façon d’accéder à GitHub Enterprise Server prend en charge différents modes d’authentification.
- Votre fournisseur d’identité (IdP)
- Nom d’utilisateur et mot de passe avec authentification à 2 facteurs
- Personal access token
- Clé SSH
Authentification dans votre navigateur
Vous pouvez vous authentifier auprès de GitHub Enterprise Server dans votre navigateur de plusieurs façons.
- Nom d’utilisateur et mot de passe uniquement
- Vous créez un mot de passe lors de la création de votre compte sur GitHub Enterprise Server. Nous vous recommandons d’utiliser un gestionnaire de mots de passe pour générer un mot de passe aléatoire et unique. Pour plus d’informations, consultez « Création d’un mot de passe fort ».
- Authentification à 2 facteurs (TFA) (recommandée)
- Si vous activez 2FA, après avoir correctement entré votre nom d’utilisateur et votre mot de passe, nous vous inviterons également à fournir un code généré par une application de mot de passe à temps unique (TOTP) sur votre appareil mobile. Pour plus d’informations, voir « Accès à GitHub avec l’authentification à 2 facteurs ».
- En plus de l’authentification avec une application TOTP, vous pouvez ajouter une autre méthode d’authentification avec une clé de sécurité à l’aide de WebAuthn. Pour plus d’informations, consultez « Configuration de l’authentification à 2 facteurs avec une clé de sécurité ».
- Authentification externe
- Votre administrateur de site peut configurer votre instance GitHub Enterprise Server de manière à utiliser l’authentification externe plutôt qu’un nom d’utilisateur et un mot de passe. Pour plus d’informations, consultez « Méthodes d’authentification externe ».
Authentification avec GitHub Desktop
Vous pouvez vous authentifier avec GitHub Desktop à l’aide de votre navigateur. Pour plus d’informations, consultez « Authentification auprès de GitHub ».
Authentification avec l’API
Vous pouvez vous authentifier avec l’API de différentes façons.
- Personal access tokens
- Dans certaines situations (par exemple pour des tests), vous pouvez utiliser un personal access token pour accéder à l’API. Le recours à un personal access token vous permet de révoquer l’accès à tout moment. Pour plus d’informations, consultez « Création d’un personal access token ».
- Flux d’application web
- Pour les applications OAuth en production, vous devez vous authentifier à l’aide du flux d’application web. Pour plus d’informations, consultez « Autorisation des applications OAuth ».
- Applications GitHub
- Pour les applications GitHub en production, vous devez vous authentifier pour le compte de l’installation de l’application. Pour plus d’informations, consultez « Authentification avec des GitHub Apps ».
Authentification avec la ligne de commande
Vous pouvez accéder aux dépôts sur GitHub Enterprise Server à partir de la ligne de commande de deux façons, HTTPS et SSH, chacune ayant sa propre méthode d’authentification. La méthode d’authentification diffère selon que vous choisissez une URL distante SSH ou HTTPS quand vous clonez le dépôt. Pour plus d’informations sur la façon d’accéder, consultez « À propos des dépôts distants ».
HTTPS
Vous pouvez utiliser tous les dépôts sur GitHub Enterprise Server sur HTTPS, même si vous êtes derrière un pare-feu ou un proxy.
Si vous vous authentifiez avec GitHub CLI, vous pouvez utiliser soit un personal access token, soit votre navigateur web. Pour plus d’informations sur l’authentification avec GitHub CLI, consultez gh auth login.
Si vous vous authentifiez sans GitHub CLI, vous devez utiliser un personal access token. Lorsque Git vous invite à entrer votre mot de passe, entrez votre personal access token. Vous pouvez également utiliser une assistance d’informations d’identification comme Git Credential Manager. L’authentification par mot de passe pour Git a été supprimée en faveur de méthodes d’authentification plus sécurisées. Pour plus d’informations, consultez « Création d’un jeton d’accès personnel ». Chaque fois que vous utilisez Git pour vous authentifier auprès de GitHub Enterprise Server, vous êtes invité à entrer vos informations d’identification pour vous authentifier auprès de GitHub Enterprise Server, sauf si vous les mettez en cache avec un gestionnaire d’informations d’identification.
SSH
Vous pouvez utiliser tous les dépôts sur GitHub Enterprise Server sur SSH, bien que les pare-feux et proxys puissent refuser les connexions SSH.
Si vous vous authentifiez avec GitHub CLI, l’interface de ligne de commande trouve des clés publiques SSH sur votre ordinateur et vous invite à en sélectionner une à charger. Si GitHub CLI ne trouve pas de clé publique SSH à charger, il peut générer une nouvelle paire de clés publique-privée SSH et charger la clé publique sur votre compte dans votre instance GitHub Enterprise Server. Vous pouvez alors vous authentifier avec un personal access token ou votre navigateur web. Pour plus d’informations sur l’authentification avec GitHub CLI, consultez gh auth login.
Si vous vous authentifiez sans GitHub CLI, vous devez générer une nouvelle paire de clés publique-privée SSH sur votre ordinateur local et ajouter la clé publique à votre compte dans votre instance GitHub Enterprise Server. Pour plus d’informations, consultez « Génération d’une nouvelle clé SSH et ajout de celle-ci à ssh-agent ». Chaque fois que vous utilisez Git pour vous authentifier auprès de GitHub Enterprise Server, vous êtes invité à entrer votre phrase secrète de clé SSH, sauf si vous avez stocké la clé.
Formats de jeton de GitHub
GitHub émet des jetons avec un préfixe indiquant le type de jeton.
| Type de jeton | Préfixe | Plus d’informations |
|---|---|---|
| Personal access token | ghp_ | « Création d’un personal access token » |
| Jeton d’accès OAuth | gho_ | « Autorisation des OAuth Apps » |
| Jeton d’utilisateur à serveur pour une GitHub App | ghu_ | « Identification et autorisation des utilisateurs pour des GitHub Apps » |
| Jeton de serveur à serveur pour une GitHub App | ghs_ | « Authentification avec des GitHub Apps » |
| Jeton d’actualisation pour une GitHub App | ghr_ | « Actualisation de jetons d’accès d’utilisateur à serveur » |