AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

AWS IAM 認証

注意

MongoDB Atlas共有責任モデルは、安全で回復力のあるデータ環境を維持するためのMongoDBとそのカスタマーの補完的な役割を定義します。このフレームワークの下、 MongoDB は基礎のプラットフォームのセキュリティと運用上の整合性を管理しますが、カスタマーは特定の配置の構成、管理、データ ポリシーに責任を負います。所有者のセキュリティと運用の優れ性の詳細な内訳については、共有責任モデルを参照してください。

Amazon Web Services IAM ユーザーまたはロールを使用して、パスワードを管理することなく Atlas クラスターのデータベースユーザーを認証できます。AWS IAM を使用すると、認証メカニズムの数と管理する秘密の数が削減されます。Atlas はネットワーク経由で認証秘密キーを受信しません、ドライバーはそれを保持しません。

ユースユースケースに適した認証方法を選択します。

  • IAM ロール: AWSサービス(EC2、 Lambda、ECS)またはフェデレーティッド ユーザーが引き受けるロール。AWSコンピューティング リソースで実行中ワークロードには、アプリケーションとワークロードロードにアクセスするために IAM ロール を使用することをお勧めします。

  • IAM ユーザー:データベースに直接アクセスする必要がある個々のAWSユーザー。このオプションは、特定のユーザー認証情報で実行中アプリケーションに適しています。開発者や管理者などの人間ユーザーの場合は、OIDC とともに Workforce IdP フェデレーション を使用することをお勧めします。

重要

クライアントがAWS IAMデータベース認証を使用して接続する前に、 IAM認証用に構成されたデータベースユーザーを作成する必要があります。認証に IAM Users または IAM Roles を使用するデータベースユーザーを作成する方法については、データベースユーザーの管理 を参照してください。

注意

Atlas は AWS STS を利用して IAM ユーザーおよびロールのアイデンティティを認証します。AWS は、アカウントごと、リージョンごと、1 秒あたり 600 リクエストのデフォルトのリクエストクォータを強制する。このクォータは、 IAM ユーザーまたはロールの AWS アカウントに適用されます。

Amazon Web ServicesIAM ロールを設定して、 クラスターへのAmazon Web Services コンピュートAtlas タイプを認証できます。

注意

Amazon Web Services IAM プリンシパルの認証は、LDAP 認証が有効になっている場合は設定できません。

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、EC 、ECS、または EKS に IAM2 ロールを割り当てる必要があります。

AWS Lambda は、Lambda 関数に 実行ロールを割り当てる と、次の環境変数を通じて関数に情報を渡します。

  • AWS_ACCESS_KEY_ID

  • AWS_SECRET_ACCESS_KEY

  • AWS_SESSION_TOKEN

注意

関数内で 実行ロール を使用する場合は、これらの環境変数を手動で作成する必要はありません。

これらの環境変数について詳しくは、 Amazon Web Services Lambda環境変数の使用 を参照してください。

データベースアクセスを AWS IAM ロールに許可するには、 AWS IAM の データベースユーザーの設定 セクションで説明されている手順を完了します。Atlas CLI、 Atlas 管理API、または Atlas UIを使用してデータベースへのアクセスを許可する方法の詳細については、データベースユーザーの設定を参照してください。

を使用して、 AWSmongosh IAM 認証情報で Atlas に接続するには、 MONGODB-AWS 認証メカニズムを指定する接続文字列 を指定します。この接続文字列形式は、すべてのAmazon Web Services IAM 認証メカニズムに適用されます。

重要

この接続文字列形式を使用する前に、 Amazon Web Services 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>