Atlas App Connections は、 MongoDB Atlas OAuth 2.1 プラットフォームであり、ユーザー指定のアクセスを通じてアプリが Atlas ユーザーに代わって動作します。ユーザーがアプリを認証 すると、アプリはトークンを受け取ります。このトークンは、ユーザーが Atlas 組織で保持する権限と同じ権限で Atlas Administration API を呼び出すために使用できます。
このページでは、Atlas アプリ Connectionsを通じたユーザー委任アクセスを支える概念について説明します。これらの概念は、あらゆる種類のアプリに適用されます。このページで説明するガバナンスおよび取り消しコントロール（組織レベルのアクセスモードやトークンの有効期間など）は、AIクライアントに固有のものです。提携するアプリケーション、MongoDB Compass、およびAtlas エージェント エンジンには、それぞれ独自のガバナンスコントロールがあります。特定の種類のアプリを接続または管理するには、そのアプリタイプのドキュメントを参照してください。
アプリの種類
AIクライアント
AIクライアントは、MongoDB MCP サーバーを通じてAtlasにアクセスし、MCP サーバーが公開するツールを使用してユーザーの代理としてアクションを実行します。Organization Ownerは、AIクライアントが組織に接続できるかどうか、およびどのアクセスモードを使用するかを制御します。
AIクライアントが接続する方法を比較するには、「MongoDB AtlasのMCPアクセスモデル」を参照してください。組織のAIクライアントアクセスを有効または制限するには、「組織へのAIクライアントアクセスの管理」を参照してください。
提携するアプリケーション
提携するアプリケーションは、OAuth 2.1 を介してAtlasと直接統合するサードパーティのアプリケーションです。Proof Key for Code Exchange (PKCE) を使用した承認コードフロー。提携するアプリケーションは、独自のアクセス トークンと更新トークンを取得し、MCP サーバーを仲介することなく、承認ユーザーの権限で Atlas Administration API を呼び出します。
アプリケーションをAtlasと提携するには、「Integrate Your アプリ with Atlas アプリ Connections」を参照してください。統合でローテーションされたデータベース認証情報を自動的に受信する必要がある場合は、「実装する the Credential Rotation Webhook」を参照してください。
自社製アプリケーション
MongoDB Compass
Compass の Atlas アプリ接続を使用すると、ユーザーは Atlas にサインインでき、Compass がユーザーの既存の Atlas パーミッションを安全に使用できるようになります。これにより、Atlas に接続された体験がよりスムーズになります。
Compassの委任アクセスはデフォルトで有効になっています。Atlasでこの機能を無効にすることはできません。CompassでAtlas アプリ Connectionsを無効にするには、Compass設定ファイルを開き、enableAtlasSignInをoffに切り替えます。
認証トークンには、Atlas user と同じ許可が付与されています。Compass は Atlas user のディスク上に暗号化されたリフレッシュトークンを保存します。デフォルトのリフレッシュ トークン設定は、7 日間の非アクティビティ ウィンドウおよび 30 日間の最大有効期間です。これらのトークンは、有効期限が切れるか、ユーザーが取消するまで有効ですが、従業員が退職する場合やデバイスを引き渡す場合には注意が必要です。リフレッシュ トークンの最大ライフタイムを組織の設定で引き下げることもできます。ユーザーを除く方法については、組織ユーザーの管理を参照してください。
Atlas Agent Engine
Atlas Agent Engine は、AI エージェントを構築、配置する、管理するための MongoDB マネージドプラットフォームです。Atlas エージェント エンジン を初めて使用するときは、アプリ Connections を介して Atlas アクセスをサービスに委任します。
MongoDBプラットフォームサービスは、お客様の委任アクセスを使用して、お客様に代わってAtlas Administration APIへのサーバー側呼び出しを行います。
委任されたアクセスの仕組み
ユーザーがアプリを認可すると、アプリは別のエンティティとしてではなく、そのユーザーに代わって動作します。アプリは、Atlas 組織とプロジェクトでユーザーが持つのと同じ許可を使用して Atlas Administration API を呼び出すことができるトークンを受け取ります。ユーザーがアクションを実行できない場合、アプリもユーザーに代わって実行できません。アプリはユーザーのパスワードや長期間有効な認証情報を受信することはありません。
AI クライアントに限り、実効アクセスは次の 2 つの要素のうち、より制限の厳しい方になります。認可するユーザーの既存の Atlas パーミッション、および Organization Owner が組織に設定する読み取り専用または読み書き込みアクセス モード。アクセス モードにより AI クライアントが実行できる内容を削減できます。ただし、ユーザー自身のパーミッションで許可されるアクセスより多くのアクセスを付与することはありません。
ユーザー自身の許可からアクセスが継承されるため、
ユーザーのロールが変更されると、アプリの実効的な許可も自動的に変更されます。
組織に対する操作が成功するのは、その組織が AI クライアント接続を許可し、かつ承認されたユーザーが操作に必要なロールを持っている場合のみです。
ユーザーは、クライアントを認可すると、常にすべてのアクセスを委任します。これは、クライアントが特定のタスクに必要とするものよりも多くなる可能性があります。組織への委任を制限するには、Organization Owner は次のアクションを実行できます。
Atlas は、既存の組織と、既存の Atlas user が作成する新しい組織に対して、AI クライアントアクセスをデフォルトで無効にします。
Organization Owner は、必要な組織にのみ AI クライアント アクセスを有効にできます。
Organization Owner は、AI クライアントの読み取り専用または読み取り/書き込みモードを指定できます。
承認と同意
アプリは OAuth 2.1 を通じて廃止されたアクセスを取得しますコード交換の証明キーを使用した承認コード フロー（PKCE）。PKCE フローは次のとおりです。
ユーザーは Atlas からではなく、アプリから接続を開始します。
接続を開始するための正確な手順は、アプリによって異なります。AIクライアントの場合、 MongoDB MCP Server のドキュメントで クライアント固有の設定ガイダンスを参照してください。
アプリは、新しいブラウザウィンドウ、ポップアップ、または既存のウィンドウ内でのリダイレクトなどを介して、ユーザーを承認ページにリダイレクトする方法を制御します。
Atlasは、ログインしていない場合、ログインするようにユーザーに促します。
Atlasアカウントをまだお持ちでないユーザーは、このステップでアカウントを作成し、接続フローを続行できます。
Atlasには、要求されている許可の一覧を示す同意画面が表示されます。
ユーザーは、アクセスを許可するには（太字）許可（太字）を選択し、キャンセルするには（太字）拒否（太字）を選択します。
Atlas はユーザーをアプリにリダイレクトします。
接続が有効になりました。
詳細については、「セキュリティ、ガバナンス、および監査可能性」を参照してください。
組織レベルのガバナンス
Atlas は、既存の組織と、既存の Atlas user が作成する新しい組織に対して、AI クライアント接続をデフォルトで無効にします。Organization Owner は、AI クライアントがその組織に対して委任されたアクセスを使用できるように、AI クライアントアクセスを明示的に有効にする必要があります。Atlas は、ユーザーが既存の Atlas アカウントを持っていない場合、サインアップ時に新規ユーザーが作成する組織に対して、AI クライアントアクセスをデフォルトで有効にします。
Organization Owner は次のことができます。
組織の AI クライアント アクセスを有効または無効にします。
読み取り専用または読み書き込みアクセス モードを選択します。
認証された接続の最大トークン有効期間を設定します。
構成するアクセス モードと認可するユーザー自身の Atlas 権限によって、AI クライアントが実行できる操作が決定されます。AI クライアントの実効アクセスは、常に両者のうちより制限の厳しい方になります。
設定と構成の手順については、組織に対する AI クライアント アクセスの管理を参照してください。
アクセス取消とタイミング
ユーザーがアプリへのアクセスの委任を承認すると、アプリはアクセス トークンとリフレッシュ トークンを受け取ります。このアプリは、Atlas Administration API を呼び出すごとにアクセス トークンを提示します。アクセス トークンの有効期限が切れると、アプリはリフレッシュ トークンを使用して新しいアクセス トークンを取得し、ユーザーが再度サインインする必要はありません。
AI クライアントのアクセス取消が有効になるまでの時間は、アクセスを取消する人によって異なります。
Organization Owner が組織の AI クライアント アクセスを無効にします。組織に接続されているすべての AI クライアントのコントロールプレーン アクセスは直ちに取消されます。
ユーザーが個別の AI クライアントのアクセスを取り消した場合: 変更が有効になるまでに 10 分かかる場合があります。
警告
フェデレーティッド ユーザーのプロビジョニングを速やかに解除する
組織がロール マッピングを使用してIdPグループを通じてAtlasユーザーアクセスを管理する場合、フェデレーティッド ユーザーのAtlasでの許可は、ユーザーがログインしたときにのみ更新されます。これはジャストインタイム (JIT) プロビジョニングと呼ばれています。ユーザーがアクセスを失ったときにAtlas Administration APIを通じてユーザーをプロビジョニング解除しない場合、そのユーザーのリフレッシュ トークンを持つAIクライアントは、そのユーザーに代わって引き続き操作できます。
このリスクを制限するには、次のようにします。
ユーザーがアクセス権を失うとすぐに、Atlas Administration API を介してユーザーのプロビジョニングを解除します。
組織の最大リフレッシュ トークンの有効期間を設定して、ユーザーのプロビジョニング解除後にクライアントがアクセスを保持できる期間を短縮します。
詳細については、AI クライアントアクセスライフタイムを参照してください。
アプリの接続と管理
以下のガイダンスは、ロールに関係なく、Atlas アプリ Connectionsを通じて接続するすべてのタイプのアプリに適用されます。
アプリのアクセスを管理する
Organization Ownerは、アプリが組織に接続できるかどうかを制御します。Organization Settings > App Connectionsから、Organization Ownerはサードパーティ製アプリの接続の有効化/無効化、承認済みアプリの最大更新トークン有効期間の設定、組織内のユーザーが承認したアプリの確認を行うことができます。
アプリをアカウントに接続する
個々のユーザーは、自分に代わって行動するアプリを承認します。アプリを接続すると、Atlasはアプリがリクエストするアクセス権を一覧表示する同意画面を表示します。接続したアプリはいつでも検討し、取り消すことができます。取り消すと、そのアプリはユーザーに代わって行動できなくなります。
制限
統合を計画する際は、Atlas App Connections の次の範囲と境界を考慮してください。
Organization Owner は、ユーザーからクライアントに付与された個別のアクセスを取り消すことはできません。組織内のユーザーが委任したアクセスを削除するには、組織全体の AI クライアントアクセスを無効にします。組織の AI クライアントアクセスを有効にすると、委任されたアクセスをサポートする現在および将来のすべての AI クライアントが有効になります。
Atlas Administration API IP アクセス リストは、委任されたアクセス トラフィックには適用されません。AI クライアントの委任されたアクセス呼び出しは、AI クライアントが接続する IP アドレスに基づいてブロックすることはできません。
取消しても、クライアントが認可されたアクセス中に作成したセキュリティアーティファクトは削除されません。これらのアーティファクトは、クライアントの取消されたトークンとは独立して引き続き有効です。
サービス アカウントと API キーは、コントロール プレーン アーティファクトです。それらを監査し、クライアントのコントロール プレーンへのアクセスを終了するために除くまたはローテーションします。詳細については、「サービス アカウントのシークレットをローテーションする」を参照してください。
データベースユーザーはデータプレーンアーティファクトです。プロジェクト内の他のデータベースアイデンティティとともに検討します。詳細については、「データベースユーザーの設定」を参照してください。