한국어
OIDC ui_locales 로 Logto 로그인 경험 현지화하기
모든 사용자가 자연스럽게 느끼는 로그인 경험을 제공하세요. 이 튜토리얼에서는 표준 OIDC 파라미터인 ui_locales 를 사용해 Logto 의 로그인 UI 와 관련 이메일의 런타임 언어를 설정하는 방법을 배웁니다.
Charles
Developer
Developer
모든 사용자가 자연스럽게 느끼는 로그인 경험을 제공하세요. 이 튜토리얼에서는 표준 OIDC 파라미터인 ui_locales 를 사용해 Logto 의 로그인 UI 와 관련 이메일의 런타임 언어를 설정하는 방법을 배웁니다.
Logto 는 이미 다국어 콘텐츠와 자동 감지를 지원하지만, 특정 상호작용에서 명시적으로 언어를 지정하고 싶을 때가 있습니다:
게다가, ui_locales 는 많은 신원 제공자들과 SDK 들이 지원하는 표준 파라미터입니다.
uiLocales 로 노출합니다 (예: "요청한 언어: {{uiLocales}}")자세한 내용은 참고 문서를 확인하세요: UI locales docs.
선택 사항이지만 있으면 편리해요:
Logto SDK 는 로그인 때 추가 OIDC 파라미터를 전달할 수 있게 해줍니다. extraParams 에 ui_locales 를 추가하세요:
주의사항:
fr-CA, 없으면 fr, 없으면 en).ui_locales 를 다른 표준 또는 커스텀 파라미터 (login_hint, organization_id 또는 첫 화면 지시사항 등) 와 조합해서 사용할 수 있습니다.OIDC 인증 요청을 직접 작성(혹은 범용 OIDC 클라이언트 통해) 하는 경우, URL 에 ui_locales 를 직접 추가하세요:
상호작용이 이메일(예: 인증 코드)을 트리거할 때, Logto 는 다음 우선순위로 언어를 판단합니다:
ui_locales (가장 먼저 지원되는 태그)Accept-Language 헤더로 자동 감지이후 Logto 는 판단된 언어와 템플릿 종류에 맞는 커스텀 이메일 템플릿을 먼저 찾고; 없으면 커넥터 기본값으로 대체합니다.
공급자 관리형 템플릿(예: Postmark, HTTP Email)의 경우: Logto 는 uiLocales 와 locale 을 공급자에게 전달합니다.
ui_locales 가 있으면 locale 은 그 중 첫 번째 지원되는 태그가 됩니다.
자세한 안내: 이메일 템플릿 현지화.