---
title: Conectar mi repositorio
question: ¿Cómo conecto mi repositorio de GitLab o GitHub a Diavi?
description: Iniciar sesión con su forja, dar al espacio su acceso a los repositorios y elegir el repositorio en el que trabajará Diavi.
section: start
order: 1
---
Haga clic en **Continuar con GitLab** o **Continuar con GitHub**: su forja prueba quién es usted, sin contraseña que crear. El acceso a los repositorios pasa por el token del espacio, que el propietario instala una vez; cada miembro trabaja después con él, sin aportar el suyo.

## ¿Cómo iniciar sesión?

- **Con su forja** (recomendado): un clic, y GitLab o GitHub confirma su identidad. Para una instancia de GitLab autoalojada, despliegue el campo opcional e indique su URL, en `https://`.
- **Con un correo y una contraseña**: se definen en **Preferencias → Inicio de sesión y seguridad**, una vez conectado con su forja. Práctico allí donde la forja no está abierta a todos.
- **Con un token personal**: solo cuando su instancia aún no ha declarado una aplicación de inicio de sesión. Sirve para probar su identidad una vez y después no se guarda.

## ¿Qué permisos necesita el token del espacio?

El mínimo para leer una issue, clonar el repositorio y abrir una merge request.

- **GitLab**: los scopes `api` y `read_user`.
- **GitHub**: el scope `repo`.

Se instala en **Preferencias → Forja**. Se valida contra su forja antes de guardarse: si ha caducado o le falta un scope, lo sabe enseguida y no en el primer run fallido.

## ¿Alguien puede volver a leer el token?

No, y es deliberado. Está cifrado en la base de datos y ninguna pantalla lo vuelve a mostrar — ni la suya ni la consola de Diavi. Si lo pierde, genera uno nuevo en su forja y lo reemplaza; no hay recuperación, solo sustitución. Diavi le avisa cuando se acerca a la antigüedad que usted fijó, y en cuanto la forja lo rechaza.

## ¿Y si la persona que puso el token se va?

Con un token personal, el espacio depende de esa persona: si deja el equipo o su token caduca, los runs se detienen. En GitLab, ponga mejor un **token de acceso de grupo** (o de proyecto): actúa en nombre de un bot que no pertenece a nadie, y Diavi lo reconoce solo — la pantalla muestra «Token del bot». En GitHub, instale la **aplicación Diavi** en su organización desde **Preferencias → Forja**, cuando se ofrezca: su token se renueva solo. Los inicios de sesión de los miembros nunca sustituyen a ninguno de los dos.

## ¿Y después?

Una vez conectado, Diavi ve los proyectos a los que da acceso el token del espacio. Usted elige en cuál lanzar un run en el momento del lanzamiento — nada queda bloqueado en un solo repositorio.