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.
Menu Docs

Planeje sua configuração de TLS para implantações autogerenciadas

TLS criptografa conexões entre clientes e sua implantação do MongoDB, e entre nós em um conjunto de réplicas. Antes de configurar o TLS, use esta página para decidir sobre a configuração que corresponde aos seus requisitos de segurança.

Importante

Essas etapas se aplicam a implantações autogerenciadas do MongoDB. Os clusters do MongoDB Atlas usam TLS por padrão. Se você usar o Cloud Manager ou o Ops Manager, configure o TLS por meio da sua ferramenta de gerenciamento de implantação.

Antes de planejar sua configuração de TLS, certifique-se de ter os seguintes recursos e informações:

  • Um conjunto de réplicas do MongoDB autogerenciado para configurar com TLS.

  • O tipo de autoridade de certificação disponível para você, como uma CA pública ou privada.

  • Seus requisitos de segurança, como se você precisa de autenticação X.509.

O tipo de CA ao qual você tem acesso determina quais configurações TLS estão disponíveis para você:

Tipo de CA
Descrição
Uso recomendado

CA pública

  • Requer um nome de domínio registrado

  • Não oferece suporte a clientAuth EKU (a partir de abril de 2026)

Criptografia TLS intra-cluster sem mTLS ou autenticação X.509

CA privado

  • Operado internamente pelo PKIda sua organização

  • Suporta EKUs serverAuth e clientAuth

Autenticação de nó mTLS e X.509 intra-cluster

Autoassinado

  • Você gera o certificado

  • Não verifica a identidade de forma tão confiável quanto os certificados emitidos pela CA

  • Não use em produção

Apenas desenvolvimento e teste local

As seções a seguir ajudam você a decidir como configurar a criptografia e a autenticação TLS entre nós em um conjunto de réplicas e entre clientes e o servidor.

Diagrama de implantação habilitada para TLS, com TLS e autenticação de arquivo-chave entre nós e TLS mútua e autenticação X.509 entre servidor e cliente.

Exemplo de implantação com TLS intra-cluster e autenticação de arquivo de chave entre nós, e TLS mútua e autenticação X.509 entre cliente e servidor.

clique para ampliar

Todas as implantações habilitadas para TLS criptografam conexões entre nós. Você também pode habilitar o mTLS intra-cluster, que exige que os nós apresentem certificados para autenticar como clientes durante o handshake TLS. Quando um nó aceita uma conexão de entrada, ele apresenta seu certificado de servidor para que a parte conectada possa verificar sua identidade. Quando um nó faz uma conexão de saída para outro nó, seu comportamento depende de você habilitar o mTLS intra-cluster.

Use a tabela a seguir para determinar o que você precisa para cada modo de criptografia:

Modo de criptografia
Requisitos do sistema

TLS intra-cluster sem mTLS

  • Certificados de servidor com serverAuth EKU apenas, emitidos por qualquer tipo de CA

mTLS intra-cluster

  • Certificados de servidor com serverAuth EKU, emitidos por qualquer tipo de CA

  • Certificados de cliente com clientAuth EKU, emitidos por uma CA privada

Sem mTLS intra-cluster, os nós não apresentam um certificado para autenticar como cliente em conexões de saída. O nó de conexão verifica o certificado do servidor do nó de recebimento, mas o nó de recebimento não verifica a identidade do nó de conexão por meio do handshake TLS. Use esta configuração se você só puder obter certificados com um serverAuth EKU, como por meio de uma CA pública. Você não pode habilitar a autenticação X.509 entre nós com esta configuração.

Com o mTLS intra-cluster, cada nó também apresenta um certificado em conexões de saída para outros nós, fornecendo verificação de identidade mútua. O mTLS intra-cluster é necessário para usar a autenticação de nó X.509. No entanto, como requer certificados com o EKU clientAuth, você deve ter acesso a uma CA privada.

Os nós do conjunto de réplicas se autenticam para confirmar que apenas nós autorizados participam da replicação. Por padrão, os conjuntos de réplicas habilitados para autorização usam autenticação de arquivo-chave entre nós. No entanto, se você habilitar o mTLS intra-cluster, poderá usar a autenticação de certificado X.509 em vez disso.

