Google 월렛으로 인증은 세 가지 통합 경로를 지원합니다. 두 가지 온라인 경로(Android 앱 및 웹사이트용)와 한 가지 오프라인 경로 (근접 리더 및 POS 단말기용)입니다. 시작하려면 학습 과정을 선택하세요.
세 가지 통합 경로
신뢰 당사자 (RP)
자체 웹사이트 또는 Android 앱의 사용자를 직접 인증하는 개인 판매자, 비즈니스 또는 앱 개발자
인증자 등록기관 (VR)
여러 다운스트림 비즈니스 (최종 RP)를 대신하여 사용자를 인증하는 IDV 제공업체, 애그리게이터 또는 플랫폼
오프라인 인증
오프라인에서 mDL을 확인하는 POS 단말기, 공연 무대 리더기 또는 모바일 인증 앱의 경우 단말기가 ISO/IEC 18013-5 mdoc 검색을 지원하면 Google 허용 목록 없이 작동합니다 (신분증 패스는 현재 오프라인에서 지원되지 않음).
온라인 경로 비교: 신뢰 당사자 및 인증자 등록기관
| 관점 | 신뢰 당사자 (RP) | 인증자 등록기관 (VR) |
|---|---|---|
| 요청에 서명하는 사용자 | Google에서 인증서에 서명 (CSR 제출) | 자체 CA (샌드박스 + 프로덕션 루트 CA)를 실행하고 최종 RP의 리프 인증서에 서명합니다. |
| 샌드박스 사용자 인증 정보 | Google의 공유 샌드박스 테스트 키 및 메타데이터 (즉시 테스트 시작) | Google에서 신뢰한 후 자체 샌드박스 루트 CA에서 서명한 인증서 |
| Google에 문의해야 하는 경우 | 샌드박스 테스트를 완료한 후 마지막 (5단계) | 시작 (1단계)에서 샌드박스 및 프로덕션 루트 CA를 등록합니다. |
온라인 통합 가이드
온라인 통합 경로를 선택하여 1~5단계를 순서대로 따릅니다. 엔지니어링팀에서 3단계를 빌드하는 동안 1단계와 2단계 (샌드박스 및 테스트 ID 설정)를 동시에 완료할 수 있습니다.
신뢰 당사자 (직접)
샌드박스 설정
테스트를 시작하는 데 접수 양식이나 승인이 필요하지 않습니다. 테스트 Google 계정의 샌드박스 허용 목록 추가를 요청하고, 테스트 Android 기기를 샌드박스 모드로 전환하고, Google의 공유 샌드박스 테스트 키와 Utopia Sandbox 인증서를 다운로드합니다.
샌드박스에서 테스트 ID 만들기
Utopia ePassport Simulator를 실행하는 두 번째 Android 기기를 사용하여 시뮬레이션된 신분증 패스를 샌드박스 기기의 Google 월렛에 프로비저닝합니다.
신뢰 당사자로 통합
신뢰 당사자 통합 가이드의 4가지 구현 단계를 따릅니다.
- 3A단계 — 요청 형식 지정 및 서명: OpenID4VP JSON 쿼리를 빌드하고 서버에서 JWS에 서명합니다.
- 3.B단계 — API 트리거: Android
CredentialManager또는 웹navigator.credentials.get()을 호출합니다. - 3.C단계 — 응답 복호화 및 검증: JWE를 복호화하고 서버에서 IACA 인증서 체인과 MSO를 확인합니다.
- 3D단계 (선택사항) — 영지식 증명 추가: 사용자의 생년월일을 수신하지 않고 연령 술어를 확인합니다.
통합 엔드 투 엔드 테스트
서비스에 Utopia 테스트 신분증 패스를 제시하고, Utopia 샌드박스 인증서에 대한 issuerAuth 검증을 포함한 엔드 투 엔드 체크리스트의 모든 항목을 확인하고, 시연 동영상을 녹화합니다.
신뢰 당사자로 게시
프로덕션 CSR, 브랜딩 애셋, 샌드박스 E2E 동영상과 함께 공개 키 이용자 온보딩 양식을 제출합니다 (공개 키 이용자 서비스 약관에 공식적으로 동의). 승인되면 (일반적으로 영업일 기준 3~5일) Google에서 서명된 프로덕션 인증서와 고유한 gw_rp_metadata_bytes를 반환합니다.
인증자 등록기관 (애그리게이터)
루트 CA 제출 및 샌드박스 설정
먼저 Google에서 샌드박스 루트 CA를 신뢰할 수 있도록 샌드박스 및 프로덕션 루트 CA 인증서와 함께 검증자 등록기관 온보딩 접수 양식을 제출합니다 (검증자 등록기관 서비스 약관에 동의). 동시에 테스트 Google 계정을 허용 목록에 추가하고 테스트 Android 기기를 샌드박스 모드로 전환합니다.
샌드박스에서 테스트 ID 만들기
Utopia ePassport Simulator를 실행하는 두 번째 Android 기기를 사용하여 시뮬레이션된 신분증 패스를 샌드박스 기기의 Google 월렛에 프로비저닝합니다.
인증자 등록기관으로 통합
검증자 등록기관 통합 가이드의 5가지 구현 단계를 따르세요.
- 3.A단계 — CA 및 CBOR 메타데이터 구성: X.509 인증서 프로필 (OID
1.3.6.1.4.1.11129.10.1) 및 CBOR 메타데이터 스키마를 설정합니다. - 3B단계 — 요청 형식 지정 및 서명: OpenID4VP JSON 쿼리를 빌드하고 최종 RP 리프 인증서로 JWS에 서명합니다.
- 3.C단계 — API 트리거: Android
CredentialManager또는 웹navigator.credentials.get()을 호출합니다. - 3.D단계 — 응답 복호화 및 검증: JWE를 복호화하고 서버에서 IACA 인증서 체인과 MSO를 확인합니다.
- 3.E단계 (선택사항) — 영지식 증명 추가: 사용자의 생년월일을 받지 않고 연령 술어를 확인합니다.
통합 엔드 투 엔드 테스트
Google에서 샌드박스 루트 CA가 신뢰할 수 있다고 알리면 테스트 최종 RP 인증서에 서명하고, 서버에서 Utopia 샌드박스 인증서를 신뢰하고, Utopia 테스트 신분증 패스로 테스트하고, 검증 도구 호스팅 흐름과 판매자 호스팅 흐름 모두에 대한 데모 동영상을 녹화합니다.
검증자 등록기관으로 라이브 시작 및 최종 RP 온보딩
검토를 위해 E2E 동영상을 제출합니다. Google은 동영상을 승인하고 프로덕션 루트 CA를 동시에 신뢰합니다. 그런 다음 검증자 등록기관 클라이언트 온보딩 양식을 사용하여 각 다운스트림 클라이언트를 등록하고 전역적으로 고유한 고유 이름으로 리프 인증서를 발급합니다.
시작하기 전에 준비해야 할 사항
- 요청을 만들고 응답을 검증하는 서버 Android 앱의 경우에도 서버에서 전체 요청을 생성합니다.
- 테스트용 Android 기기 2대: 한 기기에서는 여권 시뮬레이터를 실행하고 다른 기기에서는 Google 월렛에 테스트 ID를 보관합니다. 샌드박스로 전환하면 기기의 프로덕션 월렛 데이터가 삭제되므로 전용 테스트 기기를 사용하세요.
- 테스트하는 동안 Google 월렛에서 사용할 @gmail.com Google 계정
- 동의 화면의 표시 애셋: 표시 이름, 로고 (브랜드 가이드라인 참조), 개인정보처리방침 URL, 서비스 약관 URL