TLS の有効化と構成

Overview

このガイドでは、 TLS プロトコルを使用して MongoDB 配置への接続を保護する方法を学習できます。 TLS は、アプリケーションと MongoDB 間の通信を保護する暗号化プロトコルです。 TLS を使用するように接続を構成するには、 TLS オプションを有効にし、クライアントを作成するときに検証用の証明書を提供します。

このガイドには、次のセクションが含まれています。

• TLSを有効にする では、接続で TLS を有効にする方法について説明します。

• 「証明書の構成」では、TLS を構成するために必要な証明書について説明します。

• クライアント内の参照証明書には、 TLS オプションを構成するためのTlsOptions構造体を作成する方法の例が記載されています

• 追加情報では、このガイドで言及されている型とメソッドのリソースとAPIドキュメントへのリンクを提供します

TLS の有効化

次のいずれかの方法で、MongoDB インスタンスへの接続で TLS を有効にできます。

• 接続stringで tls オプションを true に設定する

• 空のTlsOptions構造体を使用してClientOptionsインスタンスのtlsフィールドをTls::Enabledバリアントに設定し、それらのオプションを使用してClientをインスタンス化する

Connection StringClientOptions次の タブと タブから選択すると、対応するコードサンプルが表示されます。

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)?;

クライアントオプションの完全なリストについては、 「接続オプションの指定」 ガイドを参照してください 。

証明書の構成

TLS 要求を正常に開始するには、アプリケーションが ID を証明するために暗号化証明書を提示する必要があります。 MongoDB 配置に接続するときに TLS を有効にするには、アプリケーションの証明書を PEM（プライバシー拡張メール） ファイルとして保存する必要があります。 PEM ファイル形式は、暗号化証明書のコンテナ形式です。

次のリストでは、TLS 対応接続を確立するためにクライアントが提示する必要があるコンポーネントを説明します。

クライアントでの証明書の参照

クライアントが接続する前にサーバーが証明書を検証できるように、 TlsOptions構造体で証明書を参照する必要があります。

最初に証明書ファイルパスをPathBufタイプに変換する必要があるため、 std::pathモジュールからこのタイプをインポートする必要があります。 TlsOptions次に、ca_file_path 構造体のビルダ関数を呼び出して、cert_key_file_path フィールドと フィールドを証明書ファイルパスに設定します。

TlsOptionsインスタンス内で、接続上で TLS を構成するための任意のフィールドを設定できます。 テスト目的 には、allow_invalid_certificates allow_invalid_hostnamesフィールドと フィールドを設定できます。

allow_invalid_certificatesオプションをtrueに設定するとホスト名検証が無効になり、 allow_invalid_hostnamesをtrueに設定すると証明書の検証が無効になります。

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 key_password = b"<password for client key>".to_vec();
    let tls_opts = TlsOptions::builder()
        .ca_file_path(ca_file)
        .cert_key_file_path(key_file)
        .tls_certificate_key_file_password(key_password)
        .build();
    client_options.tls = Some(Tls::Enabled(tls_opts));
    let _client = Client::with_options(client_options)?;
    Ok(())
}

詳細情報

接続で TLS を有効にする方法の詳細については、次のサーバー マニュアル ドキュメントを参照してください。

• TLS/SSL (トランスポート暗号化)

• クライアントの TLS/SSL 設定