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ê aprende a 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 connection string.

Importante

O driver ignora as configurações de proxy se uma das seguintes afirmações for verdadeira:

Um soquete de domínio Unix lida com a comunicação. Para obter mais informações, consulte a documentação UnixServerAddress.
TransportSettings estão configurados. Para obter mais informações, consulte a documentação do TransportSettings.

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	número inteiro não negativo	Especifica o número da porta TCP do servidor proxy SOCKS5. O padrão desta opção é `1080` quando você define `proxyHost`.
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 de SOCKS5. As configurações de proxy podem ser especificadas em uma instância MongoClientSettings ou em uma string de conexão. Esses exemplos usam os valores de espaço reservado descritos na seção Configurações de proxy SOCKS5 . Substitua os espaços reservados por suas configurações de proxy.

Especificar as configurações de proxy no MongoClientSettings

O exemplo de código a seguir mostra como especificar suas configurações de proxy SOCKS5 usando o construtor 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());

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

O exemplo de código a seguir mostra como especificar suas configurações de proxy SOCKS5 em sua cadeia de conexão:

String connectionString = "mongodb+srv://myDatabaseUser:myPassword@example.org/" +
        "?proxyHost=<proxyHost>" +
        "&proxyPort=<proxyPort>" +
        "&proxyUsername=<proxyUsername>" +
        "&proxyPassword=<proxyPassword>";
MongoClient mongoClient = MongoClients.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:

← Habilitar TLS/SSL em uma conexão

Conecte-se ao MongoDB usando uma fonte de dados JNDI →