Azure Active Directory B2C での言語のカスタマイズ

[アーティクル]
05/25/2023

"開始する前に"、[ポリシーの種類の選択] セレクターを使用して、設定するポリシーの種類を選択します。 Azure Active Directory B2C には、ユーザーがアプリケーションを操作する方法を定義する 2 つの方法 (定義済みのユーザーフローを使用する、または完全に構成可能なカスタムポリシーを使用する) があります。この記事で必要な手順は、方法ごとに異なります。

Azure Active Directory B2C (Azure AD B2C) の言語のカスタマイズを使うと、顧客のニーズに応じて、ユーザーフローをさまざまな言語に対応させることができます。 Microsoft では 36 の言語の翻訳が提供されていますが、どの言語についてもユーザーが自分で翻訳を提供できます。 1 つの言語でのみページが提供されている場合でも、ページ上の任意のテキストをカスタマイズできます。

言語のカスタマイズのしくみ

ユーザーフローで利用できる言語を選ぶには、言語のカスタマイズを使います。この機能を有効にした後、アプリケーションからクエリ文字列パラメーター ui_locales を指定できます。 Azure AD B2C を呼び出すと、ページが指定したロケールに翻訳されます。この種類の構成では、ユーザーフローの言語を完全に制御し、顧客のブラウザーの言語設定を無視できます。

顧客に表示される言語をそこまで制御する必要がない場合もあります。 ui_locales パラメーターを指定しない場合、顧客のエクスペリエンスはブラウザーの設定によって決まります。その場合でも、ユーザーフローの翻訳先言語を、サポートされる言語として追加することで制御できます。サポートしない言語を表示するように顧客のブラウザーが設定されている場合は、サポートされているカルチャで既定として選択した言語が代わりに表示されます。

ui-locales で指定した言語:言語のカスタマイズを有効にすると、ユーザーフローはここで指定した言語に翻訳されます。
ブラウザーで要求されている言語:ui_locales パラメーターを指定しないと、ユーザーフローはブラウザーで要求されている言語に翻訳されます ("言語がサポートされている場合")。
ポリシーの既定の言語:ブラウザーで言語が指定されていない場合、またはサポートされていない言語が指定されている場合は、ユーザーフローはユーザーフローの既定の言語に翻訳されます。

注意

カスタムユーザー属性を使っている場合は、独自の翻訳を提供する必要があります。詳しくは、「文字列のカスタマイズ」をご覧ください。

Azure AD B2C を使用して言語をローカライズまたはカスタマイズする方法については、このビデオをご覧ください。

ローカライズには次の 3 つの手順が必要です。

サポートされている言語の明示的な一覧を設定する
言語固有の文字列とコレクションを指定する
ページのコンテンツ定義を編集する。

前提条件

ユーザーフローを作成して、ユーザーがアプリケーションにサインアップおよびサインインできるようにします。
Web アプリケーションを登録します。

「Active Directory B2C でのカスタムポリシーの概要」にある手順を完了します。
Web アプリケーションを登録します。

ui_locales で要求された言語のサポート

言語のカスタマイズの一般公開前に作成されたポリシーについては、最初に、この機能を有効にする必要があります。一般公開後に作成されたポリシーとユーザーフローでは、言語のカスタマイズは既定で有効になっています。

ユーザーフローで言語のカスタマイズを有効にした後は、ui_locales パラメーターを追加することにより、ユーザーフローの言語を制御できます。

Azure AD B2C テナントで、 [ユーザーフロー] を選択します。
翻訳を有効にするユーザーフローをクリックします。
[言語] を選択します。
[言語のカスタマイズを有効化] を選びます。

ユーザーフローで有効にする言語を選択する

ui_locales パラメーターが指定されていないブラウザーで要求された場合に、ユーザーフローで言語セットが翻訳されるように、言語セットを有効にします。

前の手順で、ユーザーフローの言語のカスタマイズを有効にしていることを確認します。
ユーザーフローの [言語] ページで、サポートする言語を選択します。
プロパティウィンドウで、 [有効] を [はい] に変更します。
プロパティウィンドウの上部にある [保存] を選びます。

注意

ui_locales パラメーターが指定されていない場合、ページは顧客のブラウザーの言語に翻訳されます (有効になっている場合のみ)。

文字列のカスタマイズ

言語のカスタマイズを使うと、ユーザーフローの文字列をカスタマイズできます。

前の手順で、ユーザーフローの言語のカスタマイズを有効にしていることを確認します。
ユーザーフローの [言語] ページで、カスタマイズする言語を選択します。
[Page-level-resources files](ページレベルリソースファイル) で、編集するページを選択します。
[既定値のダウンロード] (この言語を前に編集した場合は [オーバーライドのダウンロード] ) を選びます。

