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 拡張機能を使用して、ポリシー ファイルをすばやく移動する。

前提条件

Note

この記事は、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 拡張機能に関する記事のガイダンスに従ってください。

Note

コミュニティでは、ID 開発者を支援するために、Azure AD B2C 用の VS Code 拡張機能が開発されました。 Microsoft はこの拡張機能をサポートしておらず、厳密に現状のまま利用可能です。

次のステップ

次は、以下を学びます。