使用 TrustFrameworkPolicy 架构验证自定义策略文件

重要

自 2025 年 5 月 1 日起,Azure AD B2C 将不再可供新客户购买。 在我们的常见问题解答中了解详细信息

可以在编辑或编写自定义策略文件时提高工作效率,方法是在上传文件之前验证文件。 可以让 Azure Active Directory B2C(Azure AD B2C)在上传 XML 策略文件时验证 XML 策略文件,但大多数错误都会导致上传失败。 因此,建议在上传自定义策略文件之前对其进行验证。 无效策略文件的一个示例是格式不正确的XML。

使用良好的 XML 编辑器(如 Visual Studio Code(VS Code)至关重要。 我们建议使用 VS Code,因为它允许你安装 XML 扩展,例如 Red Hat 的 XML 语言支持。 良好的 XML 编辑器和额外的 XML 扩展使你能够着色代码内容、预填充常用术语、使 XML 元素保持索引,并且可以根据 XML 架构进行验证。

为了验证自定义策略文件,我们提供了自定义策略 XML 架构。 可以使用链接 https://raw.githubusercontent.com/Azure-Samples/active-directory-b2c-custom-policy-starterpack/master/TrustFrameworkPolicy_0.3.0.0.xsd 下载架构,也可以使用同一链接从编辑器中引用架构。 还可以使用适用于 VS Code 的 Azure AD B2C 扩展快速浏览 Azure AD B2C 策略文件和其他许多功能。 详细了解 适用于 VS Code 的 Azure AD B2C 扩展

在这篇文章中,你将学会如何:

  • 使用自定义策略 XML 架构验证策略文件。
  • 使用适用于 VS Code 的 Azure AD B2C 扩展快速浏览策略文件。

先决条件

备注

本文是《在 Azure Active Directory B2C 中创建和运行自己的自定义策略操作指南系列教程》的一部分。 建议从第一篇文章开始本系列教程。

使用 TrustFrameworkPolicy 架构

TrustFrameworkPolicy 架构是一种自定义策略 XML 架构,可用于验证策略文件:

  1. 在 VS Code 编辑器中安装 Red Hat 支持的 XML 扩展

  2. 按照排查策略有效性问题中的步骤设置 VS Code 编辑器的 fileAssociations。 这些说明还包括验证策略文件的过程。

使用 Azure AD B2C 扩展

使用 Azure AD B2C 扩展可以轻松了解策略文件的组织。 例如,自定义策略资源管理器允许查看使用的自定义策略元素并快速移动到它们。

  1. 在 VS Code 编辑器中安装 Azure AD B2C 扩展

  2. 按照 Azure AD B2C 扩展 中提供的指南了解如何使用 Azure AD B2C 扩展。

备注

社区已为 Azure AD B2C 开发 VS Code 扩展,以帮助标识开发人员。 Microsoft 不支持此扩展,它严格按原样提供。

后续步骤

接下来,学习: