첫 화면 매개변수
사용자에게 원하는 첫 화면 경험을 맞춤화할 수 있는 사용자 정의 인증 매개변수 세트입니다.
first_screen: 사용자가 처음 보게 될 화면을 지정합니다.identifier: 로그인 또는 회원가입 양식에서 허용할 식별자 유형을 지정합니다.login_hint: 사용자의 이메일 주소 또는 사용자 이름으로 식별자 필드를 채웁니다. (이는 OIDC 표준 매개변수입니다)
first_screen
first_screen 매개변수는 사용자가 Logto의 로그인 페이지로 리디렉션될 때 처음 보게 될 화면을 결정하는 핵심 매개변수입니다. 기본적으로는 범용 로그인 양식이 표시됩니다. 이 매개변수를 사용하여 애플리케이션의 요구 사항에 따라 첫 화면을 맞춤화하세요. 지원되는 값은 다음과 같습니다:
sign_in: 로그인 양식을 표시합니다. (기본값)register: 회원가입 양식을 표시합니다.reset_password: 비밀번호 재설정 양식을 표시합니다.single_sign_on: 엔터프라이즈 SSO 로그인 양식을 표시합니다. (활성화된 SSO 제공자를 결정하기 위해 이메일 주소가 필요합니다)identifier:sign-in: 특정 식별자 로그인 양식을 표시합니다. 식별자 유형은identifier매개변수를 사용하여 지정할 수 있습니다. 여러 식별자 로그인 방법이 활성화된 경우 유용합니다.identifier:register: 특정 식별자 회원가입 양식을 표시합니다. 식별자 유형은identifier매개변수를 사용하여 지정할 수 있습니다. 여러 식별자 회원가입 방법이 활성화된 경우 유용합니다.
예를 들어, 사용자를 엔터프라이즈 SSO 로그인 양식으로 직접 보내는 경우:
curl --location \
--request GET 'https://<your-tenant>.logto.app/oidc/auth?client_id=<client_id>&...&first_screen=single_sign_on'
identifier
identifier 매개변수는 로그인 또는 회원가입 양식에서 사용할 식별자 유형을 지정하는 데 사용됩니다. 이 매개변수는 first_screen 매개변수가 identifier:sign-in, identifier:register, 또는 reset_password로 설정된 경우에만 적용됩니다. 지원되는 값은 username, email, phone입니다. 여러 값을 허용하려면 빈 공간으로 구분하세요.
예를 들어, 사용자를 이메일 또는 전화번호 회원가입 페이지로 직접 보내는 경우:
curl --location \
--request GET 'https://<your-tenant>.logto.app/oidc/auth?client_id=<client_id>&...&first_screen=identifier:register&identifier=email phone'
이 매개변수에 지정된 모든 식별자 유형은 Logto 콘솔의 로그인 또는 회원가입 설정에서 활성화되어 있어야 합니다.
지원되지 않거나 비활성화된 식별자 유형은 무시됩니다. 지정된 모든 식별자가 지원되지 않는 경우, 기본 로그인 경험 구성이 사용됩니다.
login_hint
표준 OpenID Connect 사양에 정의된 login_hint 매개변수는 사용자의 식별자 (예: 이메일, 전화번호 또는 사용자 이름)로 로그인 양식을 미리 채우는 데 사용됩니다. Logto에서는 다른 로그인 화면 매개변수와 결합하여 사용자 경험을 향상시킬 수 있습니다. 이 매개변수는 사용자 식별자를 미리 수집하는 사용자 정의 사전 인증 양식이 있는 경우 특히 유용하며, 로그인 시 이를 다시 입력할 필요가 없도록 합니다.
예를 들어, 수집된 이메일 주소를 로그인 양식에 미리 채우는 경우:
curl --location \
--request GET 'https://<your-tenant>.logto.app/oidc/auth?client_id=<client_id>&...&first_screen=identifier:sign_in&identifier=email&login_hint=[email protected]
SDK 지원
지원되는 Logto SDK에서는 signIn 메서드를 호출할 때 매개변수를 설정할 수 있습니다:
logtoClient.signIn({
redirectUri: 'https://your-app.com/callback',
firstScreen: 'identifier:register',
identifier: ['email', 'phone'],
loginHint: '[email protected]',
});