对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。
Docs 菜单

为 OIDC 身份验证配置MongoDB 助手

您可以配置MongoDB 助手(包括自动化、监控和备份),使用 OIDC Workload Identity Federation 对MongoDB部署进行身份验证。通过 OIDC,代理使用来自身份提供程序 (IdP) 的短期令牌,而不是长期数据库凭证。代理在这些令牌过期前自动对其进行刷新。

本教程介绍如何:

  • 在Ops Manager中为MongoDB 部署启用 OIDC身份验证。

  • 注册 OIDC IdP 配置。

  • 配置MongoDB 助手以使用 OIDC 连接。

为工作负载联合配置MongoDB 助手后,无法恢复为本地身份验证。

MongoDB 助手在 OIDC 令牌过期前自动对其进行刷新。令牌生命周期取决于 IdP 配置,通常范围5 到 60 分钟。

OIDC 配置适用于所有代理功能:自动化、监控和备份。您无需单独配置每个函数。

在为 OIDC身份验证配置MongoDB 助手之前,请为MongoDB 部署启用OIDC 工作负载联合身份。要学习;了解详情,请参阅使用 OAuth 2 设置 Workload Identity Federation。0

要为MongoDB 助手配置 OIDC身份验证,请执行以下操作:

1

在Ops Manager中,转到您的项目。在左侧导航栏中,依次单击 Deployment 和 Security,然后选择 Settings标签页。

注意

如果您尚未为项目配置安全性,则会出现横幅,提示您设立网络加密、身份验证和授权。单击 Get Started访问权限设置。

2

在 MongoDB Deployment Authentication Mechanism 部分,选择 Federated Auth (OIDC)。

3
  1. 在 OIDC Connection and Authorization 部分中,单击 + OIDC IdP Configuration。

  2. 在 OIDC Protocol Settings窗口中,选择 Workload Identity Federation。

  3. 输入 IdP 详细信息:

    字段
    说明
    Configuration Name

    在Ops Manager中标识此 IdP 配置的前缀。

    Issuer URI

    颁发访问权限令牌的 IdP 的 URI。

    Audience

    必须与 IdP 发出的 JWT 中的 aud 声明一致。

    Authorization Method

    根据您的 IdP设置,选择 User ID 或 Group Membership。

    Customize User Claim

    用于标识用户身份的声明。默认为 sub。

  4. 单击 Save Configuration(连接)。

4
  1. 在 MongoDB Agent Connections to Deployment 部分,选择 Workload Federation。

    重要

    使用工作负载联合部署后,无法将MongoDB 助手恢复为本地身份验证。

  2. 输入代理身份验证详细信息:

    字段
    说明
    OIDC IdP Configuration

    MongoDB 助手用于身份验证的 IdP 配置。选择您在上一步中创建的配置。

    User Identifier

    用户主体声明值。Ops Manager将MongoDB用户创建为 [configuration name]/[user identifier]。

    Authentication Method

    代理 IdP 连接的身份验证方法。为标准 IdP 集成(例如 Okta)选择 Client Credentials,为Azure或GCP上的云原生工作负载身份选择 Built-in。

    Client ID

    分配给代理的OAuth 2.0客户端ID 。使用 Client Credentials 时必需。

    Client Secret

    分配给代理的 OAuth 2.0客户端密钥。使用 Client Credentials 时必需。

    提示

    如果您的 IdP 使用云原生工作负载身份,例如Azure或GCP,请选择 Built-in。您无需提供 Client ID 或 Client Secret。

  3. 单击 Save Settings(连接)。

5
  1. 在 Review Your Changes 模式中,查看部署差异。确认差异显示 Auth Mechanisms: MONGODB-OIDC 以及 Auth 下的工作负载联合详细信息。

  2. 确认部署。

Ops Manager应用更改后, MongoDB 助手会自动接收更新的配置,并从 IdP 获取其初始 OIDC 令牌。代理无需重启即可过渡到 OIDC身份验证。

要在不重新启动MongoDB 助手的情况下轮换助手的 OIDC客户端密钥,请执行以下操作:

1

在 IdP 中,打开用于此部署的OAuth/OIDC应用程序并生成新的客户端密钥。先不要撤销现有密钥。

2
  1. 在Ops Manager中,转到您的项目。单击 Deployment、Security,然后选择 Settings标签页。

  2. 在 MongoDB Agent Connections to Deployment 下,选择 Workload Federation 。

  3. 在 Client Secret 中输入新密钥,然后单击 Save Settings。

  4. 查看并确认部署。

3
4