データベースユーザーを認証するには、 AWS IAM ユーザーまたはロール ARN を使用します。 AWS IAM を使用すると、認証メカニズムの数と管理対象の秘密の数が削減されます。 Atlas はネットワーク経由で認証秘密キーを受信せず、ドライバーは秘密キーを保持しません。
注意
Amazon Web Services IAM ロールを使用して認証を設定する
Amazon Web ServicesIAM ロールを設定して、 クラスターへのAmazon Web Services コンピュートAtlas タイプを認証できます。
注意
LDAP認可が有効になっている場合、 AWS IAM プリンシパルの認証を設定することはできません。
Amazon Web Services IAM プリンシパルの認証が必要な場合は、Amazon Amazon Web Services IAM 認証でアクセスするクラスターを、 LDAP認証が無効になっている別のプロジェクトに移動することを検討してください。
AWS LambdaおよびHTTP （ECS および EC2 ）の場合、ドライバーは 環境変数 から自動的に読み取りを行います。 AWS EKS の場合、 IAM ロールを手動で割り当てる必要があります。
このページでは、AWS Lambda、AWS ECS、AWS EKS による AWS IAM ロールを使用した接続方法について説明します。
注意
AWS コンソールで、Lambda、EC2、ECS、または EKS に IAM ロールを割り当てる必要があります。
AWS Lambda は、Lambda 関数に 実行ロールを割り当てる と、次の環境変数を通じて関数に情報を渡します。
AWS_ACCESS_KEY_IDAWS_SECRET_ACCESS_KEYAWS_SESSION_TOKEN
注意
関数内で 実行ロール を使用する場合は、これらの環境変数を手動で作成する必要はありません。
これらの環境変数について詳しくは、「AWS Lambda 環境変数の使用」を参照してください。
Amazon Web Services ECS は次の URI から資格情報を取得します。
http://169.254.170.2${AWS_CONTAINER_CREDENTIALS_RELATIVE_URI}
AWS_CONTAINER_CREDENTIALS_RELATIVE_URI は、環境変数です。詳細については、 AWSドキュメントの「 タスクの IAM ロール 」を参照してください。
AWS EC2 は、次の URL でインスタンス メタデータ サービス V2 から認証情報を取得します。
http://169.254.169.254/latest/meta-data/iam/security-credentials/
詳細については、 AWSドキュメントの「 IAM ロールを使用してインスタンスを起動する 」を参照してください。
AWS ECS Fargate で認証ためにAWS IAM ロールを設定する方法については、 AWSドキュメントの「 Amazon ECSタスク実行 IAM ロール」を参照してください。
AWS EKS の場合、まずポッドに IAM ロールを割り当てて、そのポッドで次の環境変数を設定する必要があります。
AWS_WEB_IDENTITY_TOKEN_FILE- Web ID トークン ファイルへのパスが含まれます。AWS_ROLE_ARN- クラスターへの接続に使用されるIAMロールが含まれます。
AWS EKS の詳細については、 「 Amazon EKS とは 」を参照してください。 AWSドキュメントを参照してください。
Amazon Web Services IAM ロールへのデータベースアクセスの付与
IAMAmazon Web Services ロールへのデータベースアクセスを許可するには、AmazonAmazon Web Services Web IAM の データベースユーザーの構成 セクションに記載されている手順を完了します。Atlas CLI、Atlas Administration API、または Atlas UI を使用してデータベースにアクセスできるようにする方法の詳細については、「データベース ユーザーの追加 」を参照してください。
IAM を使用してAtlas クラスターに接続Amazon Web Services
を使用してAmazon Web Services IAM 認証情報でmongosh に接続するにAtlas は、 MONGODB- 認証メカニズムを指定する接続 を指定しますstringAmazon Web Services 。この接続文字列形式は、すべてのAmazon Web Services IAM 認証メカニズムに適用されます。
重要
この接続文字列形式を使用する前に、 「 AWS IAM ロールを使用した認証の設定 」で説明されている方法のいずれかを使用して認証を設定する必要があります。
mongosh で Amazon Web Services IAM 認証を使用して Atlas に接続するには、shell バージョン v0.9.0 以上が必要です。
次の点を考慮してください。
アクセス キー ID をユーザー名、秘密鍵をパスワードとして使用して、AWS IAM 認証情報を使用します。
authSourceクエリ パラメータは$externalで、%24externalとしてURL エンコードします。authMechanismクエリ パラメータはMONGODB-AWSです。例
mongosh "mongodb+srv://<atlas-host-name>/test?authSource=%24external&authMechanism=MONGODB-AWS" --username <access-key-id> --password <secret-key>