통합(법인) 인증 서비스를 적용하기 위한 사용자앱 Client 라이브러리 API를 정의
- HAuthCorpInterface API를 사용하기 위한 객체 생성
Example: Swift
let corpInterface = HAuthCorpInterface.getInstance()
Example: Objective-c
HAuthCorpInterface *corpInterface = [HAuthCorpInterface getInstance];
Arguments
Example: Swift
HAuthCorpInterface.getInstance().setCorpBlockChainServerDomain("발급서버도메인", authDomain:"인증서버도메인", pcDomain:"PC인증도메인", originDomain:"공통서버도메인")
Example: Objective-c
[[HAuthCorpInterface getInstance] setCorpBlockChainServerDomain:@"발급서버도메인" authDomain:@"인증서버도메인" pcDomain:@"PC인증도메인" originDomain:@"공통서버도메인"];
Arguments
| Key | Type | Description |
|---|---|---|
| resultCode | String | 결과 코드 ( 0000 : 성공, 그 외 실패 ) |
| resultMessage | String | 결과 메세지 |
| businessUserInfoList | Array | 발급 가능한 사업자 결과 정보 Array |
| Key | Type | Description |
|---|---|---|
| loginId | String | 로그인 아이디 |
| stplatAgreAt | String | |
| deviceNo | String | 디바이스 번호 |
| userName | String | 사용자 이름 |
| userId | String | 사용자 아이디 |
| bsnesUserNm | String | |
| bsnesUseSttus | String | |
| bsnesSttus | String | |
| bsnesUserId | String | |
| bsnesDeviceId | String | |
| userMbtlnum | String | |
| bsnesNm | String | 사업자명 |
| bizrno | String | 사업자 번호 |
| walletAddress | Array | 전자 지갑 주소 |
Example: Swift
HAuthCorpInterface.getInstance().getCertIssueTargetVerifyList(
bcId,
successBlock: { dic :[AnyHashable : Any] in
print("success \(dic)")
},
errorBlock: { error in
print("fail : \(error)")
})
Example: Objective-c
[[HAuthCorpInterface getInstance] getCertIssueTargetVerifyList:bcId
successBlock:^(NSDictionary *dic){
NSLog(@"success %@", dic);}
errorBlock:^(NSString *error) {
NSLog(@"fail : %@", error);}
];
Arguments
| Key | Type | Description |
|---|---|---|
| resultCode | String | 결과 코드 ( 0000 : 성공, 그 외 실패 ) |
| originl | String | 원문 |
| bsnesOrginlHistSeq | String | 조회순번 |
| responseDate | String | 원문 응답 시간 |
Example: Swift
HAuthCorpInterface.getInstance().getPersonOriginalText(
bizrNo,
loginID: loginID
successBlock: { dic :[AnyHashable : Any] in
print("success \(dic)")
},
errorBlock: { error in
print("fail : \(error)")
})
Example: Objective-c
[[HAuthCorpInterface getInstance] getPersonOriginalText:bizrNo
loginID:loginID
successBlock:^(NSDictionary *dic){
NSLog(@"success %@", dic);}
errorBlock:^(NSString *error) {
NSLog(@"fail : %@", error);}
];
Arguments
| Key | Type | Description |
|---|---|---|
| bcId | String | 개인 인증서 발급시 받은 블록체인 ID |
| crtfctInfo | String | 인증서 정보 |
Example: Swift
HAuthCorpInterface.getInstance().createCertificate(
self,
userId: userId,
loginId: loginId,
userNm: userNm,
bsnesOrginlHistSeq: bsnesOrginlHistSeq,
signDoc: signDoc,
deviceId: deviceId,
bizrno: bizrno,
successBlock: { dic :[AnyHashable : Any] in
print("success \(dic)")
},
errorBlock: { error in
print("fail : \(error)")
})
Example: Objective-c
[[HAuthCorpInterface getInstance] createCertificate:self
userId:userId
loginId:loginId
userNm:userNm
bsnesOrginlHistSeq:bsnesOrginlHistSeq
signDoc:signDoc
deviceId:deviceId
bizrno:bizrno
successBlock:^(NSDictionary *dic){
NSLog(@"success %@", dic);}
errorBlock:^(NSString *error) {
NSLog(@"fail : %@", error);}
];
Arguments
Returns
Return Types
| Key | Type | Description |
|---|---|---|
| certId | String | 인증서 아이디 |
| bcId | String | 블록체인 아이디 |
| certDnInfo | String | 인증서 DN 정보 |
| expirationDate | String | 인증서 유효기간 |
| bizrNo | String | 사업자 번호 |
| loginId | String | 로그인 아이디 |
Example: Swift
let array = HAuthCorpInterface.getInstance().getCorpCertificateList(&error)
print("result : \(array)")
Example: Objective-c
NSArray *array = [[HAuthCorpInterface getInstance] getCorpCertificateList:&error];
NSLog(@"result : %@", array);
Arguments
Example: Swift
HAuthCorpInterface.getInstance().checkVerifyCertificate(
bizNo,
userId: userId,
deviceId: deviceId,
certId: certId,
successBlock: { result in
print("success \(result)")
},
errorBlock: { error in
print("fail : \(error)")
})
Example: Objective-c
[[HAuthCorpInterface getInstance] checkVerifyCertificate:bizNo
userId:userId
deviceId:deviceId
certId:certId
successBlock:^(NSString *result){
NSLog(@"success %@", result);}
errorBlock:^(NSString *error) {
NSLog(@"fail : %@", error);}
];
Arguments
| Key | Type | Description |
|---|---|---|
| certifyType | Int | 인증타입 |
| certificate | String | 서명값 |
Example: Swift
HAuthCorpInterface.getInstance().doSignatureCertificate(
self,
certId: certId,
oriDoc: oriDoc,
bizNo: bizNo,
userId: userId,
deviceId: deviceId,
successBlock: { dic :[AnyHashable : Any] in
print("success \(dic)")
},
errorBlock: { error in
print("fail : \(error)")
})
Example: Objective-c
[[HAuthCorpInterface getInstance] doSignatureCertificate:self
certId:certId
oriDoc:oriDoc
bizNo:bizNo
userId:userId
deviceId:deviceId
successBlock:^(NSDictionary *dic){
NSLog(@"success %@", dic);}
errorBlock:^(NSString *error) {
NSLog(@"fail : %@", error);}
];
Arguments
Example: Swift
HAuthCorpInterface.getInstance().modifyPinNumber(
self,
certId: certId,
deviceId: deviceId,
successBlock: {
print("success")
},
errorBlock: { error in
print("fail : \(error)")
})
Example: Objective-c
[[HAuthCorpInterface getInstance] modifyPinNumber:self
certId:certId
deviceId:deviceId
successBlock:^{
NSLog(@"success");}
errorBlock:^(NSString *error) {
NSLog(@"fail : %@", error);}
];
Arguments
Example: Swift
HAuthCorpInterface.getInstance().addAuthType(
self,
authType: authType,
certId: certId,
deviceId: deviceId,
successBlock: {
print("success")
},
errorBlock: { error in
print("fail : \(error)")
})
Example: Objective-c
[[HAuthCorpInterface getInstance] addAuthType:self
authType:100
certId:certId
deviceId:deviceId
successBlock:^{
NSLog(@"success");}
errorBlock:^(NSString *error) {
NSLog(@"fail : %@", error);}
];
Arguments
Returns
Return Types
Example: Swift
let result = try HAuthCorpInterface.getInstance().deleteAuth(100, certId: certId)
print("result : \(result)")
Example: Objective-c
int result = [[HAuthCorpInterface getInstance] deleteAuth:100 certId:certId, error:&error];
NSLog(@"result : %d", result);
Arguments
Returns
Return Types
Example: Swift
HAuthCorpInterface.getInstance().deleteCertificate(certId)
Example: Objective-c
[[HAuthCorpInterface getInstance] deleteCertificate:certId];
Arguments
Example: Swift
HAuthCorpInterface.getInstance().deleteCertificate(
self,
certId: certId,
birzNo: birzNo,
userId: userId,
deviceId: deviceId,
successBlock: {
print("success")
},
errorBlock: { error in
print("fail : \(error)")
})
Example: Objective-c
[[HAuthCorpInterface getInstance] deleteCertificate:self
certId:certId
birzNo:birzNo
userId:userId
deviceId:deviceId
successBlock:^{
NSLog(@"success");}
errorBlock:^(NSString *error) {
NSLog(@"fail : %@", error);}
];
Arguments
Example: Swift
HAuthCorpInterface.getInstance().authPCWithSelect(
self,
certId: certId,
bizNo: bizNo,
userId: userId,
deviceId: deviceId,
successBlock: {
print("success")
},
errorBlock: { error in
print("fail : \(error)")
})
Example: Objective-c
[[HAuthCorpInterface getInstance] authPCWithSelect:self
certId:certId
bizNo:bizNo
userId:userId
deviceId:deviceId
successBlock:^{
NSLog(@"success");}
errorBlock:^(NSString *error) {
NSLog(@"fail : %@", error);}
];
Arguments
Example: Swift
HAuthCorpInterface.getInstance().authPc(
self,
authType: authType,
certId: certId,
bizNo: bizNo,
userId: userId,
deviceId: deviceId,
successBlock: {
print("success")
},
errorBlock: { error in
print("fail : \(error)")
})
Example: Objective-c
[[HAuthCorpInterface getInstance] authPc:self
authType:authType
certId:certId
bizNo:bizNo
userId:userId
deviceId:deviceId
successBlock:^{
NSLog(@"success");}
errorBlock:^(NSString *error) {
NSLog(@"fail : %@", error);}
];
Arguments
Example: Swift
HAuthCorpInterface.getInstance().authPCWithPush(
self,
pushValue: pushValue,
certId: certId,
bizNo: bizNo,
userId: userId,
deviceId: deviceId,
successBlock: {
print("success")
},
errorBlock: { error in
print("fail : \(error)")
})
Example: Objective-c
[[HAuthCorpInterface getInstance] authPCWithPush:self
pushValue:pushValue
certId:certId
bizNo:bizNo
userId:userId
deviceId:deviceId
successBlock:^{
NSLog(@"success");}
errorBlock:^(NSString *error) {
NSLog(@"fail : %@", error);}
];
Arguments
Returns
Return Types
Example: Swift
let issueDate = HAuthCorpInterface.getInstance().startDateWithCertID(certId, error:&error)
print("result : \(issueDate) ")
Example: Objective-c
NSDate issueDate = [[HAuthCorpInterface getInstance] startDateWithCertID:certId error&error];
NSLog(@"result : %@ ", issueDate);
Arguments
Returns
Return Types
Example: Swift
let endDate = HAuthCorpInterface.getInstance().endDateWithCertID(certId, error:&error)
print("result : \(endDate) ")
Example: Objective-c
NSDate endDate = [[HAuthCorpInterface getInstance] endDateWithCertID:certId error&error];
NSLog(@"result : %@ ", endDate);
| 결과코드 | 분류 | 에러내용 | 비고 |
|---|---|---|---|
| 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 오류 |