/ /

Configurar autenticación SCRAM

Overview

El mecanismo de autenticación SCRAM (Salted Challenge Response Authentication Mechanism) es el mecanismo de autenticación predeterminado para MongoDB. El controlador Scala admite las siguientes variantes de SCRAM:

SCRAM-SHA-256: Utiliza el algoritmo de hash SHA-256 y es el mecanismo predeterminado para MongoDB 6.0 y versiones posteriores.
SCRAM-SHA-1: Utiliza el algoritmo de hash SHA-1.

Puede utilizar SCRAM para autenticarse en MongoDB Atlas, MongoDB Enterprise Advanced y MongoDB Community Edition.

Tip

Mecanismos SCRAM

Para obtener más información sobre la familia de mecanismos de autenticación SCRAM, consulta RFC 5802 y Mecanismo de Autenticación con Desafío y Respuesta Sazonada en Wikipedia.

Para obtener más información sobre la implementación SCRAM de MongoDB, consulte SCRAM en el manual del servidor de MongoDB.

Marcadores de posición de código

Los ejemplos de código en esta página utilizan los siguientes marcadores de posición:

<db_username>: El nombre de usuario de MongoDB del usuario que se va a autenticar.
<db_password>La contraseña MongoDB del usuario para autenticarse.
<hostname>: La dirección de red de tu implementación de MongoDB.
<port>: El número de puerto de su implementación de MongoDB. Si omite este parámetro, el controlador utilizará el número de puerto predeterminado (27017). No necesita especificar un número de puerto al conectarse a un clúster de MongoDB Atlas.
<authenticationDb>La base de datos de MongoDB que contiene los datos de autenticación del usuario. Si omite este parámetro, el driver utiliza el valor por defecto, admin.

Para utilizar los ejemplos de código, reemplaza estos marcadores de posición por tus propios valores.

Mecanismo de autenticación por defecto

El mecanismo de autenticación predeterminado para MongoDB 6.0 y versiones posteriores es SCRAM-SHA-256. Para usar el mecanismo predeterminado, seleccione una de las siguientes pestañas:

Para autenticarse con una cadena de conexión, omita el parámetro authMechanism:

val mongoClient = MongoClient("mongodb://<db_username>:<db_password>@<hostname>:<port>/?authSource=<authenticationDb>")

La clase MongoCredential representa una credencial de autenticación e incluye métodos de fábrica estáticos para cada mecanismo de autenticación. Para autenticarse con la clase MongoCredential, utilice el método createCredential():

val user = "<db_username>"          // the username
val source = "<authenticationDb>"   // the authentication database
val password = ...                  // the password as a character array
val credential = MongoCredential.createCredential(user, source, password)
val mongoClient = MongoClient(MongoClientSettings
    .builder()
    .applyToClusterSettings(builder =>
        builder.hosts(Collections.singletonList(ServerAddress("<hostname>", <port>))))
    .credential(credential)
    .build())

SCRAM-SHA-256

Para utilizar este mecanismo, featureCompatibilityVersion debe ser 4.0 o posterior. Para especificar el mecanismo de autenticación SCRAM-SHA-256, seleccione una de las siguientes pestañas:

Para autenticarse con una cadena de conexión, establezca el parámetro authMechanism en SCRAM-SHA-256:

val mongoClient = MongoClient("mongodb://<db_username>:<db_password>@<hostname>:<port>/?authSource=<authenticationDb>&authMechanism=SCRAM-SHA-256")

val user = "<db_username>"          // the username
val source = "<authenticationDb>"   // the authentication database
val password = ...                  // the password as a character array
val credential = MongoCredential.createScramSha256Credential(user, source, password)
val mongoClient = MongoClient(MongoClientSettings
    .builder()
    .applyToClusterSettings(builder =>
        builder.hosts(Collections.singletonList(ServerAddress("<hostname>", <port>))))
    .credential(credential)
    .build())

SCRAM-SHA-1

Para especificar el mecanismo de autenticación SCRAM-SHA-1, seleccione una de las siguientes pestañas:

Para autenticarse con una cadena de conexión, establezca el parámetro authMechanism en SCRAM-SHA-1:

val mongoClient = MongoClient("mongodb://<db_username>:<db_password>@<hostname>:<port>/?authSource=<authenticationDb>&authMechanism=SCRAM-SHA-1")

val user = "<db_username>"          // the username
val source = "<authenticationDb>"   // the authentication database
val password = ...                  // the password as a character array
val credential = MongoCredential.createScramSha1Credential(user, source, password)
val mongoClient = MongoClient(MongoClientSettings
    .builder()
    .applyToClusterSettings(builder =>
        builder.hosts(Collections.singletonList(ServerAddress("<hostname>", <port>))))
    .credential(credential)
    .build())

Documentación de la API

Para obtener más información sobre los métodos y tipos de esta página, consulte la siguiente documentación de la API:

Volver

Autenticación

X.509