Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

Gerencie Chaves do cliente com o Azure Key Vault: Rede Pública

Observação

Este recurso não está disponível para nenhuma das seguintes implantações:

  • Clusters gratuitos

  • Clusters flexíveis

Para saber mais,consulte Limites.

Você pode usar uma chave gerenciada pelo cliente (CMK) do Azure Key Vault (AKV) para criptografar ainda mais seus dados em repouso no Atlas. Esta página descreve como configurar o gerenciamento de chave do cliente utilizando AKV no seu projeto Atlas e nos clusters neste projeto.

Para habilitar chaves gerenciadas pelo cliente com AKV para um projeto MongoDB , você deve:

  • Use um cluster M10 ou superior.
  • Tenha as credenciais da conta Azure e do Key Vault, e o identificador de chave para a chave de criptografia em seu AKV.

    Para saber como configurar esses componentes do Azure, consulte a Documentação do Azure.

    O Atlas utiliza estes recursos ao habilitar encryption at rest para um cluster no projeto Atlas.

Aviso

Quando você restringe o acesso do AKV a intervalos de IP específicos, o Atlas não sabe o endereço IP de saída de um nó até depois do provisionamento. Os nós recém-adicionados inicialmente não têm conectividade AKV e as operações KMS falham até que você adicione manualmente os endereços IP dos nós ao firewall. Essa lacuna de conectividade pode fazer com que as simulações de inicialização de nós e recuperação de desastres sejam interrompidas ou falhem.

Para cargas de trabalho que executam simulações de interrupção regional, dimensionamento, alterações de topologia ou failovers de multirregional, configure o Azure Key Vault sobre o ponto de extremidade privado. Os pontos de extremidade privados eliminam a dependência do endereço IP e garantem o acesso ininterrupto ao KMS.

Você deve habilitar a CMK para um projeto antes de habilitá-la em um cluster nesse projeto. Você pode habilitar CMK para um projeto a partir da UI do Atlas e da Atlas Administration API .

1
  1. Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.

  2. Se ainda não estiver exibido, selecione seu projeto no menu Projects na barra de navegação.

  3. Na barra lateral, clique em Database & Network Access sob o título Security.

  4. Na barra lateral, clique em Advanced.

    A página Avançado é exibida.

2
3
4

O Atlas suporta dois métodos de autenticação para AKV:

  • Principal de serviço (recomendado): Use uma entidade de serviço gerenciada pelo Atlas específica para seu projeto para autenticar no AKV (autenticação sem segredo). Para saber mais, consulte Gerenciar chaves do cliente com o Azure Key Vault (Secretless).

  • Credenciais estáticas: forneça credenciais gerenciadas pelo cliente (tratadas aqui).

5

ID do cliente

Insira o Client ID (ou Application ID) do aplicação do Azure. Certifique-se de ter atribuído ao Active Directory Application o acesso necessário. Para saber mais, consulte Acesso necessário.

ID do Inquilino

Insira o Tenant ID (ou Directory ID) do locatário do Active Directory.

Segredo

Insira um dos segredos de cliente não expirados do aplicativo associados ao locatário do Active Directory.

Ambiente Azure

Selecione a nuvem Azure em que seu inquilino do Active Directory se localiza.

6

ID de Inscrição

Insira o Subscription ID do Key Vault.

Nome do Grupo de Recursos

Insira o nome Resource Group de um Azure Resource Group contendo o Key Vault.

Nome do Key Vault

Insira o nome do Key Vault. Certifique-se de que o Key Vault tenha as políticas de acesso necessárias. Para saber mais, consulte Acesso necessário.

Observação

Você não pode modificar as credenciais do AKV aqui depois de habilitar e configurar conexões de private endpoints para o AKV.

7

Identificador de chave

Insira a URL completa da chave criada no Key Vault.

IMPORTANTE: o identificador de chave deve ser fornecido no formato geral do Azure:

https://{keyvault-name}.vault.azure.net/{object-type}/{object-name}

Você pode anexar /{object-version}. No entanto, recomendamos que você omita a versão para habilitar a resolução automática para a versão mais recente.

8

Para saber mais, consulte Habilitar e configurar conexões de endpoint privado para um projeto

9

Se você configurou o Atlas usando a Atlas Administration API para se comunicar com o AKV usando o Azure Private Link para garantir que todo o tráfego entre o Atlas e o Key Vault ocorra nas interfaces de rede privada do Azure, o Atlas define o status Require Private Networking como Active. Se o status for Inactive, você pode, opcionalmente, concluir as etapas para Habilitar e configurar private endpoints para um projeto se você quiser que o Atlas use private endpoints para seu AKV.

10

O Atlas exibe um banner no console do Atlas durante o processo de criptografia.

Após Habilitar Chaves Gerenciadas pelo Cliente para um Projeto, você deve habilitar o gerenciamento de chave do cliente para cada cluster do Atlas que contém dados que você deseja criptografar.

Observação

Você deve ter a role Project Owner para habilitar o gerenciamento de chaves do cliente para clusters nesse projeto.

Para novos clusters, alterne a configuração Gerenciar suas próprias chaves de encriptação para Yes quando você criar o cluster.

Para clusters existentes:

1
  1. Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.

  2. Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.

  3. Na barra lateral, clique em Clusters sob o título Database.

A página Clusters é exibida.

2

Para o cluster que contém os dados que você deseja criptografar, clique no botão e selecione Edit Configuration.

3
  1. Expanda o painel Additional Settings.

  2. Alterne a configuração Manage your own encryption keys para Yes.

  3. Verifique o status da configuração Require Private Networking para seu cluster.

    Se você configurou a criptografia em repouso usando CMK (Over Private Networking) para Atlas no nível do projeto, o status é Active. Se você não configurou nenhuma conexão de private endpoint para seu projeto, o status será Inactive.

4
  1. Clique em Review Changes.

  2. Revise suas alterações e clique em Apply Changes para atualizar seu cluster.

Você deve desabilitar o gerenciamento de chave do consumidor em cada cluster em um projeto antes de poder desabilitar o recurso para o projeto.

Aviso

Não desative nem exclua nenhuma chave AKV usada por qualquer cluster em seu projeto Atlas antes de desativar o gerenciamento de chaves do cliente no projeto Atlas. Se o Atlas não puder acessar uma chave AKV, todos os dados criptografados por essa chave se tornarão inacessíveis.

Você pode revogar o acesso do Atlas a uma chave de criptografia no AKV. O Atlas pausa automaticamente seus clusters quando você revoga o acesso à chave de criptografia, a menos que sua lista de acesso de IP do AKV restrinja o plano de controle do Atlas.

Para permitir a pausa automática do cluster, você deve:

Observação

O MongoDB adiciona novos endereços IP do plano de controle do Atlas ao longo do tempo. Você deve manter a lista de acesso IP atualizada para permitir a pausa automática do cluster ao usar uma lista de acesso IP para seu AKV.

Se a lista de acesso IP do AKV restringir o acesso do plano de controle do Atlas quando você revogar o acesso a uma chave de criptografia, você deverá pausar os clusters manualmente para revogar o acesso do Atlas.

Observação

Este recurso não está disponível para nenhuma das seguintes implantações:

  • Clusters gratuitos

  • Clusters flexíveis

Para saber mais,consulte Limites.

Antes de começar, saiba mais sobre como girar seu identificador de chave Azure.

Você deve criar uma nova chave no AKV associado ao projeto Atlas . O procedimento a seguir documenta como girar o Identificador de Chave do projeto Atlas especificando um novo identificador de chave no Atlas.

1
  1. Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.

  2. Se ainda não estiver exibido, selecione seu projeto no menu Projects na barra de navegação.

  3. Na barra lateral, clique em Database & Network Access sob o título Security.

  4. Na barra lateral, clique em Advanced.

    A página Avançado é exibida.

2
3
  1. Clique em Azure Key Vault se o seletor Azure Key Vault ainda não estiver ativo.

  2. Clique em Encryption Key se o seletor Encryption Key ainda não estiver ativo.

  3. Insira o Identificador de Chave Azure no campo Key Identifier.

    Inclua o URL completo do novo identificador de chave de criptografia. Por exemplo:

    https://mykeyvault.vault.azure.net/keys/AtlasKMSKey/a241124e3d364e9eb99fbd3e11124b23

    Importante

    A chave de criptografia deve pertencer ao Key Vault configurado para o projeto. Clique na seção Key Vault para exibir o Cofre de Chave configurado atualmente para o projeto.

  4. Clique em Update Credentials.

O Atlas exibe um banner na UI do Atlas durante o processo de rotação do Identificador de Chave. Não exclua ou desative o identificador de chave original até que suas alterações sejam implementadas.

Se o cluster usar Fazer Backup do Cluster, não exclua ou desabilite o Identificador de chave original até validar que nenhum snapshot usou essa chave para criptografia.