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

> Collega il tuo tenant Azure con il consenso dell'amministratore e un ruolo Reader in sola lettura, senza secret da archiviare.

Collega il tuo tenant Azure così Enclave può mappare le risorse e le identità di ogni sottoscrizione e collegarle al tuo codice. L'accesso è in sola lettura e non ci sono secret da archiviare.

## Cosa serve a Enclave

Enclave si collega tramite un'app Microsoft Entra multi-tenant di proprietà di Enclave. Le concedi due cose:

* Il **consenso dell'amministratore** per l'app Enclave. Include il permesso Microsoft Graph `Directory.Read.All`, che Enclave usa per leggere le identità Entra come service principal, applicazioni e gruppi.
* Il ruolo **Reader** sul **management group radice del tenant**. Il ruolo Reader alla radice viene ereditato da ogni sottoscrizione del tenant, comprese quelle che crei in seguito.

### Permessi per eseguire la configurazione

* Per concedere il consenso dell'amministratore ti serve un ruolo Entra che possa dare il consenso per l'intera organizzazione.
* Per eseguire il comando in Cloud Shell ti serve il permesso di creare assegnazioni di ruolo sul management group radice del tenant.
* In Enclave ti serve il ruolo **Owner** o **Admin**.

## Collega il tuo tenant

**1. Apri la pagina di configurazione**

Apri **Settings → Integrations** e fai clic su **Connect** accanto a **Microsoft Azure**.

**2. Concedi il consenso dell'amministratore**

In **Connect Microsoft**, fai clic su **Connect Microsoft**. Accedi come amministratore Entra e approva l'app Enclave per la tua organizzazione. Enclave attende il consenso, poi mostra il passaggio successivo.

**3. Concedi il ruolo Reader alla radice del tenant**

In **Grant tenant-root Reader**, copia il comando. Apri [Azure Cloud Shell](https://shell.azure.com) ed eseguilo. Il comando è simile a questo:

```bash theme={null}
az role assignment create --assignee <enclave-app-id> --role Reader --scope /providers/Microsoft.Management/managementGroups/<tenant-id>
```

**4. Convalida**

Tornato in Enclave, fai clic su **Validate**. Enclave verifica di poter elencare le sottoscrizioni del tuo tenant.

Dopo la convalida, Enclave rileva le tue sottoscrizioni alla scansione successiva. Ogni sottoscrizione compare poi nel collegamento come voce separata.

## Cosa rileva Enclave

* **Infrastruttura**: ogni risorsa di ogni sottoscrizione, letta tramite Azure Resource Graph.
* **Topologia di rete**: subnet, route e regole del firewall.
* **Identità**: assegnazioni e definizioni di ruolo, identità gestite e service principal, applicazioni e gruppi Entra. Enclave collega le macchine virtuali e le altre risorse di calcolo alle identità gestite con cui vengono eseguite.

## Gestisci un collegamento

Apri **Settings → Integrations → Microsoft Azure** per vedere le sottoscrizioni collegate.

* **Re-validate** verifica che Enclave possa ancora leggere una sottoscrizione.
* **Remove** interrompe l'analisi di una sottoscrizione.
* **Disconnect Azure** rimuove l'intero collegamento e interrompe l'analisi.

Per revocare l'accesso da Azure, rimuovi il consenso dell'app Enclave in Entra ed elimina la sua assegnazione del ruolo Reader alla radice del tenant.

## Cosa fa e cosa non fa Enclave

* **Fa**: legge la configurazione delle risorse e le identità con il ruolo Reader e `Directory.Read.All`.
* **Non fa**: non crea, modifica o elimina risorse e non legge il contenuto di file, secret, messaggi o database. Enclave non archivia credenziali per il tuo tenant. Ogni scansione usa token a breve durata.

## Risoluzione dei problemi

> [accordion] La convalida non riesce
>
> L'assegnazione del ruolo Reader manca o non è ancora attiva. Esegui di nuovo il comando in Cloud Shell, attendi un minuto, poi fai clic su **Revalidate**.

> [accordion] Il collegamento non mostra sottoscrizioni
>
> Se il collegamento indica **Tenant validated. Subscriptions are discovered on the next scan.**, Enclave non ha ancora eseguito la scansione. Per eseguirla subito, fai clic su **Analyze Environment** in [Coverage](https://docs.enclave.ai/it/onboarding/coverage.md).

> [accordion] Le risorse compaiono, ma le identità Entra no
>
> Il rilevamento delle identità richiede il consenso `Directory.Read.All`, separato dal ruolo Reader. Concedi di nuovo il consenso dell'amministratore all'app Enclave.

> [accordion] La pagina indica che il consenso dell'amministratore non è disponibile
>
> Solo Owner e Admin possono avviare la configurazione di Azure. Se hai il ruolo giusto e vedi comunque questo messaggio, contatta il supporto.


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