메인 콘텐츠로 건너뛰기
Authentication는 새로운 기능이며 didit_auth는 릴리스에 따라 달라집니다. 배포 좌표, 버전 및 호출 가능한 시그니처는 여기에서 확인되지 않습니다. 추측으로 패키지를 설치하지 마시고, Identity verification SDK를 Authentication SDK처럼 사용하지 마십시오.

애플리케이션 준비

  1. Didit 애플리케이션에서 Authentication이 활성화되어 있는지 확인하고, 콘솔에서 로그인 오리진(https://<slug>.auth.didit.me, 샌드박스의 경우 <slug>.sandbox.auth.didit.me)를 복사합니다.
  2. 애플리케이션과 런타임이 지원하는 정확한 콜백 URL을 등록합니다. 앱 링크의 소유권을 검증하고, 임의의 커스텀 URL 스킴이 허용된다고 가정하지 마십시오.
  3. 샌드박스와 프로덕션 환경의 구성을 분리해 유지합니다. 여기에는 콜백 처리와 저장된 자격 증명도 포함됩니다.
  4. 검증 또는 모니터링을 연결하기 전에 안정적인 사용자 매핑 방식을 선택합니다.
iOS와 Android에서 콜백 링크를 각각 따로 구성하고 테스트합니다. Authentication 래퍼는 신분증 인증을 담당하는 didit_sdk와 별개입니다.

호스팅 흐름 구현

{origin}/sign-in URL로 네이티브 시스템 인증 브라우저를 엽니다. 매번 새로운 무작위 state, S256 PKCE 챌린지, 등록된 redirect_uri를 함께 전달합니다. 검증자(verifier)는 해당 인증 시도 동안에만 앱에 보관합니다. JavaScript 빠른 시작에서 기본 프로토콜을 확인할 수 있으며, 네이티브 코드에서는 브라우저 전역 객체 대신 플랫폼의 암호화 기능과 URL 처리를 사용하십시오. 콜백을 받으면 token/에서 일회용 코드를 교환하기 전에 state, 트랜잭션 유효 기간, 콜백 대상을 검증합니다. 원래의 검증자와 정확한 리다이렉트 URI를 사용합니다. 브라우저를 취소하거나 닫는 것은 로그인 성공이 아닙니다. 리프레시 토큰은 플랫폼에서 보호되는 네이티브 저장소에만 저장하십시오. 평문 환경설정 파일, 분석 도구 또는 크래시 로그에는 절대 저장하지 마십시오. 최종 사용자의 Bearer 토큰으로 GET session/을 호출해 현재 세션을 검증합니다. 리프레시는 직렬화하여 처리하고, 두 토큰을 함께 교체합니다. 로그아웃 후에는 사용자별 상태를 삭제합니다. 요청 계약과 리프레시 재사용 동작은 토큰 및 JWKS를 참고하십시오.

네이티브 SDK 릴리스 미리보기

네이티브 Authentication 모듈은 자동 기기 신호와 함께 로그인, 현재 세션 조회, 토큰 가져오기, 로그아웃, 추가 인증을 제공할 예정입니다. 네이티브 패스키와 보호된 토큰 저장소도 해당 릴리스에 포함됩니다. 래퍼 API는 공개된 플랫폼 계약을 따르며, 설계 예시에 있는 추측된 생성자 인수나 메서드 시그니처를 복사하지 마십시오. 모듈이 출시되기 전까지는 해당 어댑터를 비활성화된 상태로 두거나, 활성화된 애플리케이션에 대해 검토를 마친 호스팅 프로토콜 구현을 사용하십시오. 패키지 설치만으로 네이티브 Authentication 빠른 시작이 동작한다고 홍보하지 마십시오.

검증 및 모니터링 연결

백엔드가 인증된 사용자로부터 vendor_data를 도출합니다. 그 사용자를 위해 검증 세션을 생성하거나 범위가 지정된 모니터링 토큰을 발급합니다. 앱에는 세션 자격 증명이나 범위가 지정된 토큰만 반환하며, API 키는 서버에만 보관합니다. 신분증 인증이 필요하면 Flutter 검증 SDK를 사용합니다. 플랫폼에서 모니터링을 지원하려면 SDK 거래 제출을 따르십시오. 로그인, 검증, 거래에 대한 결정은 각각 별도로 처리합니다.

통합 검증

콜드 스타트 후 앱으로 돌아오기, 백그라운드 및 포그라운드 전환, 브라우저 취소, 일치하지 않는 콜백, 코드 재사용, 토큰 만료, 동시 리프레시, MFA, 로그아웃, 다른 사용자로 로그인하기를 테스트합니다. 패스키 등록과 로그인은 해당 릴리스가 제공된 후 지원되는 기기에서 테스트하십시오. 기기 전용 검사는 대상 플랫폼에서 실행될 때까지 검증되지 않은 상태로 남습니다.
마지막 수정일 2026년 11월 7일