/ /

Java Sync Driver

Docs Home

Librerías de clientes

Java

Java Sync Driver

Docs Home

Librerías de clientes

Java

Java Sync Driver

Conéctese a MongoDB mediante un proxy SOCKS5

Overview

En esta guía, aprenderá a conectarse a MongoDB mediante 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 MEDIAS.

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 más información, consulte la documentación de UnixServerAddress.
TransportSettings Están configurados. Para más información, consulte la documentación de TransportSettings.

La siguiente tabla describe las opciones de cliente SOCKS5:

Nombre	Valores permitidos	Descripción
proxyHost	String	Especifica la5 dirección IPv, la4 dirección IPv o el nombre de host del proxy6 SOCKS. Debe proporcionar este valor para conectarse a un5 proxy SOCKS. \| \| Predeterminado: `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 el5 servidor proxy SOCKS. El controlador ignora los `null` valores y de cadena vacía para esta configuración. El controlador requiere que se pasen valores para `proxyUsername` y `proxyPassword` o que se omitan ambos. \| \| Predeterminado: `null`
proxyPassword	String	Especifica la contraseña para la autenticación en el servidor proxy SOCKS5. El controlador ignora los valores `null` y de cadena vacía para esta configuración. El controlador requiere que se pasen valores para `proxyUsername` y `proxyPassword`, o que se omitan ambos. 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.

Especificar la configuración del proxy en MongoClientSettings

El siguiente ejemplo de código muestra cómo especificar la configuración del proxy SOCKS5 mediante 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 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 analizados en esta guía, consulte la siguiente documentación de API:

Volver

TLS/SSL

Validar las firmas de los artefactos del driver