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
Página inicial do Docs
/ /
TLS/SSL
Página inicial do Docs
/ /
Proteção de rede e configuração
/
TLS/SSL
Página inicial do Docs
/
Gestão
/
Segurança
/
Proteção de rede e configuração
/
TLS/SSL

Atualizar um cluster para usar TLS/SSL

O servidor MongoDB oferece suporte ao listening para conexões criptografadas e não criptografadas TLS/SSL na mesma porta TCP. Isso permite atualizações de clusters MongoDB para usar conexões criptografadas TLS/SSL.

Observação

O MongoDB desabilita o suporte para criptografia TLS 1.0 em sistemas em que o TLS 1.1+ está disponível.

Procedimento (usando configurações tls)

Importante

Uma descrição completa de certificados TLS/SSL, PKI (Public Key Infrastructure) e autoridade de certificação está além do escopo deste documento. Esta página pressupõe conhecimento prévio de TLS/SSL, bem como acesso a certificados válidos.

Para atualizar de um cluster MongoDB usando nenhuma criptografia TLS/SSL para um usando apenas criptografia TLS/SSL, use o seguinte processo de atualização contínua.

Observação

The procedures in this section use the tls settings/option. For procedures using their ssl aliases, see Procedure (Using ssl Settings).

As configurações/opções tls oferecem funcionalidade idêntica à das opções ssl, pois o MongoDB sempre foi compatível com o TLS 1.0 e posterior.

  1. For each node of a cluster, start the node with the command-line option --tlsMode or the configuration file option net.tls.mode set to allowTLS. The allowTLS setting allows the node to accept both TLS/SSL and non-TLS/non-SSL incoming connections. Its connections to other servers do not use TLS/SSL. Include other TLS/SSL options [1] as well as any other options that are required for your specific configuration.

    Observação

    mongod e mongos se vinculam ao localhost por padrão. Se os membros do sistema forem executados em hosts diferentes, ou se você desejar que os clientes remotos se conectem ao sistema, especifique --bind_ip ou net.bindIp.

    Por exemplo:

    mongod --replSet <name> --tlsMode allowTLS --tlsCertificateKeyFile <TLS/SSL certificate and key file> --tlsCAFile <path to root CA PEM file> <additional options>

    Atualize todos os nós do cluster para essas configurações.

  2. Mude todos os clientes para usar TLS/SSL. Consulte Conecte-se a um conjunto de réplicas habilitado para TLS.

  3. For each node of a cluster, use the setParameter command to update the tlsMode to preferTLS. [2] With preferTLS as its net.tls.mode, the node accepts both TLS/SSL and non-TLS/non-SSL incoming connections, and its connections to other servers use TLS/SSL. For example:

    db.adminCommand( { setParameter: 1, tlsMode: "preferTLS" } )

    Atualize todos os nós do cluster para essas configurações.

    Neste ponto, todas as conexões devem estar usando TLS/SSL.

  4. For each node of the cluster, use the setParameter command to update the tlsMode to requireTLS. [2] With requireTLS as its net.tls.mode, the node will reject any non-TLS/non-SSL connections. For example:

    db.adminCommand( { setParameter: 1, tlsMode: "requireTLS" } )

  5. Após a atualização de todos os nós, edite o arquivo de configuração com as configurações TLS/SSL apropriadas para garantir que, após a reinicialização subsequente, o cluster use TLS/SSL.

Procedimento (usando configurações ssl)

Importante

Uma descrição completa de certificados TLS/SSL, PKI (Public Key Infrastructure) e autoridade de certificação está além do escopo deste documento. Esta página pressupõe conhecimento prévio de TLS/SSL, bem como acesso a certificados válidos.

Para atualizar de um cluster MongoDB usando nenhuma criptografia TLS/SSL para um usando apenas criptografia TLS/SSL, use o seguinte processo de atualização contínua.

Observação

The procedures in this section use the ssl settings/option. For procedures using their tls aliases, see Upgrade a Cluster to Use TLS/SSL.

As configurações/opções tls oferecem funcionalidade idêntica à das opções ssl, pois o MongoDB sempre foi compatível com o TLS 1.0 e posterior.

  1. For each node of a cluster, start the node with the command-line option --sslMode or the configuration file option net.ssl.mode set to allowSSL. The allowSSL setting allows the node to accept both TLS/SSL and non-TLS/non-SSL incoming connections. Its connections to other servers do not use TLS/SSL. Include other TLS/SSL options [1] as well as any other options that are required for your specific configuration.

    Observação

    mongod e mongos se vinculam ao localhost por padrão. Se os membros do sistema forem executados em hosts diferentes, ou se você desejar que os clientes remotos se conectem ao sistema, especifique --bind_ip ou net.bindIp.

    Por exemplo:

    mongod --replSet <name> --sslMode allowSSL --sslPEMKeyFile <path to TLS/SSL Certificate and key PEM file> --sslCAFile <path to root CA PEM file> <additional options>

    Atualize todos os nós do cluster para essas configurações.

  2. Mude todos os clientes para usar TLS/SSL. Consulte Conecte-se a um conjunto de réplicas habilitado para TLS.

  3. For each node of a cluster, use the setParameter command to update the sslMode to preferSSL. [2] With preferSSL as its net.ssl.mode, the node accepts both TLS/SSL and non-TLS/non-SSL incoming connections, and its connections to other servers use TLS/SSL. For example:

    db.adminCommand( { setParameter: 1, sslMode: "preferSSL" } )

    Atualize todos os nós do cluster para essas configurações.

    Neste ponto, todas as conexões devem estar usando TLS/SSL.

  4. For each node of the cluster, use the setParameter command to update the sslMode to requireSSL. [2] With requireSSL as its net.ssl.mode, the node rejects any non-TLS/non-SSL connections. For example:

    db.adminCommand( { setParameter: 1, sslMode: "requireSSL" } )

  5. Após a atualização de todos os nós, edite o arquivo de configuração com as configurações TLS/SSL apropriadas para garantir que, após a reinicialização subsequente, o cluster use TLS/SSL.

[2](1, 2, 3, 4) As an alternative to using the setParameter command, you can also restart the nodes with the appropriate TLS/SSL options and values.
[1](1, 2)

Você pode usar armazenamentos de certificados SSL do sistema para Windows e macOS. Para usar o armazenamento de certificados SSL do sistema, use:

  • net.tls.certificateSelector (ou a opção de linha de comando --tlsCertificateSelector) em vez de net.tls.certificateKeyFile (ou a opção de linha de comando ''--certificateKeyFile'').

  • net.ssl.certificateSelector (ou a opção de linha de comando --sslCertificateSelector) em vez de net.ssl.PEMKeyFile (ou a opção de linha de comando ''--sslPEMKeyFile'').

Ao usar o armazenamento de certificados SSL do sistema, o OCSP (Online Certificate Status Protocol) é usado para validar o status de revogação dos certificados.

Voltar
Configurar mongod e mongos
Próximo
Configurar para FIPS
Avalie esta página