/ /

Controlador de corrutinas de Kotlin

Docs Home

Librerías de clientes

Kotlin

Controlador de corrutinas de Kotlin

Docs Home

Librerías de clientes

Kotlin

Controlador de corrutinas de Kotlin

Conéctese a MongoDB mediante un proxy SOCKS5

Overview

En esta guía, aprenderá a usar el controlador Kotlin de MongoDB para conectarse a MongoDB mediante un proxy SOCKS.5 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 la dirección del servidor proxy SOCKS5 y sus credenciales de autenticación. Puede especificar su configuración en una instancia de MongoClientSettings o en su 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, la dirección IPv6 o el nombre de host del proxy SOCKS5. Debe proporcionar este valor para conectarse 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 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.
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.

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 las especificaciones y credenciales 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 método de creación 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 del proxy SOCKS5 en su 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 analizados en esta guía, consulte la siguiente documentación de API:

Volver

TLS/SSL

Autenticación