2단계: 샌드박스에서 테스트 ID 만들기

테스트 ID를 사용하면 실제 정부 발급 신분증 없이도 전체 프레젠테이션 흐름을 실행하고 서비스가 Google 월렛 응답을 수락하고 검증하는지 확인할 수 있습니다. 샌드박스 기기에서 Google 월렛에 시뮬레이션된 전자여권을 스캔하여 테스트 ID를 만듭니다.

시작

과정 선택하기 RP, VR 또는 오프라인

1
샌드박스 설정 계정 허용 목록에 추가 및 기기 전환
2여기
테스트 신분증 만들기 월렛에 테스트 신분증 패스 추가
3
통합 원하는 방식으로 빌드:
신뢰 당사자→ 검증자 등록 기관→
4
통합 테스트 E2E 체크리스트 실행 및 동영상 녹화
5
라이브 스트리밍 경로별 출시:
신뢰 당사자→ 검증자 등록 기관→

이 페이지의 단계

A 두 기기 설정시뮬레이터 휴대전화 + 샌드박스 월렛 휴대전화 B 월렛에 테스트 신분증 추가MRZ 스캔 및 NFC를 사용하여 탭 C 월렛에서 신분증 검사Google 월렛에서 카드 세부정보 확인 D 테스트 신분증 사용신분증 패스 doctype 및 테스트 흐름 요청

A단계: Android 기기 2대 설정하기

두 개의 Android 기기가 필요합니다. 첫 번째 기기는 전자여권을 시뮬레이션하고 두 번째 기기는 시뮬레이션된 전자여권에서 파생된 신분증 패스를 추가하는 기기입니다.

NFC를 지원하는 Android 휴대전화 두 대를 사용하여 Utopia 테스트 신분증 패스를 Google 월렛에 추가하는 3단계 프로세스

요구사항 기기 1: 여권 시뮬레이터 기기 2: 테스트 Google 월렛
직책 NFC 전자 여권을 시뮬레이션합니다. Google 월렛에 테스트 신분증 패스 보관
설정 단계
  1. Utopia ePassport Simulator 앱을 설치합니다.
  2. 앱을 열고 새 여권 항목을 추가합니다. B단계에서 이 항목을 스캔합니다.
  1. Play 스토어에서 Google 월렛 앱을 설치하거나 업데이트합니다.
  2. Google Play 서비스가 24.38.xx 이상인지 확인합니다 (확인 방법).
  3. 기기가 디버그 또는 루팅된 기기가 아닌지 확인합니다.
  4. Google 월렛을 샌드박스 환경으로 전환합니다 (개인 기기에서 이 작업을 수행하면 기존 프로덕션 데이터가 삭제됨).
  5. @gmail.com Google 계정으로 로그인합니다.

B단계: 월렛에 테스트 신분증 추가하기

  1. 기기 2에서 Google 월렛 앱을 열고 월렛에 추가를 탭합니다.
  2. 신분증 > 신분증 패스를 선택합니다.
  3. 화면에 표시된 안내를 따라 완료합니다.
    1. MRZ 스캔: 기기 1에서 시뮬레이터 앱에 이전에 만든 항목을 탭하고 기기 2에 여권 세부정보를 수동으로 입력합니다.
    2. NFC 스캔: NFC 스캔 중에 기기 1 (시뮬레이터 앱의 MRZ 페이지가 열려 있음)을 기기 2 뒷면에 갖다 댑니다.

C단계: 월렛에서 세부정보 보기

  1. 신분증 패스가 Google 월렛에 추가되면 오른쪽 상단의 점 3개 메뉴를 탭하고 신분증 패스 정보를 선택합니다.
  2. 나열된 옵션을 탭하고 예상대로 작동하는지 확인합니다. 특히 카드 세부정보 섹션을 열어 속성이 생성한 항목과 일치하는지 확인합니다.

D단계: 요청에 테스트 ID 사용

샌드박스 테스트 ID는 신분증 패스입니다. Google 월렛에서 일치하는 항목을 찾아 표시하려면 OpenID4VP dcql_query에서 신분증 패스 문서 유형을 요청해야 합니다.

  • com.google.wallet.idcard.1 (신분증 패스) 또는
  • org.iso.23220.photoid.1 (ISO 사진이 있는 신분증 문서 유형을 사용하는 신분증 패스)

모바일 운전면허증(org.iso.18013.5.1.mDL)만 요청하는 요청은 Utopia 테스트 신분증 패스와 일치하지 않습니다. 사용 가능한 사용자 인증 정보를 수락하려면 3.A단계: 요청 형식 지정에서 다중 사용자 인증 정보 dcql_query 샘플을 사용하고 사용 가능한 클레임 경로에 대해 지원되는 사용자 인증 정보 및 속성을 확인하세요.

다음 두 단계로 새 신분증 패스를 테스트합니다.

  1. 웹 인증 도구를 사용한 빠른 확인: 기기 2에서 (또는 교차 기기 QR 테스트를 위해 데스크톱 브라우저에서) verifier.multipaz.org를 열고 신분증 패스를 요청합니다. 이렇게 하면 자체 코드를 테스트하기 전에 기기와 테스트 신분증 패스가 작동하는지 확인할 수 있습니다.
  2. 자체 서비스에 대해 테스트: 3단계를 완료한 후 샌드박스 테스트 키(공개 키 기반 인증을 사용하는 당사자) 또는 샌드박스 루트 CA (검증자 등록기관)로 서명된 요청을 전송하고 Utopia 샌드박스 인증서에 대해 issuerAuth를 검증하도록 서버를 구성합니다.

문제 해결

문제 확인 사항
설정에 TapAndPay Environment가 없음 Google 계정이 아직 샌드박스 허용 목록에 없습니다. 1.A단계: 샌드박스 액세스 요청을 참고하세요.
월렛에 추가에 신분증 패스 옵션이 표시되지 않음 기기 2가 샌드박스 모드 (1.C단계)이고, @gmail.com 계정으로 로그인되어 있으며, 루팅/디버그되지 않았고, Play 서비스 24.38.xx 이상을 실행 중인지 확인합니다.
요청을 테스트할 때 '사용 가능한 디지털 신분증 없음' 요청에 com.google.wallet.idcard.1 또는 org.iso.23220.photoid.1가 포함되어 있고 기기 2가 여전히 샌드박스 모드인지 확인합니다.
Google 월렛 동의 화면 전에 요청이 실패함 JWS 서명, x5c 인증서 헤더, client_id (x509_hash), gw_rp_metadata_bytes를 확인합니다.

월렛에서 테스트 신분증 패스 삭제하기

신분증 화면 오른쪽 상단에 있는 점 3개 메뉴를 탭하고 삭제를 선택한 다음, 메시지에 따라 테스트 신분증 패스를 삭제합니다.

다음 단계

3단계 (공개 키 이용자): 통합 → 3단계 (검증자 등록기관): 통합 →