使用 Microsoft Entra ID 配置 TOPdesk - Public 进行单一登录

本文介绍如何将 TOPdesk - Public 与 Microsoft Entra ID 集成。 将 TOPdesk - Public 与 Microsoft Entra ID 集成后,可以:

  • 在 Microsoft Entra ID 中控制谁有权访问 TOPdesk - Public。
  • 让用户能够使用其 Microsoft Entra 帐户自动登录到 TOPdesk - Public。
  • 在中心位置管理帐户。

先决条件

本文中概述的方案假定你已具备以下先决条件:

  • 启用了单一登录 (SSO) 的 TOPdesk - Public 订阅。

方案描述

本文中,您将在测试环境中配置和测试 Microsoft Entra 的单一登录功能。

  • TOPdesk - Public 支持 SP 发起的 SSO。

要配置 TOPdesk - Public 与 Microsoft Entra ID 的集成,需要从库中将 TOPdesk - Public 添加到托管 SaaS 应用列表。

  1. 以至少云应用程序管理员身份登录到 Microsoft Entra 管理中心
  2. 请导航到 Entra ID>企业应用>新应用
  3. 在“从库中添加”部分的搜索框中,键入“TOPdesk - Public” 。
  4. 从结果面板中选择“TOPdesk - Public”,然后添加该应用。 在该应用添加到租户时等待几秒钟。

或者,也可以使用 企业应用配置向导。 在此向导中,还可以将应用程序添加到租户、将用户/组添加到应用、分配角色以及演练 SSO 配置。 深入了解Microsoft 365 助手。

配置并测试 TOPdesk - Public 的 Microsoft Entra SSO

使用名为 B.Simon 的测试用户,配置和测试 Microsoft Entra SSO 与 TOPdesk - Public 的集成。 若要使 SSO 正常工作,需要在 Microsoft Entra 用户与 TOPdesk - Public 中的相关用户之间建立关联。

若要配置并测试 TOPdesk - Public 的 Microsoft Entra SSO,请执行以下步骤:

  1. 配置 Microsoft Entra SSO - 使用户能够使用此功能。
    1. 创建 Microsoft Entra 测试用户 - 使用 B.Simon 测试 Microsoft Entra 单一登录。
    2. 分配 Microsoft Entra 测试用户 - 使 B.Simon 能够使用 Microsoft Entra 单一登录。
  2. 配置 TOPdesk - Public SSO - 以在应用程序端配置单一登录设置。
    1. 创建 TOPdesk - Public 测试用户 - 创建一个在 TOPdesk - Public 中与 B.Simon 对应的用户,该用户与 Microsoft Entra 用户表示相关联。
  3. 测试 SSO - 验证配置是否正常工作。

配置 Microsoft Entra SSO

按照以下步骤启用 Microsoft Entra SSO。

  1. 以至少云应用程序管理员身份登录到 Microsoft Entra 管理中心

  2. 浏览到 Entra ID>企业应用>TOPdesk - Public>单点登录

  3. 在“选择单一登录方法”页上选择“SAML” 。

  4. “使用 SAML 设置单一登录 ”页上,选择 基本 SAML 配置的 铅笔图标以编辑设置。

    编辑基本 SAML 配置

  5. “基本 SAML 配置 ”部分中,如果有 服务提供程序元数据文件,请执行以下步骤:

    注意

    可以从“配置 TOPdesk - 公共单一登录”部分获取服务提供程序元数据文件,本文稍后将对此进行介绍。

    a。 选择“上传元数据文件”

    上传元数据文件

    b. 选择 文件夹徽标 以选择元数据文件,然后选择“ 上传”。

    选择元数据文件

    选项c. 成功上传元数据文件后,“标识符”和“回复 URL”值会自动填充在“基本 SAML 配置”部分。

    d。 在“登录 URL” 文本框中,使用以下模式键入 URL:

    e。 在“标识符 URL”文本框中,填写可从 TOPdesk 配置中检索的 TOPdesk 元数据 URL。 它应使用以下模式:https://<companyname>.topdesk.net/saml-metadata/<identifier>

    f。 在 “回复 URL ”文本框中,使用以下模式键入 URL: https://<companyname>.topdesk.net/tas/public/login/verify

    注意

    如果未自动填充 标识符回复 URL 值,则需要手动输入它们。 对于标识符,请遵循上述模式,并从“ 配置 TOPdesk - 公共单一登录 ”部分获取回复 URL 值,本文稍后将对此进行介绍。 登录 URL 值不是实际值,因此需要用实际的 Sign-On URL 来更新该值。 请联系 TOPdesk - Public 客户端支持团队 获取该值。 还可参考“基本 SAML 配置”部分中显示的模式。

  6. 在“设置 SAML 单一登录”页的“SAML 签名证书”部分,选择“下载”以根据要求下载从给定选项提供的“联合元数据 XML”并将其保存在计算机上

    证书下载链接

  7. 在“设置 TOPdesk - Public”部分中,根据要求复制相应的 URL

    复制配置 URL

