本文介绍如何将 Gra-Pe 与 Microsoft Entra ID 集成。 将 Gra-Pe 与 Microsoft Entra ID 相集成可提供以下优势：
- 可以在 Microsoft Entra ID 中控制谁有权访问 Gra-Pe。
- 可让用户使用其 Microsoft Entra 帐户自动登录到 Gra-Pe（单一登录）。
- 可以在一个中心位置管理帐户。
若要详细了解 SaaS 应用与 Microsoft Entra ID 的集成，请参阅 什么是应用程序访问和Microsoft Entra ID 的单一登录。 如果没有 Azure 订阅，请在开始之前创建一个免费帐户。
先决条件
本文中概述的方案假定你已具备以下先决条件：
- 启用了 Gra-Pe 单一登录的订阅
方案说明
本文中，您将在测试环境中配置和测试 Microsoft Entra 的单一登录功能。
- Gra-Pe 支持 SP 发起的 SSO
从库中添加 Gra-Pe
若要配置 Gra-Pe 与 Microsoft Entra 的集成，需要从库中将 Gra-Pe 添加到托管 SaaS 应用列表。
若要从库中添加 Gra-Pe，请执行以下步骤：
至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。
请导航到 Entra ID>企业应用>新应用。
在搜索框中，键入 Gra-Pe，在结果面板中选择 Gra-Pe ，然后选择“ 添加 ”按钮添加该应用程序。
配置和测试 Microsoft Entra 单一登录
在本部分中，基于一个名为“Britta Simon”的测试用户使用 Gra-Pe 配置和测试 Microsoft Entra 单一登录。 若要运行单一登录，需要在 Microsoft Entra 用户与 Gra-Pe 相关用户之间建立链接关系。
若要配置和测试 Gra-Pe 的 Microsoft Entra 单一登录，需要完成以下构建基块：
- 配置 Microsoft Entra 单一登录 - 使用户能够使用此功能。
- 配置 Gra-Pe 单一登录 - 在应用程序端配置单一登录。
- 创建 Microsoft Entra 测试用户 - 测试 Britta Simon 的 Microsoft Entra 单一登录。
- 分配 Microsoft Entra 测试用户 - 使 Britta Simon 能够使用 Microsoft Entra 单一登录。
- 创建 Gra-Pe 测试用户 - 创建一个与 Microsoft Entra 中用户表示形式关联的 Britta Simon 的对应用户并放置在 Gra-Pe 中。
- 测试单一登录 - 验证配置是否正常工作。
配置 Microsoft Entra 单一登录
在本部分中，将启用 Microsoft Entra 单一登录。
若要配置 Gra-Pe 的 Microsoft Entra 单一登录，请执行以下步骤：
至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。
浏览到 Entra ID>Enterprise 应用>Gra-Pe 应用程序集成页，选择 “单一登录”。
在 “选择单一登录方法 ”对话框中，选择 SAML/WS-Fed 模式以启用单一登录。
在“使用 SAML 设置单一 Sign-On”页面上，选择编辑 图标以打开“基本 SAML 配置”对话框。
在 “基本 SAML 配置 ”部分中，执行以下步骤：
在“登录 URL”文本框中，键入 URL：
在“使用 SAML 设置单一登录”页的“SAML 签名证书”部分中，选择“下载”以根据要求从给定的选项下载“证书(Base64)”，并将其保存在计算机上。
在“设置 Gra-Pe”部分中，根据要求复制相应的 URL。
a。 登录网址
b. Microsoft Entra 标识符
选项c. 登出 URL
配置 Gra-Pe 单一登录
若要在 Gra-Pe 端配置单一登录，需要将下载的证书 (Base64) 以及从应用程序配置复制的相应 URL 发送给 Gra-Pe 支持团队。 他们进行此设置以确保在两端均正确配置 SAML SSO 连接。
创建 Microsoft Entra 测试用户
本部分的目的是创建名为 Britta Simon 的测试用户。
- 至少以用户管理员身份登录到 Microsoft Entra 管理中心。
- 浏览到 Entra ID>用户页面。
- 选择屏幕顶部的“ 新建用户>创建新用户”。
- 在“用户”属性中执行以下步骤：
- 在“显示名称”字段中输入 。
- 在“用户主体名称”字段中，输入 。 例如，
B.Simon@contoso.com。 - 选中“显示密码”复选框，然后记下“密码”框中显示的值。
- 选择“查看 + 创建”。
- 选择 创建。
分配 Microsoft Entra 测试用户
在本部分中，通过向 Britta Simon 授予 Gra-Pe 的访问权限支持她使用 Azure 单一登录。
至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。
浏览到 Entra ID>企业应用>Gra-Pe。
在应用程序列表中，选择“Gra-Pe”。
在应用的概述页中，选择“用户和组”。
选择“添加用户/组”，然后在“添加分配”对话框中选择“用户和组”。
- 在“ 用户和组 ”对话框中，从“用户”列表中选择 B.Simon ，然后选择屏幕底部的 “选择 ”按钮。
- 如果希望将角色分配给用户，可以从 “选择角色 ”下拉列表中选择该角色。 如果未为此应用设置任何角色，则会看到已选择“默认访问”角色。
- 在“添加分配”对话框中，选择“分配”按钮 。
创建 Gra-Pe 测试用户
在本部分中，将在 Gra-Pe 中创建一个名为“Britta Simon”的用户。 请与 Gra-Pe 支持团队协作，将用户添加到 Gra-Pe 平台中。 在使用单一登录之前，必须先创建和激活用户。
测试单一登录
在本部分中，将使用访问面板测试 Microsoft Entra 单一登录配置。
在访问面板中选择 Gra-Pe 磁贴时，您应自动登录到为其设置了 SSO 的 Gra-Pe。 有关访问面板的详细信息，请参阅访问面板 简介。