Menu Docs
Página inicial do Docs
/
Idiomas
/
Java
/
Driver de sincronização Java
/
Segurança

Conecte-se ao MongoDB usando um proxy SOCKS5

Nesta página

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 o5 endereço do servidor proxy SOCKS e suas credenciais de autenticação. Você pode especificar suas configurações em uma instância de MongoClientSettings ou em sua string de conexão.

Importante

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

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

Nome
Valores aceitos
Descrição

proxyHost

String

Especifica o endereço IPv4 proxy SOCKS5, endereço IPv6 ou nome do host. Você deve fornecer este valor para se conectar a um proxy SOCKS5. | | Padrão: null

proxyPort

número inteiro não negativo

Specifies the TCP port number of the SOCKS5 proxy server.

Default: 1080 when you set proxyHost

proxyUsername

String

Especifica o nome de usuário para autenticação no servidor proxy SOCKS5. O driver ignora null e valores de string vazia para esta configuração. O driver exige que você passe valores para proxyUsername e proxyPassword ou que omita ambos os valores. | | Padrão: null

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.

Default: null

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:

Voltar

TLS/SSL

Próximo

Validar assinaturas de artefato de driver