Comment créer un Personal Access Token (PAT)

Quand utiliser ce guide

Utilise ce guide quand tu veux :

Accéder à l'API gitrust depuis un script ou un outil CI sans exposer ton mot de passe
Cloner un dépôt via HTTPS depuis un environnement où SSH n'est pas disponible
Révoquer un accès accordé à un outil tiers sans changer ton mot de passe
Comprendre quels scopes attribuer à un token selon l'usage

Pré-requis

Un compte gitrust actif

Étapes

1. Accéder à la gestion des tokens

Dans ton navigateur, navigue vers Paramètres → Tokens d'accès (/settings/tokens).

La page liste tes tokens existants avec leur nom, leur date de création et leur date d'expiration.

Page /settings/tokens

2. Créer un nouveau token

Clique Créer un token. Remplis le formulaire :

Nom : un nom descriptif qui rappelle l'usage (ex. script-backup-2026, ci-github-actions, cli-perso)
Expiration : choisis une durée (30 jours, 90 jours, 1 an, ou sans expiration). Pour les scripts de CI, préfère une expiration explicite.
Scopes : sélectionne uniquement les permissions nécessaires (principe du moindre privilège)

Scope	Permet
`repo:read`	Lire les dépôts, les issues, les PRs, les commits
`repo:write`	Créer des issues, commenter, pousser du code, ouvrir des PRs
`user:read`	Lire les informations de ton profil

Clique Générer le token.

3. Copier le token immédiatement

gitrust affiche le token une seule fois :

gr_pat_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Copie-le immédiatement dans ton gestionnaire de mots de passe. Cette valeur ne sera plus jamais affichée — si tu la perds, tu devras révoquer le token et en créer un nouveau.

Utiliser le token

Avec `git clone` via HTTPS

git clone https://tonpseudo:gr_pat_xxxx@gitrust.example.com/owner/repo.git

Pour éviter que le token apparaisse dans l'historique du shell, stocke-le dans une variable d'environnement :
export GITRUST_TOKEN="gr_pat_xxxx"
git clone https://tonpseudo:${GITRUST_TOKEN}@gitrust.example.com/owner/repo.git

Avec l'API REST (header `Authorization`)

curl -H "Authorization: Bearer gr_pat_xxxx" \
     https://gitrust.example.com/api/v1/user

Réponse attendue :

{
  "id": 42,
  "username": "tonpseudo",
  "email": "ton@email.com"
}

Dans un script Python

import urllib.request
import json

token = "gr_pat_xxxx"
req = urllib.request.Request(
    "https://gitrust.example.com/api/v1/user",
    headers={"Authorization": f"Bearer {token}"}
)
with urllib.request.urlopen(req) as resp:
    user = json.load(resp)
    print(user["username"])

Révoquer un token

Dans /settings/tokens, clique Révoquer à côté du token concerné. La révocation est immédiate — toute requête utilisant ce token recevra une réponse 401 Unauthorized.

Cas où révoquer immédiatement :

Token exposé accidentellement dans un dépôt public ou des logs
Machine ou outil auquel le token était destiné est compromise
Token inutilisé depuis longtemps

Variantes

Token sans expiration

Acceptable pour les outils personnels sur une machine de confiance. À déconseiller pour les environnements partagés (CI d'entreprise, scripts déployés sur un serveur). Préfère dans ces cas un token avec expiration de 90 jours renouvelé via un secret manager.

Plusieurs tokens pour un même outil

Crée un token par environnement (local, staging, prod) avec des scopes distincts. Ainsi, compromettre le token de staging n'expose pas la production.

Voir aussi

Référence API REST v1 : liste des endpoints et authentification JWT vs PAT
Comprendre la sécurité côté utilisateur : comment gitrust stocke les tokens (hash, jamais en clair)
Gérer ses clés SSH : alternative SSH pour les opérations Git

Eric / documentation