GitHub Personal Access Token (PAT) — authentification sécurisée pour GitHub

Introduction

Le GitHub Personal Access Token (PAT), ou token d’accès personnel, est une méthode moderne pour s’authentifier en toute sécurité sur la plateforme GitHub.

Depuis août 2021, GitHub ne prend plus en charge l’utilisation des mots de passe pour les opérations Git via HTTPS. Cela signifie que pour toute action nécessitant auparavant un mot de passe, un token est maintenant requis. Le PAT permet de :

• accéder en toute sécurité aux dépôts ;
• travailler avec l’API GitHub ;
• automatiser des processus dans des scripts, CI/CD et autres outils sans risquer de compromettre le compte.

En résumé : le PAT est une « clé » qui offre un accès limité, peut être révoquée facilement et peut avoir une date d’expiration.

---

Pourquoi utiliser un PAT

L’objectif principal d’un PAT est de sécuriser le travail sur GitHub tout en conservant la commodité.

Fonctions clés :

1. Sécurité
   Un mot de passe donne un accès complet au compte. S’il est compromis, tout est en danger. Un token peut être limité par permissions et durée.
2. Automatisation
   Les scripts, CI/CD, bots et autres outils peuvent utiliser un PAT au lieu de saisir manuellement un nom d’utilisateur et un mot de passe.
3. Contrôle d’accès
   Il est possible de créer plusieurs tokens avec des permissions différentes pour différentes tâches. Si un token fuit, il peut être révoqué sans affecter les autres.

---

Types de tokens

GitHub propose deux types de tokens :

1. Classic (classique)
   • L’accès est défini via des scopes (par exemple, repo, workflow).
   • Donne des droits sur tous les dépôts de l’utilisateur.
   • Simple à utiliser mais moins flexible.
2. Fine-grained (détaillé)
   • Permet de limiter l’accès à des dépôts spécifiques.
   • On peut attribuer des permissions précises, par exemple « lecture seule des issues ».
   • Les organisations peuvent exiger l’approbation de ces tokens.

💡 Conseil : utilisez des tokens fine-grained là où la sécurité et la limitation de l’accès sont importantes ; les tokens classic pour la compatibilité avec les outils anciens.

---

Comment créer un PAT

Étape 1. Aller dans les paramètres

1. Ouvrez GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic).

Étape 2. Générer un nouveau token

1. Cliquez sur Generate new token (classic).
2. Donnez un nom (Note), par exemple CI-token ou Git-PC.
3. Définissez la date d’expiration — 90 jours ou 1 an est recommandé.
4. Sélectionnez les permissions nécessaires (Scopes) — minimum pour Git : repo, pour Actions : workflow.
5. Générez le token et enregistrez-le immédiatement — il ne sera affiché qu’une seule fois.

---

Utilisation du PAT

1. Git via HTTPS

git clone https://github.com/username/repo.git
# Nom d’utilisateur : votre login GitHub
# Mot de passe : token généré

Pour ne pas entrer le token à chaque fois, il peut être mis en cache :

git config --global credential.helper manager   # Windows/Mac
git config --global credential.helper 'cache --timeout=3600'  # Linux

---

2. Travailler avec l’API GitHub

$token = Get-Secret -Name GitHubToken  # récupération sécurisée du token
$headers = @{ Authorization = "token $token" }

$repos = Invoke-RestMethod -Uri "https://api.github.com/user/repos" -Headers $headers
$repos | ForEach-Object { $_.name }

Créer un issue :

$body = @{
    title = "Nouvelle tâche de test"
    body  = "Description de la tâche"
} | ConvertTo-Json

Invoke-RestMethod -Uri "https://api.github.com/repos/username/repo/issues" `
                  -Method Post `
                  -Headers $headers `
                  -Body $body

---

3. CI/CD et scripts

$token = Get-Secret -Name GitHubToken
git config --global user.name "CI Bot"
git config --global user.email "ci@example.com"

git add .
git commit -m "Mise à jour automatique"
git push "https://$token@github.com/username/repo.git" main

💡 Conseil : utilisez un token séparé avec les permissions minimales pour CI/CD.

---

4. IDE et développement local

• Dans Visual Studio Code et d’autres IDE, vous pouvez utiliser le PAT à la place du mot de passe pour travailler avec des dépôts privés et des pull requests.
• Pour différentes machines ou IDE, créez des tokens séparés afin de limiter l’impact d’une éventuelle fuite.

---

5. Gestion et sécurité

• Stockez les tokens dans des gestionnaires de mots de passe ou SecretStore.
• Créez des tokens séparés pour différentes tâches.
• Vérifiez et révoquez régulièrement les tokens inutilisés.
• Toujours définir une date d’expiration (ne pas utiliser « No expiration »).
• Planifiez la rotation des tokens pour CI/CD et scripts automatisés.

---

6. Alternative : GitHub CLI

gh auth login

Le CLI ouvrira le navigateur, effectuera l’authentification, créera et sauvegardera le token localement. Cela évite la génération manuelle du PAT et simplifie la gestion des clés.