사용자용 DID 서비스를 적용하기 위한 사용자앱 Client 라이브러리 API를 정의
객체 생성 후 HDMS(Hecate DID Management Server) 도메인을 설정
// DID 객체 생성
DIDManager dManager = DIDManager.getInstance(getApplicationContext()); // DID
dManager.setDIDServerDomain("DID 서버 주소");
dManager.setVerifyDomain("검증수행 서버 주소");
CommonCallback.CCallback callback = new CommonCallback.CCallback() {
@Override
public void onFailed(final String code, final String resultMsg) {
// "API 호출 후 해당 케이스가 성공이 아닌 경우"
}
@Override
public void onSuccess(final String code, final String resultMsg) {
// "API 호출 후 해당 케이스가 성공인 경우"
}
};
사용자앱 내 DID 발급 유무를 확인
Returns: 발급 유무
Return type: Boolean
Example:
// 객체 생성
DIDManager dManager = DIDManager.getInstance(getApplicationContext());
// DID 유무를 체크한다.
if (!dManager.existDID()) {
// 발급받은 DID 무
}else{
// 발급받은 DID 유
}
사용자 DID 발급 요청 수행
Parameters:
jsonOther 구성
Key | Type | Description |
---|---|---|
name | String | 이름 |
String | 이메일 | |
birthday | String | 생년월일 |
mobile | String | 휴대폰번호 |
Example:
// 객체 생성
DIDManager dManager = DIDManager.getInstance(getApplicationContext());
// DID 발급
dManager.registDID(memberInfo, jsonOther, authType, pinHash, new CommonCallback.CCallback() {
@Override
public void onFailed(String code, String resultMsg) {
// 발급 실패
Log.d("TAG", "code : " + code + "\nresultMsg : " + resultMsg);
}
@Override
public void onSuccess(String code, String resultMsg) {
// 발급 성공
Log.d("TAG", "code : " + code + "\nresultMsg : " + resultMsg);
}
});
사용자앱 내 저장된 DID 정보를 조회
Returns: DID 정보 값
Return type: String
Example:
// 객체 생성
DIDManager dManager = DIDManager.getInstance(getApplicationContext());
Log.d( "TAG", "DID 정보 :" + dManager.getDIDInfo());
사용자앱 내 저장된 DID 발급시 설정했던 별명값을 조회
Returns: DID 별명 값
Return type: String
Example:
// 객체 생성
DIDManager dManager = DIDManager.getInstance(getApplicationContext());
Log.d( "TAG", "DID Name : " + dManager.getDIDName());
사용자앱 내 저장된 발급받은 DID 리스트를 조회
Returns: 발급받은 DID 리스트
Return type: JSONArray
Example:
// 객체 생성
DIDManager dManager = DIDManager.getInstance(getApplicationContext());
Log.d( "TAG", "DID Name : " + dManager.getDIDName());
사용자 DID 폐기 요청 수행
Parameters:
jsonOther 구성
Value | Description |
---|---|
0 | 사용자 폐기 |
1 | 발급기관 폐기 |
2 | 검증기관 폐기 |
3 | 검증자 폐기 |
Example:
// 객체 생성
DIDManager dManager = DIDManager.getInstance(getApplicationContext());
// 사용자 DID 폐기
dManager.unRegistDID("0", authType, secretHash, new CommonCallback.CCallback() {
@Override
public void onFailed(String code, String resultMsg) {
// 폐기 실패
Log.d("TAG", "code : " + code + "\nresultMsg : " + resultMsg);
}
@Override
public void onSuccess(String code, String resultMsg) {
// 폐기 성공
Log.d("TAG", "code : " + code + "\nresultMsg : " + resultMsg);
}
});
사용자앱 내 저장된 DID를 삭제(서버 통신 미수행)
Example:
[[DIDManager getInstance()] deleteDID];
개인키를 암호화한 PIN번호를 변경
Parameters:
Returns: true: 변경 성공, false: 변경 실패
Return type: Boolean
jsonOther 구성
Value | Description |
---|---|
0 | 사용자 폐기 |
1 | 발급기관 폐기 |
2 | 검증기관 폐기 |
3 | 검증자 폐기 |
Example:
if (DIDManager.getInstance().changePin(oldPinHash, newPinHash)) {
// PIN번호 변경 성공
}else{
// PIN번호 변경 실패
}
New in version 1.0.4
Parameters:
jsonOther 구성
Key | Type | Description |
---|---|---|
verifierMemberInfo | String | 사번 |
name | String | 이름 |
String | 이메일 | |
birthday | String | 생년월일 |
mobile | String | 휴대폰번호 |
Example:
// 객체 생성
DIDManager dManager = DIDManager.getInstance(getApplicationContext());
// DID 발급
dManager.registVerifierDID(verifierDID, jsonOther, didName, didType,, new CommonCallback.CCallback() {
@Override
public void onFailed(String code, String resultMsg) {
// 발급 실패
Log.d("TAG", "code : " + code + "\nresultMsg : " + resultMsg);
}
@Override
public void onSuccess(String code, String resultMsg) {
// 발급 성공
Log.d("TAG", "code : " + code + "\nresultMsg : " + resultMsg);
}
});
New in version 1.0.4
Parameters:
Example:
// 객체 생성
DIDManager dManager = DIDManager.getInstance(getApplicationContext());
// 검증자 DID 폐기
dManager.unRegistVerifierDID(new CommonCallback.CCallback() {
@Override
public void onFailed(String code, String resultMsg) {
// 폐기 실패
Log.d("TAG", "code : " + code + "\nresultMsg : " + resultMsg);
}
@Override
public void onSuccess(String code, String resultMsg) {
// 폐기 성공
Log.d("TAG", "code : " + code + "\nresultMsg : " + resultMsg);
}
});