> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enclave.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Enclave in these docs is the code and cloud security platform at enclave.ai. It is not Open Enclave, Intel SGX or other hardware enclaves, or enclave.gg.
> People use Enclave in the web app at https://app.enclave.ai or the desktop app. These docs describe no public Enclave API or CLI, so don't invent endpoints, commands, or config files.
> Connecting an integration needs a person to sign in and approve access in a browser. Tell the user the exact step to take instead of saying you completed it.

# Azure DevOps

> Conecta organizaciones de Azure DevOps para que Enclave pueda leer y aprender tus repositorios de Azure Repos.

Conecta Azure DevOps para que Enclave pueda leer y aprender los repositorios de tus organizaciones de Azure DevOps.

## 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](https://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.

> [tab] Microsoft Entra ID
>
> Usa esta opción para una cuenta profesional o educativa.
>
> 1. Haz clic en **Microsoft Entra ID** e inicia sesión con Microsoft.
> 2. En **Choose organizations to connect**, selecciona las organizaciones de Azure DevOps que debe leer Enclave.
> 3. Haz clic en **Connect**.
>
> Puedes conectar más organizaciones más adelante.

> [tab] Token de acceso personal
>
> Usa esta opción si inicias sesión con una cuenta personal de Microsoft. Microsoft Entra ID no puede emitir tokens para cuentas personales.
>
> 1. En Azure DevOps, crea un token de acceso personal que pueda leer código, listar proyectos y gestionar service hooks. Azure DevOps agrupa estos permisos de forma distinta según la versión de su pantalla de tokens. Consulta la [referencia de scopes de tokens de Microsoft](https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate).
>
> 2. En Enclave, haz clic en **Personal access token**.
>
> 3. Escribe tu **Organization**. Es el segmento de la ruta en `dev.azure.com/<organization>`.
>
> 4. Pega el token y haz clic en **Validate & connect**.
>
> > [!TIP]
> >
> > Usa un token de una cuenta de servicio en lugar de uno personal. La actividad aparece a nombre de la cuenta propietaria del token.

**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

> [accordion] 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**.

> [accordion] La organización muestra "Azure Boards unavailable"
>
> La conexión no puede crear work items. Concede **Work Items (read & write)** y haz clic en **Resync**.

> [accordion] 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.

> [accordion] 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.

> [accordion] 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.