본문으로 건너뛰기

에러 코드

설명#

GCCS 인증 및 생체 인증 구현 중 발생할 수 있는 에러를 설명합니다.


인증 시 사용자 관련 에러#

Error CodeDescriptionSolution
2000클라이언트 키가 잘못된 경우발급 받은 클라이언트 키를 확인합니다.
SDK 초기화 시 클라이언트 키를 사용했는지 확인바랍니다.
2008가입되어 있지 않은 사용자인 경우GCCS 가입 여부를 확인바랍니다.
가입 여부는 GuardianSdk의 getMe()로 확인할 수 있습니다.
5001인증 시간이 만료된 경우인증 시간이 만료된 경우로 인증 재요청이 필요합니다.
5005승인되지 않은 사용자승인되지 않은 사용자로 관리자에게 문의바랍니다.
5006일시 정지된 사용자일시 정지된 사용자로 관리자에게 문의바랍니다.
5007영구 정지된 사용자영구 정지된 사용자로 관리자에게 문의바랍니다.
5008탈퇴 사용자탈퇴한 사용자로 일정 기간 내에 계정 복구 기능을 통해 복구가 가능합니다.

인증 관련 에러#

Error CodeDescriptionSolution
2004채널이 존재하지 않는 경우초기화 설정한 서버 URL을 확인합니다.
계속 발생하는 경우 관리자에게 문의바랍니다.
2010인증이 진행 중인 사용자인 경우인증이 진행 중인 사용자로 상황에 따라 인증취소 후 재인증 요청 바랍니다.
5010인증 실패관리자에게 문의 바랍니다.
5011인증이 취소된 경우재인증 요청 바랍니다.
5015채널 생성 실패파라미터가 부족한 경우 발생할 수 있습니다.
지속적으로 발생하는 경우 문의바랍니다.
5017푸시 알림 전송 실패등록한 FCM Server Key에 문제가 있는지, 업데이트한 FCM 토큰이 올바른지 확인합니다.
5022검증이 실패한 경우노드 검증이 실패한 경우 발생할 수 있습니다.
지속적으로 발생하는 경우 관리자에게 문의바랍니다.

생체 인증 관련 에러#

Error CodeDescriptionSolution
9001생채인증을 지원하지 않는 iOS 버전입니다사용 중인 기기의 버전이 iOS 13.0 이하인 경우 발생할 수 있습니다.
생체인증을 사용할 수 없는 경우 패턴 or 비밀번호가 사용됩니다.
9003생체인증을 지원하지 않는 기기입니다사용 중인 기기가 생체인증 인식 모듈을 지원하지 않습니다.
생체인증을 사용할 수 없는 경우 패턴 or 비밀번호가 사용됩니다.
9004생체인증 정보를 등록하지 않은 기기입니다사용 중인 기기에 생체 정보가 등록되어 있지 않습니다.
생체인증을 사용할 수 없는 경우 패턴 or 비밀번호가 사용됩니다.
9005앱에 등록된 생체인증 정보가 존재하지 않습니다iOS SDK에 생체정보를 등록하지 않은 기기입니다.
GuardianSdk에 registerBiometric()로 생체정보를 등록바랍니다.
9006생체인증 정보가 변경되었습니다사용자가 사용 중인 기기의 생체 정보를 변경할 경우 발생합니다.
GuardianSdk에 resetBiometric()로 생체정보를 초기화바랍니다.
9007등록되어 있는 생체인증 정보가 존재합니다생체정보 등록 시 이미 등록된 생체정보가 있는 경우 발생합니다.
9008생체인증 정보가 일치하지 않습니다생체 인증 시 생체정보를 인식하지 못하는 경우 발생합니다. 올바른 생체 정보를 인식바랍니다.
9009생체인증 오류기타 오류로 생체 인증을 사용할 수 없습니다. 관리자에게 문의바랍니다.

기타 에러#

Error CodeDescriptionSolution
10002SDK에서 에러가 발생SDK 내에서 Exception이 발생, 관리자에게 문의바랍니다.
10003서버에서 에러가 발생API 서버에서 Exception이 발생, 관리자에게 문의바랍니다.
10004서버 접속 에러서버와 연결이 되지 않습니다.
인터넷 연결 확인 및 초기화 시 사용한 서버주소를 확인바랍니다.