上記の手順により、文字列の編集を開始する際に使用できる JSON ファイルを入手できます。

ページ上の文字列を変更する

前の手順でダウンロードした JSON ファイルを JSON エディターで開きます。
変更する要素を探します。探している文字列の StringId を見つけるか、変更する Value 属性を見つけます。
Value 属性を表示する文字列に更新します。
変更するすべての文字列について、Override を true に変更します。
ファイルを保存し、変更内容をアップロードします。 (アップロードコントロールは、JSON ファイルをダウンロードした場所にあります)

重要

文字列をオーバーライドする必要がある場合は、必ず Override の値を true に設定してください。値が変更されていない場合、そのエントリは無視されます。

拡張属性を変更する

カスタムユーザー属性の文字列を変更する場合や、JSON に追加する場合は、次の形式を使います。

{
  "LocalizedStrings": [
    {
      "ElementType": "ClaimType",
      "ElementId": "extension_<ExtensionAttribute>",
      "StringId": "DisplayName",
      "Override": true,
      "Value": "<ExtensionAttributeValue>"
    }
    [...]
  ]
}

<ExtensionAttribute> をカスタムユーザー属性の名前に置き換えます。

<ExtensionAttributeValue> を表示する新しい文字列に置き換えます。

LocalizedCollections を使って値の一覧を提供する

応答の値セットの一覧を指定する場合は、LocalizedCollections 属性を作成する必要があります。 LocalizedCollections は、Name と Value のペアの配列です。項目の順序は、表示される順序になります。 LocalizedCollections を追加するには、次の形式を使います。

{
  "LocalizedStrings": [...],
  "LocalizedCollections": [
    {
      "ElementType":"ClaimType",
      "ElementId":"<UserAttribute>",
      "TargetCollection":"Restriction",
      "Override": true,
      "Items":[
        {
          "Name":"<Response1>",
          "Value":"<Value1>"
        },
        {
          "Name":"<Response2>",
          "Value":"<Value2>"
        }
      ]
    }
  ]
}

ElementId は、この LocalizedCollections 属性が応答になるユーザー属性です。
Name は、ユーザーに表示される値です。
Value は、このオプションが選択された場合に要求で返される値です。

変更のアップロード

JSON ファイルの変更が完了したら、B2C テナントに戻ります。
[ユーザーフロー] を選択し、翻訳を有効にするユーザーフローをクリックします。
[言語] を選択します。
翻訳する言語を選びます。
翻訳を提供するページを選びます。
フォルダーアイコンを選び、アップロードする JSON ファイルを選びます。

変更がユーザーフローに自動的に保存されます。

言語のカスタマイズを使用してページの UI をカスタマイズする

HTML コンテンツをローカライズする方法は 2 つあります。方法の 1 つは、言語のカスタマイズを有効にすることです。この機能を有効にすると、Azure AD B2C で OpenID Connect パラメーター ui-locales をエンドポイントに転送できるようになります。コンテンツサーバーは、このパラメーターを使用して、言語固有のカスタマイズされた HTML ページを提供できます。

使われているロケールに基づいて、さまざまな場所からコンテンツをプルすることもできます。 CORS 対応エンドポイントでは、特定の言語のコンテンツをホストするようにフォルダー構造を設定できます。ワイルドカード値 {Culture:RFC5646} を使うと、適切な言語が呼び出されます。たとえば、次のようなカスタムページの URI があるものとします。

https://wingtiptoysb2c.blob.core.windows.net/{Culture:RFC5646}/wingtip/unified.html

このページを fr で読み込むことができます。ページは、HTML および CSS のコンテンツを取得とき、次の場所から取得します。

https://wingtiptoysb2c.blob.core.windows.net/fr/wingtip/unified.html

カスタム言語の追加

現在 Microsoft が翻訳を提供していない言語を追加することもできます。ユーザーフロー内のすべての文字列に対して翻訳を提供する必要があります。言語およびロケールのコードは、ISO 639-1 標準にものに限られます。ロケールコードの形式は、"ISO_639-1_code"-"CountryCode" (例: en-GB) である必要があります。詳細については、ロケール ID の形式に関するページを参照してください。

