本指南介绍如何使用 PingOne 作为您的身份提供程序配置员工身份联合。
将 PingOne 与 Atlas 集成后,您的员工可以使用其 PingOne 凭证,访问 Atlas 集群,并采用 OIDC 身份验证。
必需的访问权限
如需管理联合身份验证,必须拥有 Organization Owner 访问权限,能够访问一个或多个将联合设置委托给实例的组织。
先决条件
要将 PingOne 用作 Atlas 的IdP ,您必须拥有:
步骤
在如下过程中,为您的 Atlas 联合管理控制台和 PingOne 帐户分别打开一个浏览器标签页会很有帮助。
将 PingOne 配置为身份提供者
使用 PingOne 管理控制台将 PingOne 配置为 OIDC 身份提供程序 。
在 PingOne 中创建一个应用程序。
在 PingOne 管理控制台中,请移步: Applications > My Applications > OIDC。
单击 Add Application(连接)。
选择 Native App,然后单击 Next。
要了解更多信息,请参阅添加或更新 OIDC 应用程序。
在 Atlas 中配置 Workforce Identity Federation
注意
先决条件
此过程要求您拥有 访问权限,并假定您已经在 身份提供程序Organization Owner 中创建 OIDC 应用程序。要了解如何配置 身份提供程序,请参阅 配置 PingOne 作为身份提供程序。
要在Atlas中配置劳动力身份提供程序,请执行以下操作:
输入以下劳动力身份提供商协议设置。
设置 | 必要性 | 值 |
|---|---|---|
Configuration Name | 必需 | 标识此配置的人类可读标签。 此标签对Atlas用户可见。 |
Configuration Description | Optional | 描述此配置的人类可读标签。 |
Issuer URI | 必需 | 所注册的 IdP 应用程序提供的发行者值。使用此 URI,MongoDB 会找到 OpenID 提供商配置文档,该文档应当 |
Client ID | 必需 | 已注册应用程序的唯一标识符。 输入您在外部身份提供程序中注册的应用的 |
Audience | 必需 | 外部身份提供商打算为其提供令牌的实体。 输入您在外部身份提供程序中注册的应用的 |
Requested Scopes | Optional | 授予用户从授权端点请求数据权限的令牌。 如果计划支持刷新令牌,则此字段必须包含值 对于要添加的每个附加作用域,请单击 Add more scopes(添加更多作用域)。 |
Authorization Type | 必需 | 选择 Group Membership 以根据 身份提供程序 用户组成员身份授予授权,或选择 User ID 以授予单个用户授权。 |
Customize Groups Claim | 必需 | 包含主体的 `身份提供程序` 用户群组成员信息的声明的标识符。接受默认值,除非您的 身份提供程序 使用不同的声明,或者您需要自定义声明。该字段仅在您选择 Group Membership 时才需要填写。 默认值: |
Customize User Claim | 必需 | 包含用户主体身份的声明的标识符。 接受默认值,除非IdP使用不同的声明。 默认值: |
使用劳动力身份验证添加数据库用户
AtlasGoDatabase & Network Access在Atlas中,Go项目的 页面。
如果尚未显示,请从导航栏上的 Organizations 菜单中选择包含项目的组织。
如果尚未显示,请从导航栏的 Projects 菜单中选择您的项目。
在侧边栏中,单击 Security 标题下的 Database & Network Access。
完成上述步骤后,将显示数据库和网络访问页面。
打开 Add New Database User or Group(添加新的数据库用户)对话框。
单击 Add New Database User or Group(添加新的数据库用户)。
注意
在将 Workforce IdP 应用到 Atlas 之前,此按钮显示 Add New Database User。
选择 Federated Auth(Atlas SQL)。
在 Authentication Method 部分,选择 Federated Auth。
注意
在为组织启用 Workforce IdP 之前,您无法选中此复选框。
分配用户或群组权限。
要向新用户或群组分配权限,请执行以下一项或多项任务:
从 Built-in Role 下拉菜单中,选择一个内置角色。
您可以在 Atlas 用户界面中为每个数据库组选择一个内置角色。
如果删除默认选项,则可以单击Add Built-in Role选择新的内置角色。
选择或添加自定义角色。
如果您定义了任何自定义角色,则可以展开Custom Roles部分,然后从Custom Roles下拉菜单中选择一个或多个角色。
单击Add Custom Role以添加更多自定义角色。
单击Custom Roles链接可查看项目的自定义角色。
添加权限。
展开Specific Privileges部分,然后从Specific Privileges下拉菜单中选择一个或多个权限。
单击Add Specific Privilege可添加更多权限。 这将为群组分配对各个数据库和集合的特定权限。
删除已应用的角色或特权。
- 单击Delete旁边
- 要删除的角色或特权。
注意
如果只选择了一个选项,Atlas 不会在 Built-in Role(内置角色)、Custom Role(自定义角色)或 Specific Privilege(特定权限)选项旁边显示 Delete(删除)图标。应用了其他角色或权限后,就可以删除选定的角色或权限。
Atlas 可以将一个内置角色、多个自定义角色和多个特定权限应用到 数据库群组。
要了解有关授权的更多信息,请参阅 MongoDB 手册中的基于角色的访问控制和内置角色。
使用 Workforce Identity Federation 将客户端连接到MongoDB
下面列出了使用 Workforce Identity Federation身份验证将客户端连接到MongoDB 的方法:
Compass v1.38 +
MongoDB Shell v2.1.4+
注意
如果配置了设备授权流,则在与mongosh连接时必须传递 --oidcFlows=device-auth 标志。示例:
mongosh "<connection-string>" \ --authenticationMechanism MONGODB-OIDC \ --oidcFlows=device-auth