/ /

/ /

x.509

Overview

X.509 認証メカニズムでは、サーバーとクライアントは TLS プロトコルを使用して X.509 公開鍵証明書を交換します。このメカニズムを使用して、 MongoDB Atlas、 MongoDB Enterprise Advanced、 MongoDB Community Edition を認証できます。

Tip

X.509 メカニズム

Javaドライバーで TLS/SSL を使用する方法については、接続ガイドで TLS/SSL を有効にするを参照してください。

X.509 証明書の詳細については、 MongoDB Serverマニュアルの「 x.509 証明書を使用した自己管理型配置でクライアントの認証」を参照してください。

コードプレースホルダー

このページのコード例では、次のプレースホルダーを使用します。

<hostname>: MongoDBデプロイのネットワークアドレス。
<port>: MongoDBデプロイのポート番号。このパラメーターを省略すると、ドライバーはデフォルトのポート番号（27017）を使用します。 MongoDB Atlasクラスターに接続する場合、ポート番号は必要ありません。
<authenticationDb>: ユーザーの認証データが含まれるMongoDBデータベース。このプレースホルダーを省略すると、ドライバーはデフォルトのadminデータベースを使用します。

コード例を使用するには、これらのプレースホルダーを独自の値に置き換えます。

X.509 認証の指定

Connection StringMongoCredentialこの認証メカニズムを指定するための手順とサンプルコードについては、以下の [0 タブまたはタブを選択してください。

接続文字列を使用して X.509認証メカニズムを指定するには、authMechanism パラメータを MONGODB-X509 に割り当て、tls パラメータを true に割り当てて TLS を有効にします。 MongoClient をインスタンス化するコードは次のようになります。

MongoClient mongoClient = MongoClients.create("mongodb://<hostname>:<port>/?authSource=<authenticationDb>&authMechanism=MONGODB-X509&tls=true");

MongoCredentialクラスを使用して X.509認証メカニズムを指定するには、createMongoX509Credential() メソッドを使用します。また、 applyToSslSettings() メソッドを呼び出し、SslSettings.Builder ブロックで enabledプロパティを true に設定して、TLS を有効にします。MongoClient をインスタンス化するコードは次のようになります。

MongoCredential credential = MongoCredential.createMongoX509Credential();
MongoClient mongoClient = MongoClients.create(
    MongoClientSettings.builder()
        .applyToClusterSettings(builder ->
            builder.hosts(Arrays.asList(new ServerAddress("<hostname>", <port>))))
        .applyToSslSettings(builder ->
            builder.enabled(true);
            )
        .credential(credential)
        .build());

API ドキュメント

このページで使用されているMongoDB のメソッドとタイプの詳細については、次のAPIドキュメントを参照してください。

戻る

SCRAM

AWS IAM

Overview

Tip

X.509 メカニズム

コード プレースホルダー

X.509 認証の指定

API ドキュメント

コードプレースホルダー