通过

注册 Microsoft Entra 应用并创建服务主体

  • 项目

在本文中，你将了解如何创建可以与基于角色的访问控制 (RBAC) 配合使用的 Microsoft Entra 应用程序和服务主体。 在 Microsoft Entra ID 中注册新应用程序时，系统会自动为应用注册创建服务主体。 服务主体是应用在 Microsoft Entra 租户中的标识。 资源访问权限受分配给服务主体的角色限制，可用于控制哪些资源可以访问以及在哪个级别进行访问。 出于安全原因，始终建议将服务主体与自动化工具配合使用，而不是允许它们使用用户标识进行登录。

此示例适用于在一个组织内使用的业务线应用程序。 还可以使用 Azure PowerShell 或 Azure CLI 来创建服务主体。

重要

请考虑使用 Azure 资源的托管标识作为应用程序标识，而不是创建服务主体。 如果代码在支持托管标识的服务上运行并访问支持 Microsoft Entra 身份验证的资源，则托管标识是更好的选择。 若要详细了解 Azure 资源的托管标识（包括当前支持它的服务），请参阅什么是 Azure 资源的托管标识？。

有关应用注册、应用对象和服务主体之间关系的详细信息，请参阅 Microsoft Entra ID 中的应用程序对象和服务主体对象。

先决条件

若要在 Microsoft Entra 租户中注册应用程序，需要：

  • 一个 Microsoft Entra 用户帐户。 如果还没有帐户，可以免费创建一个帐户。
  • 具有足够的权限向 Microsoft Entra 租户注册应用程序，并向应用程序分配 Azure 订阅中的角色。 若要完成这些任务，需要 Application.ReadWrite.All 权限。

向 Microsoft Entra ID 注册应用程序并创建服务主体

提示

本文中的步骤可能因开始使用的门户而略有不同。

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

  2. 浏览到“标识”>“应用程序”>“应用注册”，然后选择“新建注册”。

  3. 为应用程序命名，例如“example-app”。

  4. 在“支持的帐户类型”下，选择“仅此组织目录中的帐户” 。

  5. 在“重定向 URI”下，选择“Web”作为要创建的应用程序类型。 输入访问令牌将发送到的 URI。

  6. 选择注册。

    显示“应用程序注册”页面的屏幕截图。

向应用程序分配角色

若要访问订阅中的资源，必须将角色分配给应用程序。 判定哪个角色能为应用程序提供适当的权限。 若要了解可用角色，请参阅 Azure 内置角色。

可将作用域设置为订阅、资源组或资源级别。 较低级别的作用域会继承权限。

  1. 登录 Azure 门户。

  2. 选择要将应用程序分配到的范围级别。 例如，若要在订阅范围内分配角色，搜索并选择“订阅”。 如果未看到所需订阅，请选择“全局订阅筛选器”。 请确保已为该租户选择所需的订阅。

  3. 选择“访问控制 (IAM)”。

  4. 依次选择“+ 添加”和“添加角色分配” 。

  5. 在“角色”选项卡中，选择要分配给列表中的应用程序的角色。

  6. 选择下一步。

  7. 在“成员”选项卡上，对于“将访问权限分配到”，请选择“用户、组或服务主体”。

  8. 选择“选择成员”。 默认情况下，可用选项中不显示 Microsoft Entra 应用程序。 若要查找应用程序，请按名称搜索它。

  9. 选择“选择”按钮，然后选择“查看 + 分配”。

    显示角色分配的屏幕截图，其中突出显示了如何添加成员。

服务主体已设置完毕。 可以开始使用它运行脚本或应用。 若要管理服务主体（权限、用户同意权限、查看已同意的用户、查看权限、查看登录信息等），请访问“企业应用程序”。

下一部分演示如何获取以编程方式登录时所需的值。

登录应用程序

以编程方式登录时，请在身份验证请求中传递目录（租户）ID 和应用程序（客户端）ID。 还需要一个证书或身份验证密钥。 获取目录 ID 和应用程序 ID：

  1. 打开 Microsoft Entra 管理中心主页。
  2. 浏览到“标识”>“应用程序”>“应用注册”，然后选择应用程序。
  3. 在应用的概述页上，复制“目录(租户) ID”值并将其存储在应用程序代码中。
  4. 复制“应用程序(客户端) ID”值并将其存储在应用程序代码中。

设置身份验证

服务主体可以使用两种类型的身份验证：基于密码的身份验证（应用程序机密）和基于证书的身份验证。 建议使用证书颁发机构颁发的受信任证书，但你也可以创建应用程序机密或创建自签名证书来进行测试。

若要上传证书文件，请执行以下操作：

  1. 浏览到“标识”>“应用程序”>“应用注册”，然后选择应用程序。
  2. 选择“证书和机密”。
  3. 依次选择“证书”、“上传证书”和要上传的证书文件。
  4. 选择“添加” 。 上传证书后，将显示指纹、开始日期和到期日期值。

在应用程序注册门户中将证书注册到应用程序后，请启用机密客户端应用程序代码以使用该证书。

选项 2：仅测试：创建和上传自签名证书

（可选）可以创建自签名证书，仅限测试目的。 打开 Windows PowerShell 并使用以下参数运行 New-SelfSignedCertificate，以在计算机上的用户证书存储中创建自签名证书：

$cert=New-SelfSignedCertificate -Subject "CN=DaemonConsoleCert" -CertStoreLocation "Cert:\CurrentUser\My"  -KeyExportPolicy Exportable -KeySpec Signature

使用可从 Windows 控制面板访问的管理用户证书 MMC 管理单元将此证书导出到文件。

  1. 从“开始”菜单中选择“运行”，然后输入“certmgr.msc” 。 此时会显示当前用户的证书管理器工具。
  2. 若要查看证书，请在左窗格中的“证书 - 当前用户”下，展开“个人”目录。
  3. 右键单击创建的证书，选择“所有任务”>“导出”。
  4. 按证书导出向导的要求操作。

若要上传证书，请执行以下操作：

  1. 浏览到“标识”>“应用程序”>“应用注册”，然后选择应用程序。
  2. 选择“证书和机密”。
  3. 依次选择“证书”、“上传证书”，然后选择证书（现有证书或已导出的自签名证书）。
  4. 选择 添加 。

在应用程序注册门户中将证书注册到应用程序后，请启用机密客户端应用程序代码以使用该证书。

选项 3：创建新的客户端密码

如果选择不使用证书，则可以创建新的客户端密码。

  1. 浏览到“标识”>“应用程序”>“应用注册”，然后选择应用程序。
  2. 选择“证书和机密”。
  3. 选择“客户端密码”，然后选择“新建客户端密码”。
  4. 提供机密的说明和持续时间。
  5. 选择 添加 。

保存客户端密码后，将显示客户端密码的值。 此值仅显示一次，因此请复制此值并将其存储在应用程序可以检索它的位置，通常是应用程序保存 clientId 等值的位置，或是源代码中的 authority。 你将提供机密值以及应用程序的客户端 ID，以作为应用程序登录。

在资源上配置访问策略

你可能需要对应用程序需要访问的资源配置额外权限。 例如，你还必须更新密钥保管库的访问策略，以使应用程序能够访问密钥、机密或证书。

配置访问策略：

  1. 登录 Azure 门户。

  2. 选择自己的密钥保管库，然后选择“访问策略”。

  3. 选择“添加访问策略”，然后选择要授予应用程序的密钥、机密和证书权限。 选择之前创建的服务主体。

  4. 选择“添加”以添加访问策略，然后选择“保存”。

    添加访问策略

相关内容