クレームスキーマ

ClaimsSchema要素は、ポリシーの一部として参照可能な要求の種類を定義します。 要求スキーマは、要求を宣言する場所です。 要求は、名、姓、表示名、電話番号などを指定できます。 ClaimsSchema 要素にはClaimType要素の一覧が含まれています。 ClaimType要素に Id属性が含まれており、 それは要求の名前であります。

<BuildingBlocks>
  <ClaimsSchema>
    <ClaimType Id="Id">
      <DisplayName>Surname</DisplayName>
      <DataType>string</DataType>
      <DefaultPartnerClaimTypes>
        <Protocol Name="OAuth2" PartnerClaimType="family_name" />
        <Protocol Name="OpenIdConnect" PartnerClaimType="family_name" />
        <Protocol Name="SAML2" PartnerClaimType="http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname" />
      </DefaultPartnerClaimTypes>
      <UserHelpText>Your surname (also known as family name or last name).</UserHelpText>
      <UserInputType>TextBox</UserInputType>

クレームタイプ

ClaimType 要素には、次の属性が含まれています。

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

データ型

DataType 要素は次の値をサポートします。

DefaultPartnerClaimTypes (デフォルトパートナークレームタイプ)

DefaultPartnerClaimTypesには次の要素が含まれることがあります。

Protocol 要素には、次の属性が含まれています。

次の例で、Identity Experience Framework は SAML2 id プロバイダーまたは証明書利用者アプリケーションと相互作用するときに、 surname要求がhttp://schemas.xmlsoap.org/ws/2005/05/identity/claims/surnameにマップされ、OpenIdConnect と OAuth2 とともに、要求は、family_nameにマップされます。

<ClaimType Id="surname">
  <DisplayName>Surname</DisplayName>
  <DataType>string</DataType>
  <DefaultPartnerClaimTypes>
    <Protocol Name="OAuth2" PartnerClaimType="family_name" />
    <Protocol Name="OpenIdConnect" PartnerClaimType="family_name" />
    <Protocol Name="SAML2" PartnerClaimType="http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname" />
  </DefaultPartnerClaimTypes>
</ClaimType>

その結果、Azure AD B2C によって発行された JWT は、ClaimType 名family_nameではなくを出力します。

{
  "sub": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
  "auth_time": 1535013501,
  "given_name": "David",
  "family_name": "Williams",
  "name": "David Williams",
}

マスク

マスク 要素には、次の属性が含まれています。

次の例では PhoneNumber 要求を Simple マスクで構成します。 その他のサンプルについては、要求の簡単なマスクに関するライブ デモをご覧ください。

<ClaimType Id="PhoneNumber">
  <DisplayName>Phone Number</DisplayName>
  <DataType>string</DataType>
  <Mask Type="Simple">XXX-XXX-</Mask>
  <UserHelpText>Your telephone number.</UserHelpText>
</ClaimType>

Identity Experience Framework では、最初の 6 桁の数字を非表示し、電話番号を表示します。

次の例では AlternateEmail 要求を Regex マスクで構成します。 その他のサンプルについては、Regex マスクに関するライブ デモをご覧ください。

<ClaimType Id="AlternateEmail">
  <DisplayName>Please verify the secondary email linked to your account</DisplayName>
  <DataType>string</DataType>
  <Mask Type="Regex" Regex="(?&lt;=.).(?=.*@)">*</Mask>
  <UserInputType>Readonly</UserInputType>
</ClaimType>

Identity Experience Framework では、電子メールアドレスと電子メールのドメイン名の最初の文字のみを表示します。

制限

制限要素は、次の属性を含めることがあります。

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

列挙

Enumeration 要素は、ユーザーが要求についてユーザー インターフェイスで選択可能なオプション (CheckboxMultiSelect、DropdownSingleSelect、または RadioSingleSelect の値など) を定義します。 または、LocalizedCollections 要素を使用して、使用可能なオプションを定義してローカライズすることもできます。 要求 Enumeration コレクションから項目を検索するには、GetMappedValueFromLocalizedCollection 要求変換を使用します。

