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

ワークフォース認証のための OIDC の構成

OIDC を使用して Workforce IdP を構成するには、 OIDCアプリケーションをOkta やMicrosoft Entra IDなどの外部IdPに登録します。これにより、安全な認証が確保され、ユーザー管理が容易になります。

Workforce IdP は OIDC を使用します。 OIDC 標準をサポートする任意の外部IdPを使用できます。

OIDCアプリケーションは、次の付与タイプで構成できます。

  • PKCEを使用した認証コードフロー

  • デバイス認証フロー

MongoDB、セキュリティを強化するために、Authorization Code Flow と PKCE を使用することを推奨しています。 ユーザーがブラウザを使用せずにマシンからデータベースにアクセスする必要がある場合にのみ、Device Authorization Flow を使用します。

注意

Workforce IdP は認証用のJSON web token のみをサポートしています。不変のアクセス トークンはサポートされていません。

次の手順では、 Microsoft Entra IDと Okta の詳細な構成手順と、その他の外部 ID プロバイダーの一般的な構成手順を示します。

1
  1. App registrationsに移動します。

    1. Azure portal アカウントで、 を検索し、Microsoft Entra ID をクリックします。

    2. 左側のナビゲーションの Manage セクションで、App registrations をクリックします。

  2. [New registration] をクリックします。

  3. 次の値を適用します。

    フィールド
    値

    Name

    MongoDB - Workforce

    Supported Account Types

    Accounts in this organizational directory only (single tenant)

    Redirect URI

    - Public client/native (mobile & desktop)
    - MongoDB Compass と MongoDB Shell を使用してクラスターにアクセスするには、Redirect URI を http://localhost:27097/redirect に設定します。

  4. [Register] をクリックします。

アプリケーションの登録 の詳細については、Azure のドキュメントを参照してください。

2
  1. Token Configurationに移動します。

    左側のナビゲーションの Manage セクションで、Token Configuration をクリックします。

  2. [Add groups claim] をクリックします。

  3. Edit groups claimモーダルで、 Securityを選択します。

    選択するグループは、Azure 環境で構成したグループのタイプによって異なります。 適切なグループ情報を送信するには、別のタイプのグループを選択する必要がある場合があります。

  4. Customize token properties by typeセクションで、 Group IDのみを選択します。

  5. [Add] をクリックします。

グループ クレームを追加する方法の詳細については、Azureドキュメント を参照してください。

3
  1. [Add optional claim] をクリックします。

  2. Add optional claimモーダルで、 Accessを選択します。

  3. メールなど、MongoDB アクセス ログで参照できるユーザー識別子を含むクレームを選択します。

    UPNクレームを使用して、メール アドレスを持つユーザーを識別できます。

  4. [Add] をクリックします。

  5. Microsoft Graph Permissionsノートで、[] ボックスをオンにし、[ Addをクリックします。

詳しくは、Azure のドキュメント を参照してください。

4
  1. 左側のナビゲーションの Manage セクションで、Manifest をクリックします。

  2. nullから2にrequestedAccessTokenVersionを更新します。

    数字2は Microsoft のアクセス トークンのバージョン 2 を表します。 他のアプリケーションは、Active Directory が管理するユーザーの ID の署名された認証局としてこれを使用できます。 バージョン 2 では、トークンはJSON web token MongoDBが理解する であることが保証されます。

  3. [Save] をクリックします。

オプションのクレームを追加する方法の詳細については、Azure のドキュメント を参照してください。

5
  1. 左側のナビゲーションで [ Overview ] をクリックします。

    Application (client) ID値をコピーします。

  2. 上部のナビゲーションで、 Endpointsをクリックします。

    /.well-known/openid-configuration部分を除いてOpenID Connect metadata document値をコピーします。

    この値は、OpenID Connect metadata document URLで issuer の値をコピーすることで取得することもできます。

次の表は、これらのMicrosoft Entra ID UI の値がMongoDBoidcIdentityProviders パラメーターにマップされる内容を示しています。

Microsoft Entra ID UI
MongoDB oidcIdentityProviders パラメーター フィールド

Application (client) ID

clientID
audience

OpenID Connect metadata document (without /.well-known/openid-configuration)

issuer