認証メカニズム

接続URI

まず、 C++ドライバーは、接続 URI の一部としてAmazon Web Servicesの認証情報を MongoClient コンストラクターに渡したかどうかを確認します。 接続 URI で認証情報を渡すには、次の接続オプションを設定します。

• username: 認証するAmazon Web Services IAM アクセスキーID 。

• password: Amazon Web Services IAM シークレット アクセス キー。

• authMechanism: "MONGODB-AWS"に設定します。

次の例に示すように、 mongocxx::clientオブジェクトを作成するときに接続stringでこれらのオプションを設定できます。

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);

また、 Amazon Web Servicesセッション トークンを 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);

環境変数

MongoClientオブジェクトを構築するときにユーザー名とパスワードを指定しない場合、 C++ドライバーは次の環境変数からAmazon Web Servicesの認証情報を検索しようとします。

• AWS_ACCESS_KEY_ID

• AWS_SECRET_ACCESS_KEY

• AWS_SESSION_TOKEN （任意）

これらの環境変数を使用してアプリケーションを認証するには、まず、次のコード例に示すように、認証に必要なAmazon Web Services IAM 値に設定します。

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>

これらの環境変数を設定したら、次の例に示すように、接続 URI のauthMechanismパラメータを"MONGODB-AWS"に設定します。

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

AssumeRoleWithWebIdentity requests

アプリケーションが OpenID Connect（OIDC） IdPから EKS クラスターのユーザーを認証する場合、 C++ドライバーは AssumeRoleWithWebIdentityリクエストを実行して、アプリケーションの一時的なAmazon Web Services認証情報の OIDC トークンを交換できます。

AssumeRoleWithWebIdentityリクエストによって返された一時的なAmazon Web Services IAM 認証情報を使用して認証するには、 Amazon Web Servicesの設定ファイルが環境内に存在し、かつ AWS_WEB_IDENTITY_TOKEN_FILE と AWS_ROLE_ARN 環境変数で構成されていることを確認します。 Amazon Web Servicesの設定ファイルの作成および構成方法については、「 構成 Amazon Web Services」を参照してください。 （ のドキュメント）。

AssumeRoleWithWebIdentityリクエスト用に環境を構成したら、次の例に示すように、接続 URI のauthMechanismパラメータを"MONGODB-AWS"に設定します。

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

AssumeRoleWithWebIdentity リクエストを使用してアプリケーションを認証する方法の詳細については、次のAmazon Web Servicesドキュメントを参照してください。

• AssumeRoleWithWebIdentity

• OpenID Connect ID プロバイダーからクラスターのユーザーを認証する

ECS Metadata

アプリケーションが Elastic Container Service（ECS）コンテナで実行される場合、 C++ドライバーは ECS エンドポイントから一時的なAmazon Web Servicesの認証情報を自動的に検索できます。 そのためには、次の例に示すように、 AWS_CONTAINER_CREDENTIALS_RELATIVE_URIという環境変数で ECS エンドポイントの URI を指定します。

export AWS_CONTAINER_CREDENTIALS_RELATIVE_URI=<URI of the ECS endpoint>

環境変数を設定したら、次の例に示すように、接続 URI のauthMechanismパラメータを"MONGODB-AWS"に設定します。

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

EC 2インスタンス メタデータ

C++Amazon Web Servicesドライバーは、Amazon Elastic Cloud compute (EC)インスタンスから一時的な2 の認証情報を自動的に取得できます。EC 2インスタンス内から一時認証情報を使用するには、次の例に示すように、接続 URI のauthMechanismパラメータを"MONGODB-AWS"に設定します。

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