Saltar para o conteúdo principal

​
Visão geral

O ZeroPath suporta o Azure DevOps Services como um provedor de VCS de primeira classe. Depois de conectar uma organização do Azure DevOps Services, você pode importar repositórios do Azure Repos, executar scans completos, escanear pull requests a partir de eventos de service hooks, publicar verificações de status e comentários inline, criar pull requests de correção para achados validados e visualizar achados de dependências no painel Supply Chain.
O suporte ao Azure DevOps atualmente contempla organizações do Azure DevOps Services na nuvem, como https://dev.azure.com/{organization}. O Azure DevOps Server não está incluído neste caminho de configuração v1.

​
Pré-requisitos

  • Uma organização no ZeroPath onde você possa criar instalações de VCS e repositórios.
  • Uma organização do Azure DevOps Services e pelo menos um projeto com o Azure Repos habilitado.
  • Permissão no Azure DevOps para ler repositórios e criar service hooks nos projetos que você quer que o ZeroPath monitore.
  • Uma conta Microsoft Entra que possa autorizar o ZeroPath ou um personal access token com os escopos necessários.

​
Conecte o Azure DevOps Services

Use OAuth quando sua organização puder aprovar uma conexão delegada do Microsoft Entra. Este é o caminho recomendado porque os usuários não precisam copiar PATs de longa duração para o ZeroPath.
1

Abra a configuração do Azure DevOps

No ZeroPath, acesse Add Repositories, selecione a aba Azure DevOps e clique em Setup Azure DevOps.
2

Insira a URL da sua organização

Insira a URL da sua organização do Azure DevOps Services, por exemplo https://dev.azure.com/my-organization.
3

Autorize o ZeroPath

Prossiga pela tela de consentimento da Microsoft. O ZeroPath troca o código de autorização por material de credencial criptografado e valida o acesso listando os projetos e repositórios do Azure DevOps.
4

Importe repositórios

Após o callback, os repositórios acessíveis aparecem na aba Azure DevOps. Selecione repositórios individuais, importe um lote selecionado ou clique em Add all accessible Azure DevOps repositories.

​
Importação de repositórios

O ZeroPath descobre repositórios listando os projetos da organização do Azure DevOps Services conectada e, em seguida, listando os repositórios Git dentro de cada projeto. Você pode importar repositórios de três formas:
  • Repositório único - selecione um repositório e clique em Add selected Azure DevOps repositories.
  • Lote selecionado - selecione vários repositórios na tabela e importe-os juntos.
  • Adicionar todos - importe todos os repositórios acessíveis e não arquivados do Azure DevOps sem paginar a lista completa no navegador.
Repositórios arquivados do Azure DevOps são automaticamente excluídos da sua lista de repositórios, seguindo o comportamento já existente para repositórios do GitHub e do GitLab. Repositórios importados recebem as mesmas configurações padrão de scanner, tags, limites de repositórios, eventos de auditoria e notificações de repositório adicionado que os demais provedores de VCS suportados.

​
Scan de PRs

O ZeroPath cria assinaturas de service hooks do Azure DevOps para os projetos conectados. Quando um pull request é criado ou atualizado, o ZeroPath agenda um scan de PR sobre os arquivos alterados. Os resultados do scan de PR podem incluir:
  • Um status do ZeroPath publicado no pull request do Azure DevOps.
  • Comentários de revisão inline nas linhas de diff afetadas.
  • Um comentário de resumo no PR com o resultado do scan.
  • Resolução automática de threads de comentários obsoletas quando os achados são corrigidos ou triados.
Os comandos do bot não estão disponíveis no momento em comentários de PR do Azure DevOps. Use o painel para ações de triagem, como marcação de falso positivo, atribuição e geração de correções.

​
Pull requests de correção

Quando um achado é elegível para uma correção automática, o ZeroPath pode criar um pull request no Azure DevOps usando o mesmo fluxo de correção dos demais provedores de VCS suportados:
  • Gerar um branch de correção.
  • Fazer o commit da correção com a convenção padrão de mensagens de commit do ZeroPath.
  • Abrir um pull request direcionado ao branch original.
  • Adicionar contexto de resumo e vincular o PR de correção de volta ao achado no ZeroPath.

​
Solução de problemas

Confirme que a identidade OAuth ou o PAT pode acessar a organização do Azure DevOps Services e os projetos esperados. A conexão deve conseguir listar projetos e repositórios.
Verifique se um repositório com o mesmo nome ou URL já está vinculado no ZeroPath. Verifique também se a sua organização não atingiu o limite de repositórios.
Confirme que o scan de PR está habilitado nas configurações do repositório no ZeroPath e que a conexão do Azure DevOps ainda tem permissão para gerenciar service hooks no projeto em questão. Para PRs grandes, o ZeroPath recorre automaticamente a um método alternativo de obtenção do diff se o método primário exceder o tempo limite, então os scans de PR ainda devem ser concluídos.
Verifique se a concessão OAuth ou o PAT inclui acesso de escrita para status, comentários de pull request e threads de pull request. Reconecte a instalação após rotacionar as credenciais.
Confirme que a credencial pode criar branches, enviar commits e abrir pull requests no repositório de destino. Políticas de branch no Azure DevOps também podem bloquear atualizações automatizadas de branches.

​
Notas operacionais

  • Renovação de token OAuth: quando você conecta o Azure DevOps via Microsoft Entra OAuth, o ZeroPath renova automaticamente os tokens de acesso expirados durante as operações de scan. Você não precisa reconectar manualmente a instalação quando o token de acesso OAuth de curta duração expira. Se o refresh token em si for revogado ou expirar, o ZeroPath solicita que você reconecte a instalação.
  • Desconectar uma instalação do Azure DevOps impede que novos scans sejam agendados para aquela conexão e remove todos os repositórios que foram vinculados por meio dela. Repositórios protegidos pelo modo pesquisador são retidos até que o modo pesquisador seja desabilitado.
  • Rotacione PATs reconectando a instalação do Azure DevOps com o novo token.
  • Se novos projetos forem adicionados após a configuração, reconecte ou ressincronize os service hooks para que o ZeroPath possa se inscrever nos eventos de PR e de criação de repositórios desses projetos.