Credential Manager Holder API 可讓 Android 持有者 (也稱為「錢包」) 應用程式管理數位憑證,並向驗證者出示。

憑證格式
憑證可以不同的憑證格式儲存在持有者應用程式中。這些格式是憑證呈現方式的規格,每種格式都包含下列憑證資訊:
- 類型:類別,例如大學學位或駕照。
- 屬性:姓氏和名字等屬性。
編碼:憑證的結構,例如 SD-JWT 或 mdoc
Validity:以加密編譯方式驗證憑證真實性的方法。
每種憑證格式的編碼和驗證方式略有不同,但功能相同。
登錄檔支援兩種格式:
- SD-JWT:符合 IETF SD-JWT 型可驗證憑證 (SD-JWT VC) 規格。
- 行動文件或 mdoc:符合 ISO/IEC 18013-5:2021 規格。
使用 Credential Manager 時,驗證器可以針對 SD-JWT 和 mdoc 提出 OpenID4VP 要求。選擇會因用途和產業而異。
憑證中繼資料註冊
Credential Manager 不會直接儲存持有者的憑證,而是儲存憑證的中繼資料。持有者應用程式必須先使用 RegistryManager 向 Credential Manager 註冊憑證中繼資料。這項註冊程序會建立註冊記錄,主要用途有兩個:
- 比對:已註冊的憑證中繼資料會用於比對日後的驗證器要求。
- 顯示:在憑證選取器介面上,向使用者顯示自訂 UI 元素。
請使用 OpenId4VpRegistry 類別註冊數位憑證,因為該類別同時支援 mdoc 和 SD-JWT 憑證格式。驗證者會傳送 OpenID4VP 要求,索取這些憑證。
憑證核發方法
憑證核發作業可透過下列兩種方式觸發:
- 發卡機構啟動流程:使用者透過發卡機構應用程式或網站,觸發核發 VDC 的要求。舉例來說,網站可能會提供「將護照新增至錢包」選項。核發者會呼叫 Credential Manager 核發 API,提出 OpenID4VCI 憑證提供要求。如要處理這類要求,持有者必須先與 Credential Manager 整合,註冊其中繼資料。Credential Manager 會顯示相關選項供使用者選取。使用者選取持有者選項後,系統會叫用持有者應用程式,並繼續執行完成核發所需的步驟。
- 持有人啟動流程:使用者要求從持有人應用程式新增 VDC。舉例來說,持有人可能會提供「新增護照」按鈕。 在這種情況下,持卡人會維護支援的發卡機構清單和中繼資料。不必與 Android Credential Manager 整合,即可完成這項功能。