關於儲存數位憑證

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

圖片:Credential Manager 中的數位憑證使用者介面
圖 1. 數位憑證選取器使用者介面。

憑證格式

憑證可以不同的憑證格式儲存在持有者應用程式中。這些格式是憑證呈現方式的規格,每種格式都包含下列憑證資訊:

  • 類型:類別,例如大學學位或駕照。
  • 屬性:姓氏和名字等屬性。
  • 編碼:憑證的結構,例如 SD-JWT 或 mdoc

  • Validity:以加密編譯方式驗證憑證真實性的方法。

每種憑證格式的編碼和驗證方式略有不同,但功能相同。

登錄檔支援兩種格式:

使用 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 整合,即可完成這項功能。