/ /

Conecte-se ao MongoDB usando um proxy SOCKS5

Visão geral

Neste guia, você pode aprender como usar o MongoDB Kotlin Driver para se conectar ao MongoDB usando um proxy SOCKS5. SOCKS5 é um protocolo padronizado para comunicação com serviços de rede por meio de um servidor proxy.

Dica

Para saber mais sobre o protocolo SOCKS5, consulte o verbete da Wikipedia sobre SOCKS.

Configurações de proxy SOCKS5

As configurações de proxy especificam o endereço do servidor proxy SOCKS5 e suas credenciais de autenticação. Você pode especificar suas configurações em uma instância de MongoClientSettings ou em sua cadeia de conexão.

A tabela a seguir descreve as opções do cliente SOCKS5 :

Nome	Valores aceitos	Descrição
proxyHost	String	Especifica o endereço IPv4 do proxy SOCKS5, endereço IPv6 ou nome de host. Você deve fornecer este valor para se conectar a um proxy SOCKS5.
proxyPort	Non-negative integer	Especifica o número da porta TCP do servidor proxy SOCKS5. Se você definir um valor para `proxyHost`, essa opção será padronizada como `1080`, mas você poderá especificar um número de porta diferente.
proxyUsername	String	Especifica o nome de usuário para autenticação no servidor proxy SOCKS5. O driver ignora `null` e valores de string vazios para esta configuração. O driver requer que os valores sejam passados para `proxyUsername` e `proxyPassword` ou que ambos valores sejam omitidos.
proxyPassword	String	Especifica a senha para autenticação no servidor proxy SOCKS5. O driver ignora `null` e valores de string vazios para essa configuração. O driver requer que os valores sejam passados para `proxyUsername` e `proxyPassword`, ou que ambos valores sejam omitidos.

Exemplos

The following examples show how to instantiate a MongoClient that connects to MongoDB by using a SOCKS5 proxy. The proxy settings can be specified in a MongoClientSettings instance or a connection string. These examples use the placeholder values described in the SOCKS5 Proxy Settings section. Replace the placeholders with your proxy specifications and credentials.

Especificar as configurações de proxy no MongoClientSettings

O exemplo de código abaixo mostra como especificar as configurações de proxy SOCKS5 usando o método de construtor applyToSocketSettings() ao criar uma instância 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()
)

Especifique as configurações de proxy na string de conexão

O seguinte exemplo de código mostra como especificar as configurações de proxy SOCKS5 em sua string de conexão:

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

Documentação da API

Para saber mais sobre os métodos e tipos discutidos neste guia, consulte a seguinte documentação da API:

Voltar

TLS/SSL

Autenticação