FIDO2 API 可讓 Android 應用程式建立及使用經過嚴格驗證的公用金鑰憑證,用於驗證使用者。這個 API 提供了 WebAuthn Client 實作,支援使用 BLE、NFC 和 USB 漫遊驗證器 (安全金鑰) 以及平台驗證工具,透過指紋或螢幕鎖定的方式進行驗證。
整合
FIDO2 API 進入點是 Fido2ApiClient。
API 支援以下兩種作業:
- 「註冊」是指每個帳戶與每個驗證器產生一次,也就是使用者將驗證器與帳戶建立關聯時。
- 信賴關係會在信賴方想要驗證使用者時進行。
註冊和簽署都需要使用者互動。
您可以前往 https://github.com/android/security-samples/tree/master/Fido 查看展示 API 使用情況的範例應用程式。
與您網站的互動性
方便使用者在您的網站和 Android 應用程式中順暢共用憑證。方法很簡單,只要利用數位資產連結就行了。 如要宣告關聯,您可以在網站中代管 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 App Links 說明文件。
步驟 2:在 Android 應用程式中連結至 assetlinks.json
在您的 Android 應用程式中,將以下這一行加入資訊清單的 <application>
之下:
<meta-data android:name="asset_statements" android:resource="@string/asset_statements" />
步驟 3:將 asset_statements
字串資源新增至 string.xml 檔案。
asset_statements
字串是一個 JSON 物件,用於指定您要載入的 assetlinks.json
檔案。您必須逸出在字串中使用的任何引號和引號。例如:
<string name="asset_statements" translatable="false">
[{
\"include\": \"https://example.com/.well-known/assetlinks.json\"
}]
</string>
如要進一步瞭解如何為應用程式和網站建立關聯,請參閱 Android 專用密碼專用 SmartLock 說明文件。