步驟 4:測試整合功能

在正式環境上線前,請先使用測試身分憑證,在沙箱中驗證整合功能是否能端對端運作,然後錄製完整流程的示範影片。Google 會在新手上路的第 5 步審查這部影片。

本頁步驟

重要測試參考資料

支援的憑證和屬性

查看行動駕照、身分憑證和附相片的身分證件支援的確切doctype_value ID 和宣告路徑。

支援的核發機構和 IACA 憑證

下載正式版發卡機構 IACA 根憑證和 Utopia 沙箱憑證。

互動式網頁驗證工具

將您的整合功能與 OpenWallet Foundation 代管的參考驗證工具並列比較。


步驟 A:驗證沙箱測試設定

執行端對端測試前,請確認已符合下列四項必要條件:

  1. 裝置處於沙箱模式,並具有測試 ID:Android 測試裝置已切換至「SANDBOX」 (步驟 1),且 Google 錢包中已新增 Utopia 身分憑證 (步驟 2)。
  2. 沙箱要求簽署:
    • 依賴方:伺服器會使用預先信任的沙箱測試金鑰組和中繼資料簽署要求。
    • 驗證器註冊商:Google 已確認您的沙箱根憑證授權單位位於沙箱信任存放區,且您的伺服器使用與沙箱根憑證授權單位鏈結的葉憑證簽署要求,並包含 CBOR 編碼的 gw_rp_metadata_bytes (步驟 3.A:VR 規格)。
  3. 要求包含身分憑證文件類型:由於沙箱測試 ID 是身分憑證,因此 dcql_query 會要求 com.google.wallet.idcard.1 或 org.iso.23220.photoid.1 (或使用步驟 3.A 的多重憑證要求)。
  4. 伺服器信任 Utopia 沙箱憑證:伺服器的信任存放區包含 Utopia 沙箱憑證,因此 Utopia 測試 ID 的 issuerAuth 簽章驗證成功。

步驟 B:測試要求、使用者體驗和錯誤處理

請在您支援的每個平台 (Android 應用程式、行動版網站和電腦跨裝置網站) 上,逐一執行下列檢查:

  • 醒目的進入點:使用者輕觸/點選明確的按鈕 (例如「使用數位身分證件驗證」),即可啟動要求。
  • Android 應用程式 (如適用): CredentialManager.getCredential() 會開啟 Android 憑證選取器,並顯示沙箱測試身分憑證。
  • 網頁 (如適用): navigator.credentials.get() 會在行動瀏覽器上開啟認證選取器,並在使用經簽署的要求時,在電腦版瀏覽器上顯示跨裝置 QR code。
  • Google 錢包同意畫面:輕觸憑證會開啟 Google 錢包,並顯示 gw_rp_metadata_bytes 的預期顯示名稱、標誌和隱私權政策連結,以及您要求的屬性。
  • 資料最小化原則:只要求用途所需的屬性 (請參閱「支援的憑證和屬性」),並為每個要求準確設定 intent_to_retain。
  • 使用者取消和備用方案:取消工作表 (Android 上的 GetCredentialCancellationException 或網頁上遭拒的承諾),或在沒有相符 ID (NoCredentialException) 的情況下測試,都會在 UI 中妥善處理。

步驟 C:測試伺服器端解密和加密編譯驗證

在 Google 錢包中核准同意畫面後,請確認伺服器執行所有必要的密碼編譯檢查:

  • JWE 解密:伺服器會使用與 client_metadata.jwks 加密公開金鑰對應的私密金鑰,解密傳回的 identityToken,並擷取 vp_token。
  • SessionTranscript 重建:伺服器會使用 OpenID4VPDCAPIHandover 重建 SessionTranscript,並提供確切的要求 nonce、加密 JWK 指紋和平台來源 (android:apk-key-hash:... 或網路來源網址)。
  • IACA 憑證鏈驗證 (issuerAuth):伺服器會從 issuerAuth 擷取核發者憑證鏈,並在沙箱中根據 Utopia 沙箱憑證進行驗證,以及在正式環境中根據支援的核發者和 IACA 憑證中的官方正式版根憑證進行驗證。請務必執行這項檢查。
  • MSO、ValueDigests 和 deviceSignature 驗證:伺服器會驗證行動安全物件 (MSO) 簽章、確認 ValueDigests 與傳回的資料元素相符,並驗證 deviceSignature (ISO/IEC 18013-5 第 9.1.2 和 9.1.3 節)。
  • 零知識證明 (如已實作):如果要求 mso_mdoc_zk,伺服器會使用 longfellow-zk 驗證傳回的證明。

步驟 D:錄製端對端示範影片

整合功能通過步驟 B 和 C 後,請錄製螢幕畫面,展示完整的使用者歷程,包括從應用程式或網站到 Google 錢包同意聲明,再回到驗證狀態。下表列出根據新手上路路徑應包含的內容:

影片規定 依賴方 (直接) 驗證機構註冊商 (集結網站)
要顯示的畫面 完整使用者歷程:進入畫面 → 憑證選取器 → Google 錢包同意聲明和驗證 → 應用程式或網站中的驗證結果 初始 (第 1 個) 下游依賴方的完整使用者歷程
要記錄的流程 Android 應用程式和/或網頁整合流程 驗證者代管 (自行代管) 和商家代管 (依賴方代管) 流程 (如適用)
品牌宣傳和展示素材資源 實際顯示名稱、標誌,以及隱私權政策/《服務條款》網址 實際商家顯示素材資源 (名稱、標誌、服務條款網址) 和集結網站顯示素材資源

下一步

選擇新手上路路徑,提交影片並在正式環境中推出: