모바일 운전면허증

1. 모바일 신분증은 개인 스마트폰에 안전하게 저장하여 편리하게 사용할 수 있는 신분증으로 신분증이 필요한 모든 곳에서 편리하게 사용할 수 있다.
2. 개인이 스마트폰 안에 자신의 정보를 보유하고 직접 꺼내 쓰며, 신원 증명을 위해 필요한 정보만 골라서 제공할 수 있어 자기 정보 결정권이 강화된다.
3. 내 신원 정보는 내 스마트폰 안에만 안전하게 보관되며, 블록체인을 통해 신원 정보의 진위 여부를 확인할 수 있다.
4. 모바일 신분증 하나로 오프라인과 온라인에서 간편하고 안전하게 사용할 수 있다.
5. 모바일 운전면허증은 한국조폐공사장으로 연계 서비스 신청서 공문을 접수하여 심의 승인 후 연계 서비스를 개발한다.
   • 모바일 신분증 홈페이지 https://www.mobileid.go.kr/mip/hps/main.do
   • 모바일 신분증 개발지원센터 https://dev.mobileid.go.kr/mip/dfs/dfsmain.do
6. 표준프레임워크는 연계모듈을 이용한 애플리케이션 개발에 활용할 수 있는 예제를 제공한다.

1. 모바일 신분증 개발지원센터에서 모바일 신분증 연계신청서 다운로드 및 작성.
   • 모바일 신분증 연계 안내페이지 https://dev.mobileid.go.kr/mip/dfs/apiuse/apiusestep.do
2. 수신처 한국조폐공사장으로 공문 접수.
3. 심의 결과에 따른 승인/보완/반려 처리.
4. 승인 후 연계서비스 개발.

1. 위키가이드의 공통컴포넌트 시작하기를 참고하여 공통컴포넌트를 설치한다.
2. 모바일 운전면허증 서비스 신청 승인 후 생성한 DID Document 및 Wallet 파일을 공통컴포넌트 프로젝트에 추가한다.
   • 추가할 위치는 위의 관련소스 부분을 참고한다.
3. mip.properties 파일에 개발환경에 맞게 환경설정한다.

#################################################################################
# Server Settings
#################################################################################
# blockchain node address : 블록체인 노드 주소(모바일 운전면허증에서 제공)
app.blockchain-server-domain=https://bcdev.mobileid.go.kr:18888
# SP Server Address
# 사용자(Client)에서 접근할 수 있는 검증자(Service Provider)의 IP Address : SP 서버 주소
app.sp-server=http://192.168.xxx.xxx:8080/egovframework-all-in-one


#################################################################################
# SP & Wallet
#################################################################################
# Wallet file path : 생성한 신분증 월렛 파일 경로
app.keymanager-path=/eGovFrameDev-4.1.0-64bit/workspace/egovframework-all-in-one-AllNew/src/main/resources/egovframework/mip/****.wallet
# Wallet password : 생성 시 설정했던 신분증 월렛 패스워드
app.keymanager-password=****
# ECC key id : 생성 시 설정했던 sp key
app.sp-key-id=****.sp
# RSA key id : 생성 시 설정했던 rsa key
app.sp-rsa-key-id=****.sp.rsa
# SP blockchain account (SP 서비스 신청 승인 시 발급) : 모바일 운전면허증에서 발급
app.sp-account=****.sp
# SP DID file path : 생성한 DID Document 파일 경로
app.sp-did-path=/eGovFrameDev-4.1.0-64bit/workspace/egovframework-all-in-one-AllNew/src/main/resources/egovframework/mip/****.did

1. 모바일 신분증 개발지원센터에서 안내하는 연계 서비스 이용 절차에 따라 공문 접수 및 승인 후 DID 및 Wallet 파일을 생성하여 표준프레임워크 예제에 추가해 서비스 예제를 구성한다.
2. 표준프레임워크 공통컴포넌트에서 제공하는 모바일 운전면허증 연계 서비스 예제는 QR-MPM - direct mode 방식으로 연동 프로세스는 연계 순서도를 통해 확인할 수 있다.

SP 서버 정보와 트랜잭션 정보 등이 포함되어 있는 QR 코드를 요청하여 생성한다.

/**
 * QR-MPM 시작
 * 
 * @MethodName : start
 * @param t510 QR-MPM 정보
 * @return QR-MPM 정보 + Base64로 인코딩된 M200 메시지
 * @throws SpException
 */
