메인 콘텐츠로 건너뛰기
이 가이드는 첫 리디렉션부터 출시 전 체크리스트까지, 프로덕션 환경에서 Didit Authentication 연동이 어떻게 구성되는지 설명합니다. 사용자를 아직 로그인시키지 않으셨다면 빠른 시작부터 시작하십시오. 각 SDK의 코드는 플랫폼별 빠른 시작 가이드를 참고하십시오.

아키텍처

네 가지 구성 요소가 관여합니다. Didit API 키와 시크릿은 앱에 절대 포함되어서는 안 됩니다. 공개용 키(publishable key)는 공개되어도 괜찮으며, 코드 교환은 클라이언트 시크릿 대신 PKCE로 보호됩니다.

호스팅 페이지 또는 직접 만든 화면

사용자가 이메일, 비밀번호, 코드를 입력하는 위치를 선택합니다. 설정 값은 sign_in_ui이며, 기본값은 hosted이고 own으로 바꿀 수 있습니다. 나중에 변경할 수도 있습니다. 패스키는 애플리케이션의 로그인 출처에 연결됩니다. SDK의 패스키 메서드는 해당 출처에서 제공되는 페이지에서만 동작하므로, 다른 도메인의 직접 만든 화면에서는 패스키를 사용하려면 호스팅 페이지로 안내해야 합니다.

SDK 선택

SDK를 사용하지 않는다면 PKCE를 사용한 인가 코드 흐름을 직접 구현하십시오. JavaScript 빠른 시작에서 전체 규격을 확인할 수 있습니다.

백엔드 보호

프론트엔드의 세션 확인은 화면에 표시할 내용만 제어합니다. 백엔드는 검증된 토큰을 기준으로 모든 결정을 내립니다.
  1. 모든 요청마다 액세스 토큰을 검증합니다. 발급자의 JWKS를 사용해 ES256 서명을 확인한 다음 iss, aud, exp, typ: at+jwt를 확인하고, 라우트가 AI 에이전트를 허용하는 경우를 제외하고 act가 null이 아닌 토큰은 거부합니다. 서버에서 토큰을 검증하는 방법을 참조하십시오.
  2. 민감한 작업 전에 라이브 세션을 확인합니다. 액세스 토큰은 만료될 때까지 최대 5분 동안 유효합니다. GET /session/은 세션이 취소되었거나 유휴 상태가 되었거나 만료된 경우, 사용자가 차단된 경우, 또는 세션이 더 이상 MFA 정책을 충족하지 않는 경우 즉시 실패합니다. 세션 확인하기를 참조하십시오.
  3. 작업이 위험한 경우 추가 인증을 요청합니다. 지급, 새 은행 계정 등록, 이메일 또는 전화번호 변경 전에 Didit에 사용자가 다시 인증해야 하는지 문의하고, 백엔드가 직접 읽은 approved 상태의 추가 인증에 대해서만 조치합니다. 민감한 작업 전 추가 인증을 참조하십시오.
  4. vendor_data는 검증된 토큰에서 가져옵니다. 브라우저가 보낸 필드에서는 절대 가져오지 않습니다. 이 값은 사용자의 인증 및 거래에 사용합니다.

Sessions

세션 기간은 Authentication > Security and sessions에서 변경하거나, 애플리케이션 설정에서 API를 통해 변경할 수 있습니다.
Didit Business Console의 Active sessions 화면. 로그인된 세션의 기기, 위치, 시작 시각, 마지막 활동, 종료 시각과 Revoke 버튼이 표시되어 있습니다.

Authentication > Sign-ins > Active sessions 화면. 각 세션에 Revoke 버튼이 표시됩니다.

네이티브 앱

Didit은 HTTPS 리디렉션으로만 사용자를 네이티브 앱으로 돌려보냅니다. 사용자 지정 URL 스킴은 지원하지 않습니다.
  • iOS: 리디렉션을 연결된 도메인으로 설정하고, apple-app-site-association에 webcredentials를 포함하세요.
  • Android: 리디렉션을 App Link로 설정하고, assetlinks.json을 사용하세요.
  • 모든 리디렉션 URL을 웹 콜백과 같은 방식으로 Authentication > Security and sessions에 등록하세요.