Azure AD B2C テナントで、 [ユーザーフロー] を選択します。
カスタム言語を追加するユーザーフローをクリックし、 [言語] をクリックします。
ページの上部から [カスタム言語の追加] を選択します。
表示されたコンテキストウィンドウで、有効なロケールコードを入力して、翻訳を提供する言語を指定します。
ページごとに英語の一連のオーバーライドをダウンロードし、翻訳作業を行うことができます。
完了した JSON ファイルは、ページごとにアップロードできます。
[有効] を選択すると、ユーザーフローでユーザーに対してこの言語を表示できるようになります。
言語を保存します。

重要

カスタム言語を有効にするか、保存する前のオーバーライドをアップロードする必要があります。

サポートされる言語の一覧を設定する

お使いのポリシーの拡張ファイルを開きます。たとえば、「 SocialAndLocalAccounts/TrustFrameworkExtensions.xml 」のように入力します。

BuildingBlocks 要素を検索します。要素が存在しない場合は追加します。
Localization 要素を、サポートされている言語である英語 (既定) とスペイン語を指定して追加します。

<Localization Enabled="true">
  <SupportedLanguages DefaultLanguage="en" MergeBehavior="ReplaceAll">
    <SupportedLanguage>en</SupportedLanguage>
    <SupportedLanguage>es</SupportedLanguage>
  </SupportedLanguages>
</Localization>

言語固有のラベルを指定する

Localization 要素の LocalizedResources には、ローカライズされた文字列の一覧が含まれています。ローカライズされたリソース要素には、ローカライズされたリソースを一意に識別するために使用される識別子があります。この識別子は後でコンテンツ定義要素で使用されます。

ローカライズされたリソース要素は、コンテンツ定義およびサポートする任意の言語に対して設定します。英語とスペイン語の統合されたサインアップまたはサインインページをカスタマイズするには、</SupportedLanguages> 要素の後に次の LocalizedResources 要素を追加します。

注意

