기기 재등록

Overview

Android SDK의 GCCS 기기 재등록 방법을 안내합니다.

기능 설명

기존에 GCCS를 사용중이던 사용자의 모바일 기기가 변경된 경우 회원정보 검증 후 재등록하여
기존과 동일하게 GCCS 인증을 사용할 수 있도록 기기 재등록 기능을 제공합니다.
회원 여부를 먼저 확인한 뒤 이메일로 OTP 코드를 발송하여 회원 검증 후 재등록을 진행합니다.

사용자 체크 및 OTP 발송

사용자 체크 및 OTP 발송을 요청 합니다. GuardianSdk의 verityUserToOtp()로 API를 요청합니다.
입력한 사용자 정보가 맞는 경우 이메일로 OTP 코드가 전송됩니다.

Parameter

Key	Value	Description
userKey	String	유저 아이디
name	String	이름
email	String	이메일

Example

// 사용자 체크 및 OTP 발송GuardianSdk.getInstance().verityUserToOtp("gccsuser", "gccsname", "fnsvalue@fnsvalue.co.kr", new GuardianResponseCallback<RegisterOtpResponse>() {    @Override    public void onSuccess(RegisterOtpResponse result) {        Log.i(TAG, "결과코드 : " + result.rtCode);        Log.i(TAG, "seq : " + result.data.seq);    }
    @Override    public void onFailed(ErrorResult errorResult) {        Log.e(TAG, "에러코드 : " + errorResult.getErrorCode());        Log.e(TAG, "에러코드 : " + errorResult.getErrorMessage());    }});

VerityUserToOtpResponse

Key	Value	Description
rtCode	0	결과코드
rtMsg	String	결과 메시지
seq	Int	seq

사용자 체크 및 OTP 발송 API 호출 성공 시 rtCode 로 0이 수신됩니다.

ErrorResult

Key	Value	Description
errorCode	Int	에러코드
errorMessage	String	에러메시지

사용자 체크 및 OTP 발송 API 호출 실패 시 errorCode가 수신됩니다.

---

이메일 인증 확인

requestOtpEmail() 에 결과 값인 seq, 이메일에 보여진 가입 인증 코드, 이메일을 입력하여 이메일 인증을 확인합니다. 이메일 인증 확인을 위해 GuardianSdk 의 verityOtpEmail() 로 API를 요청합니다. 정상적인 가입 인증 코드 인 경우 가입에 사용하는 token 값이 전달 됩니다.

Parameter

Name	Value	Description
email	String	인증 받을 이메일 주소
seq	Int	인증 요청 seq
authNum	String	인증 코드

Example

// 가입 정보 중복 체크GuardianSdk.getInstance().verityOtpEmail("fnsvalue@fnsvalue.co.kr", 23, "452422", new GuardianResponseCallback<VerityOtpResponse>() {    @Override    public void onSuccess(VerityOtpResponse result) {        Log.i(TAG, "결과코드 : " + result.rtCode);        Log.i(TAG, "가입토큰 : " + result.token);    }
    @Override    public void onFailed(ErrorResult errorResult) {        Log.e(TAG, "에러코드 : " + errorResult.getErrorCode());    }});

VerityOtpResponse

Key	Value	Description
rtCode	0	결과코드
result	Boolean	인증 코드 맞는지 여부
token	String	가입 인증 토큰

이메일 인증 확인하는 API를 호출하여 정상적인 인증 코드가 맞는 경우 rtCode로 0과 result 값이 true 가 수신 됩니다.

ErrorResult

Key	Value	Description
errorCode	0	에러코드

가입 정보 중복을 체크하는 API 호출 실패 시 errorCode 가 수신됩니다.

---

기기 재등록

GuardianSdk의 reRegisterClientUser()로 기기 재등록 API를 요청합니다.
verityOtpEmail()를 통해 검증된 토큰 값이 필요하며, 재등록 절차가 완료되면 기존과 동일하게 GCCS 인증을 사용할 수 있습니다.

Parameter

Key	Value	Description
userKey	String	유저키
name	String	이름
disposeToken	String	이메일 인증 토큰

Example

// OTP 검증GuardianSdk.getInstance().reRegisterUser("gccsuser", "gccsname", "{token}", new GuardianResponseCallback<RegisterUserResponse>() {    @Override    public void onSuccess(RegisterUserResponse result) {        Log.i(TAG, "결과코드 : " + result.rtCode);    }
    @Override    public void onFailed(ErrorResult errorResult) {        Log.e(TAG, "에러코드 : " + errorResult.getErrorCode());        Log.e(TAG, "에러코드 : " + errorResult.getErrorMessage());    }});

RegisterUserResponse

Key	Value	Description
rtCode	0	결과코드
rtMsg	String	결과 메시지

기기 재등록 API 호출 성공 시 rtCode로 0이 수신 됩니다.

ErrorResult

Key	Value	Description
errorCode	Int	에러코드
errorMessage	String	에러메시지

기기 재등록 API 호출 실패 시 errorCode가 수신됩니다.

---