ソーシャル アカウント要求変換

  • [アーティクル]

Azure Active Directory B2C (Azure AD B2C) では、ソーシャル アカウント ID は、alternativeSecurityIdCollection 要求の種類の alternativeSecurityIds 属性に格納されます。 alternativeSecurityIdCollection の各項目では、発行者 (ID プロバイダー名、facebook.com など) や issuerUserId (発行者の一意のユーザー識別子) を指定します。

"alternativeSecurityIds": [{
    "issuer": "google.com",
    "issuerUserId": "MTA4MTQ2MDgyOTI3MDUyNTYzMjcw"
  },
  {
    "issuer": "facebook.com",
    "issuerUserId": "MTIzNDU="
  }]

この記事では、Azure AD B2C の Identity Experience Framework スキーマのソーシャル アカウント要求変換の使用例を示します。 詳細については、「ClaimsTransformations」を参照してください。

AddItemToAlternativeSecurityIdCollection

AlternativeSecurityId を alternativeSecurityIdCollection 要求に追加します。 この要求変換のライブ デモをご覧ください。

要素 TransformationClaimType データ型 Notes
InputClaim 要素 string 出力要求に追加される要求。
InputClaim collection alternativeSecurityIdCollection 要求変換で使用される要求 (ポリシーで使用可能な場合)。 指定されている場合は、要求変換によってコレクションの最後に item が追加されます。
OutputClaim collection alternativeSecurityIdCollection この要求変換が呼び出された後に生成される要求。 入力 collection と item の両方の項目を含む新しいコレクション。

AddItemToAlternativeSecurityIdCollection の例

次の例では、新しいソーシャル ID と既存のアカウントをリンクしています。 新しいソーシャル ID をリンクするには:

  1. AAD-UserReadUsingAlternativeSecurityId および AAD-UserReadUsingObjectId 技術プロファイルで、ユーザーの alternativeSecurityIds 要求を出力します。
  2. このユーザーに関連付けられていない ID プロバイダーのいずれかを使用してサインインするように、ユーザーに依頼します。
  3. CreateAlternativeSecurityId 要求変換を使用して、新しい alternativeSecurityId 要求の種類を AlternativeSecurityId2 という名前で作成します。
  4. AddItemToAlternativeSecurityIdCollection 要求変換を呼び出して、既存の AlternativeSecurityIds 要求に AlternativeSecurityId2 要求を追加します。
  5. ユーザー アカウントに alternativeSecurityIds 要求を保持します。
<ClaimsTransformation Id="AddAnotherAlternativeSecurityId" TransformationMethod="AddItemToAlternativeSecurityIdCollection">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="AlternativeSecurityId2" TransformationClaimType="item" />
    <InputClaim ClaimTypeReferenceId="AlternativeSecurityIds" TransformationClaimType="collection" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="AlternativeSecurityIds" TransformationClaimType="collection" />
  </OutputClaims>
</ClaimsTransformation>

  • 入力要求:

    • 項目:

      {
    "issuer": "facebook.com",
    "issuerUserId": "MTIzNDU="
}

    • コレクション:

      [
    {
        "issuer": "live.com",
        "issuerUserId": "MTA4MTQ2MDgyOTI3MDUyNTYzMjcw"
    }
]

  • 出力要求:

    • コレクション:

      [
    {
        "issuer": "live.com",
        "issuerUserId": "MTA4MTQ2MDgyOTI3MDUyNTYzMjcw"
    },
    {
        "issuer": "facebook.com",
        "issuerUserId": "MTIzNDU="
    }
]

CreateAlternativeSecurityId

Microsoft Entra ID の呼び出しで使用できる、ユーザーの alternativeSecurityId プロパティの JSON 表現を作成します。 この要求変換のライブ デモをご覧ください。 詳細については、「AlternativeSecurityIdのスキーマ」を参照してください。

要素 TransformationClaimType データ型 Notes
InputClaim key string ソーシャル ID プロバイダーによって使われる一意のユーザー識別子を指定する要求。
InputClaim identityProvider string ソーシャル アカウント ID プロバイダー名 (facebook.com など) を指定する要求。
OutputClaim alternativeSecurityId string 要求変換が呼び出された後に生成される要求。 ソーシャル アカウント ユーザーの ID に関する情報が含まれています。 issuer は、identityProvider 要求の値です。 issuerUserId は、base64 形式の key 要求の値です。

CreateAlternativeSecurityId の例

この要求変換を使用して alternativeSecurityId 要求 を生成します。 これは、すべてのソーシャル ID プロバイダー技術プロファイル (Facebook-OAUTH など) によって使用されます。 次の要求変換は、ユーザー ソーシャル アカウント ID と ID プロバイダー名を受け取ります。 この技術プロファイルの出力は、Microsoft Entra ディレクトリ サービスで使用できる JSON 文字列形式です。

<ClaimsTransformation Id="CreateAlternativeSecurityId" TransformationMethod="CreateAlternativeSecurityId">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="issuerUserId" TransformationClaimType="key" />
    <InputClaim ClaimTypeReferenceId="identityProvider" TransformationClaimType="identityProvider" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="alternativeSecurityId" TransformationClaimType="alternativeSecurityId" />
  </OutputClaims>