Use a tabela a seguir para determinar o que você precisa para cada modo de autenticação:

Modo de autenticação
Requisitos do sistema

Autenticação de arquivo-chave

  • Arquivo de chave compartilhado em todos os nós

X.509 autenticação de nó

  • mTLS intra-cluster ativado

  • Certificados de cliente com clientAuth EKU emitidos por uma CA privada

Se você usar a autenticação de arquivo de chave, todos os nós do conjunto de réplicas compartilharão um único segredo armazenado em um arquivo de chave. Cada nó prova sua associação apresentando o segredo compartilhado quando se conecta a outros nós no conjunto. Como todos os nós compartilham a mesma chave, se você quiser revogar o acesso de um nó individual, deverá substituir o arquivo de chave em todos os nós.

A autenticação X.509 usa o certificado de cluster de cada nó para verificar a associação. Como a troca de certificados ocorre durante o handshake TLS, a autenticação de nó X.509 requer mTLS intra-cluster para que os nós tenham verificação mútua de identidade. A identidade de certificado exclusiva de cada nó permite revogar o acesso de um nó individual revogando seu certificado, sem afetar outros nós. Além disso, a autenticação e a criptografia são estabelecidas juntas em um único handshake.

Os certificados de nó do cluster devem incluir atributos X.509 que os distinguem dos certificados de cliente regulares. Para saber mais sobre os atributos de certificado necessários, consulte Certificado X.509 do nó.

Quando um cliente como ou um driver se conecta a mongosh uma mongod instância de habilitada para TLS, o servidor apresenta seu certificado para provar sua identidade e o cliente verifica o certificado em relação a um certificado CA confiável. O cliente também confirma que o nome de host do servidor corresponde ao nome de host do certificado. Se a verificação for bem-sucedida, o TLS criptografará a conexão entre o servidor e o cliente.

Use a tabela a seguir para determinar o que você precisa para cada modo de criptografia:

Modo de conexão
Requisitos do sistema

TLS sem certificado do cliente

Defina allowConnectionsWithoutCertificates como true no seu arquivo de configuração mongod/mongos

Autenticação de cliente Mutual TLS ou X.509

O cliente deve apresentar um certificado com clientAuth EKU

Você pode definir allowConnectionsWithoutCertificates como true para permitir que o cliente se conecte sem enviar um certificado. A ativação disso impede que os usuários se conectem com certificados incorretos, como aqueles que incluem apenas o EKU serverAuth. O servidor criptografa a conexão e prova sua própria identidade para o cliente, mas o servidor não pode verificar a identidade do cliente por meio do handshake TLS. O cliente deve autenticar por meio de um método como o SCRAM.

Se o cliente apresentar seu próprio certificado durante o handshake, o servidor poderá verificar o certificado do cliente em relação a uma CA confiável. Isso estabelece TLS mútuo entre servidor e cliente. O cliente deve apresentar um certificado para habilitar a autenticação de cliente X.509 entre cliente e servidor.

Depois de estabelecer a conexão TLS, os clientes devem se autenticar para acessar a implantação. Os clientes podem se autenticar de várias maneiras, mas este início rápido abrange SCRAM e autenticação X.509.

Use a tabela a seguir para determinar o que você precisa para cada modo de autenticação:

Modo de autenticação
Requisitos do sistema

Autenticação SCRAM

  • Conta de administrador no cluster

X.509 autenticação do cliente

  • TLS mútua entre cliente e servidor

  • Certificado com clientAuth EKU

  • Acesso a CA privado

O MongoDB usa o SCRAM como o mecanismo de autenticação de cliente padrão. O cliente fornece um nome de usuário, senha e o banco de dados de autenticação, e o MongoDB verifica as credenciais em relação aos usuários no banco de dados especificado. O SCRAM não exige que o cliente apresente um certificado durante o handshake TLS.

A autenticação de cliente X.509 usa o certificado que o cliente apresenta durante a conexão. Depois que o TLS mútuo é estabelecido, o cliente se autentica no banco de dados $external usando o mecanismo MONGODB-X509 . O MongoDB mapeia o campo de assunto no certificado para um usuário no banco de dados $external .

Depois de determinar sua configuração usando esta página, continue em Obter certificados de servidor TLS.