Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Mecanismo de autenticación AWS IAM

Importante

El mecanismo de autenticación MONGODB-AWS solo está disponible en la versión 4.4 de MongoDB o posterior.

El mecanismo de autenticación MONGODB-AWS utiliza las credenciales de Amazon Web Services Identity and Access Management (AWS IAM) para autenticar a un usuario en MongoDB. Puede usar este mecanismo solo cuando se autentique en MongoDB Atlas.

Tip

Configura Atlas para la autenticación IAM de AWS

Para obtener más información sobre cómo configurar MongoDB Atlas para la autenticación de AWS IAM, consulte Configurar la autenticación con AWS IAM en la documentación de Atlas.

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. Proveedor de credenciales personalizado. Para obtener más información, consulte Especificar un proveedor de credenciales de Amazon Web Services personalizado.

  3. Variables de entorno.

  4. Archivo de token de identidad web.

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

  6. Punto final de AWS EC2. Para obtener más información, consulta Roles IAM para tareas en la documentación de AWS.

Importante

El controlador obtiene las credenciales solo de la primera fuente en la que se encuentran. Por ejemplo, si se especifican las credenciales de AWS en la cadena de conexión, el driver ignorará cualquier otra credencial especificada en las variables de entorno.

Tip

Los siguientes ejemplos establecen las credenciales adecuadas utilizando el método SetAuth(). También puedes especificar estas credenciales utilizando el método ApplyURI(). Si utilizas el método ApplyURI(), debes codificar en URL el nombre de usuario y la contraseña para garantizar que se analicen correctamente.

Para conectarte a tu instancia de MongoDB utilizando tus credenciales de AWS IAM, realiza los siguientes pasos:

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

  • Asignar a la opción Username el valor de su accessKeyID

  • Asignar a la opción Password el valor de su secretAccessKey

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

Si es necesario especificar un token de sesión AWS, use las credenciales temporales devueltas de una solicitud de rol asumido.

Para utilizar credenciales temporales, asigna el valor de tu sessionToken a la opción AuthMechanismProperties:

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

Puede proporcionar su propio proveedor de credenciales de AWS al driver, lo que le permite utilizar la cadena completa de credenciales del SDK de AWS para Go v2. Si se autentica mediante un mecanismo de AWS que la cadena de credenciales con funcionalidad incorporada del driver no admite, como Amazon EKS Pod Identity, utilice este método.

Antes de comenzar, asegúrate de tener lo siguiente:

  • Go 1.26 o posterior

  • Go driver v2.9 o posterior

Nota

Funcionalidad Experimental

El módulo ext/awsauth está en versión preliminar. Su API es inestable y podría cambiar de formas incompatibles con versiones anteriores.

Para proporcionar un proveedor de credenciales desde el SDK de Amazon Web Services, instale el módulo ext/awsauth y el SDK de Amazon Web Services para Go v2:

go get go.mongodb.org/mongo-driver/ext/awsauth github.com/aws/aws-sdk-go-v2/config

El siguiente ejemplo pasa una cadena de proveedores del SDK de AWS al mecanismo de autenticación de AWS:

awsConfig, err := config.LoadDefaultConfig(context.TODO())if err != nil { panic(err)} awsSdkCredential := options.Credential{ AuthMechanism: "MONGODB-AWS", AWSCredentialsProvider: awsauth.NewCredentialsProvider(awsConfig.Credentials),} awsSdkClient, err := mongo.Connect(options.Client().SetAuth(awsSdkCredential))if err != nil { panic(err)}_ = awsSdkClient

Para aprender más sobre cualquiera de los métodos o tipos tratados en esta página, consulta la siguiente documentación de la API: