Autenticación de AWS IAM

Especificar el mecanismo de autenticación

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

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 del SDK de AWS

Para agregar el SDK de AWS como una dependencia a su proyecto, consulte la siguiente documentación de AWS para la versión que necesita:

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

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

Proporcione sus credenciales

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

• Para obtener más información sobre la clase AWS SDK para Java v2 que utiliza el controlador para obtener las credenciales, consulte la documentación de la API DefaultCredentialsProvider.

  Aprenda cómo proporcionar sus credenciales a esta clase desde la sección Utilizar la cadena de proveedor de credenciales predeterminada.

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

  Aprenda cómo proporcionar sus credenciales a esta clase desde la sección Uso de la cadena de proveedor de credenciales predeterminada.

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éguelo 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 configurando variables de entorno para los siguientes tipos de autenticación:

• Teclas de acceso programático

• Credenciales del 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>

Omita la línea que establece la variable AWS_SESSION_TOKEN si no necesita un token de sesión de AWS para esa función.

Para autenticarse mediante las credenciales del contenedor ECS, configure el URI relativo del punto final ECS en una variable de entorno utilizando bash o un shell similar, como se muestra en el siguiente ejemplo:

export AWS_CONTAINER_CREDENTIALS_RELATIVE_URI=<your ECS endpoint>

Para autenticarse con las 2 credenciales del contenedor EC, no configure las variables de entorno de AWS. El controlador obtiene las credenciales4 del2 punto de conexión de metadatos de la instancia EC IPv predeterminada.