日本語
OIDC ui_locales で Logto のサインイン体験をローカライズしよう
すべてのユーザーにネイティブなサインイン体験を提供しましょう。このチュートリアルでは、標準の OIDC パラメーター ui_locales を使って、Logto のサインイン UI や関連メールの実行時言語を設定する方法を学びます。
すべてのユーザーにネイティブなサインイン体験を提供しましょう。このチュートリアルでは、標準の OIDC パラメーター ui_locales を使って、Logto のサインイン UI や関連メールの実行時言語を設定する方法を学びます。
Logto はすでに多言語コンテンツと自動検出に対応していますが、特定のやり取りごとに明示的に言語を指定したい場合があります:
さらに、ui_locales は多くのアイデンティティプロバイダーや SDK でサポートされている標準パラメーターです。
uiLocales としてメールテンプレートに公開します(例:「リクエストされた言語: {{uiLocales}}」)詳細はリファレンスをご覧ください: UI locales ドキュメント。
オプションですが便利:
Logto SDK では、サインイン時に追加の OIDC パラメーターを渡すことができます。extraParams に ui_locales を追加しましょう:
注意:
fr-CA、それがなければ fr、それもなければ en)を選択します。ui_locales は他の標準/カスタムパラメーター(例:login_hint、organization_id またはファーストスクリーンディレクティブ等)と組み合わせて使えます。OIDC 認可リクエストを手動(または汎用 OIDC クライアント経由)で作成している場合は、ui_locales を直接追加してください:
認証フローでメール(例:認証コード)がトリガーされた場合、Logto は次の順序で言語を解決します:
ui_locales(最初のサポートタグ)Accept-Language ヘッダーによる自動検出その後、Logto は解決された言語とテンプレートタイプに一致するカスタムメールテンプレートを探します。見つからない場合はコネクターのデフォルトにフォールバックします。
プロバイダー管理テンプレート(例:Postmark、HTTP Email)では、Logto は両方の uiLocales と locale をプロバイダーに渡します。ui_locales が指定されていれば、locale は ui_locales の最初のサポートタグを使用します。
参照: メールテンプレートのローカライズ。