Habilitar e configurar TLS

Visão geral

Neste guia, você verá como usar o protocolo TLS para proteger sua conexão com um MongoDB deployment. O TLS é um protocolo criptográfico que protege a comunicação entre seu aplicativo e o MongoDB. Para configurar sua conexão para usar TLS, habilite a opção TLS e forneça seus certificados para validação ao criar um cliente.

Este guia inclui as seguintes seções:

• Habilitar TLS descreve maneiras de habilitar o TLS em sua conexão

• Configurar certificados descreve os certificados necessários para configurar o TLS

• Certificados de Referência em um Cliente fornece um exemplo de como criar uma estrutura TlsOptions para configurar suas opções de TLS

• Informações adicionais fornecem links para recursos e documentação da API para os tipos e métodos mencionados neste guia

Habilitar TLS

Você pode habilitar o TLS em uma conexão com sua instância do MongoDB de uma das seguintes maneiras:

• Definindo a opção tls para true em sua connection string

• Definir o campo tls de uma instância ClientOptions para a variante Tls::Enabled com uma estrutura TlsOptions vazia e instanciar um Client com essas opções

Selecione entre as seguintes abas Connection String e ClientOptions para ver uma amostra de código correspondente:

let uri = "mongodb://<hostname>:<port>?tls=true"
let client = Client::with_uri_str(uri).await?;

let uri = "<connection string>"
let mut client_options = ClientOptions::parse(uri).await?;
let tls_opts = TlsOptions::builder().build();
client_options.tls = Some(Tls::Enabled(tls_opts));
let client = Client::with_options(client_options)?;

Para obter uma lista completa das opções de cliente , consulte o guiaOpções de conexão .

Configurar certificados

Para iniciar com êxito uma solicitação de TLS, seu aplicativo deve apresentar certificados criptográficos para provar sua identidade. Os certificados do seu aplicativo devem ser armazenados como arquivos PEM (Privacidade Melhorada do Email) para habilitar o TLS ao conectar a uma implantação do MongoDB. O formato de arquivo PEM é um formato de container para certificados criptográficos.

A lista a seguir descreve os componentes que seu cliente deve apresentar para estabelecer uma conexão habilitada para TLS:

Certificados de referência em um cliente

Você deve fazer referência aos seus certificados em sua estrutura TlsOptions para que o servidor possa validá-los antes que o cliente se conecte.

Você deve primeiro converter seus caminhos de arquivo de certificado em tipos PathBuf , portanto, você deve importar esse tipo do módulo std::path. Em seguida, chame as funções do construtor do struct TlsOptions para definir os campos ca_file_path e cert_key_file_path para os caminhos de arquivo do certificado.

Na sua instância do TlsOptions , você pode definir campos opcionais para configurar o TLS na sua conexão. Para fins de teste, você pode definir os campos allow_invalid_certificates e allow_invalid_hostnames .

Definir a opção allow_invalid_certificates como true desabilita a verificação do nome do host, e definir o allow_invalid_hostnames como true desabilita a validação do certificado.

use std::path::PathBuf;
use mongodb::{ options::{ ClientOptions, TlsOptions, Tls }, Client };
#[tokio::main]
async fn main() -> mongodb::error::Result<()> {
    let uri = "<connection string>";
    let mut client_options = ClientOptions::parse(uri).await?;
    let ca_file = PathBuf::from(r"<path to CA certificate>");
    let key_file = PathBuf::from(r"<path to client certificate>");
    let tls_opts = TlsOptions::builder().ca_file_path(ca_file).cert_key_file_path(key_file).build();
    client_options.tls = Some(Tls::Enabled(tls_opts));
    let _client = Client::with_options(client_options)?;
    Ok(())
}

Informações adicionais

Para saber mais sobre como habilitar o TLS em uma conexão, consulte a seguinte documentação de manual do servidor:

• TLS/SSL (Criptografia de transporte)

• Configuração TLS/SSL para clientes