# Permissions et scopes Git

> Les scopes OAuth et les permissions de token qu'AI CodeOps demande sur GitHub, GitLab, Bitbucket, Gitea et Forgejo, à quoi sert chacun et comment révoquer l'accès.

Source: https://aicodeops.dev/fr/docs/git/permissions-and-scopes · Mis à jour le: 2026-10-18

AI CodeOps accède à vos dépôts par une connexion Git que vous établissez dans **Configure → Settings → Git Providers**. Cette page liste exactement ce que chaque connexion demande, ce qu'AI CodeOps en fait et comment retirer l'accès.

## Ce qu'AI CodeOps fait d'une connexion

Avec votre token, AI CodeOps :

- lit votre profil utilisateur, pour indiquer quel compte est connecté et pour vérifier le token au moment où vous le connectez ;
- liste les dépôts auxquels vous avez accès et permet d'y faire des recherches, avec leurs branches, leurs fichiers, leurs commits et leurs pull requests (**Develop → Repositories**) ;
- clone le dépôt d'un projet pour qu'une session puisse y travailler ;
- pousse une branche nommée `codeops/run-<id>` et ouvre une pull request vers la branche par défaut du projet ;
- fusionne une pull request lorsque vous la fusionnez depuis la console.

Il ne crée pas de dépôts et ne commente pas les pull requests, et les sessions n'enregistrent pas de webhooks et ne publient pas de statuts de commit. Un dépôt que vous connectez sous **Build & Test → Builds** fait exception : il reçoit un webhook, afin qu'un push ou une pull request puisse lancer un build, et un statut de commit avec le résultat de chaque build.

## Scopes OAuth par hébergeur

Choisissez **Connect** (ou **Connect via OAuth** sur GitLab) sur la carte d'un hébergeur pour vous connecter avec OAuth.

| Hébergeur      | Scopes demandés                                | À quoi ils servent                                                                                                                                                                                                                           |
| -------------- | ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| GitHub         | `repo`, `read:user`, `user:email`              | `repo` : lire et écrire vos dépôts, y compris privés, pour cloner, pousser des branches, ouvrir et fusionner des pull requests. `read:user` : afficher le compte connecté. `user:email` est demandé mais n'est pas utilisé par la connexion. |
| GitLab         | `api`, `read_user`                             | `api` : lire les dépôts, pousser des branches, ouvrir et fusionner des merge requests. `read_user` : afficher le compte connecté.                                                                                                            |
| Bitbucket      | Définis par le consumer OAuth de la plateforme | Bitbucket les liste sur son écran de consentement. Ils servent aux mêmes opérations que ci-dessus.                                                                                                                                           |
| Gitea, Forgejo | Aucun dans la requête                          | La valeur par défaut du serveur pour l'application OAuth s'applique.                                                                                                                                                                         |

GitHub utilise une OAuth app, pas une GitHub App. OAuth pour GitLab, Gitea et Forgejo ne fonctionne qu'avec le serveur sur lequel l'application OAuth de la plateforme est enregistrée (GitLab.com pour GitLab). Pour tout autre serveur, connectez-vous avec un token : la carte ne propose OAuth que là où il peut fonctionner.

## Tokens d'accès personnels

La carte de chaque hébergeur comporte un champ de token : **or access token** (ou **or access token (no OAuth app)** sur GitHub et Bitbucket). Collez un token et choisissez **Connect with token**.

Pour GitLab sur votre propre serveur, Gitea et Forgejo, saisissez aussi l'**Instance URL**. Ce doit être l'adresse https publique du serveur. Les adresses de réseau privé et `localhost` sont refusés, sauf si l'opérateur de la plateforme autorise cet hôte.

Le token doit pouvoir lire votre profil, lire les dépôts, pousser des branches, et créer et fusionner des pull requests :

