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 tus servidores MongoDB, accesible por tu cliente

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

• authenticationDb - Su base de datos MongoDB que contiene los datos de autenticación del usuario. Si omite esta opción, el driver utiliza el valor por defecto 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 más información sobre los mecanismos de autenticación de challenge-response (CR) y de challenge-response con sal (SCRAM) que soporta MongoDB, consulte la sección SCRAM del manual del servidor.

SCRAM-SHA-256

SCRAM-SHA-256 es un mecanismo de autenticación por desafío y respuesta con sal (SCRAM) que usa tu nombre de usuario y contraseña de base de datos, cifrados con el algoritmo SHA-256, para autenticar al usuario.

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

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, cifrados mediante el algoritmo SHA-1, para autenticar a su usuario.

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

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 tu nombre de usuario y contraseña para autenticar a tu usuario.

MONGODB-AWS

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

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

El controlador verifica tus credenciales en las siguientes fuentes, en el orden en que aparecen:

1. cadena de conexión.

2. Variables de entorno.

3. Archivo de token de identidad web.

4. Endpoint AWS ECS especificado en la variable de entorno AWS_CONTAINER_CREDENTIALS_RELATIVE_URI.

5. Punto final de AWS EC2. Para obtener más información, consulta Roles 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 mecanismo de autenticación X.509 utiliza TLS con certificados X.509 para autenticar al usuario, identificado por los nombres distinguidos relativos (RDNs) del certificado de cliente. Cuando especificas el mecanismo de autenticación X.509, el servidor autentica la conexión utilizando las rutas de los siguientes archivos:

• tlsCAFile que contiene una única o un conjunto de autoridades certificadoras en las que confiar al establecer una conexión TLS

• tlsCertificateKeyFile que hace referencia a la ruta del archivo del certificado de cliente o del archivo de la 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)