앱에서 패스키를 사용하려면, 애플리케이션의 패스키를 공유하는 앱을 인증 관리 API의 PUT native-apps/로 등록하세요. 그러면 Didit은 등록된 앱을 로그인 오리진에서 제공하는 apple-app-site-association과 assetlinks.json에 나열합니다. MANAGEMENT_BASE는 애플리케이션의 관리 API 주소이며, authentication 범위에서 쓰기 권한이 있는 API 키로 이 호출을 할 수 있습니다. 이 호출은 두 목록을 모두 교체하므로, 두 목록을 함께 보내세요:
앱 측 설정은 iOS 및 Android 빠른 시작 가이드에서 확인할 수 있습니다.

신원 확인 및 거래 모니터링 연결

모든 사람에게는 토큰과 세션에 담기는 vendor_data 값이 하나씩 있습니다. 인증 세션을 생성하거나 거래를 제출할 때 이 값을 vendor_data로 사용하면, 콘솔에서 로그인, 인증, 거래를 같은 사람에 대해 확인할 수 있습니다.
  • 회원가입 시점이나 지급 전에 다시 인증 흐름을 직접 구축하지 않고 사람을 확인하려면 검증된 신원을 사용하십시오.
  • 로그인 이벤트는 이벤트 규칙과 사기 탐지 화면으로 자동 전달됩니다. 같은 로그인에 대해 auth.login 이벤트를 직접 전송하지 마십시오.
  • 로그인이 성공해도 인증이나 거래가 승인되지는 않습니다. 각 제품의 결정은 개별적으로 처리하십시오.
여러 제품에서 한 사용자 유지하기를 참고하십시오.

로그인 이벤트 수신

webhook 대상이 필요한 auth.* 유형(예: auth.new_device, auth.account_locked)을 구독하도록 설정하십시오. 중복 제거는 auth_event.event_id를 기준으로 하고, 모든 Didit webhook과 마찬가지로 서명을 검증하십시오. 모든 유형과 페이로드는 이벤트 및 webhook에서 확인하십시오.

기존 사용자 이전

이미 다른 신원 인증 플랫폼이나 자체 데이터베이스에 계정을 가진 사용자가 있다면, 로그인 방식을 전환하기 전에 사용자를 가져오십시오. 원본에서 제공되는 경우 비밀번호 해시를 가져오고, 소셜 연동 정보를 유지하며, 자체 사용자 ID는 external_id로 보관하십시오. 이 값은 사용자의 vendor_data가 됩니다. 앱을 Didit으로 전환하기 전까지 사용자에게는 아무것도 달라지지 않습니다.

운영 전환 체크리스트

  1. 인증 기능이 Products 페이지에서 Live 애플리케이션에 대해 켜져 있어야 합니다.
  2. 운영용 https:// 리디렉션 URL과 허용 출처가 Live 애플리케이션에 등록되어 있어야 합니다. Live 애플리케이션은 http:// 주소를 허용하지 않습니다.
  3. 각 소셜 로그인 방식은 자사 앱의 클라이언트 ID와 시크릿을 사용해야 합니다. Didit의 테스트 자격 증명은 샌드박스에서만 작동합니다.
  4. 운영 환경 설정에 Live 공개 키(pk_live_)와 Live 발급자가 포함되어 있어야 합니다.
  5. MFA 정책, 세션 유효 기간, 유휴 시간 제한, 비밀번호 길이, 가입 정책이 원하는 대로 설정되어 있어야 합니다. 애플리케이션 설정을 참고하십시오.
  6. 봇 방지가 켜져 있고 유출된 비밀번호 확인이 설정되어 있어야 합니다.
  7. 백엔드가 모든 액세스 토큰을 검증하고, 민감한 작업 전에 GET /session/을 호출해야 합니다.
  8. 브랜딩, 페이지 문구, 이용약관 및 개인정보처리방침 링크가 설정되어 있어야 합니다. 커스텀 도메인을 사용할 계획이라면, 사용자가 패스키를 추가하기 시작하기 전에 활성화하십시오.
  9. webhook 대상이 처리하는 auth.* 유형을 구독하고 있어야 합니다.
  10. Live 애플리케이션에서 가입, 기존 계정 재로그인, 가입 취소, 비밀번호 찾기, MFA, 세션 만료, 로그아웃, 철회된 세션을 모두 테스트했어야 합니다.

문제 해결

마지막 수정일 2026년 11월 22일