教程：将 Appraisd 与 Microsoft Entra ID 相集成

  • 项目

本教程介绍如何将 Appraisd 与 Microsoft Entra ID 相集成。 将 Appraisd 与 Microsoft Entra ID 集成后，可以：

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

先决条件

若要开始操作，需备齐以下项目：

  • 一个 Microsoft Entra 订阅。 如果你没有订阅，可以获取一个免费帐户。
  • 启用了 Appraisd 单一登录 (SSO) 的订阅。

方案描述

在本教程中，将在测试环境中配置并测试 Microsoft Entra SSO。

  • Appraisd 支持 SP 和 IDP 发起的 SSO。

若要配置 Appraisd 与 Microsoft Entra ID 的集成，需要从库中将 Appraisd 添加到托管 SaaS 应用列表。

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

或者，也可以使用企业应用配置向导。 在此向导中，可以将应用程序添加到租户、将用户/组添加到应用、分配角色，以及逐步完成 SSO 配置。 详细了解 Microsoft 365 向导。

配置并测试 Appraisd 的 Microsoft Entra SSO

使用名为“B.Simon”的测试用户配置并测试 Appraisd 的 Microsoft Entra SSO。 若要使 SSO 正常工作，需要在 Microsoft Entra 用户与 Appraisd 中的相关用户之间建立关联。

若要配置并测试 Appraisd 的 Microsoft Entra SSO，请执行以下步骤：

  1. 配置 Microsoft Entra SSO - 使用户能够使用此功能。
    1. 创建 Microsoft Entra 测试用户 - 使用 B.Simon 测试 Microsoft Entra 单一登录。
    2. 分配 Microsoft Entra 测试用户 - 使 B.Simon 能够使用 Microsoft Entra 单一登录。
  2. 配置 Appraisd SSO - 在应用程序端配置单一登录设置。
    1. 创建 Appraisd 测试用户 - 在 Appraisd 中创建 B. Simon 的对应用户，并将其关联到该用户的 Microsoft Entra 表示形式。
  3. 测试 SSO - 验证配置是否正常工作。

配置 Microsoft Entra SSO

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

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

  2. 浏览到“标识”>“应用程序”>“企业应用程序”>“Appraisd”应用程序集成页，找到“管理”部分，然后选择“单一登录”。

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

  4. 在“设置 SAML 单一登录”页面上，单击“基本 SAML 配置”旁边的铅笔图标以编辑设置 。

    Edit Basic SAML Configuration

  5. 在基本 SAML 配置 部分，应用程序进行了预配置，且已通过 Azure 预填充了必要的 URL。 用户需要单击“保存”按钮来保存配置，并执行以下步骤：

    a. 单击“设置其他 URL” 。

    b. 在“中继状态”文本框中键入值 <TENANTCODE>

    c. 如果要在 SP 发起的模式下配置应用程序，请在“登录 URL”文本框中使用以下模式键入一个 URL：https://app.appraisd.com/saml/<TENANTCODE>

    注意

    在本教程稍后将介绍的“Appraisd SSO 配置”页面上，你获取了实际的登录 URL 和中继状态值。

  6. Appraisd 应用程序需要特定格式的 SAML 断言，这要求向“SAML 令牌属性”配置添加自定义属性映射。 以下屏幕截图显示了默认属性的列表，其中的 nameidentifier 通过 user.userprincipalname 进行映射。 Appraisd 应用程序要求通过 user.mail 对 nameidentifier 进行映射，因此需单击“编辑”图标对属性映射进行编辑，然后更改属性映射。

    Screenshot shows the User Attributes pane with the edit icon highlighted.

  7. 在“设置 SAML 单一登录”页的“SAML 签名证书”部分中，找到“证书(Base64)”，选择“下载”以下载该证书并将其保存到计算机上 。

    The Certificate download link

  8. 在“设置 Appraisd”部分，根据要求复制相应的 URL。

    Copy configuration URLs

创建 Microsoft Entra 测试用户

在本部分中，你将创建名为 B.Simon 的测试用户。

  1. 至少以用户管理员身份登录到 Microsoft Entra 管理中心。
  2. 浏览到“标识”>“用户”>“所有用户”。
  3. 选择屏幕顶部的“新建用户”>“创建新用户”。
  4. 在“用户”属性中执行以下步骤：
    1. 在“显示名称”字段中输入 B.Simon。
    2. 在“用户主体名称”字段中，输入 username@companydomain.extension。 例如 B.Simon@contoso.com。
    3. 选中“显示密码”复选框，然后记下“密码”框中显示的值。
    4. 选择“查看 + 创建”。
  5. 选择“创建”。

