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

  • [アーティクル]

適用対象: 内側に白いチェック マーク記号がある緑の円。 従業員テナント 内側に灰色の X 記号がある白い円。 外部テナント (詳細情報)

ヒント

この記事の対象は、従業員テナントでの B2B コラボレーションのユーザー フローです。 外部テナントについては、「認証エクスペリエンスの言語をカスタマイズする」をご覧ください。

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

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

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

文字列のカスタマイズ

ヒント

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

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

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

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

既定の言語カスタマイズ json ファイルのダウンロードのスクリーンショット。

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

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

言語カスタマイズ json ファイルのアップロードのスクリーンショット。

拡張属性を変更する

カスタム ユーザー属性の文字列を変更する場合や、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. カスタマイズしたオーバーライド ファイルを削除またはダウンロードするには、言語を選択し、[属性コレクション] ページを展開します。

言語カスタマイズ json ファイルの削除またはダウンロードのスクリーンショット。

関連情報

オーバーライドとしてのページ 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 はサポートされないことを示します。 緑色のチェック マーク。
ブルガリア語 bg X はサポートされないことを示します。 緑色のチェック マーク。
ベンガル語 bn 緑色のチェック マーク。 X はサポートされないことを示します。
カタロニア語 ca X はサポートされないことを示します。 緑色のチェック マーク。
チェコ語 cs 緑色のチェック マーク。 緑色のチェック マーク。
デンマーク語 da 緑色のチェック マーク。 緑色のチェック マーク。
ドイツ語 de 緑色のチェック マーク。 緑色のチェック マーク。
ギリシャ語 el 緑色のチェック マーク。 緑色のチェック マーク。
英語 en 緑色のチェック マーク。 緑色のチェック マーク。
スペイン語 es 緑色のチェック マーク。 緑色のチェック マーク。
エストニア語 et X はサポートされないことを示します。 緑色のチェック マーク。
バスク語 eu X はサポートされないことを示します。 緑色のチェック マーク。
フィンランド語 fi 緑色のチェック マーク。 緑色のチェック マーク。
フランス語 fr 緑色のチェック マーク。 緑色のチェック マーク。
ガリシア語 gl X はサポートされないことを示します。 緑色のチェック マーク。
グジャラート語 gu 緑色のチェック マーク。 X はサポートされないことを示します。
ヘブライ語 he X はサポートされないことを示します。 緑色のチェック マーク。
ヒンディー語 hi 緑色のチェック マーク。 緑色のチェック マーク。
クロアチア語 hr 緑色のチェック マーク。 緑色のチェック マーク。
ハンガリー語 hu 緑色のチェック マーク。 緑色のチェック マーク。
インドネシア語 id X はサポートされないことを示します。 緑色のチェック マーク。
イタリア語 it 緑色のチェック マーク。 緑色のチェック マーク。
日本語 ja 緑色のチェック マーク。 緑色のチェック マーク。
カザフ語 kk X はサポートされないことを示します。 緑色のチェック マーク。
カンナダ語 kn 緑色のチェック マーク。 X はサポートされないことを示します。
韓国語 ko 緑色のチェック マーク。 緑色のチェック マーク。
リトアニア語 lt X はサポートされないことを示します。 緑色のチェック マーク。
ラトビア語 lv X はサポートされないことを示します。 緑色のチェック マーク。
マラヤーラム語 ml 緑色のチェック マーク。 X はサポートされないことを示します。
マラーティー語 mr 緑色のチェック マーク。 X はサポートされないことを示します。
マレー語 ms 緑色のチェック マーク。 緑色のチェック マーク。
ノルウェー語 - ブークモール nb 緑色のチェック マーク。 X はサポートされないことを示します。
オランダ語 nl 緑色のチェック マーク。 緑色のチェック マーク。
ノルウェー語 no X はサポートされないことを示します。 緑色のチェック マーク。
パンジャーブ語 pa 緑色のチェック マーク。 X はサポートされないことを示します。
ポーランド語 pl 緑色のチェック マーク。 緑色のチェック マーク。
ポルトガル語 - ブラジル pt-br 緑色のチェック マーク。 緑色のチェック マーク。
ポルトガル語 - ポルトガル pt-pt 緑色のチェック マーク。 緑色のチェック マーク。
ルーマニア語 ro 緑色のチェック マーク。 緑色のチェック マーク。
ロシア語 ru 緑色のチェック マーク。 緑色のチェック マーク。
スロバキア語 sk 緑色のチェック マーク。 緑色のチェック マーク。
スロベニア語 sl X はサポートされないことを示します。 緑色のチェック マーク。
セルビア語 - キリル sr-cryl-cs X はサポートされないことを示します。 緑色のチェック マーク。
セルビア語 - ラテン sr-latn-cs X はサポートされないことを示します。 緑色のチェック マーク。
スウェーデン語 sv 緑色のチェック マーク。 緑色のチェック マーク。
タミル語 ta 緑色のチェック マーク。 X はサポートされないことを示します。
テルグ語 te 緑色のチェック マーク。 X はサポートされないことを示します。
タイ語 th 緑色のチェック マーク。 緑色のチェック マーク。
トルコ語 tr 緑色のチェック マーク。 緑色のチェック マーク。
ウクライナ語 uk X はサポートされないことを示します。 緑色のチェック マーク。
ベトナム語 vi X はサポートされないことを示します。 緑色のチェック マーク。
中国語 - 簡体字 zh-hans 緑色のチェック マーク。 緑色のチェック マーク。
中国語 - 繁体字 zh-hant 緑色のチェック マーク。 緑色のチェック マーク。

次のステップ