Microsoft Entra 外部 ID での言語のカスタマイズ

  • [アーティクル]

ヒント

この記事は、B2B コラボレーション ユーザー フローを対象としています。 テナントが顧客の ID およびアクセス管理用に構成されている場合は、顧客用の「認証エクスペリエンスの言語をカスタマイズする」を参照してください。

Microsoft Entra 外部 ID の言語のカスタマイズを使用する、ユーザーのニーズに応じて、ユーザー フローをさまざまな言語に対応させることができます。 Microsoft では、36 言語の翻訳を提供しています。 この記事では、1 つの言語のエクスペリエンスしか提供されない場合でも、属性コレクション ページで属性名をカスタマイズする方法について説明します。

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

既定では、一貫したサインアップ エクスペリエンスを保証するために、サインアップしているユーザーに対して言語のカスタマイズが有効になります。 言語を使用して、サインアップ中に属性コレクション プロセスの一部としてユーザーに表示される文字列を変更できます。 カスタム ユーザー属性を使っている場合は、独自の翻訳を提供する必要があります。

文字列のカスタマイズ

ヒント

この記事の手順は、開始するポータルに応じて若干異なる場合があります。

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

  1. Microsoft Entra 管理センターに少なくとも外部 ID ユーザー フロー管理者としてサインインします。
  2. [ID]>[External Identities]>[ユーザー フロー] に移動します。
  3. 翻訳を有効にするユーザー フローを選択します。
  4. [言語] を選択します。
  5. ユーザー フローの [言語] ページで、カスタマイズする言語を選択します。
  6. 属性コレクション ページを展開します。
  7. [既定値のダウンロード] (この言語を前に編集した場合は [オーバーライドのダウンロード]) を選びます。

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

Screenshot of downloading the default language customization json file.

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

  1. 前の手順でダウンロードした JSON ファイルを JSON エディターで開きます。
  2. 変更する要素を探します。 探している文字列の StringId を見つけるか、変更する Value 属性を見つけます。
  3. Value 属性を表示する文字列に更新します。
  4. 変更するすべての文字列について、Override を true に変更します。 Override 値が true に変更されていない場合、そのエントリは無視されます。
  5. ファイルを保存し、変更内容をアップロードします。

Screenshot of uploading the language customization json file.

拡張属性を変更する

カスタム ユーザー属性の文字列を変更する場合や、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 は、このオプションが選択された場合に要求で返される値です。

変更のアップロード

  1. JSON ファイルの変更が完了したら、テナントに戻ります。
  2. [ユーザー フロー] を選択し、翻訳を有効にするユーザー フローを選択します。
  3. [言語] を選択します。
  4. 翻訳する言語を選びます。
  5. 属性コレクション ページを選択します。
  6. フォルダー アイコンを選び、アップロードする JSON ファイルを選びます。
  7. 変更がユーザー フローに自動的に保存されます。 オーバーライドは、[構成済み] タブにあります。
  8. カスタマイズしたオーバーライド ファイルを削除またはダウンロードするには、言語を選択し、[属性コレクション] ページを展開します。

Screenshot of removing or downloading the language customization json file.

追加情報

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

言語のカスタマイズを有効にすると、ページ UI のカスタマイズを使った、ラベルの以前の編集内容は、英語 (en) の JSON ファイルに保存されます。 引き続き、言語のカスタマイズで言語リソースをアップロードして、ラベルなどの文字列を変更できます。

翻訳を更新する

Microsoft は、最新の翻訳を提供するよう努めています。 継続的に翻訳を改善し、コンプライアンスを維持します。 バグやグローバルな用語の変更を特定し、ユーザー フローでシームレスに機能する更新プログラムを作成します。

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

Microsoft は現在、右から左へ記述する言語のサポートを提供していませんが、カスタム ロケールと CSS を使用して文字列の表示方法を変更できます。 この機能が必要な場合は、Azure フィードバックで投票してください。

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

Microsoft は、ui_locales OIDC パラメーターをソーシャル ログインに提供しています。 ただし、Facebook や Google などの一部のソーシャル ID プロバイダーは、それを利用していません。

ブラウザーの動作

Chrome と Firefox はどちらも、設定されている言語を要求します。 言語がサポートされている場合は、既定値の代わりにその言語が表示されます。 Microsoft Edge は現在、言語を要求せず、既定の言語を使用します。

サポートされている言語

Microsoft Entra 外部 IDには、次の言語のサポートが含まれています。 ユーザー フロー言語は、Microsoft Entra 外部 IDによって提供されます。 多要素認証の通知言語は、Microsoft Entra 多要素認証によって提供されます。

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

次のステップ