본문으로 건너뛰기

직접 로그인

직접 로그인은 기본적인 Logto 로그인 페이지를 우회하여 소셜 로그인 또는 엔터프라이즈 SSO를 직접 시작할 수 있게 해주는 Logto 전용 인증 (Authentication) 매개변수입니다.

이 기능은 웹사이트에 맞춤형 로그인 페이지나 IdP 로그인 진입점을 포함하고 있는 경우 특히 유용합니다 (사용 사례 보기). 직접 로그인을 사용하면 사용자를 IdP의 로그인 페이지로 직접 리디렉션할 수 있습니다.

소셜 로그인

direct_sign_in 매개변수를 social:<idp-name> 값과 함께 전달하여 소셜 로그인 프로세스를 직접 시작하세요.

커넥터 IdP 이름을 찾는 방법

  1. 콘솔 > 커넥터 > 소셜 커넥터로 이동합니다.
  2. 사용하려는 소셜 커넥터를 클릭합니다.
  3. 커넥터 설정 페이지 상단에서 아이덴티티 제공자 이름을 찾습니다.
소셜 커넥터 IdP 이름

예시

direct_sign_in 매개변수를 사용하여 자신의 인증 요청 URL을 만드세요:

curl --location \
--request GET 'https://[tenant-id].logto.app/oidc/auth?client_id=1234567890&...&direct_sign_in=social:google'

지원되는 Logto SDK에서는 signIn 메서드를 호출할 때 directSignIn 매개변수를 설정할 수 있습니다:

const authResult = await logto.signIn({
redirectUri: 'https://your-app.com/callback',
directSignIn: 'social:google',
});

엔터프라이즈 SSO

direct_sign_in 매개변수를 sso:<connector-id> 값과 함께 전달하여 엔터프라이즈 SSO 로그인 프로세스를 직접 시작하세요.

엔터프라이즈 SSO 커넥터 ID를 찾는 방법

  1. 콘솔 > 엔터프라이즈 SSO로 이동합니다.
  2. 사용하려는 엔터프라이즈 커넥터를 클릭합니다.
  3. 커넥터 설정 페이지 상단에서 커넥터 ID를 찾습니다.
엔터프라이즈 SSO 커넥터 ID

예시

direct_sign_in 매개변수를 사용하여 자신의 인증 요청 URL을 만드세요:

curl --location \
--request GET 'https://[tenant-id].logto.app/oidc/auth?client_id=1234567890&...&direct_sign_in=sso:1234567890'

지원되는 Logto SDK에서는 signIn 메서드를 호출할 때 directSignIn 매개변수를 설정할 수 있습니다:

logtoClient.signIn({
redirectUri: 'https://your-app.com/callback',
directSignIn: 'sso:1234567890',
});

로그인 페이지로의 폴백

직접 로그인 프로세스가 실패할 경우, 예를 들어 커넥터가 발견되지 않거나 활성화되지 않은 경우, 사용자는 표준 로그인 페이지로 리디렉션됩니다.

노트:

우리는 모든 Logto SDK에 direct_sign_in 매개변수에 대한 지원을 점진적으로 추가하고 있습니다. SDK에서 이를 찾을 수 없는 경우, 이슈를 열거나 저희에게 연락해 주세요.

자주 묻는 질문

직접 로그인이 API 인증 (Authentication)과 동일한가요?

아니요, 직접 로그인은 기본 Logto 로그인 페이지를 건너뛰고 사용자를 소셜 또는 엔터프라이즈 SSO 제공자의 로그인 페이지로 직접 리디렉션할 수 있는 사용자 흐름 매개변수입니다. API 기반 인증과 달리, 사용자는 로그인 프로세스를 시작하기 위해 먼저 Logto 인증 엔드포인트로 리디렉션되어야 합니다.