次の例では、各行の先頭にシャープ記号 (#) を追加したため、ローカライズされたラベルを画面上で簡単に見つけることができます。

<!--Local account sign-up or sign-in page English-->
<Localization Enabled="true">
  ...
 <LocalizedResources Id="api.signuporsignin.en">
        <LocalizedStrings>
          <LocalizedString ElementType="ClaimType" ElementId="signInName" StringId="DisplayName">Email Address</LocalizedString>
          <LocalizedString ElementType="UxElement" StringId="heading">Sign in</LocalizedString>
          <LocalizedString ElementType="UxElement" StringId="social_intro">Sign in with your social account</LocalizedString>
          <LocalizedString ElementType="UxElement" StringId="local_intro_generic">Sign in with your {0}</LocalizedString>
          <LocalizedString ElementType="ClaimType" ElementId="password" StringId="DisplayName">Password</LocalizedString>
          <LocalizedString ElementType="UxElement" StringId="requiredField_password">Please enter your password</LocalizedString>
          <LocalizedString ElementType="UxElement" StringId="requiredField_generic">Please enter your {0}</LocalizedString>
          <LocalizedString ElementType="UxElement" StringId="invalid_generic">Please enter a valid {0}</LocalizedString>
          <LocalizedString ElementType="UxElement" StringId="createaccount_one_link">Sign up now</LocalizedString>
          <LocalizedString ElementType="UxElement" StringId="createaccount_two_links">Sign up with {0} or {1}</LocalizedString>
          <LocalizedString ElementType="UxElement" StringId="createaccount_three_links">Sign up with {0}, {1}, or {2}</LocalizedString>
          <LocalizedString ElementType="UxElement" StringId="forgotpassword_link">Forgot your password?</LocalizedString>
          <LocalizedString ElementType="UxElement" StringId="button_signin">Sign in</LocalizedString>
          <LocalizedString ElementType="UxElement" StringId="divider_title">OR</LocalizedString>
          <LocalizedString ElementType="UxElement" StringId="createaccount_intro">Don't have an account?</LocalizedString>
          <LocalizedString ElementType="UxElement" StringId="unknown_error">We are having trouble signing you in. Please try again later.</LocalizedString>
          <!-- Uncomment the remember_me only if the keep me signed in is activated. 
          <LocalizedString ElementType="UxElement" StringId="remember_me">Keep me signed in</LocalizedString> -->
          <LocalizedString ElementType="ClaimsProvider" StringId="FacebookExchange">Facebook</LocalizedString>
          <LocalizedString ElementType="ErrorMessage" StringId="ResourceOwnerFlowInvalidCredentials">Your password is incorrect.</LocalizedString>
          <LocalizedString ElementType="ErrorMessage" StringId="UserMessageIfInvalidPassword">Your password is incorrect.</LocalizedString>
          <LocalizedString ElementType="ErrorMessage" StringId="UserMessageIfPasswordExpired">Your password has expired.</LocalizedString>
          <LocalizedString ElementType="ErrorMessage" StringId="UserMessageIfClaimsPrincipalDoesNotExist">We can't seem to find your account.</LocalizedString>
          <LocalizedString ElementType="ErrorMessage" StringId="UserMessageIfOldPasswordUsed">Looks like you used an old password.</LocalizedString>
          <LocalizedString ElementType="ErrorMessage" StringId="DefaultMessage">Invalid username or password.</LocalizedString>
          <LocalizedString ElementType="ErrorMessage" StringId="UserMessageIfUserAccountDisabled">Your account has been locked. Contact your support person to unlock it, then try again.</LocalizedString>
          <LocalizedString ElementType="ErrorMessage" StringId="UserMessageIfUserAccountLocked">Your account is temporarily locked to prevent unauthorized use. Try again later.</LocalizedString>
          <LocalizedString ElementType="ErrorMessage" StringId="AADRequestsThrottled">There are too many requests at this moment. Please wait for some time and try again.</LocalizedString>
        </LocalizedStrings>
      </LocalizedResources>
  <!--Local account sign-up or sign-in page Spanish-->
  <LocalizedResources Id="api.signuporsignin.es">
    <LocalizedStrings>
      <LocalizedString ElementType="UxElement" StringId="logonIdentifier_email">#Correo electrónico</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="requiredField_email">#Este campo es obligatorio</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="logonIdentifier_username">#Nombre de usuario</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="password">#Contraseña</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="createaccount_link">#Registrarse ahora</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="requiredField_username">#Escriba su nombre de usuario</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="createaccount_intro">#¿No tiene una cuenta?</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="forgotpassword_link">#¿Olvidó su contraseña?</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="divider_title">#O</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="cancel_message">#El usuario ha olvidado su contraseña</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="button_signin">#Iniciar sesión</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="social_intro">#Iniciar sesión con su cuenta de redes sociales</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="requiredField_password">#Escriba su contraseña</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="invalid_password">#La contraseña que ha escrito no está en el formato esperado.</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="local_intro_username">#Iniciar sesión con su nombre de usuario</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="local_intro_email">#Iniciar sesión con su cuenta existente</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="invalid_email">#Escriba una dirección de correo electrónico válida</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="unknown_error">#Tenemos problemas para iniciar su sesión. Vuelva a intentarlo más tarde.  </LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="email_pattern">^[a-zA-Z0-9.!#$%&amp;'^_`\{\}~\-]+@[a-zA-Z0-9\-]+(?:\.[a-zA-Z0-9\-]+)*$</LocalizedString>
      <LocalizedString ElementType="ErrorMessage" StringId="UserMessageIfInvalidPassword">#Su contraseña es incorrecta.</LocalizedString>
      <LocalizedString ElementType="ErrorMessage" StringId="UserMessageIfClaimsPrincipalDoesNotExist">#Parece que no podemos encontrar su cuenta.</LocalizedString>
      <LocalizedString ElementType="ErrorMessage" StringId="UserMessageIfOldPasswordUsed">#Parece que ha usado una contraseña antigua.</LocalizedString>
      <LocalizedString ElementType="ErrorMessage" StringId="DefaultMessage">#El nombre de usuario o la contraseña no son válidos.</LocalizedString>
      <LocalizedString ElementType="ErrorMessage" StringId="UserMessageIfUserAccountDisabled">#Se bloqueó su cuenta. Póngase en contacto con la persona responsable de soporte técnico para desbloquearla y vuelva a intentarlo.</LocalizedString>
      <LocalizedString ElementType="ErrorMessage" StringId="UserMessageIfUserAccountLocked">#Su cuenta se bloqueó temporalmente para impedir un uso no autorizado. Vuelva a intentarlo más tarde.</LocalizedString>
      <LocalizedString ElementType="ErrorMessage" StringId="AADRequestsThrottled">#Hay demasiadas solicitudes en este momento. Espere un momento y vuelva a intentarlo.</LocalizedString>
    </LocalizedStrings>
  </LocalizedResources>
  <!--Local account sign-up page English-->
  <LocalizedResources Id="api.localaccountsignup.en">
    <LocalizedStrings>
      <LocalizedString ElementType="ClaimType" ElementId="email" StringId="DisplayName">#Email Address</LocalizedString>
      <LocalizedString ElementType="ClaimType" ElementId="email" StringId="UserHelpText">#Email address that can be used to contact you.</LocalizedString>
      <LocalizedString ElementType="ClaimType" ElementId="email" StringId="PatternHelpText">#Please enter a valid email address.</LocalizedString>
      <LocalizedString ElementType="ClaimType" ElementId="newPassword" StringId="DisplayName">#New Password</LocalizedString>
      <LocalizedString ElementType="ClaimType" ElementId="newPassword" StringId="UserHelpText">#Enter new password</LocalizedString>
      <LocalizedString ElementType="ClaimType" ElementId="newPassword" StringId="PatternHelpText">#8-16 characters, containing 3 out of 4 of the following: Lowercase characters, uppercase characters, digits (0-9), and one or more of the following symbols: @ # $ % ^ &amp; * - _ + = [ ] { } | \ : ' , ? / ` ~ " ( ) ; .</LocalizedString>
      <LocalizedString ElementType="ClaimType" ElementId="reenterPassword" StringId="DisplayName">#Confirm New Password</LocalizedString>
      <LocalizedString ElementType="ClaimType" ElementId="reenterPassword" StringId="UserHelpText">#Confirm new password</LocalizedString>
      <LocalizedString ElementType="ClaimType" ElementId="reenterPassword" StringId="PatternHelpText">#8-16 characters, containing 3 out of 4 of the following: Lowercase characters, uppercase characters, digits (0-9), and one or more of the following symbols: @ # $ % ^ &amp; * - _ + = [ ] { } | \ : ' , ? / ` ~ " ( ) ; .</LocalizedString>
      <LocalizedString ElementType="ClaimType" ElementId="displayName" StringId="DisplayName">#Display Name</LocalizedString>
      <LocalizedString ElementType="ClaimType" ElementId="displayName" StringId="UserHelpText">#Your display name.</LocalizedString>
      <LocalizedString ElementType="ClaimType" ElementId="surname" StringId="DisplayName">#Surname</LocalizedString>
      <LocalizedString ElementType="ClaimType" ElementId="surname" StringId="UserHelpText">#Your surname (also known as family name or last name).  </LocalizedString>
      <LocalizedString ElementType="ClaimType" ElementId="givenName" StringId="DisplayName">#Given Name</LocalizedString>
      <LocalizedString ElementType="ClaimType" ElementId="givenName" StringId="UserHelpText">#Your given name (also known as first name).</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="button_continue">#Create</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="error_fieldIncorrect">#One or more fields are filled out incorrectly. Please check your entries and try again.</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="error_passwordEntryMismatch">#The password entry fields do not match. Please enter the same password in both fields and try again.</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="error_requiredFieldMissing">#A required field is missing. Please fill out all required fields and try again.</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="helplink_text">#What is this?</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="initial_intro">#Please provide the following details.</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="preloader_alt">#Please wait</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="required_field">#This information is required.</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="ver_but_edit">#Change e-mail</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="ver_but_resend">#Send new code</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="ver_but_send">#Send verification code</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="ver_but_verify">#Verify code</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="ver_fail_code_expired">#That code is expired. Please request a new code.</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="ver_fail_no_retry">#You've made too many incorrect attempts. Please try again later.</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="ver_fail_retry">#That code is incorrect. Please try again.</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="ver_fail_server">#We are having trouble verifying your email address. Please enter a valid email address and try again.</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="ver_fail_throttled">#There have been too many requests to verify this email address. Please wait a while, then try again.</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="ver_info_msg">#Verification code has been sent to your inbox. Please copy it to the input box below.</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="ver_input">#Verification code</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="ver_intro_msg">#Verification is necessary. Please click Send button.</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="ver_success_msg">#E-mail address verified. You can now continue.</LocalizedString>
      <LocalizedString ElementType="ErrorMessage" StringId="ServiceThrottled">#There are too many requests at this moment. Please wait for some time and try again.</LocalizedString>
      <LocalizedString ElementType="ErrorMessage" StringId="UserMessageIfClaimNotVerified">#Claim not verified: {0}</LocalizedString>
      <LocalizedString ElementType="ErrorMessage" StringId="UserMessageIfClaimsPrincipalAlreadyExists">#A user with the specified ID already exists. Please choose a different one.</LocalizedString>
      <LocalizedString ElementType="ErrorMessage" StringId="UserMessageIfIncorrectPattern">#Incorrect pattern for: {0}</LocalizedString>
      <LocalizedString ElementType="ErrorMessage" StringId="UserMessageIfInvalidInput">#{0} has invalid input.</LocalizedString>
      <LocalizedString ElementType="ErrorMessage" StringId="UserMessageIfMissingRequiredElement">#Missing required element: {0}</LocalizedString>
      <LocalizedString ElementType="ErrorMessage" StringId="UserMessageIfValidationError">#Error in validation by: {0}</LocalizedString>
    </LocalizedStrings>
  </LocalizedResources>
  <!--Local account sign-up page Spanish-->
  <LocalizedResources Id="api.localaccountsignup.es">
    <LocalizedStrings>
      <LocalizedString ElementType="ClaimType" ElementId="email" StringId="DisplayName">#Dirección de correo electrónico</LocalizedString>
      <LocalizedString ElementType="ClaimType" ElementId="email" StringId="UserHelpText">#Dirección de correo electrónico que puede usarse para ponerse en contacto con usted.</LocalizedString>
      <LocalizedString ElementType="ClaimType" ElementId="email" StringId="PatternHelpText">#Introduzca una dirección de correo electrónico válida.  </LocalizedString>
      <LocalizedString ElementType="ClaimType" ElementId="newPassword" StringId="DisplayName">#Nueva contraseña</LocalizedString>
      <LocalizedString ElementType="ClaimType" ElementId="newPassword" StringId="UserHelpText">#Escriba la contraseña nueva</LocalizedString>
      <LocalizedString ElementType="ClaimType" ElementId="newPassword" StringId="PatternHelpText">#De 8 a 16 caracteres, que contengan 3 de los 4 tipos siguientes: caracteres en minúsculas, caracteres en mayúsculas, dígitos (0-9) y uno o más de los siguientes símbolos: @ # $ % ^ &amp; * - _ + = [ ] { } | \\ : ' , ? / ` ~ \" ( ) ; .</LocalizedString>
      <LocalizedString ElementType="ClaimType" ElementId="reenterPassword" StringId="DisplayName">#Confirmar nueva contraseña</LocalizedString>
      <LocalizedString ElementType="ClaimType" ElementId="reenterPassword" StringId="UserHelpText">#Confirmar nueva contraseña</LocalizedString>
      <LocalizedString ElementType="ClaimType" ElementId="reenterPassword" StringId="PatternHelpText">#8 a 16 caracteres, que contengan 3 de los 4 tipos siguientes: caracteres en minúsculas, caracteres en mayúsculas, dígitos (0-9) y uno o más de los siguientes símbolos: @ # $ % ^ &amp; * - _ + = [ ] { } | \\ : ' , ? / ` ~ \" ( ) ; .</LocalizedString>
      <LocalizedString ElementType="ClaimType" ElementId="displayName" StringId="DisplayName">#Nombre para mostrar</LocalizedString>
      <LocalizedString ElementType="ClaimType" ElementId="displayName" StringId="UserHelpText">#Su nombre para mostrar.</LocalizedString>
      <LocalizedString ElementType="ClaimType" ElementId="surname" StringId="DisplayName">#Apellido</LocalizedString>
      <LocalizedString ElementType="ClaimType" ElementId="surname" StringId="UserHelpText">#Su apellido.</LocalizedString>
      <LocalizedString ElementType="ClaimType" ElementId="givenName" StringId="DisplayName">#Nombre</LocalizedString>
      <LocalizedString ElementType="ClaimType" ElementId="givenName" StringId="UserHelpText">#Su nombre (también conocido como nombre de pila).</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="button_continue">#Crear</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="error_fieldIncorrect">#Hay uno o varios campos rellenados de forma incorrecta. Compruebe las entradas y vuelva a intentarlo.</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="error_passwordEntryMismatch">#Los campos de entrada de contraseña no coinciden. Escriba la misma contraseña en ambos campos y vuelva a intentarlo.</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="error_requiredFieldMissing">#Falta un campo obligatorio. Rellene todos los campos necesarios y vuelva a intentarlo.</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="helplink_text">#¿Qué es esto?</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="initial_intro">#Proporcione los siguientes detalles.</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="preloader_alt">#Espere</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="required_field">#Esta información es obligatoria.</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="ver_but_edit">#Cambiar correo electrónico</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="ver_but_resend">#Enviar nuevo código</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="ver_but_send">#Enviar código de comprobación</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="ver_but_verify">#Comprobar código</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="ver_fail_code_expired">#El código ha expirado. Solicite otro nuevo.</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="ver_fail_no_retry">#Ha realizado demasiados intentos incorrectos. Vuelva a intentarlo más tarde.</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="ver_fail_retry">#Ese código es incorrecto. Inténtelo de nuevo.</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="ver_fail_server">#Tenemos problemas para comprobar la dirección de correo electrónico. Escriba una dirección de correo electrónico válida y vuelva a intentarlo.</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="ver_fail_throttled">#Ha habido demasiadas solicitudes para comprobar esta dirección de correo electrónico. Espere un poco y vuelva a intentarlo.</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="ver_info_msg">#Se ha enviado el código de verificación a su Bandeja de entrada. Cópielo en el siguiente cuadro de entrada.</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="ver_input">#Código de verificación</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="ver_intro_msg">#La comprobación es obligatoria. Haga clic en el botón Enviar.</LocalizedString>
      <LocalizedString ElementType="UxElement" StringId="ver_success_msg">#Dirección de correo electrónico comprobada. Puede continuar.</LocalizedString>
      <LocalizedString ElementType="ErrorMessage" StringId="ServiceThrottled">#Hay demasiadas solicitudes en este momento. Espere un momento y vuelva a intentarlo.</LocalizedString>
      <LocalizedString ElementType="ErrorMessage" StringId="UserMessageIfClaimNotVerified">#Reclamación no comprobada: {0}</LocalizedString>
      <LocalizedString ElementType="ErrorMessage" StringId="UserMessageIfClaimsPrincipalAlreadyExists">#Ya existe un usuario con el id. especificado. Elija otro diferente.</LocalizedString>
      <LocalizedString ElementType="ErrorMessage" StringId="UserMessageIfIncorrectPattern">#Patrón incorrecto para: {0}</LocalizedString>
      <LocalizedString ElementType="ErrorMessage" StringId="UserMessageIfInvalidInput">#{0} tiene una entrada no válida.</LocalizedString>
      <LocalizedString ElementType="ErrorMessage" StringId="UserMessageIfMissingRequiredElement">#Falta un elemento obligatorio: {0}</LocalizedString>
      <LocalizedString ElementType="ErrorMessage" StringId="UserMessageIfValidationError">#Error en la validación de: {0}</LocalizedString>
    </LocalizedStrings>
  </LocalizedResources>
</Localization>

ローカライズを使用してコンテンツ定義を編集する

コピーした ContentDefinitions 要素の内容全体を BuildingBlocks 要素の子として貼り付けます。

次の例では、英語 (en) とスペイン語 (es) のカスタム文字列がサインアップまたはサインインページと、ローカルアカウントサインアップページに追加されています。各 LocalizedResourcesReference の LocalizedResourcesReferenceId は、それらのロケールと同じですが、識別子として任意の文字列を使用できます。言語とページの組み合わせごとに、以前に作成した対応する LocalizedResources をポイントします。

<ContentDefinitions>
  <ContentDefinition Id="api.signuporsignin">
    <LocalizedResourcesReferences MergeBehavior="Prepend">
        <LocalizedResourcesReference Language="en" LocalizedResourcesReferenceId="api.signuporsignin.en" />
        <LocalizedResourcesReference Language="es" LocalizedResourcesReferenceId="api.signuporsignin.es" />
    </LocalizedResourcesReferences>
  </ContentDefinition>

  <ContentDefinition Id="api.localaccountsignup">
    <LocalizedResourcesReferences MergeBehavior="Prepend">
        <LocalizedResourcesReference Language="en" LocalizedResourcesReferenceId="api.localaccountsignup.en" />
        <LocalizedResourcesReference Language="es" LocalizedResourcesReferenceId="api.localaccountsignup.es" />
    </LocalizedResourcesReferences>
  </ContentDefinition>
</ContentDefinitions>

更新されたカスタムポリシーをアップロードしてテストする

カスタムポリシーをアップロードする

拡張ファイルを保存します。
複数のテナントにアクセスできる場合、上部のメニューの [設定] アイコンを選択し、[ディレクトリとサブスクリプション] メニューからお使いの Azure AD B2C テナントに切り替えます。
Azure AD B2C を検索して選択します。
[ポリシー] で [Identity Experience Framework] を選択します。
[カスタムポリシーのアップロード] を選択します。
前に変更した拡張ファイルをアップロードします。

[今すぐ実行] を使用したカスタムポリシーのテスト

アップロードしたポリシーを選択し、 [今すぐ実行] を選択します。
ローカライズされたサインアップまたはサインインページが表示されます。
サインアップリンクをクリックすると、ローカライズされたサインアップページが表示されます。
ブラウザーの既定の言語をスペイン語に切り替えます。または、クエリ文字列パラメーターの ui_locales を承認要求に追加することもできます。次に例を示します。

https://<tenant-name>.b2clogin.com/<tenant-name>.onmicrosoft.com/B2C_1A_signup_signin/oauth2/v2.0/authorize&client_id=0239a9cc-309c-4d41-12f1-31299feb2e82&nonce=defaultNonce&redirect_uri=https%3A%2F%2Fjwt.ms&scope=openid&response_type=id_token&prompt=login&ui_locales=es

サポートされている言語

Azure AD B2C では、ISO 639-1 のコードを使用することで以下の言語がサポートされています。ユーザーフローの言語は、Azure AD B2C によって提供されます。多要素認証の通知言語は、Microsoft Entra 多要素認証によって提供されます。

Language	言語コード	ユーザーフロー	MFA 通知
アラビア語	ar
ブルガリア語	bg
ベンガル語	bn
カタルニア語	ca
チェコ語	cs
デンマーク語	da
ドイツ語	de
ギリシャ語	el
English	en
スペイン語	es
エストニア語	et
バスク語	eu
フィンランド語	fi
フランス語	fr
ガリシア語	gl
グジャラート語	gu
ヘブライ語	he
ヒンディー語	hi
クロアチア語	時間
ハンガリー語	hu
インドネシア語	id
イタリア語	it
日本語	ja
カザフ語	kk
カンナダ語	kn
韓国語	ko
リトアニア語	lt
ラトビア語	lv
マラヤーラム語	ml
マラーティー語	mr
マレー語	ミリ秒
ノルウェー語 - ブークモール	nb
オランダ語	nl
ノルウェー語	いいえ
パンジャーブ語	pa
ポーランド語	pl
ポルトガル語 - ブラジル	pt-br
ポルトガル語 - ポルトガル	pt-pt
ルーマニア語	ro
ロシア語	ru
スロバキア語	sk
スロベニア語	sl
セルビア語 - キリル	sr-cryl-cs
セルビア語 - ラテン	sr-latn-cs
スウェーデン語	sv
タミル語	ta
テルグ語	te
タイ語	th
トルコ語	tr
ウクライナ語	uk
ベトナム語	vi
ウェールズ語	cy
中国語 - 簡体字	zh-hans
中国語 - 繁体字	zh-hant

次のステップ

Azure Active Directory B2C でのアプリケーションのユーザーインターフェイスのカスタマイズに関する記事を参照して、アプリケーションのユーザーインターフェイスをカスタマイズする方法の詳細を確認します。

IEF リファレンスでローカリゼーション要素についてさらに詳しく学習する。
Azure AD B2C で使用できるローカライズ文字列 ID の一覧を参照する。

Azure Active Directory B2C での言語のカスタマイズ

言語のカスタマイズのしくみ

前提条件

ui_locales で要求された言語のサポート

ユーザーフローで有効にする言語を選択する

文字列のカスタマイズ

ページ上の文字列を変更する

拡張属性を変更する

LocalizedCollections を使って値の一覧を提供する

変更のアップロード

言語のカスタマイズを使用してページの UI をカスタマイズする

カスタム言語の追加

サポートされる言語の一覧を設定する

言語固有のラベルを指定する

ローカライズを使用してコンテンツ定義を編集する

更新されたカスタムポリシーをアップロードしてテストする

カスタムポリシーをアップロードする

[今すぐ実行] を使用したカスタムポリシーのテスト

関連情報

オーバーライドとしてのページ UI カスタマイズラベル

翻訳を更新する

右から左へ記述する言語のサポート

ブラウザーの動作

サポートされている言語

次のステップ

その他のリソース

Azure Active Directory B2C での言語のカスタマイズ

言語のカスタマイズのしくみ

前提条件

ui_locales で要求された言語のサポート

ユーザー フローで有効にする言語を選択する

文字列のカスタマイズ

ページ上の文字列を変更する

拡張属性を変更する

LocalizedCollections を使って値の一覧を提供する

変更のアップロード

言語のカスタマイズを使用してページの UI をカスタマイズする

カスタム言語の追加

サポートされる言語の一覧を設定する

言語固有のラベルを指定する

ローカライズを使用してコンテンツ定義を編集する

更新されたカスタム ポリシーをアップロードしてテストする

カスタム ポリシーをアップロードする

[今すぐ実行] を使用したカスタム ポリシーのテスト

関連情報

オーバーライドとしてのページ UI カスタマイズ ラベル

翻訳を更新する

右から左へ記述する言語のサポート

ソーシャル ID プロバイダーの翻訳

ブラウザーの動作

サポートされている言語

次のステップ

その他のリソース

ユーザーフローで有効にする言語を選択する

更新されたカスタムポリシーをアップロードしてテストする

カスタムポリシーをアップロードする

[今すぐ実行] を使用したカスタムポリシーのテスト

オーバーライドとしてのページ UI カスタマイズラベル