현지화 언어

Logto는 다양한 사전 정의된 언어를 지원하며, 113개의 추가 언어 태그를 제공합니다. 이 강력한 도구를 통해 로그인 경험을 맞춤화하고, 직접 언어 옵션과 번역을 생성 및 관리할 수 있습니다.

Logto Console에서의 맞춤화 단계

코딩 없이 Logto Console에서 언어 설정을 쉽게 맞춤화할 수 있습니다.

이동 경로: Console > 로그인 경험 > 콘텐츠 > 언어.
언어 관리: “언어 관리” 버튼을 클릭하여 언어 라이브러리에 접근하세요.
- 기존 언어 편집: Logto에서 제공하는 언어의 번역을 맞춤화할 수 있습니다. 이 언어들은 삭제할 수 없지만, 변경 사항이 기본 값을 덮어씁니다.
- 새 언어 추가: ”언어 추가” 버튼을 클릭하고, 언어 태그를 선택한 뒤 번역을 입력하고 저장하면 새 언어가 추가됩니다.
자동 감지 활성화: 활성화 시, 사용자의 기기 설정에 따라 로그인 페이지가 자동으로 선호 언어로 표시됩니다.
기본 언어 설정: 언어 라이브러리에서 기본 언어를 선택할 수 있습니다. 감지된 사용자 언어가 현재 라이브러리에 없을 때 이 언어가 사용됩니다.

언어를 관리할 때 알아두면 좋은 주요 용어는 다음과 같습니다:

정의	설명
언어 태그	언어 태그는 콘텐츠의 언어를 식별합니다. 언어 태그는 언어 코드(예: en, fr, zh)와 국가/지역 코드(예: US, UK, KR)가 하이픈으로 구분되어 구성됩니다. 예시: en-US.
Logto 제공 언어	Logto 제공 언어는 Logto 공식 언어이며, Logto의 원본 코드 베이스에 저장되어 있습니다.
추가된 언어	추가된 언어는 사용자가 직접 추가한 언어입니다.
Logto 소스 값	Logto 소스 값은 사용자가 맞춤화하지 않은 Logto에서 제공된 값입니다.
맞춤 값	맞춤 값은 사용자가 이미 맞춤화한 값입니다. Logto 소스 값이 덮어써집니다.

Management API를 이용한 맞춤화

Management API PUT /api/custom-phrases/{languageTag}를 사용하여 언어 번역을 맞춤화할 수 있습니다. API 요청 본문은 다음과 같은 부분적 로케일 객체입니다:

{
  "input": { "username": "Username", "password": "Password" },
  "secondary": {
    "social_bind_with": "이미 계정이 있으신가요? 소셜 아이덴티티와 {{methods, list(type: disjunction;)}}를 연결하려면 로그인하세요."
  },
  "action": { "sign_in": "로그인" },
  "error": {
    "general_required": "{{types, list(type: disjunction;)}} 필수 항목입니다"
  },
  "list": { "or": "또는" },
  "user_scopes": {
    "descriptions": { "custom_data": "사용자 맞춤 데이터" }
  }
}

모든 맞춤화 가능한 내용을 확인하려면 소스 코드를 참고하세요.

또한 PATCH /api/sign-in-exp API를 사용하여 언어 감지 정책을 제어할 수 있습니다.

런타임 언어 결정 방식

런타임 시, 로그인 경험의 언어는 다음 우선순위로 결정됩니다:

현재 인증 요청의 ui_locales OIDC 파라미터 (지원되는 첫 번째 태그 사용). 자세한 내용은 ui_locales 참고.
그렇지 않으면, "자동 감지"가 활성화된 경우, 감지된 사용자 클라이언트 언어 (예: HTTP Accept-Language 헤더에서).
그렇지 않으면, 로그인 경험의 테넌트 기본 언어.

이 결정 방식은 상호작용으로 트리거되는 메시지의 이메일 현지화에도 영향을 미칩니다. 자세히 알아보기: 이메일 템플릿 현지화.

사용 사례

추가된 언어는 최종 고객에게 어떻게 보이나요?

예를 들어, 영어가 기본 언어이고 자동 감지가 켜진 웹사이트가 있다고 가정해봅시다. 일본에서 온 사용자가 사이트를 방문해 계정을 생성하려고 합니다. 만약 그 사용자가 앱 언어로 일본어를 사용하지만 Logto에서 아직 해당 언어를 지원하지 않는다면, 로그인 화면은 영어로 표시됩니다.

Logto 로그인 경험 i18n을 통해 맞춤 언어가 가능합니다.

ja 언어 태그를 클릭하여 직접 일본어 번역을 추가하세요.

이렇게 하면, 일본에서 접속한 사용자는 영어에서 번역한 일본어로 콘텐츠를 볼 수 있습니다.

자주 묻는 질문

내가 추가한 언어가 Logto 제공 언어가 되면 어떻게 되나요?

왼쪽 언어 태그 옆에 Logto 제공 태그가 표시되며, 추가한 언어는 더 이상 삭제할 수 없습니다. 수정한 값은 계속 동작하며, 원래 Logto 값을 대체합니다. Logto의 기본 설정에서 제공하는 값을 사용하려면, 사용자가 입력한 값을 삭제하세요.

일부 값만 맞춤화했다면 어떻게 되나요?

최종 사용자가 보는 것은 두 컬럼이 병합된 결과입니다. Logto에서 제공한 원본 콘텐츠 중 일부만 수정하고 싶을 때, 회원가입 화면에서 Logto가 제공한 것과의 차이는 수정한 키만 반영됩니다. 나머지 콘텐츠는 변경되지 않습니다.

로그인 경험에서 전화번호 국가 코드는 사용자의 브라우저 로케일을 기본값으로 사용합니다. 예를 들어, 사용자의 브라우저 언어가 fr로 설정되어 있다면, 국가 코드는 프랑스(+33)로 기본 설정됩니다.

특정 사용자 또는 지역에 대해 기본 국가 코드를 프로그래밍 방식으로 제어하려면, ui_locales 인증 파라미터를 사용할 수 있습니다. 예를 들어, ui_locales=ja로 설정하면 국가 코드가 일본(+81)으로 기본 설정됩니다.

애플리케이션에서 아랍어 및 RTL(오른쪽-왼쪽) 언어 레이아웃 지원하기

Logto Console에서의 맞춤화 단계​

Management API를 이용한 맞춤화​

런타임 언어 결정 방식​

사용 사례​

자주 묻는 질문​

내가 추가한 언어가 Logto 제공 언어가 되면 어떻게 되나요?​

일부 값만 맞춤화했다면 어떻게 되나요?​

로그인 경험에서 기본 전화번호 국가 코드는 어떻게 설정하나요?​

관련 리소스​