Privilegi di lettura e lettura/scrittura con utenti nativi secondari su Azure DocumentDB

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

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:

  • updateRole non è supportata. Usare grantPrivilegesToRole e revokePrivilegesFromRole per modificare i privilegi di un ruolo personalizzato esistente. Usare grantRolesToUser e revokeRolesFromUser quando 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.
  • rolesInfo non restituisce inheritedRoles o inheritedPrivileges per 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.