Overview
OIDC Workload Identity Federation を使用して、オートメーション、モニタリング、バックアップを含むMongoDB Agent をMongoDB配置で認証するように構成できます。 OIDC を使用すると、エージェントは有効期間が長いデータベース認証情報の代わりに、ID プロバイダー( IdP )からの有効期間が短いトークンを使用します。エージェントは、有効期限が切れる前にこれらのトークンを自動的に更新します。
このチュートリアルでは、次の方法について説明します。
MongoDB Ops Manager でMongoDBデプロイの OIDC認証を有効にします。
OIDC IdP 構成を登録します。
OIDC 接続を使用するようにMongoDB Agent を構成します。
Considerations
元に戻すことができない認証方法
Workload Federation 用のMongoDB Agent を構成した後は、ローカル認証に戻すことはできません。
トークンリフレッシュ
MongoDB Agent は、有効期限が切れる前に OIDC トークンを自動的に更新します。トークンの有効期間は IdP 構成によって異なり、通常5 から60 分の範囲です。
共有エージェントの構成
OIDC 構成は、オートメーション、モニタリング、バックアップなどのすべてのエージェント機能に適用されます。各機能を個別に設定することはありません。
前提条件
MongoDB Agent を OIDC認証用に構成する 前に、 MongoDBデプロイの OIDC Workload Identity Federation を有効にします。詳しくは、 OAuth を使用して Workload Identity Federation を設定する2.0 を参照してください。
手順
MongoDBエージェントの OIDC認証を構成するには次のようにします。
OIDC ID プロバイダー構成を追加します。
OIDC Connection and Authorizationセクションで、 + OIDC IdP Configurationをクリックします。
OIDC Protocol Settingsウィンドウで、Workload Identity Federation を選択します。
IdP の詳細を入力します。
フィールド説明Configuration Name
Ops Manager 内のこの IdP 構成を識別するプレフィックス。
Issuer URI
アクセス トークンを発行する IdP の URI 。
Audience
audIdP が発行する JWT 内の クレームに一致する必要があります。Authorization Method
IdP 設定に基づいて、 または を選択します。User IDGroup Membership
Customize User Claim
ユーザーを識別するクレーム。デフォルトは
subです。[Save Configuration] をクリックします。
配置へのエージェント接続を構成します。
MongoDB Agent Connections to Deploymentセクションで、[Workload Federation] を選択します。
重要
Workload Federation を使用して配置した後は、 MongoDB Agent をローカル認証に戻すことはできません。
エージェント認証の詳細を入力します。
フィールド説明OIDC IdP Configuration
MongoDB Agent が認証に使用する IdP 構成。前の手順で作成した構成を選択します。
User Identifier
ユーザー プリンシパル クレームの値。 MongoDB Ops Manager はMongoDBユーザーを
[configuration name]/[user identifier]として作成します。Authentication Method
エージェントの IdP 接続の認証方法。 OktaClient Credentials などの標準 IdP 統合には を選択し、Built-in AzureまたはGCPのクラウドネイティブワークロードID には を選択します。
Client ID
エージェントに割り当てられた OAuth 2.0クライアントID 。 Client Credentials を使用する場合は必須です。
Client Secret
エージェントに割り当てられた OAuth 2.0クライアントシークレット。 Client Credentials を使用する場合は必須です。
Tip
IdP がAzureやGCPなどのクラウドネイティブワークロードIDBuilt-in を使用する場合は、 を選択します。Client ID またはClient Secret を指定する必要はありません。
[Save Settings] をクリックします。
ダウンタイムなしでエージェント認証情報をローテーション
MongoDB Agent を再起動せずにエージェントの OIDCクライアントシークレットをローテーションする方法は、次のとおりです。