| Hébergeur      | Permissions du token                                                                                                                                  |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| GitHub         | Un token classic avec `repo`, ou un token fine-grained avec **Contents** et **Pull requests** en lecture et écriture.                                 |
| GitLab         | Un token d'accès personnel, de projet ou de groupe avec le scope `api`. Les tokens de projet et de groupe nécessitent le rôle Developer ou supérieur. |
| Gitea, Forgejo | Lecture et écriture sur **repository**, et lecture sur **user**.                                                                                      |
| Bitbucket      | Envoyé comme Bearer token. Les tokens qui nécessitent en plus un nom d'utilisateur ne fonctionnent pas ; connectez-vous plutôt avec OAuth.            |

Au moment de la connexion, AI CodeOps vérifie le token en lisant votre profil. En cas d'échec, le message indique pourquoi : l'hébergeur n'a pas reconnu le token, le token n'est pas autorisé à lire votre compte, ou aucune API n'a répondu à l'adresse. Il ne vérifie pas les autres scopes du token à ce moment-là : un token trop restreint se connecte donc, puis échoue lorsqu'une session tente de pousser ou d'ouvrir une pull request. **Verify access**, sur un projet, le vérifie pour un dépôt.

Les tokens ne sont pas renouvelés. Lorsqu'un token expire sur votre hébergeur, déconnectez-vous et reconnectez-vous avec un nouveau. Guides par hébergeur : [GitHub](https://aicodeops.dev/fr/docs/git/github), [GitLab](https://aicodeops.dev/fr/docs/git/gitlab), [Bitbucket](https://aicodeops.dev/fr/docs/git/bitbucket), [Gitea](https://aicodeops.dev/fr/docs/git/gitea), [Forgejo](https://aicodeops.dev/fr/docs/git/forgejo).

## Quelle connexion est utilisée

Une connexion appartient à la personne qui l'a établie, pas à l'espace de travail. Les rôles de l'espace de travail déterminent toujours ce que chaque personne peut en faire. Lorsqu'un changement est approuvé, sa pull request est ouverte avec la connexion de l'approbateur pour cet hébergeur. Lorsque vous fusionnez depuis la console, c'est votre propre connexion qui est utilisée.

Vous pouvez avoir une connexion par type d'hébergeur. Pour passer à un autre compte ou à un autre serveur, déconnectez-vous d'abord.

## Comment les tokens sont stockés

Les tokens sont chiffrés au repos avec AES-256-GCM. Ils sont transmis à Git dans un en-tête de requête, et ne sont jamais écrits dans l'URL du dépôt ni dans sa configuration Git.

## Révoquer l'accès

1. Ouvrez **Configure → Settings** et faites défiler jusqu'à **Git Providers**.
2. Choisissez **Disconnect** à côté du compte, puis **Disconnect account** pour confirmer.
3. Sur votre hébergeur Git, révoquez le token, ou l'application AI CodeOps dans vos applications autorisées.

L'étape 3 compte : **Disconnect** supprime la connexion dans AI CodeOps mais ne révoque pas le token sur votre hébergeur.

## Étapes suivantes

- [Créez un projet](https://aicodeops.dev/fr/docs/projects)
- [Comment fonctionne AI CodeOps](https://aicodeops.dev/fr/docs/how-it-works)
- [Dépannage](https://aicodeops.dev/fr/docs/troubleshooting)

## Questions fréquentes

### La déconnexion révoque-t-elle le token sur mon hébergeur Git ?

Non. Disconnect supprime la connexion dans AI CodeOps. Pour révoquer le token lui-même, révoquez-le, ou révoquez l'application, dans les réglages de votre hébergeur Git.

### AI CodeOps ajoute-t-il des webhooks à mes dépôts ?

Pas pour les sessions. Un dépôt que vous connectez sous Build & Test → Builds reçoit un webhook, afin qu'un push ou une pull request puisse lancer un build, et un statut de commit avec le résultat de chaque build. AI CodeOps ne commente pas les pull requests.

### Se connecter avec GitHub revient-il à connecter GitHub ?

Non. La connexion au compte ne lit que votre profil et votre e-mail vérifié. L'accès aux dépôts vient de la connexion Git distincte, dans Settings.
