Prima di iniziare
Ti serve il ruolo Owner o Admin in Enclave. In Azure DevOps, l’account con cui ti colleghi deve avere Project Administrator sui progetti da analizzare, oppure il permesso Edit Subscription. Enclave lo usa per creare i service hook che inviano gli eventi di push. Senza questo permesso, Enclave può leggere il tuo codice ma non vede i nuovi commit.Collega Azure DevOps
1
Apri le integrazioni
Apri Settings → Integrations in app.enclave.ai. Fai clic su Connect accanto a Azure DevOps.
2
Scegli come accedere
Seleziona l’opzione che corrisponde al modo in cui accedi ad Azure DevOps.
- Microsoft Entra ID
- Personal access token
Usa questa opzione per un account aziendale o dell’istituto di istruzione.
- Fai clic su Microsoft Entra ID e accedi con Microsoft.
- In Choose organizations to connect, seleziona le organizzazioni Azure DevOps che Enclave deve leggere.
- Fai clic su Connect.
3
Conferma il collegamento
Tornato in Settings → Integrations → Azure DevOps, l’organizzazione compare in Organizations con il numero dei suoi repository.
Permessi
Enclave usa il collegamento per:- Leggere repository, branch e pull request. Enclave legge il tuo codice e la sua cronologia.
- Creare e rimuovere sottoscrizioni ai service hook. Enclave si iscrive agli eventi di push e di pull request per sapere quando il codice cambia.
- Creare e aggiornare i work item di Azure Boards per i finding. Serve il permesso Work Items (read & write). Collegare Azure DevOps collega anche Azure Boards. Non c’è una configurazione separata.
Gestisci il collegamento
Apri Settings → Integrations → Azure DevOps per vedere le organizzazioni collegate.- Resync rileva i progetti e i repository creati dopo il collegamento. Azure DevOps non avvisa Enclave quando vengono creati, quindi fai clic su Resync dopo averne aggiunto uno. Ricontrolla anche i permessi dopo che li hai corretti.
- Add organization collega un’altra organizzazione Azure DevOps.
- Remove scollega un’organizzazione. Enclave smette di analizzarne i repository. Puoi ricollegarla in seguito.
Risoluzione dei problemi
L'organizzazione mostra "push events not active"
L'organizzazione mostra "push events not active"
Enclave ha letto i tuoi repository ma non è riuscito a creare i service hook. Concedi all’account di collegamento Edit Subscription (o Project Administrator) sui progetti, poi fai clic su Resync.
Un nuovo progetto o repository non compare
Un nuovo progetto o repository non compare
Fai clic su Resync sull’organizzazione. Per un’organizzazione di grandi dimensioni, la risincronizzazione continua dopo il clic. I repository compaiono man mano che si sincronizzano.
La convalida del token non riesce
La convalida del token non riesce
- Azure DevOps rejected this token: il token è scaduto o è stato revocato. Creane uno nuovo.
- This token can’t do everything Enclave needs: ricrea il token in modo che possa leggere il codice, elencare i progetti e gestire i service hook.
- This token authenticated but can’t see any projects: aggiungi il proprietario del token a un progetto in Project Settings → Permissions.
- We couldn’t reach that Azure DevOps organization: controlla il nome dell’organizzazione e le regole di rete.
L'organizzazione mostra "reconnect needed"
L'organizzazione mostra "reconnect needed"
Enclave non può più usare le credenziali del collegamento. Rimuovi l’organizzazione e collegala di nuovo.