你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
使用 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 扩展快速浏览策略文件。
先决条件
必须在计算机中安装 Visual Studio Code (VS Code)。
自定义策略文件,例如在使用 Azure AD B2C 自定义策略验证用户输入中使用的文件。
注意
本文是《在 Azure Active Directory B2C 中创建和运行自己的自定义策略操作指南系列教程》的一部分。 建议从第一篇文章开始本系列教程。
使用 TrustFrameworkPolicy 架构
TrustFrameworkPolicy 架构是一种自定义策略 XML 架构,可用于验证策略文件:
在 VS Code 编辑器中安装 Red Hat 的 XML 扩展支持
按照排查策略有效性问题中的步骤设置 VS Code 编辑器的 fileAssociations。 这些说明还包括验证策略文件的过程。
使用 Azure AD B2C 扩展
使用 Azure AD B2C 扩展可以轻松了解策略文件的组织。 例如,自定义策略资源管理器允许查看所使用的自定义策略元素并快速移动到这些元素。
在 VS Code 编辑器中安装 Azure AD B2C 扩展
按照 Azure AD B2C 扩展中提供的指南了解如何使用 Azure AD B2C 扩展。
注意
社区已开发适用于 Azure AD B2C 的 VS Code 扩展来帮助标识开发人员。 Microsoft 不支持此扩展,它严格按原样提供。
后续步骤
接下来,了解: