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

애플리케이션 준비

  1. Didit 애플리케이션에서 Authentication이 활성화되어 있는지 확인하고, 콘솔에서 로그인 오리진(https://<slug>.auth.didit.me, 샌드박스는 <slug>.sandbox.auth.didit.me)을 복사합니다.
  2. 애플리케이션과 런타임이 지원하는 정확한 콜백 URL을 등록합니다. 앱 링크의 소유권을 검증하세요. 임의의 커스텀 URL 스킴이 허용된다고 가정하지 마세요.
  3. 샌드박스 설정과 라이브 설정을 분리해 유지합니다. 콜백 처리와 저장된 자격 증명도 포함합니다.
  4. 인증 또는 모니터링을 연결하기 전에 안정적인 사용자 매핑을 선택합니다.
호스팅 로그인에는 시스템 브라우저 탭을 사용하고, 돌아오는 앱 링크를 검증하세요. 네이티브 패스키에는 구성된 신뢰 당사자 도메인과 플랫폼 자격 증명 흐름이 필요합니다.

호스팅 흐름 구현

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

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

네이티브 Authentication 모듈은 로그인, 현재 세션 접근, 토큰 조회, 로그아웃, 단계별 인증(step-up)을 제공할 예정이며, 기기 신호는 자동으로 수집됩니다. 네이티브 패스키와 보호된 토큰 저장소도 해당 릴리스에 포함됩니다. 래퍼 API는 공개된 플랫폼 규격을 따릅니다. 설계 예시에 있는 추측된 생성자 인수나 메서드 시그니처를 복사하지 마세요. 모듈이 릴리스되기 전까지는 해당 어댑터를 비활성화해 두거나, 활성화된 애플리케이션을 위해 검토된 호스팅 프로토콜 구현을 사용하세요. 패키지 설치만으로 동작하는 네이티브 Authentication 빠른 시작이 있다고 알리지 마세요.

인증 및 모니터링 연결

백엔드는 인증된 사용자로부터 vendor_data를 생성합니다. 이 사용자를 위해 인증 세션을 만들거나 범위가 지정된 모니터링 토큰을 발급합니다. 앱에는 세션 자격 증명 또는 범위가 지정된 토큰만 반환하세요. API 키는 서버에 남아 있어야 합니다. 신원 인증이 필요하면 Android 인증 SDK를 사용하세요. 플랫폼에서 모니터링을 지원하려면 SDK 거래 제출을 따르세요. 로그인, 인증, 거래 결정은 각각 별도로 다루세요.

연동 검증

앱이 콜드 상태일 때 앱으로 돌아오는 경우, 백그라운드와 포그라운드 전환, 브라우저 취소, 일치하지 않는 콜백, 코드 재사용, 토큰 만료, 동시 토큰 갱신, MFA, 로그아웃, 다른 사용자로 로그인하는 경우를 테스트하세요. 해당 릴리스를 사용할 수 있게 되면 지원되는 기기에서 패스키 등록과 로그인을 테스트하세요. 대상 플랫폼에서 실행하기 전까지 기기 전용 확인 항목은 검증되지 않은 상태로 남습니다.
마지막 수정일 2026년 11월 7일