TrustFrameworkPolicy スキーマを使用してカスタム ポリシー ファイルを検証する

カスタム ポリシー ファイルをアップロードする前に検証することで、カスタム ポリシー ファイルを編集または書き込む際の生産性を向上させることができます。 アップロード時に Azure Active Directory B2C (Azure AD B2C) に XML ポリシー ファイルを検証させることができますが、ほとんどのエラーでアップロードが失敗します。 そのため、アップロードする前にカスタム ポリシー ファイルを検証することをお勧めします。 無効なポリシー ファイルの例は、不適切な形式の XML です。

Visual Studio Code (VS Code) などの優れた XML エディターを使用することが不可欠です。 RED Hat による XML 言語サポートなどの XML 拡張機能をインストールできるため、VS Code を使用することをお勧めします。 優れた 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 カスタム ポリシーを使ってユーザー入力を検証する」で使われるようなカスタム ポリシー ファイル。

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 カスタム ポリシーのトラブルシューティングの方法。

• Azure AD B2C カスタム ポリシーを使用して REST API を呼び出す方法。