본문 바로가기
카테고리 없음

[WEB]모바일 신분증 Web/App 연동 개발(2/3)

예태서재 2024. 3. 6. 16:25

모바일 신분증 QR-MPM, APP2APP(WEB2APP) 방식 연동

모바일 신분증 개발지원센터에서 제공하는 샘플 소스를 통해 내 개발 환경에 적용해보자!!

 

해당 포스트에서는 모바일신분증 개발지원센터에서 제공하는 소스를 이용해 샘플 페이지를 올려보겠다.

이전 글 보기
↓ ↓ ↓ ↓
https://sensual-searcher.tistory.com/2
 

[WEB]모바일 신분증 Web/App 연동 개발(1/3)

현재 운영하고 있는 웹페이지에 모바일 신분증 연계하여 자격정보(운전면허정보)를 취득하여 처리해 달라는 오퍼가 전달되었다. 해당 포스트에서는 모바일신분증 연동 과정을 적어보겠다. ☝

sensual-searcher.tistory.com

 

☝목차

1. 모바일 신분증 소스(SP라이브러리/SDK) 구성
2. 필수 소스 다운로드
3. wallet&DID 생성
4. SDK(검증데몬) 적용

1. 모바일 신분증 관련 소스 구성

  • SP라이브러리 소스는 별도 컨테이너에 돌리지 않고, 기존 웹 컨테이너에 Import 하여 실행
  • SDK(검증데몬)는 서버에서 단독 실행
  • WAS Server <-> 블록체인(조폐공사) 방화벽 작업 필요

개발환경에 모바일신분증 라이브러리 구성도

2. 필수 소스 다운로드

모바일 신분증 연동을 위해 아래와 같이 3개의 파일이 필요하다.

필수 소스 3종

# 모바일 신분증 개발지원센터 - 활용가이드 다운로드 >>  https://dev.mobileid.go.kr/mip/dfs/downapi/useguidedown.do

위 링크를 통해 개발지원센터 -> 활용가이드 다운로드 -> 검증데몬 게시판으로 이동하여 다운 받도록 하자.
(최신버전이 있을 경우 최신버전 사용)

 

파일설명

1) SP 라이브러리 샘플소스코드(sp-with-verifier.zip)
Rest API 형식으로 개발되어 있으며, 여기 있는 대부분의 소스를 가져와 Import 하였다.
해당 소스 내 @Service 에서 SDK와 연동


2) 검증데몬 원본 소스(verifier-ori.zip)
검증데몬 jar 파일에 대한 원본 소스.
검증데몬 수정 시 해당 소스를 수정하여 Maven install 해주면 jar 파일이 생성 된다.


3) 검증데몬(verifier.zip) 
압축 해제하면 jar 파일이 하나 있고 해당 jar파일을 서버에서 실행시켜 주면 된다.
실행 시 검증데몬 원본 소스 내 일부 파일 필요(설정 파일)

 

3. Wallet&DID 생성

아래 링크를 통해 Wallet&DID 생성툴(CLI Tool)을 다운 받아 생성

# 모바일 신분증 개발지원센터 - 활용가이드 다운로드 >> https://dev.mobileid.go.kr/mip/dfs/downapi/useguidedown.do

Wallet&DID 생성 가이드

3.1 압축해제

  • 윈도우 : create_did_doc.bat 실행
  • 리눅스 : create_did_doc.sh 실행

Wallet&DID 압축 파일 해제

Wallet&DID는 윈도우나 리눅스 두 곳 중 편한 곳에서 생성하면 됨
단, 생성 시 입력 한 정보는 꼭 메모해 둘 수 있도록!!
운영환경에서 만들 필요는 없음!!(나의 경우 편의를 위해 그냥 윈도우에서 진행)

 

3.2 Wallet & DID 생성

압축해제 한 디렉토리로 이동하여 [Shift + 우클릭 -> 여기에 PowerShell 창 열기] 클릭

Wallet&DID 스크립트 실행

  1. ./create_did_doc.bat 실행
  2. [개발], [운영]에 따라 [1] 또는 [2] 입력(개발에 먼저 적용이므로 [1] 입력)
  3. Wallet 생성에 필요한 비밀번호 입력(ex: test.pwd)
  4. Wallet 에 추가할 ECC KEY ID 입력(ex: test.sp) (확장자는 .sp 이어야 함)
  5. Wallet 에 추가할 RSA KEY ID 입력(ex: test.sp.rsa) (확장자는 .sp.rsa 이어야 함)
  6. DID 파일명 입력(ex: test.did) (확장자는 .did 이어야 함)

3.3 Wallet & DID 확인

생성 완료 후 파일 확인

Wallet&DID 생성 완료

sp.wallet 파일과 test.did 파일 생성 확인(해당 파일은 연계신청서 제출 시 전달 필요)

Wallet&DID 완료 후 생성 파일

4. SDK(검증데몬) 적용

SDK(검증데몬) 셋팅

4.1 검증데몬 원본 소스(verifier-ori.zip) + 검증데몬(verifier.zip) 압축 해제
4.2 verifier-ori 폴더에 verifier.jar 복사
4.3 verifier-ori 폴더에 위에서 생성한 Wallet 파일과 DID 파일 복사

생성 파일 복사

4.4 properties 수정

  • verifier-ori 폴더에 application-dev.properties 수정 
  • Server Settings 수정
    properties 수정(server 정보)
  • SP & Wallet 수정
    properties 수정(wallet&DID)

4.5 service.json 수정

한개의 항목을 제외 하고 모두 삭제 후 테스트 신청 정보 작성 

service.json 수정

4.6 검증데몬(verifier.jar) 실행

실행 명령어
java -Dfile.encodig=UTF-8 -jar ./verifier.jar --spring.config.location=./application-dev.properties

 

@ application-dev.properties 는 위에서 수정한 properties 

검증데몬 실행 로그

위와 같이 서버에서 검증데몬(verifier.jar) 실행하게 되면 로그들이 출력 되고 위 두곳의 빨간박스의 onSuccess 를 꼭 확인해야 한다.

티스토리툴바