/ /

Java Sync Driver

Docs Home

Librerías de clientes

Java

Java Sync Driver

Docs Home

Librerías de clientes

Java

Java Sync Driver

Conectar a MongoDB mediante un proxy SOCKS5

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

Las opciones del proxy especifican la dirección del servidor proxy SOCKS5 y tus 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.
TransportSettings está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: `null`
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 el servidor proxy SOCKS5. El controlador ignora los valores `null` y las cadenas vacías para esta configuración. El controlador requiere que pases valores tanto para `proxyUsername` como para `proxyPassword`, o que omitas ambos valores. \| \| Por defecto: `null`
proxyPassword	String	Especifica la contraseña para la autenticación en el servidor proxy SOCKS5. El driver ignora los valores `null` y de string vacía para esta configuración. El controlador requiere que se pasen valores tanto para `proxyUsername` como para `proxyPassword` o que se omitan ambos valores. Default: `null`

Ejemplos

Los siguientes ejemplos muestran cómo instanciar un MongoClient que se conecta a MongoDB utilizando un proxy SOCKS5. La configuración del proxy se puede especificar en una instancia MongoClientSettings 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 . Sustituye los marcadores de posición con la configuración de tu 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 del proxy SOCKS5 en tu 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:

Volver

TLS/SSL

Validar las firmas de los artefactos del driver