Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Azure DocumentDB supporta gli utenti di DocumentDB nativi secondari con ruoli specializzati di lettura/scrittura e di sola lettura, consentendo la delega sicura dell'accesso ai dati. L'account amministrativo predefinito, creato durante il provisioning del cluster, dispone di privilegi completi, inclusa la gestione degli utenti. Gli utenti secondari vengono replicati automaticamente nelle repliche cluster, ma la gestione degli utenti deve essere eseguita nel cluster primario.
Prerequisiti
- Una sottoscrizione di Azure. Se non hai una sottoscrizione di Azure, crea un account gratuito.
Un cluster esistente di DocumentDB di Azure
- Se non si ha un cluster, creare un nuovo cluster
Estensione di Visual Studio per DocumentDB. Per altre informazioni, vedere Installare l'estensione DocumentDB per Visual Studio Code
Regole del firewall che consentono al client di connettersi al cluster. Per altre informazioni, vedere Configurare il firewall.
Utenti nativi e ruoli
Azure cluster DocumentDB includono un account amministrativo predefinito creato durante il provisioning del cluster. Questo account dispone dei privilegi necessari per gestire utenti e ruoli nativi.
Per le applicazioni e l'accesso delegato, creare utenti nativi separati anziché condividere l'account amministrativo predefinito. Gli utenti nativi ricevono l'accesso tramite i ruoli assegnati e vengono replicati nelle repliche del cluster. La gestione di utenti e ruoli deve essere eseguita nel cluster primario.
Il controllo degli accessi in base al ruolo (RBAC) di Azure DocumentDB usa i componenti seguenti:
- Un utente nativo è un'identità che può eseguire l'autenticazione nel cluster.
- Un ruolo è un set denominato di autorizzazioni che può essere assegnato a un utente nativo.
- Una risorsa identifica il database o la raccolta a cui si applica l'accesso.
- Un'azione identifica un'operazione che può essere eseguita sulla risorsa con ambito.
- Un privilegio combina una risorsa con una o più azioni consentite.
- Un'assegnazione di ruolo associa un ruolo a un utente nativo.
Nell'esempio seguente viene illustrato un privilegio con ambito per la orders raccolta nel sales database con privilegi consentiti:
{
resource: { db: "sales", collection: "orders" },
actions: ["find", "insert", "update", "delete"]
}
Scegliere un ambito di accesso
Selezionare un ruolo e un ambito in base all'accesso minimo richiesto dall'utente o dall'applicazione.
| Requisito di accesso | Approccio consigliato | Scope |
|---|---|---|
| Leggere i dati in tutti i database | Assegnare il readAnyDatabase ruolo predefinito. |
Cluster |
| Leggere e scrivere dati tra database | Assegnare il readWriteAnyDatabase ruolo predefinito. |
Cluster |
| Eseguire l'amministrazione del cluster supportata | Assegnare il clusterAdmin ruolo predefinito incorporato. |
Cluster |
| Eseguire operazioni di dati supportate all'interno di un database | Creare e assegnare un ruolo personalizzato con ambito database. | Banca dati |
| Eseguire operazioni di dati supportate su una raccolta specifica | Creare e assegnare un ruolo personalizzato con ambito raccolta. | Collection |
Ruoli nativi
Azure DocumentDB supporta il controllo degli accessi in base al ruolo nativo per gli utenti secondari con i ruoli seguenti:
| Description | |
|---|---|
readWriteAnyDatabase |
Autorizzazioni di lettura/scrittura complete, inclusa la gestione del database |
clusterAdmin |
Autorizzazioni di lettura/scrittura complete, inclusa la gestione del database |
readAnyDatabase |
Autorizzazioni di sola lettura |
Gestire utenti e ruoli usando Mongo Shell interattiva (mongosh). Le API REST ARM, i comandi di interfaccia della riga di comando di Azure basati su ARM, Bicep e Terraform non supportano le assegnazioni di ruolo utente secondario. Per Microsoft Entra ID utenti secondari, vedere Gestire le identità di Microsoft Entra ID secondarie.
Importante
Per gli utenti a cui è stato assegnato il readWriteAnyDatabase ruolo, è attualmente necessario un passaggio aggiuntivo per applicare i privilegi del ruolo a tutte le raccolte esistenti. Eseguire il comando seguente in ogni database applicabile:
const targetDb = db.getSiblingDB("<database-name>");
targetDb.getCollectionInfos({ type: "collection" }).forEach(({ name }) => {
printjson(targetDb.runCommand({ validate: name, repair: true }));
});
Ruoli personalizzati
I ruoli personalizzati consentono di definire le azioni supportate e di associarle a un database o a una risorsa di raccolta. Usare ruoli personalizzati per implementare l'accesso con privilegi minimi quando un ruolo predefinito a livello di cluster concede un accesso più ampio del necessario.
Ruoli con ambito di database
Usare un ruolo personalizzato con ambito database quando un utente o un'applicazione richiede le stesse autorizzazioni di dati supportate in un database, ma non richiede l'accesso equivalente ad altri database nel cluster.
Un privilegio con ambito database identifica il database di destinazione e usa un valore di raccolta vuoto per rappresentare l'ambito a livello di database:
resource: { db: "<database-name>", collection: "" }
Ruoli con ambito di collezione
Usare un ruolo personalizzato con ambito raccolta quando l'accesso deve essere limitato a una raccolta specifica o quando le autorizzazioni differiscono tra raccolte nello stesso database.
Un privilegio con ambito raccolta identifica sia il database di destinazione che la raccolta:
resource: { db: "<database-name>", collection: "<collection-name>" }
Privilegi di ruolo personalizzati supportati
I ruoli personalizzati supportano le azioni di dati documentate seguenti:
| Action | Description |
|---|---|
find |
Leggere i documenti dalla risorsa nell'ambito definito. |
insert |
Inserire documenti nella risorsa con ambito definito. |
update |
Aggiornare i documenti nella risorsa nell'ambito definito. |
delete |
Eliminare i documenti dalla risorsa nell'ambito definito. |
I ruoli personalizzati non forniscono attualmente privilegi separati per la gestione degli indici, le operazioni del ciclo di vita del database o le operazioni del ciclo di vita della raccolta.
Ereditarietà dei ruoli
Un ruolo personalizzato può ereditare le autorizzazioni da un ruolo predefinito supportato. Le autorizzazioni ereditate vengono combinate con i privilegi definiti direttamente nel ruolo personalizzato.
Importante
L'ereditarietà tra ruoli personalizzati e l'ereditarietà da una combinazione di ruoli personalizzati e predefiniti non sono supportate nell'anteprima corrente.
Assegnazioni di ruolo ed accesso effettivo
L'accesso effettivo di un utente nativo è determinato dai ruoli assegnati a tale utente. Un utente può ricevere l'accesso tramite ruoli predefiniti o personalizzati assegnati direttamente.
Quando si esamina o si modifica l'accesso, considerare entrambe le parti della configurazione:
- Esaminare le assegnazioni di ruolo dell'utente per verificare che vengano assegnati i ruoli previsti.
- Esaminare ogni ruolo personalizzato per verificare che l'ambito delle risorse e le azioni consentite siano corrette.
- Convalidare l'accesso connettendosi come utente nativo e testando sia le operazioni consentite che gli errori di autorizzazione previsti.
La revoca di un ruolo non comporta necessariamente la rimozione dell'accesso effettivo dell'utente a un'operazione. L'utente potrebbe continuare a ricevere l'accesso equivalente tramite un altro ruolo assegnato.
Ciclo di vita di utenti e ruoli
Gli utenti nativi e i ruoli hanno cicli di vita separati:
- La creazione di un utente nativo stabilisce l'identità e assegna i ruoli iniziali.
- La concessione di un ruolo aggiunge un'assegnazione a un utente esistente.
- La revoca di un ruolo rimuove un'assegnazione specifica mantenendo l'utente e la definizione del ruolo.
- La rimozione di un utente elimina l'account utente nativo.
- L'eliminazione di un ruolo personalizzato rimuove la definizione di ruolo personalizzata.
L'eliminazione di un utente non equivale alla revoca di un ruolo. Analogamente, l'eliminazione di un ruolo personalizzato non equivale alla rimozione dell'assegnazione di ruolo da un utente specifico.
Per i comandi e le procedure complete, vedere Configurare il controllo degli accessi in base al ruolo.
Limitazioni dell'anteprima
L'anteprima corrente presenta le limitazioni seguenti:
-
updateRolenon è supportata. UsaregrantPrivilegesToRoleerevokePrivilegesFromRoleper modificare i privilegi di un ruolo personalizzato esistente. UsaregrantRolesToUsererevokeRolesFromUserquando devono cambiare solo le assegnazioni di un utente. - I ruoli personalizzati possono ereditare i ruoli solo tramite combinazioni di ruoli predefinite supportate.
- Le assegnazioni di ruolo sono soggette al limite di conteggio dei ruoli supportato per il rilascio.
-
rolesInfonon restituisceinheritedRolesoinheritedPrivilegesper i ruoli personalizzati. - I ruoli personalizzati supportano solo i privilegi di dati documentati.
- I ruoli personalizzati sono soggetti al limite supportato dei documenti dei privilegi per la versione.
Contenuti correlati
- Informazioni sulla sicurezza in Azure DocumentDB
- Informazioni sull'ID Microsoft Entra in Azure DocumentDB