Autenticación de AWS IAM

Especificar el mecanismo de autenticación

Puedes especificar el mecanismo de autenticación MONGODB-AWS utilizando una cadena de conexión o un objeto MongoCredential. Elija el Connection String o la pestaña MongoCredential a continuación para obtener instrucciones y código de muestra correspondientes:

val mongoClient =
    MongoClient.create("mongodb://<atlasUri>?authMechanism=MONGODB-AWS")

val credential = MongoCredential.createAwsCredential(null, null)
val settings = MongoClientSettings.builder()
    .applyToClusterSettings { builder: ClusterSettings.Builder ->
        builder.hosts(
            listOf(ServerAddress("<atlasUri>"))
        )
    }
    .credential(credential)
    .build()
val mongoClient = MongoClient.create(settings)

Agregar la dependencia AWS SDK

Para añadir el SDK de AWS como dependencia a tu proyecto, consulta la siguiente documentación de AWS para la versión que necesitas:

• Para el AWS SDK para Java v2, consulta la guía Configuración.

• Para el SDK de AWS para Java v,1 consulte la guía de introducción.

Proporcione sus credenciales

Para suministrar sus credenciales, consulte la siguiente documentación de AWS para la versión que necesita:

• Para **aprender** más sobre la clase AWS SDK for Java v2 que el driver utiliza para obtener las credenciales, consulta la documentación DefaultCredentialsProvider API.

  Aprende a proporcionar tus credenciales a esta clase desde la sección Utilizar la cadena de proveedores de credenciales predeterminada.

• Para aprender más sobre la clase AWS SDK para Java v1 que utiliza el controlador para obtener las credenciales, consulta la documentación de la API DefaultAWSCredentialsProviderChain.

  Aprenda cómo suministrar sus credenciales a esta clase en la sección Usar la cadena de proveedores de credenciales por defecto.

Especificar el mecanismo de autenticación

Puede especificar el mecanismo de autenticación MONGODB-AWS utilizando un objeto MongoCredential o en la cadena de conexión.

Para especificar el mecanismo de autenticación utilizando un objeto MongoCredential, llame al método de fábrica MongoCredential.createAwsCredential() y agregue la instancia MongoCredential a su MongoClient, como se muestra en el siguiente ejemplo:

val credential = MongoCredential.createAwsCredential(null, null)
val settings = MongoClientSettings.builder()
    .applyToClusterSettings { builder: ClusterSettings.Builder ->
        builder.hosts(
            listOf(ServerAddress("<atlasUri>"))
        )
    }
    .credential(credential)
    .build()
val mongoClient = MongoClient.create(settings)

Para especificar el mecanismo de autenticación MONGODB-AWS en la cadena de conexión, agrégalo como parámetro como se muestra en el siguiente ejemplo:

val mongoClient =
    MongoClient.create("mongodb://<atlasUri>?authMechanism=MONGODB-AWS")

Establecer Variables de Entorno

Esta sección muestra cómo proporcionar sus credenciales estableciendo variables de entorno para los siguientes tipos de autenticación:

• Claves de acceso programático

• Credenciales de contenedor ECS

• Credenciales del contenedor EC2

El siguiente ejemplo muestra cómo puede configurar sus claves de acceso programático en variables de entorno utilizando bash o un shell similar:

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

Omite la línea que establece la variable AWS_SESSION_TOKEN si no necesitas un token de sesión AWS para ese rol.

Para autenticar usando credenciales de contenedor ECS, establece el URI relativo del punto final de ECS en una variable de entorno usando bash o un shell similar, como se muestra en el siguiente ejemplo:

export AWS_CONTAINER_CREDENTIALS_RELATIVE_URI=<your ECS endpoint>

Para autenticarse mediante las credenciales del contenedor EC2 , no configure las variables de entorno de AWS. El driver obtiene las credenciales del endpoint de metadatos de instancia de EC2 por defecto en IPv4.