“使用 Google 钱包验证”支持三种集成路径：两种线上路径（适用于 Android 应用和网站）和一种线下路径（适用于近距离读取器和销售终端）。选择您的路径，开始探索之旅。
三种集成路径
依赖方 (RP)
适用于直接为自己的网站或 Android 应用验证用户的个人商家、企业或应用开发者。
验证者注册机构 (VR)
适用于代表多个下游商家（最终 RP）验证用户的 IDV 提供商、聚合商或平台。
现场验证
对于离线验证 mDL 的销售终端、场馆读卡器或移动验证器应用，如果您的终端支持 ISO/IEC 18013-5 mdoc 检索，则无需 Google 许可清单即可运行（目前不支持当面验证身份证件）。
在线路径对比：信赖方 vs. 验证器注册机构
| 切面 | 依赖方 (RP) | 验证者注册机构 (VR) |
|---|---|---|
| 谁来签署请求 | Google 为您的证书签名（您提交 CSR） | 您运行自己的 CA（沙盒 + 生产根 CA），并为最终 RP 签署叶证书 |
| 沙盒凭证 | Google 共享的沙盒测试密钥和元数据（立即开始测试） | 由您自己的沙盒根 CA 签名的证书（在 Google 信任该 CA 之后） |
| 何时与 Google 联系 | 在最后（第 5 步），即完成沙盒测试后 | 在开始时（第 1 步），注册您的沙盒和生产根 CA |
在线集成指南
选择您的线上集成路径，然后按顺序执行第 1 步到第 5 步。 在工程团队执行第 3 步的同时，您可以并行完成第 1 步和第 2 步（沙盒和测试 ID 设置）。
依赖方（直接）
设置沙盒
无需填写申请表或获得批准即可开始测试。为您的测试 Google 账号申请沙盒许可清单，将测试 Android 设备切换到沙盒模式，并下载 Google 的共享沙盒测试密钥和 Utopia 沙盒证书。
在沙盒中创建测试 ID
使用另一部运行 Utopia ePassport Simulator 的 Android 设备，将模拟的身份证件配置到沙盒设备上的 Google 钱包中。
作为依赖方进行集成
按照信赖方集成指南中的四个实现步骤操作：
- 第 3.A 步 - 设置请求格式并签名：构建 OpenID4VP JSON 查询，并在服务器上对 JWS 进行签名。
- 第 3.B 步 - 触发 API：调用 Android
CredentialManager或 Webnavigator.credentials.get()。 - 第 3.C 步 - 解密并验证响应：在服务器上解密 JWE 并验证 IACA 证书链和 MSO。
- 第 3.D 步（可选）- 添加零知识证明：在不接收用户出生日期的情况下验证年龄谓词。
端到端测试集成
针对您的服务出示 Utopia 测试身份证件，验证端到端核对清单中的每一项（包括针对 Utopia 沙盒证书的 issuerAuth 验证），并录制演示视频。
作为依赖方上线
提交依赖方新手入门表单，其中包含您的生产环境 CSR、品牌资产和沙盒 E2E 视频（正式接受依赖方服务条款）。获得批准后（通常需要 3-5 个工作日），Google 会返回您已签名的正式版证书和唯一的 gw_rp_metadata_bytes。
验证者注册机构（聚合信息提供方）
提交根 CA 并设置沙盒
首先，提交验证者注册机构入驻信息收集表单以及您的沙盒和生产根 CA 证书（接受验证者注册机构服务条款），以便 Google 信任您的沙盒根 CA。同时，将您的测试 Google 账号列入许可清单，并将测试 Android 设备切换到沙盒模式。
在沙盒中创建测试 ID
使用另一部运行 Utopia ePassport Simulator 的 Android 设备，将模拟的身份证件配置到沙盒设备上的 Google 钱包中。
作为验证器注册机构进行集成
按照 Verifier Registrar 集成指南中的五个实现步骤操作：
- 第 3.A 步 - 配置 CA 和 CBOR 元数据：设置 X.509 证书配置文件（OID
1.3.6.1.4.1.11129.10.1）和 CBOR 元数据架构。 - 第 3.B 步 - 设置请求格式并签名：构建 OpenID4VP JSON 查询，并使用 End-RP 叶证书对 JWS 进行签名。
- 第 3.C 步 - 触发 API：调用 Android
CredentialManager或 Webnavigator.credentials.get()。 - 第 3.D 步 - 解密和验证响应：在服务器上解密 JWE 并验证 IACA 证书链和 MSO。
- 第 3.E 步（可选）- 添加零知识证明：在不接收用户出生日期的情况下验证年龄。
端到端测试集成
Google 通知您沙盒根 CA 已受信任后，请签署测试 End-RP 证书，在服务器上信任 Utopia 沙盒证书，使用 Utopia 测试身份证件进行测试，并录制验证方托管流程和商家托管流程的演示视频。
以验证者注册机构身份上线并让最终 RP 注册
提交您的 E2E 视频以供审核。Google 会同时批准您的视频并信任您的生产根 CA。然后，使用验证器注册商客户端新手入门表单注册每个下游客户端，并颁发具有全局唯一可分辨名称的叶证书。
开始前的准备工作
- 一个用于创建请求和验证响应的服务器。在服务器上生成完整请求，即使对于 Android 应用也是如此。
- 两部 Android 设备用于测试：一部运行电子护照模拟器，另一部在 Google 钱包中保存测试 ID。请使用专用测试设备，因为切换到沙盒会删除设备的正式版 Google 钱包数据。
- 一个 @gmail.com Google 账号，用于在测试期间登录 Google 钱包。
- 权限请求页面的显示资源：显示名称、徽标（请参阅品牌推广指南）、隐私权政策网址和服务条款网址。