在您的租户中查看和管理代理身份蓝图

通过 Microsoft Entra 管理中心,您可以查看租户中的所有代理标识蓝图主体。 可以搜索、筛选、排序和管理蓝图主体,包括其凭据、权限和所有者。

  1. 登录到 Microsoft Entra 管理中心
  2. 浏览到 Entra ID>代理程序>代理蓝图
  3. 选择蓝图主体以打开其管理页。

搜索和筛选蓝图

  1. 在搜索框中输入蓝图主体 的名称对象 ID
  2. 若要按 蓝图应用程序 ID 查找蓝图,请选择 “添加筛选器 ”并添加 蓝图应用 ID 筛选器。
  3. 可以使用基于各种条件的筛选器进一步优化列表。

选择查看选项

若要自定义视图,请选择 “选择列 ”以配置显示哪些列。 当前可用的列包括:

列名称 说明 可排序 可筛选 特殊备注
Name 代理标识蓝图主体的显示名称 主搜索字段;可单击以查看代理标识蓝图主体的详细信息
代理标识 代理蓝图主体创建的子代理标识数 选择此选项可查看该代理标识蓝图主体的链接子代理标识列表
Status 操作状态(活动或已禁用)
蓝图应用程序 ID 此代理标识蓝图主体中的代理标识蓝图的唯一标识符
对象 ID 代理蓝图主体的唯一标识符

查看链接代理标识

查看从蓝图创建的代理标识。

  1. 在蓝图的管理页中,从左侧菜单中选择 “链接代理标识 ”。
  2. 该列表显示每个链接标识及其 名称状态查看访问 链接以及 所有者和发起人
  3. 选择一个身份名称以查看其详细信息页面。
  4. 使用 “添加筛选器” 优化列表。

查看授予的权限

查看分配给蓝图主体的权限,并按同意类型进行分类。

  1. 在蓝图的管理页中,选择“访问权限”下的“已授予权限”。
  2. 选择 “管理员同意 ”选项卡以查看通过管理员同意授予的权限,或选择“ 用户同意 ”选项卡以查看通过用户同意授予的权限。
  3. 该列表显示每个权限条目的 API 名称声明值权限类型通过授予以及授予者

查看清单

若要查看或编辑代理标识蓝图的原始 JSON 清单,请从蓝图的管理页中选择“开发人员设置”下的清单

注释

清单编辑器目前处于预览状态。

管理凭据

配置代理身份标识所用的身份验证凭据。 凭据页包含三个不同凭据类型的选项卡。

蓝图凭据页的屏幕截图,其中显示了证书、客户端机密和联合凭据的三个选项卡。

Important

为了与零信任原则保持一致,请使用联合凭据或证书,而不是客户端机密。

上传证书

  1. 在蓝图的管理页中,选择“开发人员设置”下的“凭据”。
  2. 选择“ 证书 ”选项卡。
  3. 选择“上传证书”。
  4. 浏览到并选择证书文件,并选择性地添加说明。
  5. 选择 并添加

创建客户端机密

  1. 在蓝图的管理页中,选择“开发人员设置”下的“凭据”。
  2. 选择 “客户端机密 ”选项卡。
  3. 选择新建客户端密码
  4. 输入秘密描述
  5. “过期”下选择到期期限。 对于自定义过期,请设置 “开始 ”和 “结束 ”日期。
  6. 选择 并添加
  7. 立即复制机密 。 离开页面后,该值不会再次显示。

注释

租户策略可能会限制客户端机密的最大生存期。

添加联合凭据

联合凭据使用工作负荷身份联合,来在Microsoft Entra与外部标识提供者之间建立信任,而无需存储秘密信息。 有关这些方案以及工作负荷标识联合的工作原理的详细信息,请参阅 工作负荷标识联合

执行以下步骤,为代理身份蓝图主体添加一个联合身份凭证。

  1. 在蓝图的管理页中,选择“开发人员设置”下的“凭据”。
  2. 选择“ 联合凭据 ”选项卡。
  3. 选择添加凭据
  4. “联合凭据方案”下,选择一个方案:
    • 托管标识 - 配置托管标识,以跨租户获取令牌和访问资源。
    • GitHub Actions部署Azure资源 - 配置GitHub工作流以获取令牌并部署到Azure。
    • Kubernetes 访问Azure资源 - 配置 Kubernetes 服务帐户以获取令牌和访问Azure资源。
    • 其他颁发者 - 配置由外部 OpenID Connect 提供程序管理的标识。
  5. 完成所选方案的必填字段。
  6. 选择 并添加

管理所有者和赞助商

所有者和发起人有助于为蓝图建立治理。 在左侧菜单中的 “所有者和发起人 ”页中,可以管理代理蓝图和代理蓝图主体的所有权。

有关添加、删除和管理所有者与赞助商的详细步骤,请参阅 为代理身份和蓝图添加和管理所有者与赞助商

查看审核和登录日志

可以从蓝图的管理页查看代理蓝图主体和蓝图本身的日志。

代理蓝图主要活动

代理蓝图主体支持审核日志和登录日志:

  • 若要查看对蓝图主体采取的管理操作,请从代理蓝图主体活动下的左侧菜单中选择“审核日志”。
  • 若要查看蓝图主体的登录活动,请从代理蓝图主体活动下的左侧菜单中选择“登录日志”。 有关详细信息,请参阅 查看代理的登录日志

代理蓝图活动

代理蓝图仅支持审核日志:

  • 若要查看与蓝图配置相关的管理操作,请从代理蓝图活动下的左侧菜单中选择“审核日志”。

禁用代理标识蓝图主体

若要禁用代理标识蓝图主体,请选择蓝图概述页顶部命令栏中的 “禁用 ”按钮。 此时会显示一个确认对话框警告,指出从此蓝图创建的现有代理标识 将无法再进行身份验证。 确认要继续的操作。