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 構成は、オートメーション、モニタリング、バックアップなどのすべてのエージェント機能に適用されます。各機能を個別に設定することはありません。
前提条件
Before you configure the MongoDB Agent for OIDC authentication, enable OIDC Workload Identity Federation for your MongoDB deployment. To learn more, see Set up Workload Identity Federation with OAuth 2.0.
手順
MongoDBエージェントの OIDC認証を構成するには次のようにします。
OIDC ID プロバイダー構成を追加します。
OIDC Connection and Authorizationセクションで、 + OIDC IdP Configurationをクリックします。
OIDC Protocol Settingsウィンドウで、Workload Identity Federation を選択します。
IdP の詳細を入力します。
フィールド説明Configuration NameOps Manager 内のこの IdP 構成を識別するプレフィックス。
Issuer URIアクセス トークンを発行する IdP の URI 。
AudienceIdP が発行する JWT 内の
audクレームに一致する必要があります。Authorization MethodIdP 設定に基づいて、User ID または Group Membership を選択します。
Customize User Claimユーザーを識別するクレーム。デフォルトは
subです。[Save Configuration] をクリックします。
配置へのエージェント接続を構成します。
MongoDB Agent Connections to Deploymentセクションで、[Workload Federation] を選択します。
重要
Workload Federation を使用して配置した後は、 MongoDB Agent をローカル認証に戻すことはできません。
エージェント認証の詳細を入力します。
フィールド説明OIDC IdP ConfigurationMongoDB Agent が認証に使用する IdP 構成。前の手順で作成した構成を選択します。
User Identifierユーザー プリンシパル クレームの値。MongoDB Ops Manager はMongoDBユーザーを
[configuration name]/[user identifier]として作成します。Authentication Methodエージェントの IdP 接続の認証方法。 Okta などの標準 IdP 統合には Client Credentials を選択し、 AzureまたはGCP上のクラウドネイティブワークロードID には Built-in を選択します。
Client IDエージェントに割り当てられた OAuth 2.0クライアントID 。Client Credentials を使用する場合は必須です。
Client Secretエージェントに割り当てられた OAuth 2.0クライアントシークレット。Client Credentials を使用する場合は必須です。
Tip
IdP がAzureやGCPなどのクラウドネイティブワークロードID を使用する場合は、 Built-in を選択します。 Client ID または Client Secret を指定する必要はありません。
[Save Settings] をクリックします。
ダウンタイムなしでエージェント認証情報をローテーション
MongoDB Agent を再起動せずにエージェントの OIDCクライアントシークレットをローテーションする方法は、次のとおりです。