列挙型要素には、次の属性が含まれています。

次の例では、市区町村のドロップダウン リストの要求を設定し、既定値を New York に設定します。 その他のサンプルについては、要求の制限リストに関するライブ デモをご覧ください。

<ClaimType Id="city">
  <DisplayName>city where you work</DisplayName>
  <DataType>string</DataType>
  <UserInputType>DropdownSingleSelect</UserInputType>
  <Restriction>
    <Enumeration Text="Bellevue" Value="bellevue" SelectByDefault="false" />
    <Enumeration Text="Redmond" Value="redmond" SelectByDefault="false" />
    <Enumeration Text="New York" Value="new-york" SelectByDefault="true" />
  </Restriction>
</ClaimType>

既定値は、ニューヨークに設定されている市区町村ドロップダウン リスト。

パターン

パターン要素には、次の属性が含まれることがあります。

次の例では、電子メール要求を正規表現入力検証とヘルプ テキストとともに設定します。

<ClaimType Id="email">
  <DisplayName>Email Address</DisplayName>
  <DataType>string</DataType>
  <DefaultPartnerClaimTypes>
  <Protocol Name="OpenIdConnect" PartnerClaimType="email" />
  </DefaultPartnerClaimTypes>
  <UserHelpText>Email address that can be used to contact you.</UserHelpText>
  <UserInputType>TextBox</UserInputType>
  <Restriction>
    <Pattern RegularExpression="^[a-zA-Z0-9.+!#$%&amp;'+^_`{}~-]+(?:\.[a-zA-Z0-9!#$%&amp;'+^_`{}~-]+)*@(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?\.)+[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$" HelpText="Please enter a valid email address." />
  </Restriction>
</ClaimType>

Identity Experience Framework は、電子メールの入力検証の形式を表示します。

ユーザー入力タイプ

Azure AD B2C では、さまざまなクレームの種類の要求データを手動で入力するときに使用できるテキスト ボックス、パスワード、およびドロップダウン リストなど、ユーザー入力の種類をサポートしています。 セルフ アサートの技術プロファイルおよび表示コントロールを使用してユーザーから情報を収集する時に UserInputType を指定する必要があります。

ユーザー入力の種類に関するライブ デモをご覧ください。

UserInputType 要素で使用できるユーザー入力の種類:

テキストボックス

TextBoxユーザー入力の種類が 1 行のテキスト ボックスを表示するために使用します。

<ClaimType Id="displayName">
  <DisplayName>Display Name</DisplayName>
  <DataType>string</DataType>
  <UserHelpText>Your display name.</UserHelpText>
  <UserInputType>TextBox</UserInputType>
</ClaimType>

メールボックス

EmailBoxユーザー入力の種類が基本的な電子メールの入力フィールドを提供するために使用します。

<ClaimType Id="email">
  <DisplayName>Email Address</DisplayName>
  <DataType>string</DataType>
  <UserHelpText>Email address that can be used to contact you.</UserHelpText>
  <UserInputType>EmailBox</UserInputType>
  <Restriction>
    <Pattern RegularExpression="^[a-zA-Z0-9.+!#$%&amp;'+^_`{}~-]+(?:\.[a-zA-Z0-9!#$%&amp;'+^_`{}~-]+)*@(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?\.)+[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$" HelpText="Please enter a valid email address." />
  </Restriction>
</ClaimType>

パスワード

パスワードユーザー入力の種類は、ユーザーが入力したパスワードを記録するために使用します。

<ClaimType Id="password">
  <DisplayName>Password</DisplayName>
  <DataType>string</DataType>
  <UserHelpText>Enter password</UserHelpText>
  <UserInputType>Password</UserInputType>
</ClaimType>

日時ドロップダウン

DateTimeDropdownユーザー入力の種類は、日、月、および年を選択するドロップダウン リストのセットを提供するために使用します。 述語および PredicateValidations 要素を使用すると、日付の最小値と最大値を制御できます。 詳細については、述語および PredicateValidationsの日付範囲を構成するセクションを参照してください。

<ClaimType Id="dateOfBirth">
  <DisplayName>Date Of Birth</DisplayName>
  <DataType>date</DataType>
  <UserHelpText>The date on which you were born.</UserHelpText>
  <UserInputType>DateTimeDropdown</UserInputType>
</ClaimType>

ラジオシングルセレクト

RadioSingleSelectユーザー入力の種類はユーザーが 1 つのオプションを選択できるようラジオ ボタンのコレクションを提供するために使用します。

<ClaimType Id="color">
  <DisplayName>Preferred color</DisplayName>
  <DataType>string</DataType>
  <UserInputType>RadioSingleSelect</UserInputType>
  <Restriction>
    <Enumeration Text="Blue" Value="Blue" SelectByDefault="false" />
    <Enumeration Text="Green " Value="Green" SelectByDefault="false" />
    <Enumeration Text="Orange" Value="Orange" SelectByDefault="true" />
  </Restriction>
</ClaimType>

ドロップダウンSingleSelect

DropdownSingleSelectユーザー入力の種類はユーザーが 1 つのオプションを選択できるようドロップダウンボックスを提供するために使用します。

<ClaimType Id="city">
  <DisplayName>City where you work</DisplayName>
  <DataType>string</DataType>
  <UserInputType>DropdownSingleSelect</UserInputType>
  <Restriction>
    <Enumeration Text="Bellevue" Value="bellevue" SelectByDefault="false" />
    <Enumeration Text="Redmond" Value="redmond" SelectByDefault="false" />
    <Enumeration Text="New York" Value="new-york" SelectByDefault="true" />
  </Restriction>
</ClaimType>

チェックボックス複数選択

CheckboxMultiSelectユーザー入力の種類はユーザーが 複数のオプションを選択できるようチェックボックスのコレクションを提供するために使用します。

<ClaimType Id="languages">
  <DisplayName>Languages you speak</DisplayName>
  <DataType>string</DataType>
  <UserInputType>CheckboxMultiSelect</UserInputType>
  <Restriction>
    <Enumeration Text="English" Value="English" SelectByDefault="true" />
    <Enumeration Text="France " Value="France" SelectByDefault="false" />
    <Enumeration Text="Spanish" Value="Spanish" SelectByDefault="false" />
  </Restriction>
</ClaimType>

読み取り専用

Readonlyユーザー入力の種類は、要求と値を表示する読み取り専用フィールドを提供するために使用します。

<ClaimType Id="membershipNumber">
  <DisplayName>Membership number</DisplayName>
  <DataType>string</DataType>
  <UserHelpText>Your membership number (read only)</UserHelpText>
  <UserInputType>Readonly</UserInputType>
</ClaimType>

段落

段落ユーザー入力の種類は、段落タグ内のテキストだけを表示するフィールドを提供するために使用します。 たとえば、 <p>テキスト</p>。 セルフアサート技術プロファイルの段落ユーザー入力の種類 OutputClaim は、Required 属性 false (既定値) を設定する必要があります。 このユーザー入力の種類は、セルフアサート ページ レイアウトでのみサポートされます。 統合サインインページとサインアップ ページ (unifiedssp) では、これが正しく表示されない場合があります。

<ClaimType Id="responseMsg">
  <DisplayName>Error message: </DisplayName>
  <DataType>string</DataType>
  <AdminHelpText>A claim responsible for holding response messages to send to the relying party</AdminHelpText>
  <UserHelpText>A claim responsible for holding response messages to send to the relying party</UserHelpText>
  <UserInputType>Paragraph</UserInputType>
</ClaimType>