---
title: Connecter mon dépôt
question: Comment connecter mon dépôt GitLab ou GitHub à Diavi ?
description: Se connecter avec sa forge, donner à l'espace son accès aux dépôts, et choisir le dépôt sur lequel Diavi travaillera.
section: start
order: 1
---
Cliquez sur **Continuer avec GitLab** ou **Continuer avec GitHub** : votre forge prouve qui vous êtes, sans mot de passe à créer. L'accès aux dépôts, lui, passe par le jeton de l'espace, que le propriétaire installe une fois ; chaque membre travaille ensuite avec lui, sans fournir le sien.

## Comment se connecter ?

- **Avec votre forge** (recommandé) : un clic, et GitLab ou GitHub confirme votre identité. Pour une instance GitLab auto-hébergée, dépliez le champ optionnel et indiquez son URL, en `https://`.
- **Avec un e-mail et un mot de passe** : à poser depuis **Préférences → Connexion et sécurité**, une fois connecté par votre forge. Pratique là où la forge n'est pas ouverte à tous.
- **Avec un jeton personnel** : seulement quand votre instance n'a pas encore déclaré d'application de connexion. Il sert à prouver votre identité une fois, puis il n'est pas gardé.

## Quels droits le jeton de l'espace doit-il avoir ?

Le minimum pour lire une issue, cloner le dépôt et ouvrir une merge request.

- **GitLab** : les scopes `api` et `read_user`.
- **GitHub** : le scope `repo`.

Il s'installe dans **Préférences → Forge**. Il est validé contre votre forge avant d'être enregistré : s'il est expiré ou mal scopé, vous le savez tout de suite plutôt qu'au premier run échoué.

## Personne ne peut relire le jeton ?

Non, et c'est délibéré. Il est chiffré en base et aucune interface ne le réaffiche — ni la vôtre, ni la console de Diavi. Si vous le perdez, vous en générez un nouveau depuis votre forge et vous le remplacez ; il n'y a pas de récupération, seulement un remplacement. Diavi vous prévient quand il approche de l'âge que vous avez fixé, et dès que la forge le refuse.

## Et si la personne qui a posé le jeton s'en va ?

Avec un jeton personnel, l'espace dépend de cette personne : si elle quitte l'équipe ou si son jeton expire, les runs s'arrêtent. Sur GitLab, posez plutôt un **jeton d'accès de groupe** (ou de projet) : il agit au nom d'un bot qui n'appartient à personne, et Diavi le reconnaît tout seul — l'écran affiche « Jeton du bot ». Sur GitHub, installez l'**application Diavi** sur votre organisation depuis **Préférences → Forge**, quand elle est proposée : son jeton se renouvelle seul. Les connexions des membres ne remplacent jamais ni l'un ni l'autre.

## Et ensuite ?

Une fois connecté, Diavi voit les projets auxquels le jeton de l'espace donne accès. Vous choisissez celui sur lequel lancer un run au moment du lancement — rien n'est verrouillé sur un seul dépôt.