トランスポート層セキュリティ (TLS) の構成

OpenSSL

MongoDB Cドライバーは、 Linuxおよび UNIX プラットフォーム（macOS 以外）で OpenSSL を使用します。 業界のベストプラクティスと一部の規制では、TLS 1.1 以降の使用が必要であり、少なくとも OpenSSL 1.0.1 が必要です。 OpenSSL のバージョンを確認するには、次のコマンドを使用します。

openssl version

システムの OpenSSL が最新バージョン（少なくとも 1.0.1）であることを確認するか、次のコマンドを使用して最新バージョンを非システム パスにインストールし、そのバージョンに対して をビルドします。

cmake -DOPENSSL_ROOT_DIR=/absolute/path/to/openssl

OpenSSL に対してコンパイルすると、ドライバーはディストリビューションによって構成されたシステムのデフォルトの証明書ストアのロードを試行します。これは、tlsCAFile URI オプションを設定するか、mongoc_ssl_opt_t でフィールド ca_file と ca_dir を使用して上書きできます。

OpenSSL 1.0.1+ を使用することで、オンライン証明書ステータス プロトコル（OCSP）が完全にサポートされます。ただし、crl_file が mongoc_ssl_opt_t で設定されており、crl_file がサーバーの証明書を取り消すと、証明書にステープリングされた OCSP 応答が有効であっても、証明書は失効したと見なされます。

Windows のネイティブ TLS サポート（セキュア チャネル）

MongoDB Cドライバーは、 Windows のネイティブ TLS ライブラリ（セキュア チャネル、Schannel）とそのネイティブ暗号化ライブラリ（暗号化API: 次の生成、または CNG）をサポートしています。

Windowsネイティブ ライブラリに対してコンパイルされた場合、ca_dir mongoc_ssl_opt_t の オプションはサポートされておらず、使用された場合はエラーが発生します。tlsCertificateKeyPassword URI オプションを使用して設定された暗号化された PEM ファイルもサポートされておらず、ロードしようとするとエラーが発生します。

tlsCertificateKeyFile URI オプションは、 PKCS#8 または PKCS#1形式でエンコードされた証明書を参照できます。Cドライバーのバージョン 2.1.0 以降、ドライバーは秘密キーを永続キーとしてインポートし、最新の署名アルゴリズムをサポートします。以前のバージョンでは、ドライバーはキーをエフェメラルとしてインポートしていました。インポートされたキーの管理の詳細については、インポートされたキーの管理を参照してください。

tlsCAFile が設定されている場合、ドライバーは証明機関ファイルをSystem Local Machine Root 証明書ストアにインポートします。tlsCAFile が設定されていない場合、ドライバーは System Local Machine Root 証明書ストアを使用して証明機関のファイルを検索し、提供された証明書を確認します。

crl_file が mongoc_ssl_opt_t で設定されている場合、ドライバーは失効リストを System Local Machine Root 証明書ストアにインポートします。tlsDisableOCSPEndpointCheck を設定しても効果はありません。

オンライン証明書ステータスプロトコル（OCSP）は、次の注意事項で部分的にサポートされています。

• must-staple 拡張機能（RFC 7633 を参照）は無視されます。

• must-staple 証明書がステープリングされた応答なしで提示され、 OCSP レスポンダーがダウンしても接続は継続されます。

• クライアントがOCSP レスポンダーから取り消し応答を受信した場合、接続は継続されません。

• crl_file が mongoc_ssl_opt_t で設定されており、crl_file によってサーバーの証明書が取り消されている場合は、OCSP 応答が優先されます。例、サーバーが有効なステープリングされた OCSP 応答を含む証明書を提示した場合、crl_file が証明書を失効としてマークしていても、その証明書は有効であると見なされます。

$cert = "client.pem"
# Compute the SHA256 fingerprint:
$fingerprint = (openssl x509 -in $cert -noout -fingerprint -sha256) -replace 'SHA256 Fingerprint=', '' -replace ':', ''
if (Select-String -Path $cert -Pattern '-----BEGIN RSA PRIVATE KEY-----' -Quiet) {
    # Key name for PKCS#1 key:
    $key_name = "libmongoc-$fingerprint-pkcs1"
    $csp = "Microsoft Enhanced Cryptographic Provider v1.0"
} elseif (Select-String -Path $cert -Pattern '-----BEGIN PRIVATE KEY-----' -Quiet) {
    # Key name for PKCS#8 key:
    $key_name = "libmongoc-$fingerprint-pkcs8"
    $csp = "Microsoft Software Key Storage Provider"
} else {
    Write-Output "Unexpected PEM format for $cert"
}

certutil -user -csp $csp -key $key_name

certutil -user -csp $csp -key $key_name

macOS / Darwin でのネイティブ TLS サポート（セキュア トランスポート）

MongoDB Cドライバーは、Darwin ネイティブ TLS ライブラリとそのネイティブ暗号化ライブラリである Common Crypto の両方をサポートしています。

セキュア トランスポートに対してコンパイルされた場合、 mongoc_ssl_opt_t の ca_dir オプションと crl_file オプションはサポートされません。どちらが使用されている場合は、 エラーが発行されます。

tlsCAFile が設定されている場合、ドライバーは提供された認証局によって発行されたサーバー証明書のみを許可します。 tlsCAFile が設定されていない場合、ドライバーはロックされていないキーチェーンの証明機関を使用します。

tlsDisableOCSPEndpointCheck と tlsDisableCertificateRevocationCheck を設定しても、セキュア トランスポートでコンパイルする場合、効果はありません。

オンライン証明書ステータスプロトコル（OCSP）は、次の注意事項で部分的にサポートされています。

• must-staple 拡張機能（RFC 7633 を参照）は無視されます

• must-staple 証明書がステープリングされた応答なしで提示され、 OCSP レスポンダーがダウンしても接続は継続されます

• クライアントがOCSP レスポンダから取り消された応答を受信した場合、接続は継続されません