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

> Conecte organizações do Azure DevOps para que o Enclave possa ler e aprender sobre seus repositórios do Azure Repos.

Conecte o Azure DevOps para que o Enclave possa ler e aprender sobre os repositórios das suas organizações do Azure DevOps.

## Antes de começar

Você precisa da função **Owner** ou **Admin** no Enclave.

No Azure DevOps, a conta usada na conexão precisa de **Project Administrator** nos projetos que você quer verificar ou da permissão **Edit Subscription**. O Enclave a usa para criar os service hooks que enviam eventos de push. Sem ela, o Enclave consegue ler seu código, mas não vê novos commits.

## Conectar o Azure DevOps

**1. Abra as integrações**

Abra **Settings → Integrations** em [app.enclave.ai](https://app.enclave.ai). Clique em **Connect** ao lado de **Azure DevOps**.

**2. Escolha como entrar**

Escolha a opção que corresponde à forma como você entra no Azure DevOps.

> [tab] Microsoft Entra ID
>
> Use esta opção para uma conta corporativa ou de estudante.
>
> 1. Clique em **Microsoft Entra ID** e entre com a Microsoft.
> 2. Em **Choose organizations to connect**, selecione as organizações do Azure DevOps que o Enclave deve ler.
> 3. Clique em **Connect**.
>
> Você pode conectar mais organizações depois.

> [tab] Token de acesso pessoal
>
> Use esta opção se você entra com uma conta pessoal da Microsoft. O Microsoft Entra ID não emite tokens para contas pessoais.
>
> 1. No Azure DevOps, crie um token de acesso pessoal que possa ler código, listar projetos e gerenciar service hooks. O Azure DevOps agrupa essas permissões de formas diferentes conforme a versão da tela de tokens. Consulte a [referência de escopos de token da Microsoft](https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate).
>
> 2. No Enclave, clique em **Personal access token**.
>
> 3. Informe sua **Organization**. É o segmento do caminho em `dev.azure.com/<organization>`.
>
> 4. Cole o token e clique em **Validate & connect**.
>
> > [!TIP]
> >
> > Use um token de uma conta de serviço em vez de um pessoal. A atividade aparece em nome da conta dona do token.

**3. Confirme a conexão**

De volta a **Settings → Integrations → Azure DevOps**, a organização aparece em **Organizations** com a contagem de repositórios.

## Permissões

O Enclave usa a conexão para:

* **Ler repositórios, branches e pull requests.** O Enclave lê seu código e o histórico dele.
* **Criar e remover assinaturas de service hooks.** O Enclave assina eventos de push e de pull request para saber quando o código muda.
* **Criar e atualizar work items do Azure Boards para achados.** Isso exige a permissão **Work Items (read & write)**. Conectar o Azure DevOps já conecta o Azure Boards. Não há configuração separada.

## Gerenciar a conexão

Abra **Settings → Integrations → Azure DevOps** para ver suas organizações conectadas.

* **Resync** inclui projetos e repositórios criados depois da conexão. O Azure DevOps não avisa o Enclave quando eles são criados, então clique em **Resync** depois de adicionar um. Ele também verifica as permissões de novo depois que você as corrige.
* **Add organization** conecta outra organização do Azure DevOps.
* **Remove** desconecta uma organização. O Enclave para de verificar os repositórios dela. Você pode reconectá-la depois.

## Solução de problemas

> [accordion] A organização mostra "push events not active"
>
> O Enclave leu seus repositórios, mas não conseguiu criar service hooks. Conceda à conta usada na conexão **Edit Subscription** (ou **Project Administrator**) nos projetos e clique em **Resync**.

> [accordion] A organização mostra "Azure Boards unavailable"
>
> A conexão não consegue criar work items. Conceda **Work Items (read & write)** e clique em **Resync**.

> [accordion] Um novo projeto ou repositório não aparece
>
> Clique em **Resync** na organização. Em uma organização grande, a ressincronização continua em andamento depois do clique. Os repositórios aparecem à medida que são sincronizados.

> [accordion] A validação do token falha
>
> * **Azure DevOps rejected this token**: o token expirou ou foi revogado. Crie um novo.
> * **This token can't do everything Enclave needs**: recrie o token para que ele possa ler código, listar projetos e gerenciar service hooks.
> * **This token authenticated but can't see any projects**: adicione o dono do token a um projeto em **Project Settings → Permissions**.
> * **We couldn't reach that Azure DevOps organization**: verifique o nome da organização e suas regras de rede.

> [accordion] A organização mostra "reconnect needed"
>
> O Enclave não consegue mais usar as credenciais da conexão. Remova a organização e conecte-a de novo.


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