Mecanismos de autenticação

URI de conexão

Primeiro, o driver C++ verifica se você passou as credenciais do Amazon Web Services para o construtor MongoClient como parte do URI de conexão. Para passar suas credenciais no URI de conexão, defina as seguintes opções de conexão:

• username: O da Amazon Web Services chave de acesso IAM ID para autenticar.

• password: A chave de acesso secreto IAM Amazon Web Services .

• authMechanism: Defina como "MONGODB-AWS".

Você pode definir estas opções na string de conexão ao criar um objeto mongocxx::client , como mostrado no exemplo a seguir:

auto uri = mongocxx::uri("mongodb://<AWS IAM access key ID>:<AWS IAM secret access key>@<hostname>:<port>/?"
                         "authMechanism=MONGODB-AWS");
auto client = mongocxx::client(uri);

Você também pode incluir um token de sessão Amazon Web Services passando-o para o parâmetro authMechanismProperties :

auto uri = mongocxx::uri("mongodb://<AWS IAM access key ID>:<AWS IAM secret access key>@<hostname>:<port>/?"
                         "authMechanism=MONGODB-AWSS&authMechanismProperties=AWS_SESSION_TOKEN:<token>");
auto client = mongocxx::client(uri);

Variáveis de ambiente

Se você não fornecer um nome de usuário e senha ao construir seu objeto MongoClient , o driver C++ tentará recuperar as credenciais do Amazon Web Services a partir das seguintes variáveis de ambiente:

• AWS_ACCESS_KEY_ID

• AWS_SECRET_ACCESS_KEY

• AWS_SESSION_TOKEN (Opcional)

Para usar essas variáveis de ambiente para autenticar seu aplicativo, primeiro defina-as para os valores do Amazon Web Services IAM necessários para a autenticação, conforme mostrado no exemplo de código a seguir:

export AWS_ACCESS_KEY_ID=<AWS IAM access key ID>
export AWS_SECRET_ACCESS_KEY=<AWS IAM secret access key>
export AWS_SESSION_TOKEN=<AWS session token>

Após definir essas variáveis de ambiente, defina o parâmetro authMechanism em seu URI de conexão para "MONGODB-AWS", conforme mostrado no exemplo a seguir:

auto uri = mongocxx::uri("mongodb://<hostname>:<port>/?"
                         "authMechanism=MONGODB-AWS");
auto client = mongocxx::client(uri);

Solicitação AssumeRoleWithWebIdentity

Se o seu aplicação autenticar usuários para o seu cluster EKS a partir de um provedor de identidade OpenID Connect (OIDC), o driver C++ poderá fazer uma solicitação do AssumeRoleWithWebIdentity para trocar o token OIDC por credenciais temporárias do Amazon Web Services para seu aplicação.

Para autenticar com credenciais temporárias Amazon Web Services IAM retornadas por uma solicitação do AssumeRoleWithWebIdentity, verifique se o arquivo de configuração do Amazon Web Services existe em seu ambiente e está configurado com as variáveis de ambiente do AWS_WEB_IDENTITY_TOKEN_FILE e AWS_ROLE_ARN. Para saber como criar e configurar um Amazon Web Services arquivo de configuração do , consulte Configuração na documentação do Amazon Web Services .

Após configurar seu ambiente para uma solicitação do AssumeRoleWithWebIdentity , configure o parâmetro authMechanism em seu URI de conexão para "MONGODB-AWS", como mostrado no seguinte exemplo:

auto uri = mongocxx::uri("mongodb://<hostname>:<port>/?"
                         "authMechanism=MONGODB-AWS");
auto client = mongocxx::client(uri);

Para obter mais informações sobre como usar uma solicitação AssumeRoleWithWebIdentity para autenticar seu aplicativo, consulte a seguinte documentação do Amazon Web Services:

• AssumeRoleWithWebIdentity

• Autenticação de usuários para seu cluster a partir de um provedor de identidade OpenID Connect

ECS Metadata

Se o seu aplicação for executado em um container do Elastic Container Service (ECS), o driver do C++ poderá recuperar automaticamente credenciais temporárias Amazon Web Services de um endpoint do ECS. Para fazer isso, especifique o URI do ponto de conexão ECS em uma variável de ambiente chamada AWS_CONTAINER_CREDENTIALS_RELATIVE_URI, conforme mostrado no exemplo a seguir:

export AWS_CONTAINER_CREDENTIALS_RELATIVE_URI=<URI of the ECS endpoint>

Após definir a variável de ambiente, defina o parâmetro authMechanism em seu URI de conexão para "MONGODB-AWS", conforme mostrado no exemplo a seguir:

auto uri = mongocxx::uri("mongodb://<hostname>:<port>/?"
                         "authMechanism=MONGODB-AWS");
auto client = mongocxx::client(uri);

EC2 Metadados de instância

O driver C++ pode recuperar automaticamente credenciais temporárias Amazon Web Services de uma instância da Amazon Elastic Cloud Compute (EC2). Para usar credenciais temporárias de dentro de uma instância do EC2 , configure o parâmetro authMechanism em seu URI de conexão para "MONGODB-AWS", como mostrado no exemplo a seguir :

auto uri = mongocxx::uri("mongodb://<hostname>:<port>/?"
                         "authMechanism=MONGODB-AWS");
auto client = mongocxx::client(uri);