接続での TLS の有効化

Overview

このガイドでは、 .NETフレームワーク の基礎となる TLS/SSL サポートを使用して、TLS/SSL セキュリティプロトコルでMongoDBインスタンスに接続する方法を学習できます。TLS/SSL を使用するように接続を構成するには、接続文字列 または MongoClientSettings のいずれかで TLS/SSL 設定を有効にします。

TLS の有効化

デフォルトでは、MongoDB インスタンスに接続するときに TLS は無効になっています。 MongoDBインスタンスへの接続に TLS を有効にするには、MongoClientSettings オブジェクトの プロパティを使用する方法と、 接続stringのパラメーターを使用する方法の 2 通りがあります。

var settings = new MongoClientSettings { UseTls = true };
var client = new MongoClient(settings);

var mongoClient = new MongoClient("mongodb://<db_username>:<db_password>@<hostname>:<port>?tls=true");

クライアント証明書の構成

MongoClientSettingsを使用して X.509 証明書を構成できます。 次のコード サンプルでは、パスワードmySuperSecretPasswordで保護されているclient.p12という名前の証明書ファイルを使用して新しい X.509 証明書オブジェクトを作成します。 次に、コードはこの証明書をMongoClientSettingsのSslSettings.ClientCertificates配列に追加します。

var cert = new X509Certificate2("client.p12", "mySuperSecretPassword");
var settings = new MongoClientSettings
{
   SslSettings = new SslSettings
   {
      ClientCertificates = new[] { cert }
   },
   UseTls = true
};

AllowInsecureTls

TLS が有効になっている場合、.NET/C# ドライバーはサーバーが提示した証明書を自動的に検証します。 コードをテストするときは、証明書の検証を無効にできます。 これは安全でない TLS と呼ばれます。

安全でない TLS を使用する場合、唯一の要件はサーバーが X.509 証明書を提示することです。 次のいずれかに当てはまる場合でも、ドライバーは証明書を受け入れます。

• サーバーのホスト名と証明書のサブジェクト名（またはサブジェクトの別名）が一致しません。

• 証明書の有効期限が切れているか、まだ有効ではありません。

• 証明書のチェーン内に信頼できるルート証明書がありません。

• 証明書の目的がサーバー識別には無効です。

安全でない TLS を許可するには、MongoClientSettings オブジェクトの プロパティを使用する方法と、 接続stringのパラメーターを使用する方法の 2 通りがあります。

var settings = new MongoClientSettings
{
   UseTls = true,
   AllowInsecureTls = true
};
var client = new MongoClient(settings);

var mongoClient = new MongoClient("mongodb://<db_username>:<db_password>@<hostname>:<port>?tls=true&tlsInsecure=true");

証明書の失効を確認する

X.509 証明書が信頼できなくなった場合、例 ）、その秘密キーが侵害された場合、証明機関は証明書を取り消します。

デフォルトでは、.NET/C# ドライバーは接続前にサーバーの証明書が失効しているかどうかを確認しません。 失効チェックは、MongoClientSettings または接続stringを使用して有効にできます。

var settings = new MongoClientSettings
{
   SslSettings = new SslSettings
   {
      CheckCertificateRevocation = true
   },
   UseTls = true
};

var mongoClient = new MongoClient("mongodb://<db_username>:<db_password>@<hostname>:<port>?tls=true&tlsDisableCertificateRevocationCheck=false");

API ドキュメント

このガイドで説明した接続オプションの詳細については、次の API ドキュメントを参照してください。

• MongoClientSettings