통합(개인) 인증 서비스를 적용하기 위한 사용자앱 Client 라이브러리 API를 정의
- HAuthInterface API를 사용하기 위한 객체 생성
Example: Swift
let personInterface = HAuthInterface.getInstance()
Example: Objective-c
HAuthInterface *personInterface = [HAuthInterface getInstance];
Arguments
Example: Swift
HAuthInterface.getInstance().setBlockChainServerDomain("발급서버도메인", authDomain:"인증서버도메인", pcDomain:"멀티인증도메인")
Example: Objective-c
[[HAuthInterface getInstance] setBlockChainServerDomain:@"발급서버도메인" authDomain:@"인증서버도메인" pcDomain:@"멀티인증도메인"];
Arguments
Example: Swift
HAuthInterface.getInstance().checkExistCertificate(
hash,
deviceId: deviceId,
successBlock: {
print("인증서 있음")
},
errorBlock: { error in
print("인증서 없음 : \(error)")
})
Example: Objective-c
[[HAuthInterface getInstance] checkExistCertificate:hash
deviceId:deviceId
successBlock:^{
NSLog(@"인증서 있음");}
errorBlock:^(NSString *error) {
NSLog(@"인증서 없음 : %@", error);}
];
Arguments
| Key | Type | Description |
|---|---|---|
| deviceNo | String | 휴대폰 번호 |
| String | 메일 주소 |
Example: Swift
HAuthInterface.getInstance().createCertification(
self,
hash: hash,
name: name,
userId: userId,
deviceId: deviceId,
etcInfo: etcInfo,
successBlock: {
print("success")
},
errorBlock: { error in
print("fail : \(error)")
})
Example: Objective-c
[[HAuthInterface getInstance] createCertification:self
hash:hash
name:name
userId:userId
deviceId:deviceId
etcInfo:etcInfo
successBlock:^{
NSLog(@"success");}
errorBlock:^(NSString *error) {
NSLog(@"fail : %@", error);}
];
Example: Swift
let result = HAuthInterface.getInstance().checkPossibleUseBiometric()
print("result : \(result)")
Example: Objective-c
int result = [[HAuthInterface getInstance] checkPossibleUseBiometric];
NSLog(@"result : %d", result);
Returns
Example: Swift
HAuthInterface.getInstance().moveDeviceBiometricSetting()
Example: Objective-c
[[HAuthInterface getInstance] moveDeviceBiometricSetting];
Example: Swift
var bcId:NSString?
let result = HAuthInterface.getInstance().getCertificateBcID(&bcId)
print("result : \(result) \(bcId)")
Example: Objective-c
NSString *bcId;
int result = [[HAuthInterface getInstance] getCertificateBcID:&bcId];
NSLog(@"result : %d %@", result, bcId);
Example: Swift
var errorCount:Int32 = -1
let result = HAuthInterface.getInstance().getCertificateErrorCount(&errorCount)
print("result : \(result) \(errorCount)")
Example: Objective-c
int errorCount = -1;
int result = [[HAuthInterface getInstance] getCertificateErrorCount:&errorCount];
NSLog(@"result : %d %d", result, errorCount);
Arguments
Returns
Return Types
Example: Swift
var errorCount:Int32 = -1
let result = HAuthInterface.getInstance().getCertificateErrorCount(100, errorCount:&errorCount)
print("result : \(result) \(errorCount)")
Example: Objective-c
int errorCount = -1;
int result = [[HAuthInterface getInstance] getCertificateErrorCount:100 errorCount&errorCount];
NSLog(@"result : %d %d", result, errorCount);
Example: Swift
var expireDate:NSDate? = nil
let result = HAuthInterface.getInstance().getCertificateExpireDate(&expireDate)
print("result : \(result) \(expireDate)")
Example: Objective-c
NSDate *expireDate;
int result = [[HAuthInterface getInstance] getCertificateExpireDate:&expireDate];
NSLog(@"result : %d %@", result, expireDate);
Arguments
| Key | Type | Description |
|---|---|---|
| certifyType | Int | 인증타입 |
| certificate | String | 서명값 |
| nsVIDRandB64 | String | 랜덤값 |
Example: Swift
HAuthInterface.getInstance().doSignatureCertificate(
self,
oriDoc: oriDoc,
hash: hash,
deviceId: deviceId,
successBlock: { dic :[AnyHashable : Any] in
print("success \(dic)")
},
errorBlock: { error in
print("fail : \(error)")
})
Example: Objective-c
[[HAuthInterface getInstance] doSignatureCertificate:self
oriDoc:oriDoc
hash:hash
deviceId:deviceId
successBlock:^(NSDictionary *dic){
NSLog(@"success %@", dic);}
errorBlock:^(NSString *error) {
NSLog(@"fail : %@", error);}
];
Arguments
Example: Swift
HAuthInterface.getInstance().deleteCertificate(
self,
deviceId: deviceId,
hash: hash,
oriDoc: oriDoc,
successBlock: {
print("success")
},
errorBlock: { error in
print("fail : \(error)")
})
Example: Objective-c
[[HAuthInterface getInstance] deleteCertificate:self
deviceId:deviceId
hash:hash
oriDoc:oriDoc
successBlock:^{
NSLog(@"success");}
errorBlock:^(NSString *error) {
NSLog(@"fail : %@", error);}
];
Arguments
Example: Swift
HAuthInterface.getInstance().modifyPinNumber(
self,
hash: hash,
deviceId: deviceId,
successBlock: {
print("success")
},
errorBlock: { error in
print("fail : \(error)")
})
Example: Objective-c
[[HAuthInterface getInstance] modifyPinNumber:self
hash:hash
deviceId:deviceId
successBlock:^{
NSLog(@"success");}
errorBlock:^(NSString *error) {
NSLog(@"fail : %@", error);}
];
Arguments
Example: Swift
HAuthInterface.getInstance().addAuthType(
self,
authType: authType,
hash: hash,
deviceId: deviceId,
successBlock: {
print("success")
},
errorBlock: { error in
print("fail : \(error)")
})
Example: Objective-c
[[HAuthInterface getInstance] addAuthType:self
authType:100
hash:hash
deviceId:deviceId
successBlock:^{
NSLog(@"success");}
errorBlock:^(NSString *error) {
NSLog(@"fail : %@", error);}
];
Example: Swift
var authType:Int32;
let result = HAuthInterface.getInstance().getCertificateAuthType(&errorCount)
print("result : \(result) \(authType)")
Example: Objective-c
int authType;
int result = [[HAuthInterface getInstance] getCertificateAuthType:&errorCount];
NSLog(@"result : %d %d", result, authType);
Example: Swift
let result = HAuthInterface.getInstance().deleteCertificateAuthType()
print("result : \(result)")
Example: Objective-c
int result = [[HAuthInterface getInstance] deleteCertificateAuthType];
NSLog(@"result : %d", result);
Example: Swift
var issueDate:NSDate? = nil
let result = HAuthInterface.getInstance().getCertificateIssueDate(&issueDate)
print("result : \(result) \(expireDate)")
Example: Objective-c
NSDate *issueDate;
int result = [[HAuthInterface getInstance] getCertificateIssueDate:&issueDate];
NSLog(@"result : %d %@", result, expireDate);
Arguments
Example: Swift
HAuthInterface.getInstance().authPCWithPush(
self,
encData: encData,
hash: hash,
deviceId: deviceId,
successBlock: {
print("success")
},
errorBlock: { error in
print("fail : \(error)")
})
Example: Objective-c
[[HAuthInterface getInstance] authPCWithPush:self
encData:encData
hash:hash
deviceId:deviceId
successBlock:^{
NSLog(@"success");}
errorBlock:^(NSString *error) {
NSLog(@"fail : %@", error);}
];
Arguments
Example: Swift
HAuthInterface.getInstance().authPC(
self,
authType: 2,
hash: hash,
deviceId: deviceId,
successBlock: {
print("success")
},
errorBlock: { error in
print("fail : \(error)")
})
Example: Objective-c
[[HAuthInterface getInstance] authPC:self
authType:2
hash:hash
deviceId:deviceId
successBlock:^{
NSLog(@"success");}
errorBlock:^(NSString *error) {
NSLog(@"fail : %@", error);}
];
| 결과코드 | 분류 | 에러내용 | 비고 |
|---|---|---|---|
| 0000 | 정상 | 정상 동작 | |
| 1500 | 필수값 누락 | 도메인 누락 | |
| 1501 | 필수값 누락 | 인증타입 누락 | |
| 1502 | 필수값 누락 | 디바이스 아이디 누락 | |
| 1503 | 필수값 누락 | 사용자 정보 누락 | |
| 1504 | 필수값 누락 | 사용자 이름 누락 | |
| 1505 | 필수값 누락 | 사용자 아이디 누락 | |
| 1506 | 필수값 누락 | 핀번호 누락 | |
| 1507 | 필수값 누락 | 원문 누락 | |
| 1508 | 필수값 누락 | 트렌잭션 아이디 누락 | |
| 1509 | 필수값 누락 | 클라이언트 트렌잭션 아이디 누락 | |
| 2500 | 비즈니스 오류 | 인증서가 존재하지 않음 | |
| 2501 | 비즈니스 오류 | 인증서가 존재함 | |
| 2502 | 비즈니스 오류 | 블록체인 아이디 조회 실패 | |
| 2503 | 비즈니스 오류 | 에러카운트 조회 실패 | |
| 2504 | 비즈니스 오류 | 추가인증이 존재하지 않음 | |
| 2505 | 비즈니스 오류 | 인증서 만료일자 조회 실패 | |
| 2506 | 비즈니스 오류 | 인증서 폐기 실패 | |
| 2507 | 비즈니스 오류 | 인증서 존재 여부 확인 에러 | |
| 2508 | 비즈니스 오류 | 인증서 유효성 에러 (서버) | |
| 2509 | 비즈니스 오류 | 전자서명 실패 | |
| 2514 | 비즈니스 오류 | 필수 파라미터 누락 | |
| 2530 | 비즈니스 오류 | 핀인증 화면 사용자 취소 | |
| 2531 | 비즈니스 오류 | 핀번호 암복호화 실패 (서버) | |
| 2532 | 비즈니스 오류 | 핀번호 변경 실패 | |
| 2533 | 비즈니스 오류 | 이슈챌린지 생성 실패 | |
| 2534 | 비즈니스 오류 | 인증서 저장 실패 | |
| 2535 | 비즈니스 오류 | 인증서 LOCK으로 인한 폐기 | |
| 2550 | 비즈니스 오류 | 추가인증 선택 화면 사용자 취소 | |
| 2551 | 비즈니스 오류 | 인증값 암복호화 실패 (서버) | |
| 2552 | 비즈니스 오류 | 추가인증수단 조회 실패 | |
| 2553 | 비즈니스 오류 | 추가인증수단 추가 실패 | |
| 2554 | 비즈니스 오류 | 추가인증수단 삭제 실패 | |
| 2570 | 비즈니스 오류 | 패턴인증 화면 사용자 취소 | |
| 2580 | 비즈니스 오류 | 생체(지문)인증 화면 사용자 취소 | |
| 2581 | 비즈니스 오류 | 생체인증 지원 불가 단말 | |
| 2582 | 비즈니스 오류 | 생체인증 디바이스 암호 비활성화 상태 | |
| 2583 | 비즈니스 오류 | 생체인증 디바이스 LOCK 상태 | |
| 2584 | 비즈니스 오류 | 디바이스 내 등록된 생체인증 없음 | |
| 2585 | 비즈니스 오류 | 생체인증 인증 실패 | |
| 2586 | 비즈니스 오류 | 생체인증 정보가 변경됨 | |
| 2587 | 비즈니스 오류 | 퍼미션 거부 | |
| 2588 | 비즈니스 오류 | Samsung Pass가 등록되어있지 않음 | |
| 2589 | 비즈니스 오류 | Samsung Pass내에 얼굴이 등록되어있지 않음 | |
| 2600 | 비즈니스 오류 | PC인증 선택 화면 사용자 취소 | |
| 2610 | 비즈니스 오류 | PC인증 (인증번호) 화면 사용자 취소 | |
| 2620 | 비즈니스 오류 | PC인증 (QR코드) 화면 사용자 취소 | |
| 2630 | 비즈니스 오류 | PC인증 (PUSH) 화면 사용자 취소 | |
| 9500 | 네트워크 | 네트워크 Not Found 오류 | |
| 9501 | 네트워크 | 통신 권한 오류 | |
| 9502 | 네트워크 | 통신 TimeOut | |
| 9503 | 네트워크 | URL 형식 오류 | |
| 9504 | 네트워크 | 통신 오류 |