/ /

driver de Kotlin corrutina

Docs Home

Librerías de clientes

Kotlin

driver de Kotlin corrutina

Docs Home

Librerías de clientes

Kotlin

driver de Kotlin corrutina

Conéctese a MongoDB mediante un proxy SOCKS5

Overview

En esta guía, puedes aprender cómo utilizar el MongoDB Kotlin Driver para conectarte 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 CALCETINES.

Configuración de proxy SOCKS5

La configuración del proxy especifica 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 tu cadena de conexión.

La siguiente tabla describe las opciones de cliente SOCKS5:

Nombre	Valores permitidos	Descripción
proxyHost	String	Especifica la dirección IPv4 del proxy SOCKS5, la dirección IPv6 o el nombre de host. Debe proporcionar este valor para conectar a un proxy SOCKS5.
proxyPort	Non-negative integer	Especifica el número de puerto TCP del servidor proxy SOCKS5. Si estableces un valor para `proxyHost`, esta opción se configura por defecto en `1080`, pero puedes especificar un número de puerto diferente.
proxyUsername	String	Especifica el nombre de usuario para la autenticación al 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.
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.

Ejemplos

Los siguientes ejemplos muestran cómo instanciar un MongoClient que se conecte a MongoDB utilizando un proxy SOCKS5. La configuración del proxy se puede especificar en una instancia de 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 . Reemplace los marcadores de posición con sus especificaciones y credenciales de proxy.

Especifica la configuración del proxy en MongoClientSettings

El siguiente ejemplo de código muestra cómo especificar la configuración del proxy SOCKS5 utilizando el método builder applyToSocketSettings() al crear una instancia MongoClientSettings:

val uri = "<connection string>"
val mongoClient = MongoClient.create(
    MongoClientSettings.builder()
        .applyConnectionString(ConnectionString(uri))
        .applyToSocketSettings{ builder ->
            builder
                .applyToProxySettings{ proxyBuilder ->
                    proxyBuilder
                        .host("<proxyHost>")
                        .port("<proxyPort>".toInt())
                        .username("<proxyUsername>")
                        .password("<proxyPassword>")
                        .build()
                }
        }
        .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 tu cadena de conexión:

val connectionString = ConnectionString(
    "mongodb+srv://<db_username>:<db_password>@<cluster-url>/?" +
        "proxyHost=<proxyHost>" +
        "&proxyPort=<proxyPort>" +
        "&proxyUsername=<proxyUsername>" +
        "&proxyPassword=<proxyPassword>"
)
val mongoClient = MongoClient.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

Autenticación