환경 설정하기
eKYC 연동을 시작하기 전에 아래 두 가지 준비를 먼저 완료해 주세요.
이 단계는 연동 개발을 시작하기 위한 필수 절차예요.
1. 계정 발급 및 Admin 설정하기
1) 유스비 계정 발급 신청하기
서비스를 연동하려면 고객사 전용 계정이 필요해요.
- 아래 신청서를 통해 유스비에 계정 발급을 요청해 주세요.
- 유스비 담당자가 확인한 뒤, 신청하신 이메일로 계정 정보를 보내드려요.
계정 발급 신청하기 (Jotform)
Q. 발급받은 계정 정보는 어떤 형식인가요?
ㄴ A. 발급된 계정 정보는 customer_id, id, key 형식이에요.
Q. 계정 정보는 어디에서 확인할 수 있나요?
ㄴ A. 계정 정보는 useB.에서 보내드리는 메일에 첨부된 파일에서 확인할 수 있어요.
Q. 받은 계정 정보는 어떻게 사용하나요?
ㄴ A. 해당 정보는 eKYC 인증 요청 시 필수 파라미터로 사용되니, 꼭 안전하게 보관해 주세요.
2) Admin 설정하기
아래 조건 중 하나라도 해당된다면, 유스비 Admin에서 연계 설정을 해줘야 해요.
설정은 간단해서 고객사에서도 직접 하실 수 있어요.
(1) 엔드 유저의 필수 정보를 유스비 화면으로 입력 받는 경우
고객사 서비스의 UI에서 엔드 유저의 필수 정보를 수집하지 않고, 유스비가 제공하는 화면에서 수집 받으려면 Admin에서 설정을 변경해줘야 해요.
설정 위치: Admin > 기타 설정 > 개인정보 옵션 > [사용자 필수 정보 수신]
| 설정 값 | 설명 |
|---|---|
| 사용 중 | 고객사의 서비스 화면에서 엔드 유저의 필수 정보를 입력 받아요. |
| 미사용 | 유스비 화면에서 엔드 유저의 필수 정보를 입력 받아요. |
(2) 신분증 사본탐지 기능을 사용하는 경우 (유상 옵션)
업로드된 이미지가 신분증 사본인지 자동으로 판별하는 기능이에요.
이 기능은 유상으로 제공되며, 구매 여부는 유스비 담당자가 확인해 Admin 설정이 가능하도록 열어드려요.
설정 위치: Admin > 인증 설정 > 심사 방식 > 신분증 인증 > [사본탐지 사용]
Q. 사본탐지 기능을 사용하지 않으면 설정을 안 해도 되나요?
ㄴ A. 네, 사본탐지 기능을 사용하지 않거나 고객사에서 직접 사용자 정보를 입력받는 경우엔 설정 없이 진행해도 돼요.
Q. Admin 설정은 누가 하나요?
ㄴ A. 고객사에서 직접 설정할 수 있어요. 유상 기능은 담당자가 먼저 확인한 뒤 설정할 수 있도록 반영해 드려요.
2. 개발 환경 확인하기
eKYC 인증을 연동하기 전에, 고객사의 웹 또는 앱 환경이 인증 기능을 정상적으로 지원하는지 꼭 확인해 주세요.
카메라 접근 제한이나 브라우저 호환성 문제로 인해 인증이 실패하는 경우도 있어요.
1) WEB 환경 (iframe 방식)
웹에서는 iframe을 통해 인증 화면을 띄우는 방식으로 연동해요.
※ 새 창 방식은 인증 결과 메시지를 받을 수 없기 때문에, iframe 방식만 사용할 수 있어요.
사용할 수 있는 브라우저
- Chrome (iOS 13 이상)
- Safari (iOS 13 이상)
- Samsung Internet
- Naver In App
- Daum In App
- Kakao In App
사용할 수 없는 브라우저
- Nate In App
위 브라우저는 카메라 기능(webRTC)을 안정적으로 지원하지 않아서 인증이 불가능해요.
해당 환경에서 인증을 시도하면, 지원하지 않는 환경이라는 안내 팝업이 자동으로 보여요.
2) 네이티브 APP 환경 (WebView 방식)
앱에서는 WebView를 통해 인증 화면을 띄워요.
카메라 권한 설정, postMessage 처리, 샘플 코드 등 필요한 가이드를 모두 제공해 드려요.
연동할 수 있는 개발 환경
| React Native | iOS (iOS 14 이상) | Android |
|---|---|---|
| CLI | Swift | Java |
| Expo | Objective-C | Kotlin |
지원하지 않는 환경에서는 인증 화면이 제대로 노출되지 않거나, 카메라 기능이 작동하지 않을 수 있어요.
운영 환경에 반영하기 전에, 반드시 브라우저 및 앱별 테스트를 진행해 주세요.
Q. 지원하지 않는 브라우저에서 인증을 시도하면 어떻게 되나요?
ㄴ A. 인증 화면 진입 시 자동으로 안내 팝업이 뜨고, 인증은 진행되지 않아요.
Q. iOS 앱에서도 iframe 방식으로 연동할 수 있나요?
ㄴ A. 네, iOS 13 이상 Safari 또는 인앱 브라우저에서는 iframe 방식 연동이 가능해요.
Q. 앱에서 카메라가 작동하지 않아요.
ㄴ A. WebView에서 카메라 권한 요청이 제대로 설정되어 있는지 확인해 주세요.
권한 설정이 누락된 경우, 카메라 접근이 차단될 수 있어요.