Visão geral
Você pode autenticar em um servidor LDAP (Lightweight Directory Access Protocol) usando seu nome de usuário e senha do servidor de diretório.
Dica
Autenticação PLAIN
O mecanismo de autenticação é denominado PLAIN
em vez de LDAP
porque o driver autentica usando o PLAIN
Simple Authentication and Security Layer (SASL) definido em RFC-4616.
Especificar autenticação LDAP
Os exemplos nesta seção mostram como especificar a autenticação do LDAP
utilizando uma string de conexão ou a classe MongoCredential
. Substitua os seguintes valores de espaço reservado:
<LDAP username>
: Seu nome de usuário LDAP.<password>
: Sua senha LDAP.<hostname>
: O endereço de rede da sua MongoDB deployment, acessível pelo seu cliente.<port>
: o número da porta da sua implantação do MongoDB . Se você omitir este parâmetro, o driver utilizará o número de porta padrão (27017
).
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 do LDAP
usando uma string de conexão:
Atribuir o parâmetro de URL
authMechanism
ao valorPLAIN
(Opcional) Atribua o parâmetro de URL
authSource
ao valor$external
Observação
Se você especificar o mecanismo PLAIN
, não poderá atribuir authSource
a nenhum valor diferente de $external
.
O seguinte código especifica o mecanismo de autenticação em uma string de conexão:
val connectionString = ConnectionString("<LDAP username>:<password>@<hostname>:<port>/?authSource=$external&authMechanism=PLAIN") val mongoClient = MongoClient.create(connectionString)
Para especificar o mecanismo de autenticação LDAP
usando a classe MongoCredential
, use o método createPlainCredential()
conforme mostrado no exemplo a seguir:
val credential = MongoCredential.createPlainCredential("<LDAP username>", "$external", "<password>".toCharArray()) val settings = MongoClientSettings.builder() .applyToClusterSettings { builder -> builder.hosts(listOf(ServerAddress("<hostname>", <port>))) } .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.
Documentação da API
Para saber mais sobre as classes e métodos para autenticar seu aplicação com o driver Kotlin Sync, consulte a seguinte documentação da API: