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

> Collega le organizzazioni Azure DevOps così Enclave può leggere e imparare a conoscere i tuoi repository Azure Repos.

Collega Azure DevOps così Enclave può leggere e imparare a conoscere i repository delle tue organizzazioni Azure DevOps.

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

> [tab] Microsoft Entra ID
>
> Usa questa opzione per un account aziendale o dell'istituto di istruzione.
>
> 1. Fai clic su **Microsoft Entra ID** e accedi con Microsoft.
> 2. In **Choose organizations to connect**, seleziona le organizzazioni Azure DevOps che Enclave deve leggere.
> 3. Fai clic su **Connect**.
>
> Puoi collegare altre organizzazioni in seguito.

> [tab] Personal access token
>
> Usa questa opzione se accedi con un account Microsoft personale. Microsoft Entra ID non può emettere token per gli account personali.
>
> 1. In Azure DevOps, crea un personal access token che possa leggere il codice, elencare i progetti e gestire i service hook. Azure DevOps raggruppa questi permessi in modo diverso nelle varie versioni della schermata dei token. Vedi il [riferimento di Microsoft sugli scope dei token](https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate).
>
> 2. In Enclave, fai clic su **Personal access token**.
>
> 3. Inserisci la tua **Organization**. È il segmento del percorso in `dev.azure.com/<organization>`.
>
> 4. Incolla il token e fai clic su **Validate & connect**.
>
> > [!TIP]
> >
> > Usa un token di un service account invece di uno personale. L'attività compare a nome dell'account proprietario del token.

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

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

> [accordion] L'organizzazione mostra "Azure Boards unavailable"
>
> Il collegamento non può creare work item. Concedi **Work Items (read & write)**, poi fai clic su **Resync**.

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

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

> [accordion] L'organizzazione mostra "reconnect needed"
>
> Enclave non può più usare le credenziali del collegamento. Rimuovi l'organizzazione e collegala di nuovo.


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