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

在编辑或编写自定义策略文件时,可以通过在上传文件之前对其进行验证来提高工作效率。 可以让 Azure Active Directory B2C (Azure AD B2C) 在上传 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 不支持此扩展,它严格按原样提供。

后续步骤

接下来,了解: