在正式環境上線前,請先使用測試身分憑證,在沙箱中驗證整合功能是否能端對端運作,然後錄製完整流程的示範影片。Google 會在新手上路的第 5 步審查這部影片。
本頁步驟
A
檢查沙箱設定裝置、測試 ID、簽署金鑰和 IACA 根憑證
B
測試要求和使用者體驗流程驗證選取器、同意畫面和錯誤
C
測試伺服器驗證驗證 JWE 解密和 IACA 簽章
D
錄製端對端影片錄製 RP 或 VR 核准示範影片
重要測試參考資料
支援的憑證和屬性
查看行動駕照、身分憑證和附相片的身分證件支援的確切doctype_value ID 和宣告路徑。
支援的核發機構和 IACA 憑證
下載正式版發卡機構 IACA 根憑證和 Utopia 沙箱憑證。
互動式網頁驗證工具
將您的整合功能與 OpenWallet Foundation 代管的參考驗證工具並列比較。
步驟 A:驗證沙箱測試設定
執行端對端測試前,請確認已符合下列四項必要條件:
- 裝置處於沙箱模式,並具有測試 ID:Android 測試裝置已切換至「SANDBOX」 (步驟 1),且 Google 錢包中已新增 Utopia 身分憑證 (步驟 2)。
- 沙箱要求簽署:
- 依賴方:伺服器會使用預先信任的沙箱測試金鑰組和中繼資料簽署要求。
- 驗證器註冊商:Google 已確認您的沙箱根憑證授權單位位於沙箱信任存放區,且您的伺服器使用與沙箱根憑證授權單位鏈結的葉憑證簽署要求,並包含 CBOR 編碼的
gw_rp_metadata_bytes(步驟 3.A:VR 規格)。
- 要求包含身分憑證文件類型:由於沙箱測試 ID 是身分憑證,因此
dcql_query會要求com.google.wallet.idcard.1或org.iso.23220.photoid.1(或使用步驟 3.A 的多重憑證要求)。 - 伺服器信任 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 應用程式和/或網頁整合流程 | 驗證者代管 (自行代管) 和商家代管 (依賴方代管) 流程 (如適用) |
| 品牌宣傳和展示素材資源 | 實際顯示名稱、標誌,以及隱私權政策/《服務條款》網址 | 實際商家顯示素材資源 (名稱、標誌、服務條款網址) 和集結網站顯示素材資源 |
下一步
選擇新手上路路徑,提交影片並在正式環境中推出: