본문으로 건너뛰기

인증 (Authentication) 파라미터

표준 OIDC 로그인 플로우에서 클라이언트 애플리케이션은 인증 요청을 시작하여 사용자를 Logto에서 호스팅하는 범용 로그인 경험 웹 페이지로 리디렉션합니다. 로그인 경험 설정에 따라 사용자는 다양한 식별자, 인증 방법, 그리고 서드파티 소셜 또는 엔터프라이즈 SSO 커넥터를 사용하여 로그인 또는 회원가입할 수 있습니다.

Logto는 다음과 같은 선택적 표준 OIDC 파라미터도 지원합니다:

  • login_hint: 사용자 식별자에 대한 힌트를 제공합니다. 예: 이메일/사용자명 미리 입력
  • ui_locales: 현재 상호작용(로그인 UI 및 관련 이메일 포함)에 대한 런타임 언어를 제어합니다.

표준 OIDC 인증 (Authentication) 파라미터 외에도, Logto는 최종 사용자를 위한 원하는 로그인 경험을 맞춤화할 수 있도록 여러 커스텀 인증 (Authentication) 파라미터를 제공합니다.

이는 서로 다른 사용자 그룹에 대해 특정 로그인 플로우를 강제하고자 할 때 특히 유용합니다. 다음과 같은 시나리오에 적용할 수 있습니다:

신규 사용자를 위한 직접 회원가입​

타겟팅된 회원가입 캠페인을 위해, 신규 사용자를 기본 로그인 폼을 건너뛰고 바로 회원가입 페이지로 안내하여 원활한 온보딩 경험을 제공할 수 있습니다.

사용: 첫 화면 파라미터 → first_screen=register

자체 호스팅 구독 폼을 통해 이메일을 수집하는 경우, 이 파라미터들을 사용하여 신규 구독자를 이메일 필드가 미리 채워진 회원가입 페이지로 리디렉션할 수 있어, 회원가입 과정을 쉽게 완료할 수 있습니다.

사용: 첫 화면 파라미터 → first_screen=identifier:sign_up&identifier=email&[email protected]

신규 사용자가 새 비밀번호를 설정해야 하는 경우, 직접 링크를 보내 이메일 필드가 미리 입력된 비밀번호 재설정 페이지로 리디렉션하세요.

사용: 첫 화면 파라미터 → first_screen=reset_password

즉시 소셜 로그인​

사이트에 소셜 미디어 로그인 버튼을 직접 제공하는 경우, 이 파라미터를 사용하여 기본 로그인 폼을 건너뛰고 사용자가 선택한 소셜 제공자로 바로 인증 (Authentication)할 수 있습니다.

사용: 직접 로그인 파라미터 → direct_sign_in=social:google

엔터프라이즈 고객을 위한 직접 SSO 로그인​

여러 엔터프라이즈 클라이언트를 대상으로 하는 제품의 경우, 이 파라미터를 사용하여 각 조직에 맞는 SSO 버튼을 표시하고, 범용 로그인 폼을 건너뛰어 각 조직에 최적화된 경험을 제공합니다.

사용: 직접 로그인 파라미터 → direct_sign_in=sso:1234567890

사이트별로 다른 로그인 방식 표시​

제품이 내부 팀과 소비자 또는 서로 다른 조직을 모두 대상으로 하는 경우, 로그인 경험을 맞춤화할 수 있습니다. 예시: - 내부 도구에는 이메일/사용자명 및 비밀번호 로그인만 표시 - 소비자 대상 페이지에는 Google 로그인을 포함한 모든 로그인 옵션 제공

사용: 웹사이트 유형에 따라 서로 다른 첫 화면 또는 직접 로그인 설정 사용

계속 읽으면서 첫 화면을 맞춤화하거나, 사용자에게 직접 로그인 경험을 제공하기 위한 인증 (Authentication) 파라미터에 대해 더 알아보세요.

사이트에 로그인 또는 회원가입 폼을 안전하게 임베드하는 방법

고객 온보딩 경험을 개선하는 작은 팁들