サブ体験

サブ体験を使用して、ユーザー体験内のオーケストレーション ステップのフローを整理して簡略化できます。 ユーザー体験では、証明書利用者アプリケーションがユーザーの任意の要求を取得できるようにする、ポリシーの明示的なパスを指定します。 ユーザーはこれらのパスを通じて証明書利用者に提示される要求を検索します。 つまり、ユーザー体験では、Azure AD B2C Identity Experience Framework が要求をプロセスする際に、エンド ユーザーがたどるビジネス ロジックを定義します。 ユーザー体験は、トランザクションを成功させるために従う必要のあるオーケストレーション シーケンスとして表されます。 オーケストレーション ステップの ClaimsExchange 要素は、実行される単一の技術プロファイルに関連付けられます。

サブ体験は、オーケストレーション ステップをグループ化したものであり、ユーザー体験内の任意の時点で呼び出すことができます。 サブ体験を使用して、再利用可能なステップ シーケンスを作成したり、ビジネス ロジックをもっと適切に表現する分岐を実装したりできます。

ユーザー体験の分岐

サブ体験はユーザー体験と同じように動作します。どちらも、トランザクションを成功させるために従う必要のあるオーケストレーション シーケンスとして表されます。 ユーザー体験は独自に呼び出すことができ、実行するには SendClaims ステップが必要です。 サブ体験はユーザー体験のコンポーネントであり、単独で呼び出すことはできず、常にユーザー体験から呼び出されます。

この分岐の主要コンポーネントによって、ユーザー体験でのビジネス ロジックの処理を向上させることができます。 一般的なオーケストレーション ステップが、個別に呼び出される個々のピースにグループ化されます。 サブ体験を使用すると体験が単純化され、(同じ事前条件を持つ) 複数のオーケストレーション ステップが結合されます。 サブ体験はユーザー体験からのみ呼び出され、別のサブ体験を呼び出すことはできません。

2 種類のサブ体験があります。

• 呼び出し - 呼び出し元に制御が戻ります。 サブ体験が実行された後、ユーザー体験内で現在実行中のオーケストレーション ステップに制御が返されます。
• 転送 - 制御をサブ体験に移します (不可逆分岐)。 サブ体験には、要求を証明書利用者アプリケーションに返すための SendClaims ステップが必要です。

シナリオの例

サブ体験を呼び出す

サブ体験の呼び出しは、次のシナリオで役立ちます。

• 年齢制限:年齢制限の場合、ユーザー体験で共有される多数のコンポーネントがあります。 分岐を使用して、共通の要素を共有可能なコンポーネントにまとめることができます。
• 保護者の同意:保護者の同意を得る設計の中で、分岐を便利に使用できます。小規模に実行される要求にユーザー体験からアクセスでき、ユーザーの同意が必要であることを検出した後で保護者の同意を得るユーザー体験に分岐できます。
• サインインするためのサインアップ:ユーザーが既にディレクトリに存在するが、実際にアカウントを作成したことを忘れてしまったというシナリオを考えてみましょう。 このような場合は、入力した資格情報が既に存在していることをユーザーに通知するのではなく、ポリシーによってユーザーのサインアップ フローからサインイン フローへの切り替えを実行できる体験をユーザーに再度開始させるほうが望ましい場合があります。

サブ体験を転送する

サブ体験の転送は、次のシナリオで役立ちます。

• ブロック ページの表示。
• 要求をサブ体験にルーティングして実行し、トークンを発行する A/B テスト。

サブ体験要素の追加

次に示すのは、種類が Call である SubJourney 要素の例です。ここでは制御がユーザー体験に戻ります。

<SubJourneys>
  <SubJourney Id="ConditionalAccess_Evaluation" Type="Call">
    <OrchestrationSteps>
      <OrchestrationStep Order="1" Type="ClaimsExchange">
       <ClaimsExchanges>
        <ClaimsExchange Id="ConditionalAccessEvaluation" TechnicalProfileReferenceId="ConditionalAccessEvaluation" />
       </ClaimsExchanges>
      </OrchestrationStep>
      <OrchestrationStep Order="2" Type="ClaimsExchange">
        <Preconditions>
          <Precondition Type="ClaimsExist" ExecuteActionsIf="false">
            <Value>conditionalAccessClaimCollection</Value>
            <Action>SkipThisOrchestrationStep</Action>
          </Precondition>
        </Preconditions>
        <ClaimsExchanges>
          <ClaimsExchange Id="GenerateCAClaimFlags" TechnicalProfileReferenceId="GenerateCAClaimFlags" />
        </ClaimsExchanges>
      </OrchestrationStep>
    </OrchestrationSteps>
  </SubJourney>
</SubJourneys>

次に示すのは、種類が Transfer である SubJourney 要素の例です。ここでは、トークンが証明書利用者アプリケーションに戻ります。

<SubJourneys>
  <SubJourney Id="B" Type="Transfer">
    <OrchestrationSteps>
      ...
      <OrchestrationStep Order="5" Type="SendClaims">
    </OrchestrationSteps>
  </SubJourney>
</SubJourneys>

サブ体験のステップを呼び出す

サブ体験は、InvokeSubJourney 型の新しいオーケストレーション ステップを使用して実行されます。 次に示すのは、このオーケストレーション ステップのすべての実行要素を表示する例です。

<OrchestrationStep Order="5" Type="InvokeSubJourney">
  <JourneyList>
    <Candidate SubJourneyReferenceId="ConditionalAccess_Evaluation" />
  </JourneyList>
</OrchestrationStep>

コンポーネント

ポリシーでサポートされるサブ体験を定義するには、ポリシー ファイルの最上位の要素の下にSubJourneys 要素を追加します。

SubJourneys 要素には、次の要素が含まれています。

SubJourneys 要素には、次の属性が含まれます。

SubJourney 要素には、次の要素が含まれます。

OrchestrationSteps

オーケストレーション ステップの要素の完全な一覧については、「UserJourneys」を参照してください。

次のステップ

UserJourneys の詳細