接続での TLS の有効化

Overview

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

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

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

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

• クライアントでの参照証明書では、TLS オプションを構成するための tls.Config構造体を作成する方法の例が紹介されています。

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

TLS の有効化

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

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

• ClientOptionsインスタンスの作成時に空のtls.Config構造体をSetTLSConfig()メソッドに渡す

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

uri := "mongodb://<hostname>:<port>?tls=true"
opts := options.Client().ApplyURI(uri)
client, _ := mongo.Connect(opts)

uri := "<connection string>"
opts := options.Client().ApplyURI(uri).SetTLSConfig(&tls.Config{})
client, _ := mongo.Connect(opts)

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

証明書の構成

TLS 要求を正常に開始するには、アプリケーションが ID を証明するために暗号化証明書を提示する必要があります。 接続時に TLS を有効にするには、アプリケーションの証明書が PEM ファイルとして保存されている必要があります。

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

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

クライアントが接続する前にサーバーが証明書を検証できるように、ClientOptionsオブジェクトで証明書を参照必要があります。

TLS 接続を構成するには、ClientOptionsインスタンスの TLSConfigフィールドをtls.Config 構造体に設定することをお勧めします。tls.Config 構造体はGoのネイティブであり、すべての TLS オプションを単一の 再利用可能なオブジェクトに保持できます。

tls.Configインスタンスを作成するには、crypto/tls パッケージと crypto/x509 パッケージをインポートします。次に、次のセクションに示すように、tls.Config 構造体インスタンスを作成し、構成に関連する構造体フィールドを設定します。

tls.Config構造体の詳細については、 tls.Config API ドキュメントを参照してください。

caFile := "<path to CA certificate>"
certFile := "<path to public client certificate>"
keyFile := "<path to private client key>"
// Loads CA certificate file
caCert, err := os.ReadFile(caFile)
if err != nil {
	panic(err)
}
caCertPool := x509.NewCertPool()
if ok := caCertPool.AppendCertsFromPEM(caCert); !ok {
	panic("Error: CA file must be in PEM format")
}
// Loads client certificate files
cert, err := tls.LoadX509KeyPair(certFile, keyFile)
if err != nil {
	panic(err)
}
// Instantiates a Config instance
tlsConfig := &tls.Config{
	RootCAs:      caCertPool,
	Certificates: []tls.Certificate{cert},
}
uri := "<connection string>"
// Sets TLS options in options instance
opts := options.Client().ApplyURI(uri).SetTLSConfig(tlsConfig)

詳細情報

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

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

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