Menu Docs
Página inicial do Docs
/
Idiomas
/
Kotlin
/
Kotlin Coroutine
/
Fundamentals
/
Guia de conexão

Conecte-se ao MongoDB usando um proxy SOCKS5

Nesta página

  • Visão geral
  • Configurações de proxy SOCKS5
  • Exemplos
  • Especificar as configurações de proxy no MongoClientSettings
  • Especifique as configurações de proxy na string de conexão
  • Documentação da API

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 o5 protocolo SOCKS, 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 do MongoClientSettings ou em sua string 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

Os exemplos a seguir mostram como instanciar um MongoClient que se conecta ao MongoDB usando um proxy SOCKS5 . As configurações de proxy podem ser especificadas em uma instância do MongoClientSettings ou uma string de conexão. Esses exemplos usam os valores de espaço reservado descritos na seção Configurações de proxy do SOCKS5 . Substitua os espaços reservados pelas especificações e credenciais do proxy.

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://<user>:<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

Próximo

Autenticação