分配 Microsoft Entra 测试用户

在本部分中，通过授予 B. Simon 访问 Appraisd 的权限，允许她使用 Azure 单一登录。

  1. 至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。
  2. 浏览到“标识”>“应用程序”>“企业应用程序”>“Appraisd”。
  3. 在应用的概述页中，找到“管理”部分，选择“用户和组” 。
  4. 选择“添加用户”，然后在“添加分配”对话框中选择“用户和组”。
  5. 在“用户和组”对话框中，选择“用户”列表中的“B. Simon”，然后单击屏幕底部的“选择”按钮 。
  6. 如果在 SAML 断言中需要任何角色值，请在“选择角色”对话框的列表中为用户选择合适的角色，然后单击屏幕底部的“选择”按钮。
  7. 在“添加分配”对话框中，单击“分配”按钮。

配置 Appraisd SSO

  1. 在其他 Web 浏览器窗口中，以管理员身份登录 Appraisd 公司站点

  2. 在页面的右上角，单击“设置”图标，然后导航到“配置” 。

    Screenshot shows the Configuration link called out.

  3. 从菜单的左侧，单击“SAML 单一登录” 。

    Screenshot shows the Configuration options with the SAML single sign-on option highlighted.

  4. 在“SAML 2.0 单一登录配置”页面上，执行以下步骤 ：

    Screenshot shows the SAML 2.0 Single Sign-On configuration page where you can edit the Default Relay State and Service-initiated login U R L.

    a. 复制“默认中继状态”值，并将其粘贴到 Azure 门户的“基本 SAML 配置”中的“中继状态”文本框 。

    b. 复制“服务发起的登录 URL”值，并将其粘贴到 Azure 门户的“基本 SAML 配置”中的“登录 URL”文本框 。

  5. 在同一页面上向下滚动，在“标识用户”下执行以下步骤 ：

    Screenshot shows Identifying users where you can enter values from this step.

    a. 在“标识提供者单一登录 URL”文本框中，粘贴已复制的“登录 URL”值，然后单击“保存”。

    b. 在“标识提供者证书颁发者 URL”文本框中，粘贴已复制的“Microsoft Entra 标识符”值，然后单击“保存”。

    c. 在记事本中，打开下载的 base-64 编码证书，复制其内容，然后将其粘贴到“X.509 证书”框中并单击“保存”。

创建 Appraisd 测试用户

必须将 Microsoft Entra 用户预配到 Appraisd 中，然后他们才能登录到 Appraisd。 在 Appraisd 中，预配是一项手动任务。

若要预配用户帐户，请执行以下步骤：

  1. 以安全管理员身份登录到 Appraisd。

  2. 在页面的右上角，单击“设置”图标，然后导航到“管理中心” 。

    Screenshot shows the Settings options where you can select Administration center.

  3. 在页面顶部的工具栏中，单击“人员”，再导航到“添加新用户” 。

    Screenshot shows the Appraisd page with People and Add a new user called out.

  4. 在“添加新用户”页面上，执行以下步骤 ：

    Screenshot shows the Add a new user page.

    a. 在“名字”文本框中，输入用户的名字，例如 Britta 。

    b. 在“姓氏”文本框中，输入用户的姓氏，例如 simon 。

    c. 在“电子邮件”文本框中，输入用户的电子邮件，如 B. Simon@contoso.com。

    d. 单击“添加用户” 。

测试 SSO

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

SP 启动的：

  • 单击“测试此应用程序”，这会重定向到 Appraisd 登录 URL，可以从这里启动登录流。

  • 直接转到 Appraisd 登录 URL，并从此处启动登录流。

IDP 启动的：

  • 单击“测试此应用程序”，应会自动登录到已设置了 SSO 的 Appraisd。

还可以使用 Microsoft“我的应用”在任何模式下测试此应用程序。 单击“我的应用”中的“Appraisd”磁贴时，如果该应用程序是在 SP 模式下配置的，则会重定向到应用程序登录页来启动登录流；如果是在 IDP 模式下配置的，则会自动登录到为其设置了 SSO 的 Appraisd。 有关“我的应用”的详细信息，请参阅“我的应用”简介。

后续步骤

配置 Appraisd 后，即可强制实施会话控制，实时防止组织的敏感数据发生外泄和渗透。 会话控制从条件访问扩展而来。 了解如何通过 Microsoft Defender for Cloud Apps 强制实施会话控制。