使用 Entra ID 配置 SCIM 预配（Entra ID 以前称为 Azure AD）

设置好单点登录（SSO）后， 您可以通过 Udemy Business 在 Entra ID（ 以前称为 Azure AD）中为 Udemy 配置跨域身份管理 (SCIM 2.0) 预配。您还可以参考 Microsoft 自己的有关使用 Entra ID 进行 SCIM 预配的预配指南，以获取进一步的指导。

SCIM 预配允许您在 Entra ID 中预配、取消预配、创建群组、管理群组成员、管理许可证和更改用户个人资料详细信息（如姓名和电子邮件地址），这会自动更新 Udemy Business。您将不再需要使用这些操作分别更新 Entra ID 和 Udemy Business，因为它们都将在 Entra ID 中同步。

请注意：

  • 必须在激活 SCIM 之前启用 SSO
  • 单点登录和预配适用于 Udemy Business Enterprise 方案客户。
  • 通过 Entra ID 预配的用户在首次登录 Udemy Business 应用之前不会获得许可证。
  • SCIM 预配更改只能从 Entra ID 同步到 Udemy Business，反之则不行。
  • 在 Udemy Business 应用中，无法在 Entra ID 中更改由 SCIM 管理的用户和群组，SCIM 是用户和群组数据的唯一真实来源。
  • 如果您有不需要或不想从 Entra ID 推送的用户（如承包商或临时员工），仍然可以在 Udemy Business 中手动创建群组。
  • 注意：Udemy Business 的 SCIM API 令牌有效期约为两年。管理员将收一则通知，告知他们：
    • 令牌到期前 30 天
    • 令牌到期后

目录

使用 Entra ID 配置 SCIM 预配

1. 在 Udemy Business 帐户中，转至管理 > 设置 > 预配 (SCIM)。

2. 单击开始设置，选择 Azure，然后单击生成令牌。系统会显示一个秘密令牌（持有者令牌），您需要将其输入到 Entra ID 中。

3. 访问您的 Entra ID 帐户，转到 Udemy Business SSO 应用程序，然后转到 Entra ID 门户中的预配选项卡。

4. 在预配模式屏幕中，单击新配置。

1c.png

5. 在管理员凭据部分：

选择身份验证方法：持有者身份验证
租户 URL 为：https://domain.udemy.com/scim/v2（将“domain”替换为您的 Udemy Business 帐户的 URL）
秘密令牌：这是您在第 2 步在 Udemy 门户中生成的持有者令牌。

6. 单击测试连接以检查是否正常运行。如果成功，请单击创建。

7. 保存连接后，转到左侧选项卡中的属性 映射。我们将更新“用户属性映射”。

Azure provisioning map.png

 

进入后，您应能看到属性映射列表

支持的属性

请确认以下必需的属性已添加到 customerappsso 属性中，因为 SCIM 预配在 Udemy 中运行需要这些字段。

SCIM 属性 是否必填？ 描述 
emails[type eq "work"].value
 是 用户的电子邮件。必须唯一 
userName
 是 IdP 的用户名。必须唯一。 
active
 是 标记停用/重新激活用户 
externalId
 是 IdP 用户的外部 ID。必须唯一。 
urn:ietf:params:scim:schemas:extension: enterprise:2.0:User:employeeNumber
 是 从 EnterpriseSchema 返回 employeeNumber 字段并将其存储为 external_id 字段。应与您要发送到 externalId 的属性匹配。 
name.givenName
 否 用户的名字。虽然这不是必填属性，但我们建议始终指定这些属性，因为这样便于轻松识别用户。 
name.familyName
 否 用户的姓氏。虽然这不是必填属性，但我们建议始终指定这些属性，因为这样便于轻松识别用户。 
name, { givenName, familyName }
 否 用户的名字和姓氏。虽然这不是必填属性，但我们建议始终指定这些属性，因为这样便于轻松识别用户。 
title
 否 用户的职称，例如“高级工程师”。 
urn:ietf:params:scim:schemas:extension: udemy:2.0:User:licensePoolName
 否 许可证池名称。 
urn:ietf:params:scim:schemas:extension: udemy:2.0:User:licenseTypes
 否 许可证类型的逗号分隔列表。查看可接受的值。 
urn:ietf:params:scim:schemas: extension:udemy:2.0:User:lmsUserID

否

 “LMS 用户 ID”值通常用作 LMS 连接的主要标识符 
urn:ietf:params:scim:schemas:extension: enterprise:2.0:User:costCenter

否

 用于标识用户成本中心的名称或代码。 
urn:ietf:params:scim:schemas:extension: enterprise:2.0:User:organization

否

 用户所属组织的名称。 
urn:ietf:params:scim:schemas:extension: enterprise:2.0:User:department

否

 用户所属部门的名称。 
urn:ietf:params:scim:schemas:extension: enterprise:2.0:User:division

否

 用户所属分部的名称。

8. 确保 emails[type eq "work"].value 的 Microsoft Entra ID 属性与您在 SSO 电子邮件属性和声明中配置的值一致。（例如 mail 或 userPrincipalName）

Azure Email.png

9. 确认属性 Switch([IsSoftDeleted], , "False", "True", "True", "False") 已映射到 active，以允许停用要传递的用户。

Azure Actuve.png

10. 添加属性后，请更新匹配优先级，使 emails[type eq "work"].value 设置为 1。您可能必须先转到 userName 并将该值更新为 2 或 3。

match pre updated.png

要为某个属性设置“匹配优先级”，请选择该属性，然后启用“使用此属性匹配对象”。

matching precedence (1).png

11. 返回到用户属性映射，然后单击高级选项。选择编辑 customappsso 用户属性，并为 id 和 userName 启用区分大小写。

12. 返回预配概览选项卡，然后选择开始预配。

start provi.png

 

13. 单击用户和群组。

users_and_groups.png

14. 单击添加用户，可用于选择添加用户和群组。

选择要添加到应用的所有用户或群组，然后单击选择。

Add_assignment.png

故障排除

对于预配用户时出现的任何错误，您可以通过查看预配日志来查看更多详细信息。

  • 要获取此日志，请在 Azure 上转到 Udemy 应用 > 预配 > 预配日志 > 搜索受影响的用户 > 故障排除和建议。
  • 如果需要，打开支持工单并提供 Azure 预配日志的屏幕截图，以便我们查看失败的原因。

相关文章

联系我们