생체 인증 | 사용자 경험, 알림, 인터랙션 | Appbox SDK 가이드

사용자 경험•알림•인터페이스

생체 인증

지문이나 얼굴 인식을 사용해 앱 접근을 더 안전하게 보호할 수 있습니다.
Touch ID 또는 Face ID를 활용해 특정 화면이나 기능 실행 전 사용자 인증을 요청할 수 있으며, 인증 결과는 웹으로 전달됩니다.

생체정보 인증하기

AppboxSDK.application.biometricAuth(...)

Javascript
1 // 생체 인증
2 AppboxSDK.application.biometricAuth( { haptic : true }, (err, data) => {
3 if (err) {
4 console.error( "생체 인증 실패:", "code:", err.code, "message:", err.message );
5 } else {
6 console.log( "생체 인증 OK:", data.result );
7 }
8 });

Request 항목 정의

Request 항목 필수여부 설명 기본값
haptic - 성공 또는 실패시 진동 햅틱 (true, false)

Response 항목 정의

Response 결과값
data.result 성공 여부 (true | false)
err.code 에러코드 (-1000 : 사용자가 취소, -7000 : 생체 인증을 쓸 수 없음(지원 안 함, 미등록, 일시적 사용 불가, 잠김, iOS 는 기기 암호 미설정 포함), -9999 : 인증 실패, 기타)
err.message 에러 메시지

카메라 권한과는 관계없습니다. iOS 는 생체 인증이 안 되면 기기 암호 입력으로 넘어갑니다.


생체인증을 사용하려면, 생체인증을 지원하는 디바이스 이여야 하며, 생체인증이 등록되어 있어야 합니다.
생체인증이 등록되지 않은 경우 err.code=-7000 으로 리턴됩니다.







www.naver.com
QR 코드를 촬영하면 입력하신 주소의
앱 예시 화면을 테스트할 수 있습니다.
* 스캔 후 바로 앱 다운로드 이동합니다.