MyID2.0 Implementation Guide

# BLE 검증

# Overview

이 문서는 verifier용 어플리케이션이 쯩 for 공공기관 앱과 연동하기 위한 가이드입니다.

Verifier(연동앱)이 BLE를 통해 VP(Veriable Presentation)를 획득하는 기능에 대해서만 정리되어 있습니다. 발급 관련 기능은 아직 제공하지 않습니다.

# BLE Verification Sequence

BLE Connection과 presentation message전달의 순서와 기능은 아래 그림과 같습니다.

image alt text

# Implementation Guide

기본적으로 다음과 같은 작업을 수행합니다.

  • QR Code Scan
  • BLE Connection
  • Presentation message 제출

# QR Code Scan

QR Code는 Holder역할의 쯩 for 공공기관 앱에서 노출하고 Verifier에 해당하는 연동앱에서 QR Code를 스캔합니다.

QR Code는 HolderApp과 VerifierApp 두 단말이 BLE connection 할 수 있는 정보를 담고 있습니다.

Holder는 QR Code에 ServiceUUID와 Pincode를 노출하는데 이는 각각 BLE Advertising을 위한 Service의 UUID와 Connection을 인증할 때 사용 할 Pincode입니다.

# QR Code Sample과 Plain Text

zzeunglink://k-btf.co.kr/app/link/ble?id=12342222-0000-1000-8000-00805f9b34fb&code=1234

image alt text

# BLE Connection

VerifierApp은 QR Scanner로 QR Code를 인식하고 BLE Advertising들을 scan하여 ServiceUUID가 일치하는 Holder의 Advertising를 찾고 Holder Device에 connection합니다.

connection이 완성되면 Verifier는 Holder에서 Pincode를 전달하고 Holder는 전달받은 Pincode 일치여부를 확인합니다.

Pincode가 일치 할 경우는 인증된 Verifier Device로 인식하고 presentation message가 저장된 URL을 전달합니다.

# Presentation message 제출

VerifierApp은 획득한 URL로부터 presentation message를 획득합니다.

VerifierApp은 획득한 presentation message를 직접 verifier 서버에게 전달합니다.

← API →