Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
O Azure DocumentDB suporta utilizadores nativos secundários do DocumentDB com funções especializadas de leitura-escrita e só leitura, permitindo a delegação segura de acesso aos dados. A conta administrativa incorporada, criada durante o provisionamento do cluster, tem privilégios completos, incluindo gestão de utilizadores. Os utilizadores secundários são automaticamente replicados para réplicas do cluster, mas a gestão de utilizadores deve ser realizada no cluster principal.
Pré-requisitos
- Uma assinatura do Azure. Se você não tiver uma assinatura do Azure, crie uma conta gratuita.
Um cluster existente do Azure DocumentDB
- Se não tiver um cluster, crie um novo cluster
Extensão do Visual Studio para DocumentDB. Para mais informações, consulte Instalar a extensão DocumentDB para Visual Studio Code
Regras de firewall que permitem que o cliente se conecte ao cluster. Para obter mais informações, consulte Configurar firewall.
Utilizadores nativos e funções
Os clusters Azure DocumentDB incluem uma conta administrativa incorporada criada durante o provisionamento do cluster. Esta conta tem os privilégios necessários para gerir utilizadores e funções nativos.
Para aplicações e acesso delegado, crie utilizadores nativos separados em vez de partilhar a conta administrativa incorporada. Os utilizadores nativos recebem acesso através dos seus papéis atribuídos e são replicados para réplicas de cluster. A gestão de utilizadores e funções deve ser realizada no cluster principal.
O Azure DocumentDB RBAC utiliza os seguintes componentes:
- Um utilizador nativo é uma identidade que pode autenticar-se no cluster.
- Uma função é um conjunto nomeado de permissões que podem ser atribuídas a um utilizador nativo.
- Um recurso identifica a base de dados ou coleção à qual o acesso se aplica.
- Uma ação identifica uma operação que pode ser realizada no recurso delimitado pelo âmbito.
- Um privilégio combina um recurso com uma ou mais ações permitidas.
- Uma atribuição de função associa uma função a um utilizador nativo.
O exemplo seguinte ilustra um privilégio limitado à orders coleção na sales base de dados com privilégios permitidos:
{
resource: { db: "sales", collection: "orders" },
actions: ["find", "insert", "update", "delete"]
}
Escolha um âmbito de acesso
Selecione uma função e um âmbito com base no acesso mínimo exigido pelo utilizador ou aplicação.
| Requisito de acesso | Abordagem recomendada | Scope |
|---|---|---|
| Ler dados em várias bases de dados | Atribua a readAnyDatabase função incorporada. |
Cluster |
| Ler e escrever dados entre bases de dados | Atribua a readWriteAnyDatabase função incorporada. |
Cluster |
| Executar a administração suportada do cluster | Atribua a clusterAdmin função incorporada. |
Cluster |
| Executar operações de dados suportadas dentro de uma única base de dados | Crie e atribua uma função personalizada com âmbito de base de dados. | Database |
| Executar operações de dados suportadas numa coleção específica | Crie e atribua uma função personalizada com âmbito de coleção. | Collection |
Papéis nativos
O Azure DocumentDB suporta controlo de acesso nativo baseado em funções para utilizadores secundários com as seguintes funções:
| Description | |
|---|---|
readWriteAnyDatabase |
Permissões completas de leitura e escrita, incluindo gestão de bases de dados |
clusterAdmin |
Permissões completas de leitura e escrita, incluindo gestão de bases de dados |
readAnyDatabase |
Permissões apenas de leitura |
Gerencie utilizadores e funções utilizando o Mongo Shell interativo (mongosh). APIs ARM REST, comandos CLI do Azure baseados em ARM, Bicep e Terraform não suportam atribuições de funções de utilizador secundário. Para utilizadores secundários do Microsoft Entra ID, consulte Gerir identidades secundárias do Microsoft Entra ID.
Importante
Para os utilizadores atribuídos à readWriteAnyDatabase função, é atualmente necessário um passo extra para aplicar os privilégios da função a todas as coleções existentes. Execute o seguinte comando em cada base de dados aplicável:
const targetDb = db.getSiblingDB("<database-name>");
targetDb.getCollectionInfos({ type: "collection" }).forEach(({ name }) => {
printjson(targetDb.runCommand({ validate: name, repair: true }));
});
Funções personalizadas
As funções personalizadas permitem-lhe definir ações suportadas e associá-las a uma base de dados ou recurso de coleção. Utilize funções personalizadas para implementar o acesso de menor privilégio quando uma função integrada a nível de cluster concede acesso mais amplo do que o necessário.
Funções ao nível da base de dados
Utilize uma função personalizada com âmbito de base de dados quando um utilizador ou aplicação necessita das mesmas permissões de dados suportadas em toda uma base de dados, mas não requer acesso equivalente a outras bases de dados no cluster.
Um privilégio com âmbito de base de dados identifica a base de dados de destino e utiliza um valor de coleção vazio para representar o âmbito ao nível da base de dados:
resource: { db: "<database-name>", collection: "" }
Funções no âmbito da coleção
Utilize uma função personalizada com âmbito de coleção quando o acesso tiver de ser limitado a uma coleção específica ou quando as permissões diferem entre coleções na mesma base de dados.
Um privilégio com âmbito de coleção identifica tanto a base de dados de destino como a coleção:
resource: { db: "<database-name>", collection: "<collection-name>" }
Privilégios de função personalizada suportados
As funções personalizadas suportam as seguintes ações de dados documentadas:
| Action | Description |
|---|---|
find |
Leia documentos do recurso no âmbito. |
insert |
Insira documentos no recurso com âmbito definido. |
update |
Atualize documentos no recurso com âmbito definido. |
delete |
Eliminar documentos do recurso com âmbito definido. |
As funções personalizadas não oferecem atualmente privilégios separados para gestão de índice, operações do ciclo de vida da base de dados ou operações do ciclo de vida da coleção.
Herança de funções
Um perfil personalizado pode herdar permissões de um perfil incorporado suportado. As permissões herdadas são combinadas com os privilégios definidos diretamente no papel personalizado.
Importante
A herança de função personalizada para personalizada e a herança de uma combinação de funções personalizadas e incorporadas não são suportadas na pré-visualização atual.
Atribuições de funções e acesso efetivo
O acesso efetivo de um utilizador nativo é determinado pelos papéis atribuídos a esse utilizador. Um utilizador pode receber acesso através de funções incorporadas ou personalizadas diretamente atribuídas.
Quando rever ou alterar o acesso, considere ambas as partes da configuração:
- Revise as atribuições de funções do utilizador para confirmar que as funções esperadas foram atribuídas.
- Revise cada função personalizada para confirmar que o seu âmbito de recursos e as ações permitidas estão corretas.
- Valide o acesso ligando-se como utilizador nativo e testando tanto as operações permitidas como as falhas de autorização esperadas.
Revogar uma função não remove necessariamente o acesso efetivo do utilizador a uma operação. O utilizador pode continuar a receber acesso equivalente através de outra função atribuída.
Ciclo de vida do utilizador e da função
Utilizadores nativos e funções têm ciclos de vida separados:
- Criar um utilizador nativo estabelece a identidade e atribui as suas funções iniciais.
- Conceder um perfil adiciona uma atribuição a um utilizador existente.
- Revogar uma função remove uma atribuição específica, mantendo ao mesmo tempo o utilizador e a definição da função.
- Remover um utilizador elimina a conta de utilizador nativa.
- Eliminar uma função personalizada remove a definição da função personalizada.
Eliminar um utilizador não é o mesmo que revogar um perfil. Da mesma forma, eliminar uma função personalizada não é o mesmo que remover essa atribuição de função a um utilizador específico.
Para comandos e procedimentos completos, consulte Configurar controlo de acesso baseado em funções.
Limitações de pré-visualização
A visualização atual tem as seguintes limitações:
-
updateRolenão é suportado. UtilizegrantPrivilegesToRoleerevokePrivilegesFromRolepara alterar os privilégios de uma função personalizada existente. UtilizegrantRolesToUsererevokeRolesFromUserquando apenas as atribuições de um utilizador devem mudar. - As funções personalizadas só podem herdar funções através de combinações suportadas de funções incorporadas.
- As atribuições de funções estão sujeitas ao limite do número de funções suportado para a versão.
-
rolesInfonão regressainheritedRolesneminheritedPrivilegespara papéis personalizados. - As funções personalizadas suportam apenas os privilégios de dados documentados.
- As funções personalizadas estão sujeitas ao limite suportado de privilégios documentados para a versão.
Conteúdo relacionado
- Saiba mais sobre Segurança no Azure DocumentDB
- Saiba mais sobre o Microsoft Entra ID no Azure DocumentDB