/ /

SOCKS5 プロキシを使用した MongoDB への接続

Overview

このガイドでは、SOCKS 5プロキシを使用して MongoDB に接続する方法を学習できます。 SOCKS 5は、プロキシサーバーを介してネットワークサービスで通信するための標準化プロトコルです。

Tip

SOCKS5プロトコルの詳細については、 Wikipedia の SOCKS に関するエントリを参照してください。

SOCKS 5プロキシ設定

プロキシ設定では、SOCKS5 プロキシサーバーのアドレスと認証情報を指定します。設定は、 MongoClientSettings のインスタンスまたは接続文字列で指定できます。

重要

次のいずれかに当てはまる場合、ドライバーはプロキシ設定を無視します。

Unix ドメインソケットが通信を処理します。詳細については、UnixServerAddress のドキュメントを参照してください。
TransportSettings は構成されています。詳細については、TransportSettings のドキュメントを参照してください。

次の表では、SOCKS 5クライアントオプションについて説明します。

名前	許容値	説明
proxyHost	文字列	SOCKS5 プロキシ IPv4 アドレス、IPv6 アドレス、またはホスト名を指定します。SOCKS5 プロキシに接続するには、この値を指定する必要があります。\| \| デフォルト : `null`
proxyPort	非負整数	SOCKS5 プロキシサーバーの TCP ポート番号を指定します。デフォルト: を設定した場合の`1080proxyHost`
proxyUsername	文字列	SOCKS5 プロキシサーバーへの認証に使用するユーザー名を指定します。ドライバーは、この設定の `null` と空の文字列値を無視します。ドライバーでは、`proxyUsername` と `proxyPassword` の両方の値を渡すか、両方の値を省略する必要があります。\| \| デフォルト : `null`
proxyPassword	文字列	SOCKS 5プロキシサーバーへの認証用パスワードを指定します。ドライバーは、この設定の `null` と空のstring値を無視します。ドライバーでは、 `proxyUsername`と`proxyPassword`の両方の値を渡すか、両方の値を省略する必要があります。デフォルト：`null`

例

次の例は、SOCKS 5プロキシを使用して MongoDB に接続するMongoClientをインスタンス化する方法を示しています。プロキシ設定は、MongoClientSettings インスタンスまたは接続stringで指定できます。これらの例では、「 SOCKS 5プロキシ設定」セクションで説明されているプレースホルダー値を使用します。プレースホルダーをプロキシ設定で置き換えます。

MongoClientSettings でのプロキシ設定の指定

次のコード例は、 MongoClientSettingsビルダーを使用して SOCKS 5プロキシ設定を指定する方法を示しています。

MongoClient mongoClient = MongoClients.create(
    MongoClientSettings.builder()
        .applyConnectionString(
                new ConnectionString("mongodb+srv://myDatabaseUser:myPassword@example.org/"))
        .applyToSocketSettings(builder ->
                builder.applyToProxySettings(proxyBuilder ->
                        proxyBuilder
                            .host("<proxyHost>")
                            .port(<proxyPort>)
                            .username("<proxyUsername>")
                            .password("<proxyPassword>")
                        )
        ).build());

接続stringでのプロキシ設定の指定

次のコード例は、接続stringで SOCKS5 プロキシ設定を指定する方法を示しています。

String connectionString = "mongodb+srv://myDatabaseUser:myPassword@example.org/" +
        "?proxyHost=<proxyHost>" +
        "&proxyPort=<proxyPort>" +
        "&proxyUsername=<proxyUsername>" +
        "&proxyPassword=<proxyPassword>";
MongoClient mongoClient = MongoClients.create(connectionString);

API ドキュメント

このガイドで説明するメソッドとタイプの詳細については、次の API ドキュメントを参照してください。

戻る

TLS/SSL

ドライバーアーティファクトの署名の検証