@Override
public T510VO start(T510VO t510) throws SpException {
	LOGGER.debug("t510 : {}", ConfigBean.gson.toJson(t510));
 
	String mode = t510.getMode();
	String svcCode = t510.getSvcCode();
	String branchName = t510.getBranchName();
	String deviceId = t510.getDeviceId();
 
	if (ObjectUtils.isEmpty(mode))
		throw new SpException(MipErrorEnum.SP_MISSING_MANDATORY_ITEM, null, "t510.mode");
	if (ObjectUtils.isEmpty(svcCode))
		throw new SpException(MipErrorEnum.SP_MISSING_MANDATORY_ITEM, null, "t510.svcCode");
	if (ObjectUtils.isEmpty(branchName))
		throw new SpException(MipErrorEnum.SP_MISSING_MANDATORY_ITEM, null, "t510.branchName");
	if (ObjectUtils.isEmpty(deviceId))
		throw new SpException(MipErrorEnum.SP_MISSING_MANDATORY_ITEM, null, "t510.deviceId");
 
	TrxInfoVO trxInfo = new TrxInfoVO();
 
	trxInfo.setMode(mode);
	trxInfo.setSvcCode(svcCode);
	trxInfo.setBranchName(branchName);
	trxInfo.setDeviceId(deviceId);
 
	M200VO m200 = null;
 
	if (ModeEnum.DIRECT.getVal().equals(mode)) {
		m200 = this.directStart(trxInfo);
	} else {
		throw new SpException(MipErrorEnum.UNKNOWN_ERROR, null, "unsupported mode");
	}
 
	String m200Str = ConfigBean.gson.toJson(m200);
 
	LOGGER.debug("m200Str : {}", m200Str);
 
	String m200Base64 = Base64Util.encode(m200Str);
 
	t510.setM200Base64(m200Base64);
 
	return t510;
}
 
/**
 * QR-MPM 시작(Direct 모드)
 * 
 * @MethodName : directStart
 * @param trxInfo
 * @return
 * @throws SpException
 */
private M200VO directStart(TrxInfoVO trxInfo) throws SpException {
	String spServer = configBean.getSpServer();
 
	String trxcode = Generator.genTrxcode();
	String mode = trxInfo.getMode();
 
	if (trxcode == null) {
		throw new SpException(MipErrorEnum.UNKNOWN_ERROR, null, "거래코드 생성 실패");
	}
 
	trxInfo.setTrxcode(trxcode);
 
	trxInfoService.registTrxInfo(trxInfo);
 
	M200VO m200 = new M200VO();
 
	m200.setType(ConfigBean.TYPE);
	m200.setVersion(ConfigBean.VERSION);
	m200.setCmd(ConfigBean.M200);
	m200.setTrxcode(trxcode);
	m200.setMode(mode);
	m200.setHost(spServer);
 
	return m200;
}

• 모바일 운전면허증 QR 정보 요청 화면 예

모바일 신분증 어플리케이션을 통한 QR 촬영으로 모바일 신분증 내 VP를 검증자에게 직접 전달하여 사용자 검증을 진행한다.

/**
 * VP 검증
 * 
 * @MethodName : verifyVP
 * @param trxcode 거래코드
 * @param vp VP 정보
 * @return 검증 결과
 * @throws SpException
 */
