---
title: Conectar mi repositorio
question: ¿Cómo conecto mi repositorio de GitLab o GitHub a Diavi?
description: Crear un token de acceso, iniciar sesión y elegir el repositorio en el que trabajará Diavi.
section: start
order: 1
---
Diavi se conecta a su forja con **su propio token de acceso personal**: no hay ninguna contraseña de Diavi que crear. Usted genera un token en GitLab o GitHub, lo pega al iniciar sesión, y Diavi trabaja con su identidad y exactamente los permisos que ese token lleva.

## ¿Qué permisos necesita el token?

Lo mínimo para que el pipeline pueda leer una incidencia, clonar el repositorio y abrir una merge request.

- **GitLab**: los ámbitos `api` y `read_user`.
- **GitHub**: el ámbito `repo`.

Créelo desde las preferencias de su cuenta, en *Access Tokens* (GitLab) o *Developer settings → Personal access tokens* (GitHub).

## ¿Dónde lo pego?

En la página de inicio de sesión, junto con el identificador de su espacio. Si su equipo usa una instancia autoalojada, despliegue el campo opcional e indique su URL: debe ser `https://`, nunca `http://`. Un token enviado sin cifrar cruza Internet en claro, y Diavi se niega a guardarlo.

## ¿Alguien puede volver a leer mi token?

No, y es deliberado. Se cifra en la base de datos y ninguna interfaz lo vuelve a mostrar, ni la suya ni la consola del editor. Si lo pierde, genera uno nuevo en su forja y lo reemplaza en sus ajustes; no hay recuperación, solo sustitución.

## ¿Cómo cambio el token más adelante?

Desde **Pipeline → Ejecución**, reservado al propietario de la cuenta. El nuevo token se valida contra su forja antes de guardarse: si ha caducado o le falta un ámbito, lo sabrá enseguida y no en la primera ejecución fallida.

## ¿Y después?

Una vez conectado, Diavi ve los proyectos a los que su token da acceso. Usted elige sobre cuál lanzar una ejecución en el momento de lanzarla: nada queda fijado a un único repositorio.