创建和分配 Microsoft Entra 测试用户

请按照创建和分配用户帐户快速入门中的指南,创建一个名为 B.Simon 的测试用户帐户。

配置 TOPdesk - Public SSO

  1. 以管理员身份登录到 TOPdesk - Public 公司站点。

  2. TOPdesk 菜单中,选择 “设置”。

    设置

  3. 选择“登录设置”。

    登录设置

  4. 展开 “登录设置” 菜单,然后选择“ 常规”。

    常规设置

  5. “SAML 登录配置”部分的“公共”部分中,执行以下步骤:

    技术设置

    a。 选择 “下载” 以下载公共元数据文件,然后将其保存在计算机本地。

    b. 打开下载的元数据文件,然后找到 AssertionConsumerService 节点。

    AssertionConsumerService

    选项c. 复制 AssertionConsumerService 值,将此值粘贴到“基本 SAML 配置”部分中的“回复 URL”文本框中。

  6. 若要创建证书文件,请执行以下步骤:

    证书

    a。 在 Azure 门户中打开下载的元数据文件。

    b. 展开具有 xsi:typefed:ApplicationServiceTypeRoleDescriptor 节点。

    选项c. 复制 X509Certificate 节点的值。

    d。 将复制的 X509Certificate 值保存在计算机上的本地文件中。

  7. “公共 ”部分中,选择“ 添加”。

    SAML 登录

  8. “SAML 配置助手 ”对话框页上,执行以下步骤:

    SAML 配置助手

    a。 若要从 Azure 门户上传下载的元数据文件,请在 “联合元数据”下选择“ 浏览”。

    b. 若要上传证书文件,请在 “证书”(RSA)下选择“ 浏览”。

    选项c. 若要上传从 TOPdesk 支持团队获取的徽标文件,请在 “徽标”图标下选择“ 浏览”。

    d。 在“用户名属性”文本框中,键入 http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress

    e。 在 “显示名称 ”文本框中,键入配置的名称。

    f。 选择“ 保存”。

创建 TOPdesk - Public 测试用户

要使 Microsoft Entra 用户能够登录 TOPdesk - Public,必须将这些用户预配到 TOPdesk - Public 中。 对于 TOPdesk - Public,预配是一项手动任务。

若要配置用户设置,请执行以下步骤:

  1. 以管理员身份登录到 TOPdesk - 公共 公司站点。

  2. 在顶部菜单中,选择 “TOPdesk>New>Support Files>Person”。

    人员

  3. 在“新建用户”对话框中,执行以下步骤:

    新建人员

    a。 选择“常规”选项卡。

    b. 在“姓氏”文本框中,键入用户的姓氏(如 Simon)

    选项c. 选择帐户的站点

    d。 选择“ 保存”。

注意

可使用任何其他 TOPdesk - Public 用户帐户创建工具或 TOPdesk - Public 提供的 API 来预配 Microsoft Entra 用户帐户。

测试 SSO

在本部分,你将使用以下选项测试 Microsoft Entra 单一登录配置。

  • 选择“ 测试此应用程序”,此选项将重定向到 TOPdesk - 公共登录 URL,可在其中启动登录流。

  • 直接转到 TOPdesk - Public 登录 URL,并从此处启动登录流。

  • 你可使用 Microsoft 的“我的应用”。 在“我的应用”中选择 TOPdesk - Public 磁贴时,此选项将重定向到 TOPdesk - Public 登录 URL。 有关“我的应用”的详细信息,请参阅 “我的应用简介”。

配置 TOPdesk - Public 后,就可强制实施会话控制,实时防止组织的敏感数据外泄和渗透。 会话控制从条件访问扩展而来。 了解如何使用 Microsoft Defender for Cloud Apps 强制实施会话控制