SDK 및 도구
Unico SDK는 클라이언트 측에서 캡처 경험을 관리하기 위해 애플리케이션에 직접 임베드됩니다. 캡처가 성공하면 SDK는 암호화된 페이로드를 반환하고, 백엔드에서 이를 REST API를 통해 분석을 위한 IDCloud 생체 인식 엔진으로 전달합니다.
사용 가능한 SDK
Java 및 Kotlin 애플리케이션을 위한 네이티브 라이브러리입니다.
Swift 및 Objective-C 애플리케이션을 위한 네이티브 라이브러리입니다.
Android 및 iOS 네이티브 SDK 위에 구축된 플러그인입니다.
샘플 앱(PoC)
통합을 시작하기 전에 각 SDK의 공식 개념 증명(PoC) 앱을 확인해 보세요 — 주요 캡처 플로우에 대한 검증된 최신 구현입니다.
네이티브 SDK
| 플랫폼 | 플로우 | 저장소 |
|---|---|---|
| Android | 라이브니스 | GitHub — unico-sdk-poc-kotlin |
| Android | User Journeys | GitHub — unico-sdks-poc-kotlin |
| iOS | 라이브니스 | GitHub — unico-sdk-poc-ios-swift |
| iOS | User Journeys | GitHub — unico-sdks-poc-swift |
| Flutter | 라이브니스 | GitHub — unico-sdk-poc-flutter |
| Flutter | User Journeys | GitHub — unico-sdks-flutter |
웹 앱 통합(Journeys SDK)
| 언어 / 프레임워크 | 저장소 |
|---|---|
| Angular | GitHub — unico-cbu-poc-angular |
| JS Vanilla | GitHub — unico-cbu-poc-js |
| React | GitHub — unico-cbu-poc-react |
| Vue JS | GitHub — unico-cbu-poc-vuejs |
Web SDK
| 언어 / 프레임워크 | 저장소 |
|---|---|
| Angular | GitHub — unico-sdk-poc-angular |
| JS Vanilla | GitHub — unico-sdk-poc-js-vanilla |
| Next.js | GitHub — unico-sdk-poc-next-js |
| React JS with TypeScript | GitHub — unico-webframe-poc-react |
| React JS with JavaScript | GitHub — unico-sdk-poc-react-js |
| React JS with Webpack + Babel | SFTP — 프로젝트 매니저에게 요청 |
| Vue JS | GitHub — unico-sdk-poc-vuejs |
주요 기능
SDK는 Liveness 기능과 통합되어 캡처 시점에 사용자가 실제로 존재하는지 확인합니다. 캡처 세션은 liveness가 검증된 경우에만 완료되며, 사진, 영상, 마스크 등의 스푸핑 시도를 차단합니다.
캡처 UI는 사용자의 실루엣과 화면 크기에 맞게 자동으로 조정됩니다. 이를 통해 개발자의 별도 설정 없이도 표준 카메라 구현에 비해 생체 인식 유효성이 향상되고 캡처 거부율이 감소합니다.
보안 계층
각 SDK에는 런타임에 적용되는 여러 보안 제어 기능이 포함되어 있습니다:
- 클라이언트와 백엔드 간의 페이로드 암호화
- 주입 및 변조 방지
- 카메라 모드 전반에 걸친 사기 탐지
- 코드 난독화
- 에뮬레이터 차단
- 앱 번들 검증
작동 방식
SDK(클라이언트 측)는 카메라 조작, 이미지 캡처, 사용자 여정의 모든 복잡성을 처리하여 Unico 플랫폼과의 통합을 간소화하는 역할을 합니다.
캡처가 성공하면 SDK는 생체 인식 엔진 API로 전송해야 하는 암호화된 페이로드를 반환하여 아래 다이어그램과 같이 생체 인식 검증을 완료합니다:
SDK는 클라이언트의 전체 캡처 흐름을 처리합니다: 카메라 접근, 프레임 검증, liveness 확인, 암호화. 백엔드는 암호화된 페이로드를 수신하여 IDCloud 생체 인식 엔진으로 전달합니다 — 원본 이미지는 전송되지 않습니다.
이 SDK들은 Web & SDK 계약(POST /client/v1/process)의 출력을 생성합니다. API 계약의 경우, 캡처는 별도의 환경에서 처리되며 imageBase64가 직접 전송됩니다.
SDK 버전은 시맨틱 버전 관리(MAJOR.MINOR.PATCH)를 따릅니다. SDK 업데이트 책임은 통합 방식에 따라 다릅니다. by-Client 통합의 경우, SDK를 최신 상태로 유지하는 것은 고객의 책임이며 구버전은 보안 적용 범위를 잃거나 새로운 기능에 접근하지 못할 수 있습니다. by-Unico 통합의 경우, Unico가 자동으로 업데이트를 적용합니다.
- 주요 버전(MAJOR): API에 호환되지 않는 변경 사항이 있을 때.
- 부 버전(MINOR): 호환성을 유지하면서 기능이 추가될 때.
- 패치 버전(PATCH): 호환성을 유지하면서 버그가 수정될 때.
지원: 네이티브 Android, 네이티브 iOS, 당사 플러그인을 통한 Flutter. 미지원: React Native, Ionic을 포함한 모든 하이브리드 또는 크로스 플랫폼 프레임워크.