Antes de empezar
Necesitas el rol Owner o Admin en Enclave. En Azure DevOps, la cuenta con la que te conectas necesita Project Administrator en los proyectos que quieres analizar, o el permiso Edit Subscription. Enclave lo usa para crear los service hooks que envían los eventos de push. Sin él, Enclave puede leer tu código pero no ve los commits nuevos.Conectar Azure DevOps
1
Abre las integraciones
Abre Settings → Integrations en app.enclave.ai. Haz clic en Connect junto a Azure DevOps.
2
Elige cómo iniciar sesión
Elige la opción que corresponda a cómo inicias sesión en Azure DevOps.
- Microsoft Entra ID
- Token de acceso personal
Usa esta opción para una cuenta profesional o educativa.
- Haz clic en Microsoft Entra ID e inicia sesión con Microsoft.
- En Choose organizations to connect, selecciona las organizaciones de Azure DevOps que debe leer Enclave.
- Haz clic en Connect.
3
Confirma la conexión
De vuelta en Settings → Integrations → Azure DevOps, la organización aparece en Organizations con su número de repositorios.
Permisos
Enclave usa la conexión para:- Leer repositorios, ramas y pull requests. Enclave lee tu código y su historial.
- Crear y eliminar suscripciones de service hooks. Enclave se suscribe a los eventos de push y de pull request para saber cuándo cambia el código.
- Crear y actualizar work items de Azure Boards para los hallazgos. Esto requiere el permiso Work Items (read & write). Al conectar Azure DevOps se conecta también Azure Boards. No hace falta ninguna configuración aparte.
Gestionar la conexión
Abre Settings → Integrations → Azure DevOps para ver tus organizaciones conectadas.- Resync detecta los proyectos y repositorios creados después de conectarte. Azure DevOps no avisa a Enclave cuando se crean, así que haz clic en Resync después de añadir uno. También vuelve a comprobar los permisos después de corregirlos.
- Add organization conecta otra organización de Azure DevOps.
- Remove desconecta una organización. Enclave deja de analizar sus repositorios. Puedes volver a conectarla más adelante.
Solución de problemas
La organización muestra "push events not active"
La organización muestra "push events not active"
Enclave leyó tus repositorios, pero no pudo crear los service hooks. Concede a la cuenta que se conecta Edit Subscription (o Project Administrator) en los proyectos y haz clic en Resync.
No aparece un proyecto o repositorio nuevo
No aparece un proyecto o repositorio nuevo
Haz clic en Resync en la organización. En una organización grande, la resincronización sigue en curso después de hacer clic. Los repositorios aparecen a medida que se sincronizan.
Falla la validación del token
Falla la validación del token
- Azure DevOps rejected this token: el token caducó o se revocó. Crea uno nuevo.
- This token can’t do everything Enclave needs: vuelve a crear el token para que pueda leer código, listar proyectos y gestionar service hooks.
- This token authenticated but can’t see any projects: añade al propietario del token a un proyecto en Project Settings → Permissions.
- We couldn’t reach that Azure DevOps organization: revisa el nombre de la organización y tus reglas de red.
La organización muestra "reconnect needed"
La organización muestra "reconnect needed"
Enclave ya no puede usar las credenciales de la conexión. Elimina la organización y vuelve a conectarla.