Mecanismos de autenticación

Convenciones de ejemplo

Cada mecanismo de autenticación contiene los siguientes placeholders:

• db_username - Su nombre de usuario de la base de datos MongoDB

• db_password - La contraseña del usuario de base de datos MongoDB

• hostname - La dirección de red de sus servidores MongoDB, a la que puede acceder su cliente

• port - El número de puerto de sus servidores MongoDB

• authenticationDb - La base de datos MongoDB que contiene los datos de autenticación del usuario. Si omite esta opción, el controlador usa el valor predeterminado admin.

predeterminado

El mecanismo predeterminado utiliza uno de los siguientes mecanismos de autenticación dependiendo de las versiones de MongoDB que soporte tu servidor:

Para especificar el mecanismo de autenticación por defecto, omite la opción AuthMechanism:

credential := options.Credential{
   AuthSource: "<authenticationDb>",
   Username: "<db_username>",
   Password: "<db_password>",
}
clientOpts := options.Client().ApplyURI("mongodb://<hostname>:<port>").
   SetAuth(credential)
client, err := mongo.Connect(context.TODO(), clientOpts)

Para obtener más información sobre los mecanismos de autenticación desafío-respuesta (CR) y desafío-respuesta con sal (SCRAM) que admite MongoDB, consulte la sección SCRAM del manual del servidor.

SCRAM-SHA-256

SCRAM-SHA-256 es un mecanismo de autenticación de desafío-respuesta salado (SCRAM) que utiliza su nombre de usuario y contraseña de la base de datos, encriptados con el algoritmo SHA-256, para autenticar a su usuario.

Para especificar el mecanismo de autenticación SCRAM-SHA-256, asigne a la opción AuthMechanism el valor "SCRAM-SHA-256":

credential := options.Credential{
   AuthMechanism: "SCRAM-SHA-256",
   AuthSource: "<authenticationDb>",
   Username: "<db_username>",
   Password: "<db_password>",
}
clientOpts := options.Client().ApplyURI("mongodb://<hostname>:<port>").
   SetAuth(credential)
client, err := mongo.Connect(context.TODO(), clientOpts)

SCRAM-SHA-1

SCRAM-SHA-1 es un mecanismo de desafío-respuesta salado (SCRAM) que utiliza su nombre de usuario y contraseña, encriptados mediante el algoritmo SHA-1, para autenticar a su usuario.

Para especificar el mecanismo de autenticación SCRAM-SHA-1, asigne a la opción AuthMechanism el valor "SCRAM-SHA-1":

credential := options.Credential{
   AuthMechanism: "SCRAM-SHA-1",
   AuthSource: "<authenticationDb>",
   Username: "<db_username>",
   Password: "<db_password>",
}
clientOpts := options.Client().ApplyURI("mongodb://<hostname>:<port>").
   SetAuth(credential)
client, err := mongo.Connect(context.TODO(), clientOpts)

MONGODB-CR

MONGODB-CR es un mecanismo de autenticación de desafío-respuesta que utiliza su nombre de usuario y contraseña para autenticar a su usuario.

MONGODB-AWS

El mecanismo de autenticación MONGODB-AWS utiliza sus credenciales de Amazon Web Services Identity and Access Management (AWS IAM) para autenticar a su usuario.

Para conectarse a una instancia de MongoDB con la autenticación MONGODB-AWS habilitada, especifique el mecanismo de autenticación MONGODB-AWS.

El controlador verifica sus credenciales en las siguientes fuentes en el orden indicado:

1. Cadena de conexión.

2. Variables de entorno.

3. Archivo de token de identidad web.

4. Punto final de AWS ECS especificado en la variable de entorno AWS_CONTAINER_CREDENTIALS_RELATIVE_URI.

5. Punto2 de conexión de AWS EC. Para obtener más información, consulte Roles de IAM para tareas en la documentación de AWS.

var accessKeyID, secretAccessKey string
awsCredential := options.Credential{
	AuthMechanism: "MONGODB-AWS",
	AuthSource:    "<authenticationDb>",
	Username:      "<accessKeyID>",
	Password:      "<secretAccessKey>",
}
awsIAMClient, err := mongo.Connect(
	context.TODO(),
	options.Client().SetAuth(awsCredential))
if err != nil {
	panic(err)
}
_ = awsIAMClient

var accessKeyID, secretAccessKey, sessionToken string
assumeRoleCredential := options.Credential{
	AuthMechanism: "MONGODB-AWS",
	AuthSource:    "<authenticationDb>",
	Username:      "<accessKeyID>",
	Password:      "<secretAccessKey>",
	AuthMechanismProperties: map[string]string{
		"AWS_SESSION_TOKEN": "<sessionToken>",
	},
}
assumeRoleClient, err := mongo.Connect(context.TODO(),
	options.Client().SetAuth(assumeRoleCredential))

export AWS_ACCESS_KEY_ID=<awsKeyId>
export AWS_SECRET_ACCESS_KEY=<awsSecretKey>
export AWS_SESSION_TOKEN=<awsSessionToken>

envVariablesCredential := options.Credential{
	AuthMechanism: "MONGODB-AWS",
}
envVariablesClient, err := mongo.Connect(
	context.TODO(),
	options.Client().SetAuth(envVariablesCredential))
if err != nil {
	panic(err)
}
_ = envVariablesClient

export AWS_WEB_IDENTITY_TOKEN_FILE=<absolute path to file that contains OIDC token>
export AWS_ROLE_ARN=<IAM role name>

envVariablesCredential := options.Credential{
	AuthMechanism: "MONGODB-AWS",
}
envVariablesClient, err := mongo.Connect(
	context.TODO(),
	options.Client().SetAuth(envVariablesCredential))
if err != nil {
	panic(err)
}
_ = envVariablesClient

X.509

El X.509 mecanismo de autenticación utiliza TLS con509 certificados X. para autenticar a su usuario, identificado por los nombres distinguidos relativos (RDN) de su certificado de cliente. Al especificar el X.509 mecanismo de autenticación, el servidor autentica la conexión mediante las rutas de los siguientes archivos:

• tlsCAFile que contiene una sola autoridad de certificación o un conjunto de ellas en las que confiar al realizar una conexión TLS

• tlsCertificateKeyFile que hace referencia a la ruta al archivo del certificado del cliente o al archivo de clave privada del cliente

Para especificar el mecanismo de autenticación X.509, realiza lo siguiente:

• Asignar al tlsCAFile la ruta a su archivo en la cadena de conexión

• Asignar al tlsCertificateKeyFile la ruta a su archivo en la cadena de conexión

• Asignar a la opción AuthMechanism el valor "MONGODB-X509"

caFilePath := "<cafile_path>"
certificateKeyFilePath := "<client_certificate_path>"
uri := "mongodb://<hostname>:<port>/?tlsCAFile=%s&tlsCertificateKeyFile=%s"
uri = fmt.Sprintf(uri, caFilePath, certificateKeyFilePath)
credential := options.Credential{
   AuthMechanism: "MONGODB-X509",
}
clientOpts := options.Client().ApplyURI(uri).SetAuth(credential)