Overview
En esta guía, puedes aprender a conectarte a MongoDB usando un proxy SOCKS5. SOCKS5 es un protocolo estandarizado para comunicarse con servicios de red a través de un servidor proxy.
Tip
Para obtener más información sobre el protocolo SOCKS5, consulte la entrada de Wikipedia sobre CALCETINES.
Configuración de proxy SOCKS5
La configuración del proxy especifica la5 dirección del servidor proxy SOCKS y sus credenciales de autenticación. Puede especificar su configuración en una instancia de MongoClientSettings o en su... cadena de conexión.
Importante
El controlador ignora la configuración del proxy si se cumple alguna de las siguientes condiciones:
Un socket de dominio Unix gestiona la comunicación. Para obtener más información, consulte la documentación del UnixServerAddress.
TransportSettingsestán configurados. Para obtener más información, consulta la documentación de TransportSettings.
La siguiente tabla describe las opciones de cliente SOCKS5:
Nombre | Valores permitidos | Descripción |
|---|---|---|
proxyHost | String | Especifica la dirección proxy SOCKS5 IPv4, la dirección IPv6 o el nombre de host. Debes proporcionar este valor para conectarte a un proxy SOCKS5. | | Por defecto: |
proxyPort | entero no negativo | Specifies the TCP port number of the SOCKS5 proxy server. Default: 1080 when you set proxyHost |
proxyUsername | String | Especifica el nombre de usuario para la autenticación en el5 servidor proxy SOCKS. El controlador ignora los |
proxyPassword | String | Especifica la contraseña para la autenticación en el servidor proxy SOCKS5. El driver ignora los valores Default: null |
Ejemplos
Los siguientes ejemplos muestran cómo instanciar un MongoClient que se conecta a MongoDB mediante un5 proxy SOCKS. La configuración del proxy se puede especificar en una MongoClientSettings instancia o en una cadena de conexión. Estos ejemplos utilizan los valores de marcador de posición descritos en la sección "Configuración del proxy SOCKS5 ". Reemplace los marcadores de posición con la configuración de su proxy.
Especifica la configuración del proxy en MongoClientSettings
El siguiente ejemplo de código muestra cómo especificar tu configuración de proxy SOCKS5 utilizando el generador MongoClientSettings:
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());
Especificar la configuración del proxy en la cadena de conexión
El siguiente ejemplo de código muestra cómo especificar la configuración de proxy SOCKS5 en su cadena de conexión:
String connectionString = "mongodb+srv://myDatabaseUser:myPassword@example.org/" + "?proxyHost=<proxyHost>" + "&proxyPort=<proxyPort>" + "&proxyUsername=<proxyUsername>" + "&proxyPassword=<proxyPassword>"; MongoClient mongoClient = MongoClients.create(connectionString);
Documentación de la API
Para obtener más información sobre los métodos y tipos tratados en esta guía, consulta la siguiente documentación de la API: