메인 콘텐츠로 건너뛰기
이 퀵스타트를 따라 하면 약 10분 안에 Didit Authentication을 처음부터 끝까지 작동하도록 설정할 수 있습니다. 샌드박스 애플리케이션에 콜백을 등록하고, 로그인 방식을 활성화하고, 호스팅 로그인 페이지로 사용자를 로그인시키고, 서버에서 사용자의 액세스 토큰을 검증한 뒤, 콘솔에서 로그인 내역을 확인합니다.

사전 요구 사항

  • Didit 계정과 샌드박스 애플리케이션이 필요합니다. 계정 생성은 무료이며, 모든 샌드박스 애플리케이션에서 인증이 켜져 있습니다.
  • Node.js 20 이상과 http://localhost:3000에서 실행할 수 있는 웹 앱이 필요합니다.

단계

1

샌드박스 애플리케이션 열기

Business Console에서 애플리케이션 전환기를 사용해 Sandbox 애플리케이션을 선택한 다음 Authentication을 엽니다.Sandbox 애플리케이션은 http://localhost 콜백과 소셜 로그인용 Didit 테스트 자격 증명을 허용하며, 요금이 청구되지 않습니다. Live 애플리케이션에서는 Products 페이지에서 Authentication을 켭니다. 자세한 내용은 애플리케이션 준비를 참조하세요.
2

콜백과 origin 등록하기

Authentication > Security and sessions > Redirect URLs and allowed origins를 열고 다음을 추가합니다.Didit은 등록한 리디렉션 URL로만 사용자를 돌려보내며, 문자 하나까지 정확히 일치해야 합니다. 허용된 origin을 통해 브라우저가 애플리케이션의 Didit origin으로 코드를 교환할 수 있습니다.
Didit Business Console의 Redirect URLs and allowed origins 카드. 허용 목록 및 차단 목록, 로그인 URL과 함께 표시됨

Authentication > Security and sessions 아래의 리디렉션 URL 및 허용된 origin.

3

로그인 방법 켜기

Authentication > Sign-in methods를 열고 Email code를 켭니다. 새 애플리케이션은 모든 방법이 꺼진 상태로 시작하며, 호스팅 페이지에는 켜 둔 방법만 표시됩니다.원하면 Passkeys도 추가하고, Didit 테스트 자격 증명을 사용하는 소셜 로그인 방법도 추가할 수 있습니다. 이 자격 증명은 자체 앱 없이 Sandbox에서 작동합니다. 각 방법에 대한 설명은 로그인 방법에서 확인할 수 있습니다.
Didit Business Console의 Sign-in methods 페이지. 호스팅 로그인 페이지 카드, 비밀번호 없는 방법과 비밀번호 방법, 호스팅 페이지의 실시간 미리 보기가 표시됨

Authentication > Sign-in methods, 호스팅 페이지의 실시간 미리 보기 포함.

4

공개 가능 키 복사하기

Authentication > Developers를 열고 Publishable key를 복사합니다. Sandbox 애플리케이션에서는 pk_test_로 시작합니다.퍼블리시 가능 키는 공개 키이며, 애플리케이션의 Didit 로그인 origin을 식별합니다. Secret key는 브라우저 또는 모바일 코드에 절대 넣지 마십시오.
5

SDK 설치하고 로그인하기

auth.ts
버튼을 클릭하면 호스팅 페이지에서 이메일 주소를 묻고 6자리 코드를 보냅니다. 코드를 입력하면 Didit이 사용자를 콜백으로 돌려보내며, 콜백은 일회용 코드를 세션의 토큰으로 교환합니다. 계정이 없는 주소로 처음 로그인하면 계정이 생성됩니다. 기본 회원가입 정책이 누구나 가입할 수 있도록 허용하기 때문입니다.
휴대폰에 표시된 호스팅 로그인 페이지. 패스키 버튼과 이메일 및 비밀번호 입력란이 있음

휴대폰에 표시된 호스팅 로그인 페이지입니다. 켜 둔 방법만 표시됩니다.

6

서버에서 토큰 검증하기

auth.getToken()에서 받은 액세스 토큰을 Authorization 헤더에 담아 백엔드로 보내고, 보호된 요청마다 서버에서 검증합니다.
server.ts
verifyToken은 발급자의 공개 키로 ES256 서명, 발급자, 만료 시간을 확인합니다. 액세스 토큰의 유효 기간은 최대 5분이며, auth.getToken()이 토큰을 자동으로 갱신합니다. 다른 언어에서도 서버 SDK나 JWT 라이브러리로 같은 토큰을 검증할 수 있습니다. 자세한 내용은 토큰과 JWKS를 참조하세요.
7

콘솔에서 로그인 확인하기

Authentication > Sign-ins를 엽니다. 로그인이 결과, 방법, 기기, 위치, 위험도와 함께 목록에 표시되며, 모든 Sandbox가 기본으로 제공하는 예시 로그인도 함께 보입니다. 해당 사용자는 Users에 나타납니다.
Didit Business Console의 Sign-ins 페이지. 로그인 시도를 상태, 사용자, 방법, 기기, 위치, 위험도, 시간과 함께 나열함

Authentication > Sign-ins: 모든 시도, 상태, 방법, 위험도별 필터 제공.

서버에서 로그인 활동을 받으려면 webhook 대상이 auth.signup 및 auth.login 이벤트를 구독하도록 설정하세요. 자세한 내용은 이벤트와 webhook을 참조하세요.

프로덕션 전환 전 확인 사항

  1. Products 페이지에서 Live 애플리케이션의 Authentication을 켭니다.
  2. 프로덕션용 https:// 리디렉션 URL과 오리진을 해당 페이지에 등록합니다. Live 애플리케이션은 https://만 허용합니다.
  3. 소셜 로그인용 Didit 테스트 자격 증명을 자체 앱의 클라이언트 ID와 시크릿으로 교체합니다.
  4. Live 퍼블리셔블 키(pk_live_)를 프로덕션 설정에 복사합니다.
  5. 프로덕션 전환 체크리스트를 따라 진행합니다.

다음 단계

연동 가이드

호스팅 화면 또는 직접 만든 화면, 토큰 저장, 세션, 단계별 인증 강화, 문제 해결을 다룹니다.

React 및 Next.js

컴포넌트, 훅, HttpOnly 쿠키, 서버에서의 auth()를 설명합니다.

iOS, Android, React Native 및 Flutter

시스템 브라우저를 이용한 네이티브 로그인, 패스키, 보호된 저장소를 설명합니다.

봇 방어

봇과 계정 탈취를 막는 정책을 켭니다.
마지막 수정일 2026년 11월 22일