Android 的 FIDO2 API

FIDO2 API 可讓 Android 應用程式建立和使用經過嚴格驗證的公開金鑰式憑證，以用於驗證使用者。這個 API 提供 WebAuthn Client 實作，支援使用 BLE、NFC 和 USB 漫遊驗證工具 (安全金鑰)，以及平台驗證工具，讓使用者能夠以自己的指紋或螢幕鎖定方式進行驗證。

整合

FIDO2 API 進入點是 Fido2ApiClient。

這個 API 支援兩項作業：

  • 註冊帳戶會在每個驗證器與帳戶建立關聯後，完成一次驗證。
  • 每當相依方想要驗證使用者時，系統就會進行簽署。

註冊和簽署都需要使用者進行互動。

您可以在 https://github.com/android/identity-samples/tree/main/Fido2 中找到示範 API 使用方式的範例應用程式。

與網站的互通性

可讓使用者輕鬆在網站和 Android 應用程式中順暢共用憑證。方法很簡單，只要利用 Digital Asset Links 即可。 如要宣告關聯，您可以在網站中代管 Digital Asset Links JSON 檔案，並在應用程式資訊清單中加入 Digital Asset Link 檔案的連結。

舉例來說，如果您想將 https://example.com 與 Android 應用程式 com.example.android 建立關聯，請採取下列 3 個步驟：

步驟 1：在您的網域上代管「assetlinks.json」

建立類似的 JSON 檔案，並託管於 https://example.com/.well-known/assetlinks.json。

[
  {
    "relation" : [
      "delegate_permission/common.handle_all_urls",
      "delegate_permission/common.get_login_creds"
    ],
    "target" : {
      "namespace" : "web",
      "site" : "https://example.com"
    }
  },
  {
    "relation" : [
      "delegate_permission/common.handle_all_urls",
      "delegate_permission/common.get_login_creds"
    ],
    "target" : {
      "namespace" : "android_app",
      "package_name" : "com.example.android",
      "sha256_cert_fingerprints" : [
         "DE:AD:BE:EF"
      ]
    }
  }
]

確認可供 Google 檢索，並透過 HTTP 標頭 Content-Type: application/json 提供。

sha256_cert_fingerprints 是應用程式簽署憑證的 SHA256 指紋。如需詳細資訊，請參閱 Android 應用程式連結說明文件。

在您的 Android 應用程式中，將以下這一行新增至 <application> 下的資訊清單檔案：

<meta-data android:name="asset_statements" android:resource="@string/asset_statements" />

步驟 3：在 strings.xml 檔案中新增 asset_statements 字串資源

asset_statements 字串是一個 JSON 物件，用於指定要載入的 assetlinks.json 檔案。您必須逸出在字串中使用的任何單引號和引號。例如：

<string name="asset_statements" translatable="false">
[{
  \"include\": \"https://example.com/.well-known/assetlinks.json\"
}]
</string>

如要進一步瞭解如何為應用程式和網站建立關聯，請參閱 Android 密碼專用 SmartLock 說明文件。