# Connecter GitHub

> Connectez un compte GitHub.com à AI CodeOps avec OAuth ou un token d'accès personnel, les scopes nécessaires et ce que la plateforme fait de vos dépôts.

Source: https://aicodeops.dev/fr/docs/git/github

AI CodeOps travaille sur vos dépôts GitHub par une connexion que vous établissez une fois. Les sessions clonent ensuite le dépôt, écrivent le changement sur une nouvelle branche et ouvrent une pull request pour revue.

## Avant de commencer

- Un compte GitHub.com ayant accès aux dépôts que vous voulez utiliser.
- GitHub Enterprise Server n'est pas pris en charge. Pour les serveurs Git que vous exploitez vous-même, AI CodeOps prend en charge [GitLab](https://aicodeops.dev/fr/docs/git/gitlab), [Gitea](https://aicodeops.dev/fr/docs/git/gitea) et [Forgejo](https://aicodeops.dev/fr/docs/git/forgejo).

## Se connecter avec OAuth

1. Dans votre espace de travail, ouvrez **Configure → Settings** et faites défiler jusqu'à **Git Providers**.
2. Sur la carte **GitHub**, choisissez **Connect**.
3. GitHub vous demande d'autoriser AI CodeOps. Approuvez, et vous revenez à Settings avec le compte listé sous **Connected Accounts**.

AI CodeOps demande à GitHub ces scopes OAuth :

| Scope        | Pourquoi                                                                                                                                           |
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `repo`       | Lire et écrire les dépôts auxquels vous avez accès : cloner, pousser une branche, ouvrir et fusionner des pull requests. Inclut les dépôts privés. |
| `read:user`  | Afficher quel compte GitHub est connecté.                                                                                                          |
| `user:email` | Demandé avec les scopes de connexion ; AI CodeOps ne lit pas l'adresse par cette connexion.                                                        |

Si la carte n'a pas de bouton **Connect**, ou si vous voyez « GitHub sign-in isn't available for this server », l'application OAuth de la plateforme n'est pas disponible. Connectez-vous alors avec un token.

## Se connecter avec un token d'accès personnel

Sur la carte GitHub, collez un token dans **or access token (no OAuth app)** et choisissez **Connect with token**. AI CodeOps vérifie le token auprès de GitHub avant de l'enregistrer. Un token que GitHub ne reconnaît pas reçoit « GitHub didn't recognise this token » ; un token qui ne peut pas lire votre compte reçoit un message qui nomme les permissions à ajouter.

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

- un token **classic** avec le scope `repo`, ou
- un token **fine-grained** pour les dépôts que vous voulez, avec **Contents** et **Pull requests** en lecture et écriture (Metadata en lecture est inclus).

Les tokens d'accès personnels ne sont pas renouvelés. Lorsque le token expire sur GitHub, déconnectez-vous et reconnectez-vous avec un nouveau.

## Ce qu'AI CodeOps fait du dépôt

- **Parcourir :** **Develop → Repositories** liste les dépôts que le compte peut voir, avec leurs branches, leurs fichiers et leurs pull requests.
- **Sessions :** une session clone le dépôt du projet dans son bac à sable et y écrit le changement.
- **Branches et pull requests :** lorsqu'un changement est approuvé et franchit ses [barrières qualité](https://aicodeops.dev/fr/docs/quality-gates), AI CodeOps pousse une branche nommée `codeops/run-<id>` et ouvre une pull request vers la branche par défaut du projet. Les commits ont pour auteur « AI CodeOps ».
- **Fusion :** une pull request ouverte par la console peut être fusionnée depuis la console. La barrière de livraison s'exécute d'abord de nouveau.

Les sessions n'enregistrent pas de webhooks sur vos dépôts, et AI CodeOps ne publie pas de commentaires de revue sur GitHub. 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.

## Votre token et votre accès

- Les connexions vous appartiennent, pas à l'espace de travail. Chaque membre connecte son propre compte, et les permissions de l'espace de travail déterminent toujours ce qu'il peut faire.
- Les tokens sont chiffrés au repos (AES-256-GCM) et ne sont jamais écrits dans la configuration Git d'un dépôt.
- Pour retirer l'accès, choisissez **Disconnect** à côté du compte. Vous pouvez aussi révoquer l'application ou le token sur GitHub.

## Étapes suivantes

- [Créez un projet](https://aicodeops.dev/fr/docs/projects) à partir d'un dépôt GitHub.
- [Lancez votre première session](https://aicodeops.dev/fr/docs/sessions).
- [Dépannage](https://aicodeops.dev/fr/docs/troubleshooting) si une connexion affiche **Expired** ou si un push est refusé.