</ClaimsTransformation>
  • 入力要求:
    • key: 12334
    • identityProvider: Facebook.com
  • 出力要求:
    • alternativeSecurityId: { "issuer": "facebook.com", "issuerUserId": "MTA4MTQ2MDgyOTI3MDUyNTYzMjcw"}

GetIdentityProvidersFromAlternativeSecurityIdCollectionTransformation

発行者の一覧を alternativeSecurityIdCollection 要求から新しい stringCollection 要求に返します。 この要求変換のライブ デモをご覧ください。

要素 TransformationClaimType データ型 Notes
InputClaim alternativeSecurityIdCollection alternativeSecurityIdCollection ID プロバイダー (発行者) の一覧を取得するために使用される要求。
OutputClaim identityProvidersCollection stringCollection この要求変換が呼び出された後に生成される要求。 入力要求に関連付けられている ID プロバイダーの一覧。

GetIdentityProvidersFromAlternativeSecurityIdCollectionTransformation の例

次の要求は、ユーザー alternativeSecurityIds 要求を読み取り、そのアカウントに関連付けられている ID プロバイダー名の一覧を抽出します。 出力 identityProvidersCollection を使用して、アカウントに関連付けられている ID プロバイダーの一覧をユーザーに表示します。 または、ID プロバイダー選択ページで、出力 identityProvidersCollection 要求に基づいて ID プロバイダーの一覧をフィルター処理します。 このようにして、ユーザーは、まだアカウントに関連付けられていない新しいソーシャル ID をリンクすることを選択できます。

<ClaimsTransformation Id="ExtractIdentityProviders" TransformationMethod="GetIdentityProvidersFromAlternativeSecurityIdCollectionTransformation">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="alternativeSecurityIds" TransformationClaimType="alternativeSecurityIdCollection" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="identityProviders" TransformationClaimType="identityProvidersCollection" />
  </OutputClaims>
</ClaimsTransformation>

  • 入力要求:

    • alternativeSecurityIdCollection:

      [
    {
        "issuer": "google.com",
        "issuerUserId": "MTA4MTQ2MDgyOTI3MDUyNTYzMjcw"
    },
    {
        "issuer": "facebook.com",
        "issuerUserId": "MTIzNDU="
    }
]

  • 出力要求:

    • identityProvidersCollection: [ "facebook.com", "google.com" ]

RemoveAlternativeSecurityIdByIdentityProvider

AlternativeSecurityId を alternativeSecurityIdCollection 要求から削除します。 この要求変換のライブ デモをご覧ください。

要素 TransformationClaimType データ型 Notes
InputClaim identityProvider string コレクションから削除する ID プロバイダー名を含む要求。
InputClaim collection alternativeSecurityIdCollection 要求変換で使用される要求。 要求変換により、コレクションから identityProvider が削除されます。
OutputClaim collection alternativeSecurityIdCollection この要求変換が呼び出された後に生成される要求。 コレクションから identityProvider が削除された の後の、新しいコレクション。

RemoveAlternativeSecurityIdByIdentityProvider の例

次の例では、ソーシャル ID と既存のアカウントの 1 つとのリンクを解除します。 ソーシャル ID のリンクを解除するには:

  1. AAD-UserReadUsingAlternativeSecurityId および AAD-UserReadUsingObjectId 技術プロファイルで、ユーザーの alternativeSecurityIds 要求を出力します。
  2. このユーザーに関連付けられている ID プロバイダーの一覧から削除するソーシャル アカウントを選択するように、ユーザーに依頼します。
  3. ID プロバイダー名を使用して、選択したソーシャル ID を削除した、RemoveAlternativeSecurityIdByIdentityProvider 要求変換を呼び出す、要求変換技術プロファイルを呼び出します。
  4. ユーザー アカウントに alternativeSecurityIds 要求を保持します。
<ClaimsTransformation Id="RemoveAlternativeSecurityIdByIdentityProvider" TransformationMethod="RemoveAlternativeSecurityIdByIdentityProvider">
    <InputClaims>
        <InputClaim ClaimTypeReferenceId="secondIdentityProvider" TransformationClaimType="identityProvider" />
        <InputClaim ClaimTypeReferenceId="AlternativeSecurityIds" TransformationClaimType="collection" />
    </InputClaims>
    <OutputClaims>
        <OutputClaim ClaimTypeReferenceId="AlternativeSecurityIds" TransformationClaimType="collection" />
    </OutputClaims>
</ClaimsTransformation>
</ClaimsTransformations>
  • 入力要求:
    • identityProvider: facebook.com
    • collection: [ { "issuer": "live.com", "issuerUserId": "MTA4MTQ2MDgyOTI3MDUyNTYzMjcw" }, { "issuer": "facebook.com", "issuerUserId": "MTIzNDU=" } ]
  • 出力要求:
    • collection: [ { "issuer": "live.com", "issuerUserId": "MTA4MTQ2MDgyOTI3MDUyNTYzMjcw" } ]

次の手順

  • その他の要求変換のサンプルについては、Azure AD B2C コミュニティの GitHub リポジトリをご覧ください