통합(법인) 인증 서비스를 적용하기 위한 사용자앱 Client 라이브러리 API를 정의
공통 코드 구성
| 코드 | 설명 | value |
|---|---|---|
| CODE_CREATE_CERTIFICATE | 인증서 발급 요청 | 11 |
| CODE_ADD_AUTH | 추가 인증수단 추가 | 12 |
| CODE_DELETE_CERTIFICATE | 인증서 폐기 | 13 |
| CODE_PC_AUTH_CERTIVICATE | QR, 인증번호를 이용한 PC 인증 | 15 |
| CODE_PC_PUSH_CERTIVICATE | Push를 이용한 PC 인증 | 16 |
| CODE_PIN_MODIFY | 핀번호 수정 | 17 |
| CODE_SIGN_AUTH | 전자서명 하기 | 18 |
| CODE_CHECK_CERTIVICATE | 인증서 보유 여부 | 19 |
| CODE_CHECK_VERIFY_CERTIFICATE | 인증서 유효성 검사 | 20 |
| CODE_CHECK_ISSUE_POSSIBLE_CERTIFICATE | 발급 가능 사업자 인증서 목록 조회 | 21 |
| CODE_DO_PC_CERRT | PC인증 타입 선택화면 이동 | 22 |
| CODE_GET_ORI_TEXT | 법인인증서 발급 용 원문 조회 | 30 |
HAuthCorpInterface API를 사용하기 위한 객체 생성
Example
HAuthCorpInterface mHAuthCorpInterface= new HAuthCorpInterface.getInstance(context);
Arguments
Example:
HAuthCorpInterface mHAuthCorpInterface = HAuthCorpInterface.getInstance(context);
mHAuthCorpInterface.setBlockChainServerDomain(issueDomain, authDomain, pcDomain, comDomain);
Arguments
Example:
HAuthCorpInterface mHAuthCorpInterface = HAuthCorpInterface.getInstance(context);
mHAuthCorpInterface.getCertIssueTargetVerifyList (CODE_CHECK_ISSUE_POSSIBLE_CERTIFICATE, bcId);
mHAuthCorpInterface.setOnHAuthListener(new HAuthCorpInterface.HAuthCorpInterfaceListener () {
@Override
public void successCorpListener (int senderCode, JSONObject data) {
// senderCode로 분기 후 처리
// senderCode ==>21, data ==>{}
}
@Override
public void errorCorpListener (int senderCode, String errorCode) {
// senderCode로 분기 후 처리
}
});
Arguments
Example:
HAuthCorpInterface mHAuthCorpInterface = HAuthCorpInterface.getInstance(context);
mHAuthCorpInterface.getPersonOriginalText(CODE_GET_ORI_TEXT, bizrNo, loginId);
mHAuthCorpInterface.setOnHAuthListener(new HAuthCorpInterface.HAuthCorpInterfaceListener () {
@Override
public void successCorpListener (int senderCode, JSONObject data) {
// senderCode로 분기 후 처리
// senderCode ==>30, data ==>{}
}
@Override
public void errorCorpListener (int senderCode, String errorCode) {
// senderCode로 분기 후 처리
}
});
Arguments
Example:
HAuthCorpInterface mHAuthCorpInterface = new HAuthCorpInterface.getInstance(context);
mHAuthCorpInterface.createCertificate (CODE_CREATE_CERTIFICATE, loginId, userNm, bsnesOrginlHistSeq, signDoc, deviceId, bizrno);
mHAuthCorpInterface.setOnHAuthListener(new HAuthCorpInterface.HAuthCorpInterfaceListener () {
@Override
public void successCorpListener (int senderCode, JSONObject data) {
// senderCode로 분기 후 처리
// senderCode 🡺 1, data 🡺{}
}
@Override
public void errorCorpListener (int senderCode, String errorCode) {
// senderCode로 분기 후 처리
}
});
Arguments
| Key | Type | Description |
|---|---|---|
| certId | String | 인증서 아이디 |
| bcId | String | 블록체인 아이디 |
| certDnInfo | String | 인증서 DN 정보 |
| expirationDate | String | 인증서 유효기간 |
| bizrNo | String | 사업자 번호 |
| loginId | String | Login Id |
Example:
HAuthCorpInterface mHAuthCorpInterface = HAuthCorpInterface.getInstance(context);
JSONObject result = mHAuthCorpInterface.getCorpCertificateList();
Arguments
Example:
HAuthCorpInterface mHAuthCorpInterface = HAuthCorpInterface.getInstance(this);
mHAuthCorpInterface.checkVerifyCertificate(senderCode, bizNo, userId, deviceId, certId);
mHAuthCorpInterface.setOnHAuthListener(new HAuthCorpInterface.HAuthCorpInterfaceListener() {
@Override
public void successCorpListener(int senderCode, JSONObject jsonObject) {
// senderCode로 분기 후 처리
// senderCode ==> 20, data ==>{}
}
@Override
public void errorCorpListener(int senderCode, String errorCode) {
// senderCode로 분기 후 처리
}
});
Arguments
Example:
HAuthCorpInterface mHAuthCorpInterface = HAuthCorpInterface.getInstance(context);
mHAuthCorpInterface.doSignatureCertificate(senderCode, certId, oriDoc, bizNo, userId, deviceId);
mHAuthCorpInterface.setOnHAuthListener(new HAuthCorpInterface.HAuthCorpInterfaceListener() {
@Override
public void successCorpListener(int senderCode, JSONObject jsonObject) {
// senderCode로 분기 후 처리
// senderCode ==> 18, data ==>{}
}
@Override
public void errorCorpListener(int senderCode, String errorCode) {
// senderCode로 분기 후 처리
}
});
Arguments
Example:
HAuthCorpInterface mHAuthCorpInterface = HAuthCorpInterface.getInstance(context);
mHAuthCorpInterface.modifyPinNumber(senderCode, certId);
mHAuthCorpInterface.setOnHAuthListener(new HAuthCorpInterface.HAuthCorpInterfaceListener() {
@Override
public void successCorpListener(int senderCode, JSONObject jsonObject) {
// senderCode로 분기 후 처리
// senderCode ==> 17, data ==>{}
}
@Override
public void errorCorpListener(int senderCode, String errorCode) {
// senderCode로 분기 후 처리
}
});
Arguments
Example:
HAuthCorpInterface mHAuthCorpInterface = HAuthCorpInterface.getInstance(context);
mHAuthCorpInterface.addAuthType (senderCode, authType, certId);
mHAuthCorpInterface.setOnHAuthListener(new HAuthCorpInterface.HAuthCorpInterfaceListener() {
@Override
public void successCorpListener(int senderCode, JSONObject jsonObject) {
// senderCode로 분기 후 처리
// senderCode ==> 12, data ==>{}
}
@Override
public void errorCorpListener(int senderCode, String errorCode) {
// senderCode로 분기 후 처리
}
});
Arguments
Returns
Return Types
| Key | Type | Description |
|---|---|---|
| code | String | 조회 성공 여부 코드 |
| result | String | 결과(1 또는 2) |
Example:
HAuthCorpInterface mHAuthCorpInterface = new HAuthCorpInterface.getInstance(context);
JSONObject result = mHAuthCorpInterface.getAuthType(certId);
Arguments
Returns
Return Types
| Key | Type | Description |
|---|---|---|
| code | String | 삭제 성공 여부 코드 |
| result | String | 결과(성공 : true, 실패 : false) |
Example:
HAuthCorpInterface mHAuthCorpInterface = new HAuthCorpInterface.getInstance(context);
JSONObject result = mHAuthCorpInterface.deleteAuth(certId);
Arguments
Example:
HAuthCorpInterface mHAuthCorpInterface = HAuthCorpInterface.getInstance(this);
mHAuthCorpInterface.deleteCertificate(senderCode, certId, birzNo, userId, deviceId);
mHAuthCorpInterface.setOnHAuthListener(new HAuthCorpInterface.HAuthCorpInterfaceListener() {
@Override
public void successCorpListener(int senderCode, JSONObject jsonObject) {
// senderCode로 분기 후 처리
// senderCode ==> 13, data ==>{}
}
@Override
public void errorCorpListener(int senderCode, String errorCode) {
// senderCode로 분기 후 처리
}
});
Arguments
Example:
HAuthCorpInterface mHAuthCorpInterface = HAuthCorpInterface.getInstance(this);
mHAuthCorpInterface.authPCWithSelect (sendercode, certId, bizNo, userId, deviceId);
mHAuthCorpInterface.setOnHAuthListener(new HAuthCorpInterface.HAuthCorpInterfaceListener() {
@Override
public void successCorpListener(int senderCode, JSONObject jsonObject) {
// senderCode로 분기 후 처리
// senderCode ==> 22, data ==>{}
}
@Override
public void errorCorpListener(int senderCode, String errorCode) {
// senderCode로 분기 후 처리
}
});
Arguments
Example:
HAuthCorpInterface mHAuthCorpInterface = HAuthCorpInterface.getInstance(context);
mHAuthCorpInterface.authPc(senderCode, authType, certId, bizNo, userId, deviceId);
mHAuthCorpInterface.setOnHAuthListener(new HAuthCorpInterface.HAuthCorpInterfaceListener() {
@Override
public void successCorpListener(int senderCode, JSONObject jsonObject) {
// senderCode로 분기 후 처리
// senderCode ==> 15, data ==>{}
}
@Override
public void errorCorpListener(int senderCode, String errorCode) {
// senderCode로 분기 후 처리
}
});
Arguments
Example:
HAuthCorpInterface mHAuthCorpInterface = HAuthCorpInterface.getInstance(this);
mHAuthCorpInterface.authPCWithPush (senderCode, pushValue, certId, bizNo, userId, deviceId);
mHAuthCorpInterface.setOnHAuthListener(new HAuthCorpInterface.HAuthCorpInterfaceListener() {
@Override
public void successCorpListener(int senderCode, JSONObject jsonObject) {
// senderCode로 분기 후 처리
// senderCode ==> 16, data ==>{}
}
@Override
public void errorCorpListener(int senderCode, String errorCode) {
// senderCode로 분기 후 처리
}
});
| 결과코드 | 분류 | 에러내용 | 비고 |
|---|---|---|---|
| 0000 | 정상 | 정상 동작 | |
| 4500 | 비즈니스 오류 | 인증서가 존재하지 않음 | |
| 4506 | 비즈니스 오류 | (법인) 인증서 폐기 실패 | |
| 4507 | 비즈니스 오류 | (법인) 인증서 존재 여부 확인 에러 | |
| 4508 | 비즈니스 오류 | (법인) 유효하지 않은 인증서 | |
| 4509 | 비즈니스 오류 | (법인) 전자서명 실패 | |
| 4510 | 비즈니스 오류 | (법인) 인증 5회 오류로 인한 인증서 삭제 | |
| 4511 | 비즈니스 오류 | (법인) 인증 5회 오류로 인한 해당 추가인증 수단 삭제 | |
| 4512 | 비즈니스 오류 | (법인) 인증서 발급 사용자 취소 | |
| 4530 | 비즈니스 오류 | (법인) 핀 인증 화면 사용자 취소 | |
| 4532 | 비즈니스 오류 | (법인) 핀 번호 변경 실패 | |
| 4533 | 비즈니스 오류 | (법인) 이슈 챌린지 생성 실패 | |
| 4534 | 비즈니스 오류 | (법인) 인증서 저장 실패 | |
| 4536 | 비즈니스 오류 | (법인) 인증서 비밀번호 생성 실패 | |
| 4550 | 비즈니스 오류 | (법인) 추가인증 선택 화면 사용자 취소 | |
| 4551 | 비즈니스 오류 | (법인) 인증값 암복호화 실패 | |
| 4552 | 비즈니스 오류 | (법인) 추가인증 수단 조회 실패 | |
| 4553 | 비즈니스 오류 | (법인) 추가인증 수단 추가 실패 | |
| 4570 | 비즈니스 오류 | (법인) 패턴인증 화면 사용자 취소 | |
| 4580 | 비즈니스 오류 | (법인) 생체(지문)인증 화면 사용자 취소 | |
| 4581 | 비즈니스 오류 | (법인) 생체인증 지원 불가 단말 | |
| 4584 | 비즈니스 오류 | (법인) 디바이스 내 등록된 생체인증 없음 | |
| 4585 | 비즈니스 오류 | (법인) 생체인증 인증 실패 | |
| 4586 | 비즈니스 오류 | (법인) 생체인증 정보가 변경됨 | |
| 4587 | 비즈니스 오류 | (법인) 퍼미션 거부 | |
| 4600 | 비즈니스 오류 | PC인증 선택 화면 사용자 취소 | |
| 4601 | 비즈니스 오류 | PC인증 실패 | |
| 4610 | 비즈니스 오류 | PC인증 (인증번호) 화면 사용자 취소 | |
| 4620 | 비즈니스 오류 | PC인증 (QR코드) 화면 사용자 취소 | |
| 4630 | 비즈니스 오류 | PC인증 (PUSH) 화면 사용자 취소 | |
| 4631 | 비즈니스 오류 | 사업자 인증서 발급 대상 확인 실패 | |
| 4633 | 비즈니스 오류 | 법인 인증서 기존 추가인증수단 존재 | |
| 9500 | 네트워크 오류 | 네트워크 Not Found 오류 | |
| 9504 | 네트워크 오류 | 통신 오류 | |
| 9505 | 네트워크 오류 | Json 오류 |