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. 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.
- Microsoft Entra ID
- Token de acesso pessoal
Use esta opção para uma conta corporativa ou de estudante.
- Clique em Microsoft Entra ID e entre com a Microsoft.
- Em Choose organizations to connect, selecione as organizações do Azure DevOps que o Enclave deve ler.
- Clique em Connect.
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
A organização mostra "push events not active"
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.
Um novo projeto ou repositório não aparece
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.
A validação do token falha
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.
A organização mostra "reconnect needed"
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.