- Inicio
- Documentación
- Permisos y scopes de Git
Permisos y scopes de Git
Última actualización
Los scopes de OAuth y los permisos de token que AI CodeOps pide en GitHub, GitLab, Bitbucket, Gitea y Forgejo, para qué se usa cada uno y cómo revocar el acceso.
AI CodeOps llega a tus repositorios mediante una conexión de Git que haces en Configure → Settings → Git Providers. Esta página lista exactamente qué pide cada conexión, qué hace AI CodeOps con ella y cómo retirar el acceso.
Qué hace AI CodeOps con una conexión
Con tu token, AI CodeOps:
- lee tu perfil de usuario, para mostrar qué cuenta está conectada y para comprobar el token cuando lo conectas;
- lista y busca los repositorios a los que tienes acceso, con sus ramas, archivos, commits y pull requests (Develop → Repositories);
- clona el repositorio de un proyecto para que una sesión pueda trabajar en él;
- hace push de una rama llamada
codeops/run-<id>y abre un pull request hacia la rama predeterminada del proyecto; - fusiona un pull request cuando lo fusionas desde la consola.
No crea repositorios ni comenta en los pull requests, y las sesiones no registran webhooks ni publican estados de commit. Un repositorio que conectas en Build & Test → Builds es la excepción: recibe un webhook, para que un push o un pull request puedan iniciar un build, y un estado de commit con el resultado de cada build.
Scopes de OAuth por proveedor
Elige Connect (o Connect via OAuth en GitLab) en la tarjeta de un proveedor para conectarte con OAuth.
| Proveedor | Scopes solicitados | Para qué sirven |
|---|---|---|
| GitHub | repo, read:user, user:email | repo: leer y escribir en tus repositorios, incluidos los privados, para clonar, hacer push de ramas y abrir y fusionar pull requests. read:user: mostrar la cuenta conectada. user:email se solicita, pero la conexión no lo usa. |
| GitLab | api, read_user | api: leer repositorios, hacer push de ramas, abrir y fusionar merge requests. read_user: mostrar la cuenta conectada. |
| Bitbucket | Los fija el consumidor OAuth de la plataforma | Bitbucket los lista en su pantalla de consentimiento. Se usan para las mismas operaciones que arriba. |
| Gitea, Forgejo | Ninguno en la solicitud | Se aplica el valor por defecto del servidor para la aplicación OAuth. |
GitHub usa una aplicación OAuth, no una GitHub App. OAuth para GitLab, Gitea y Forgejo solo funciona con el servidor en el que está registrada la aplicación OAuth de la plataforma (GitLab.com en el caso de GitLab). Para cualquier otro servidor, conéctate con un token: la tarjeta solo ofrece OAuth donde puede funcionar.
Tokens de acceso personal
La tarjeta de cada proveedor tiene un campo de token: or access token (u or access token (no OAuth app) en GitHub y Bitbucket). Pega un token y elige Connect with token.
Para GitLab en tu propio servidor, Gitea y Forgejo, introduce también la Instance URL. Debe ser la dirección https pública del servidor. Las direcciones de redes privadas y localhost se rechazan, salvo que el operador de la plataforma permita ese host.
El token tiene que poder leer tu perfil, leer repositorios, hacer push de ramas, y crear y fusionar pull requests:
| Proveedor | Permisos del token |
|---|---|
| GitHub | Un token classic con repo, o un token fine-grained con Contents y Pull requests en lectura y escritura. |
| GitLab | Un token de acceso personal, de proyecto o de grupo con el scope api. Los tokens de proyecto y de grupo necesitan el rol Developer o superior. |
| Gitea, Forgejo | Lectura y escritura en repository, y lectura en user. |
| Bitbucket | Se envía como token Bearer. Los tokens que necesitan un nombre de usuario junto a ellos no funcionan; conéctate con OAuth. |
Cuando te conectas, AI CodeOps comprueba el token leyendo tu perfil. Si eso falla, el mensaje dice por qué: el proveedor no reconoció el token, el token no tiene permiso para leer tu cuenta, o ninguna API respondió en esa dirección. En ese momento no comprueba los demás scopes del token, así que un token demasiado limitado se conecta y después falla cuando una sesión intenta hacer push o abrir un pull request. Verify access en un proyecto lo comprueba para un repositorio.
Los tokens no se renuevan. Cuando un token caduque en tu proveedor, desconecta y vuelve a conectar con uno nuevo. Guías de cada proveedor: GitHub, GitLab, Bitbucket, Gitea, Forgejo.
De quién es la conexión que se usa
Una conexión pertenece a la persona que la creó, no al espacio de trabajo. Los roles del espacio de trabajo siguen decidiendo qué puede hacer cada persona con ella. Cuando un cambio se aprueba, su pull request se abre con la conexión del aprobador para ese proveedor. Cuando fusionas desde la consola, se usa tu propia conexión.
Puedes tener una conexión por tipo de proveedor. Para cambiar a otra cuenta o a otro servidor, desconecta primero.
Cómo se guardan los tokens
Los tokens se cifran en reposo con AES-256-GCM. Se pasan a Git como una cabecera de la petición, y nunca se escriben en la URL del repositorio ni en su configuración de Git.
Revocar el acceso
- Abre Configure → Settings y desplázate hasta Git Providers.
- Elige Disconnect junto a la cuenta y después Disconnect account para confirmar.
- En tu proveedor de Git, revoca el token, o la aplicación AI CodeOps en tus aplicaciones autorizadas.
El paso 3 importa: Disconnect elimina la conexión de AI CodeOps, pero no revoca el token en tu proveedor.
Siguientes pasos
Preguntas frecuentes
¿Desconectar revoca el token en mi proveedor de Git?
No. Disconnect elimina la conexión de AI CodeOps. Para revocar el propio token, revócalo, o revoca la aplicación, en los ajustes de tu proveedor de Git.
¿AI CodeOps añade webhooks a mis repositorios?
No para las sesiones. Un repositorio que conectas en Build & Test → Builds recibe un webhook, para que un push o un pull request puedan iniciar un build, y un estado de commit con el resultado de cada build. AI CodeOps no comenta en los pull requests.
¿Iniciar sesión con GitHub es lo mismo que conectar GitHub?
No. El inicio de sesión solo lee tu perfil y tu correo electrónico verificado. El acceso a los repositorios viene de la conexión de Git, que es aparte y está en Settings.