AWS Autenticação do IAM

Especifique o mecanismo de autenticação

Você pode especificar o mecanismo de autenticação MONGODB-AWS usando uma string de conexão ou um objeto MongoCredential. Selecione a aba Connection String ou MongoCredential abaixo para obter as instruções correspondentes e o código de exemplo:

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)

Adicione a dependência do SDK do Amazon Web Services

Para adicionar a AWS SDK como uma dependência ao seu projeto, consulte a seguinte documentação da AWS para a versão necessária:

• Para o AWS SDK for Java v2, consulte a página de Configuração do guia.

• Para o AWS SDK for Java v1, consulte o Guia de Primeiros passos.

Forneça suas Credenciais

Para fornecer suas credenciais, consulte a seguinte documentação AWS para a versão que você precisa:

• Para saber mais sobre a classe AWS SDK para Java v2 que o driver usa para obter as credenciais, consulte a documentação da API DefaultCredentialsProvider.

  Saiba como fornecer suas credenciais a essa classe na seção Usar a cadeia de fornecedores de credenciais padrão.

• Para saber mais sobre a classe AWS SDK for Java v1 que o driver usa para obter as credenciais, consulte a documentação da API DefaultAWSCredentialsProviderChain.

  Saiba como fornecer suas credenciais a essa classe na seção Usar a cadeia de provedor de credenciais padrão.

Especifique o mecanismo de autenticação

Você pode especificar o mecanismo de autenticação MONGODB-AWS usando um objeto MongoCredential ou na string de conexão.

Para especificar o mecanismo de autenticação usando um objeto MongoCredential , chame o método de fábrica MongoCredential.createAwsCredential() e adicione a instância MongoCredential ao seu MongoClient, conforme mostrado no exemplo a seguir :

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 o mecanismo de autenticação do MONGODB-AWS na string de conexão, adicione-o como um parâmetro como mostrado no exemplo a seguir:

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

Definir variáveis de ambiente

Esta seção mostra como fornecer suas credenciais definindo variáveis de ambiente para os seguintes tipos de autenticação:

• Chaves de acesso programático

• Credenciais do container ECS

• Credenciais do container EC2

O exemplo a seguir mostra como você pode definir suas chaves de acesso programático em variáveis de ambiente usando bash ou um shell similar:

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

Omita a linha que define a variável AWS_SESSION_TOKEN se não precisar de um token de sessão do Amazon Web Services para essa função.

Para autenticar usando credenciais de container do ECS, defina o URI relativo do ponto de extremidade do ECS em uma variável de ambiente usando bash ou um shell semelhante, conforme mostrado no exemplo a seguir:

export AWS_CONTAINER_CREDENTIALS_RELATIVE_URI=<your ECS endpoint>

Para autenticar usando as credenciais do container EC2 , não defina as variáveis de ambiente do Amazon Web Services. O driver obtém as credenciais do endpoint de metadados de instância IPv4 EC2 padrão.