@Override
public Boolean verifyVP(String trxcode, VP vp) throws SpException {
	LOGGER.debug("trxcode : {}, vp : {}", trxcode, ConfigBean.gson.toJson(vp));
 
	Boolean result = false;
 
	TrxInfoVO trxInfo = new TrxInfoVO();
 
	trxInfo.setTrxcode(trxcode);
	trxInfo.setTrxStsCode(TrxStsCodeEnum.VERIFY_REQ.getVal());
 
	trxInfoService.modifyTrxInfo(trxInfo);
 
	Integer encryptType = vp.getEncryptType();
	Integer keyType = vp.getKeyType();
	String type = vp.getType();
	String data = vp.getData();
	List<String> authType = vp.getAuthType();
	String did = vp.getDid();
	String nonce = vp.getNonce();
 
	// VP 검증 Start
	VCVerifyProfileResult vCVerifyProfileResult = new VCVerifyProfileResult();
 
	vCVerifyProfileResult.setEncryptType(encryptType);
	vCVerifyProfileResult.setKeyType(keyType);
	vCVerifyProfileResult.setType(type);
	vCVerifyProfileResult.setData(data);
 
	vCVerifyProfileResult.setAuthType(authType);
	vCVerifyProfileResult.setDid(did);
	vCVerifyProfileResult.setNonce(nonce);
 
	ResultJson resultJson = this.verify(vCVerifyProfileResult, trxcode);
 
	if (resultJson == null || !resultJson.isResult()) {
		return result;
	}
	// VP 검증 End
 
	// VP 상태 확인 Start
	Map<String, Object> vpDataMap = null;
 
	EncryptKeyTypeEnum keyTypeEnum = EncryptKeyTypeEnum.getEnum(vCVerifyProfileResult.getKeyType());
 
	if (keyTypeEnum == EncryptKeyTypeEnum.ALGORITHM_RSA) {
		try {
			AESType aESType = vCVerifyProfileResult.getEncryptType() == 1 ? AESType.AES128 : AESType.AES256;
 
			byte[] vpDataByte = keyManager.rsaDecrypt(configBean.getSpRsaKeyId(), HexUtils.toBytes(vCVerifyProfileResult.getData()), aESType);
 
			data = new String(vpDataByte, StandardCharsets.UTF_8);
 
			LOGGER.debug("data : {}", data);
		} catch (IWException e) {
			throw new SpException(MipErrorEnum.UNKNOWN_ERROR, trxcode, e.getErrorMsg());
		}
	}
 
	try {
		vpDataMap = ConfigBean.gson.fromJson(data, HashMap.class);
	} catch (JsonSyntaxException e) {
		throw new SpException(MipErrorEnum.SP_UNEXPECTED_MSG_FORMAT, trxcode, "data");
	}
 
	List<Map<String, Object>> verifiableCredentialList = (List<Map<String, Object>>) vpDataMap.get("verifiableCredential");
 
	if (ObjectUtils.isEmpty(verifiableCredentialList)) {
		throw new SpException(MipErrorEnum.SP_UNEXPECTED_MSG_FORMAT, trxcode, "vp");
	}
 
	Map<String, Object> verifiableCredential = verifiableCredentialList.get(0);
 
	String vcId = (String) verifiableCredential.get("id");
 
	ResultVcStatus resultVcStatus = null;
 
	try {
		resultVcStatus = this.getVCStatus(vcId);
	} catch (BlockChainException e) {
		throw new SpException(MipErrorEnum.UNKNOWN_ERROR, trxcode, e.getErrorMsg());
	}
 
	String vcStatus = resultVcStatus.getVcStatus();
 
	if (vcStatus.equalsIgnoreCase(VcStatusEnum.ACTIVE.getVal())) { // 활성화 상태
		result = true;
	} else if (vcStatus.equalsIgnoreCase(VcStatusEnum.NEED_RENEW.getVal())) { // 갱신필요 상태
		String memo = resultVcStatus.getMemo();
 
		if (memo.equals("주소변경")) {
			result = true;
		} else {
			throw new SpException(MipErrorEnum.UNKNOWN_ERROR, trxcode, "제출불가 상태 : " + vcStatus + "(" + memo + ")");
		}
	} else {
		throw new SpException(MipErrorEnum.UNKNOWN_ERROR, trxcode, "제출불가 상태 : " + vcStatus);
	}
	// VP 상태 확인 End
 
	// Nonce 위변조 확인 Start
	TrxInfoVO curTrxInfo = trxInfoService.getTrxInfo(trxcode);
 
	if (curTrxInfo == null) {
		throw new SpException(MipErrorEnum.SP_TRXCODE_NOT_FOUND, trxcode);
	}
 
	String curVpVerifyResult = curTrxInfo.getVpVerifyResult();
 
	// 이미 verify 된 trx
	if ("Y".equals(curVpVerifyResult)) {
		throw new SpException(MipErrorEnum.SP_MSG_SEQ_ERROR, trxcode, "verifyResult == Y");
	}
 
	String profileNonce = curTrxInfo.getNonce();
 
	// 일반인증시 proof를 사용하고 안심인증시 proofs를 사용
	Map<String, Object> proof = (Map<String, Object>) vpDataMap.get("proof");
	List<Map<String, Object>> proofs = (List<Map<String, Object>>) vpDataMap.get("proofs");
 
	if (ObjectUtils.isEmpty(proof) && ObjectUtils.isEmpty(proofs)) {
		throw new SpException(MipErrorEnum.SP_UNEXPECTED_MSG_FORMAT, trxcode, "proof");
	}
 
	if (!ObjectUtils.isEmpty(proof)) {
		String vpNonce = (String) proof.get("nonce");
 
		LOGGER.debug("profileNonce : {}, vpNonce : {}", profileNonce, vpNonce);
 
		if (!profileNonce.equals(vpNonce)) {
			throw new SpException(MipErrorEnum.SP_MISMATCHING_NONCE, trxcode);
		}
	}
 
	if (!ObjectUtils.isEmpty(proofs)) {
		for (Map<String, Object> obj : proofs) {
			String vpNonce = (String) obj.get("nonce");
 
			LOGGER.debug("profileNonce : {}, vpNonce : {}", profileNonce, vpNonce);
 
			if (!profileNonce.equals(vpNonce)) {
				throw new SpException(MipErrorEnum.SP_MISMATCHING_NONCE, trxcode);
			}
		}
	}
	// Nonce 위변조 확인 End
 
	String vpVerifyResult = result ? "Y" : "N";
 
	trxInfo.setTrxcode(trxcode);
	trxInfo.setTrxStsCode(TrxStsCodeEnum.VERIFY_COM.getVal());
	trxInfo.setVpVerifyResult(vpVerifyResult);
 
	// VP 정보 추출 및 저장
	if(result) {
		Map<String, Object> credentialSubject = (Map<String, Object>) verifiableCredentialList.get(8).get("credentialSubject");
		List<Map<String, Object>> privacy = (List<Map<String, Object>>) credentialSubject.get("privacy");
		trxInfo.setVpName((String) privacy.get(0).get("value"));
	}
	// VP 정보 추출 및 저장 End
 
	trxInfoService.modifyTrxInfo(trxInfo);
 
	return result;
}

트랜잭션 처리 정보를 조회한다.

/**
 * 거래상태 조회
 * 
 * @param mipApiData {"data":"Base64로 인코딩된 TrxInfoVO"}
 * @return {"result":true, "data":"Base64로 인코딩된 TrxInfoVO"}
 * @throws SpException
 */
@RequestMapping(value = "/trxsts")
public MipApiDataVO getTrxsts(@RequestBody MipApiDataVO mipApiData) throws SpException {
	LOGGER.debug("거래상태 조회!");
 
	String data = Base64Util.decode(mipApiData.getData());
 
	TrxInfoVO trxInfo = null;
 
	try {
		trxInfo = ConfigBean.gson.fromJson(data, TrxInfoVO.class);
	} catch (JsonSyntaxException e) {
		throw new SpException(MipErrorEnum.SP_UNEXPECTED_MSG_FORMAT, null, "trxInfo");
	}
 
	trxInfo = trxInfoService.getTrxInfo(trxInfo.getTrxcode());
 
	mipApiData.setResult(true);
	mipApiData.setData(Base64Util.encode(ConfigBean.gson.toJson(trxInfo)));
 
	return mipApiData;
}

• 모바일 운전면허증 트랜잭션 정보 조회 예