Visão geral
No mecanismo de autenticação X.509, o servidor e o cliente usam o TLS protocolo para trocar certificados de chave pública X.509. Você pode usar esse mecanismo para autenticar no MongoDB Atlas, Enterprise Advanced e MongoDB Community Edition.
Dica
X.509 Mecanismo
Para saber como usar o TLS/SSL com o driver do Kotlin Sync, consulte o guia Habilitar TLS/SSL em um conexão.
Para obter mais informações sobre certificados X.509, consulte Usar x.509 certificados para autenticar clientes em sistemas autogerenciados no manual do MongoDB Server.
Especifique a autenticação X.509
Os exemplos nesta seção mostram como especificar o mecanismo de autenticação do X.509
e utilizar os seguintes valores de espaço reservado:
hostname
: O endereço de rede da sua implantação do MongoDB , aberto ao seu cliente.port
: O número da porta do servidor MongoDB .authenticationDb
: O banco de dados MongoDB que contém os dados de autenticação do seu usuário. Se omitir este parâmetro, o driver utiliza o valor padrãoadmin
.
Selecione a guia Connection String ou MongoCredential abaixo para obter instruções e código de exemplo para especificar este mecanismo de autenticação:
Para especificar o mecanismo de autenticação X.509
usando uma string de conexão, defina o parâmetro authMechanism
como MONGODB-X509
e o parâmetro tls
como true
, conforme mostrado no exemplo a seguir:
val mongoClient = MongoClient.create("mongodb://<db_username>:<db_password>@<hostname>:<port>/?authSource=<authenticationDb>&authMechanism=MONGODB-X509&tls=true")
Para especificar o mecanismo de autenticação do X.509
utilizando a classe MongoCredential
, utilize os métodos de construtor createMongoX509Credential() e applyToSslSettings() como mostrado no seguinte exemplo:
val credential = MongoCredential.createMongoX509Credential() val settings = MongoClientSettings.builder() .applyToClusterSettings { builder -> builder.hosts(listOf( ServerAddress("<hostname>", <port>)) ) } .applyToSslSettings { builder -> builder.enabled(true) } .credential(credential) .build() val mongoClient = MongoClient.create(settings)
Informações adicionais
Para saber mais sobre autenticação no MongoDB, consulte Autenticação no manual do MongoDB Server .
Para saber mais sobre como criar um objeto MongoClient
usando o driver Kotlin Sync, consulte o guia Criar um MongoClient.