FIDO2 API สําหรับ Android

FIDO2 API ช่วยให้แอปพลิเคชัน Android สร้างและใช้ข้อมูลเข้าสู่ระบบสาธารณะที่มีการรับรองและรับรองที่เข้มงวดเพื่อวัตถุประสงค์ในการตรวจสอบสิทธิ์ผู้ใช้ได้ API จัดเตรียมการใช้งาน WebAuthn Client ซึ่งรองรับการใช้การตรวจสอบสิทธิ์ BLE, NFC และ USB (คีย์ความปลอดภัย) รวมถึง Authenticator ของแพลตฟอร์ม ซึ่งช่วยให้ผู้ใช้ตรวจสอบสิทธิ์โดยใช้ลายนิ้วมือหรือการล็อกหน้าจอได้

การผสานรวม

จุดแรกเข้าของ FIDO2 API คือ Fido2ApiClient

API รองรับการดําเนินการ 2 อย่างดังนี้

  • การลงทะเบียนจะเสร็จสิ้นเพียงครั้งเดียวต่อ Authenticator 1 บัญชีเมื่อผู้ใช้เชื่อมโยง Authenticator กับบัญชี
  • การลงชื่อสมัครใช้จะมีผลทุกครั้งที่ผู้มีส่วนเกี่ยวข้องต้องการตรวจสอบสิทธิ์ผู้ใช้

ทั้งการลงทะเบียนและการลงนามจําเป็นต้องมีการโต้ตอบของผู้ใช้

ดูแอปพลิเคชันตัวอย่างที่แสดงการใช้งาน API ได้ที่ https://github.com/android/identity-sample/tree/main/Fido2

ความสามารถในการทํางานร่วมกันกับเว็บไซต์ของคุณ

คุณสามารถอนุญาตให้ผู้ใช้แชร์ข้อมูลเข้าสู่ระบบในเว็บไซต์และแอปพลิเคชัน Android ได้อย่างราบรื่น ซึ่งทําได้โดยใช้ประโยชน์จากลิงก์เนื้อหาดิจิทัล คุณประกาศการเชื่อมโยงได้โดยโฮสต์ไฟล์ JSON ของลิงก์เนื้อหาดิจิทัล (Digital Asset Links) ในเว็บไซต์ และเพิ่มลิงก์ไปยังไฟล์ลิงก์เนื้อหาดิจิทัล (Digital Asset Links) ลงในไฟล์ Manifest ของแอป

เช่น หากต้องการเชื่อมโยง https://example.com กับแอป Android com.example.android ให้ทําดังนี้

ขั้นตอนที่ 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 Link

ในแอป Android ให้เพิ่มบรรทัดต่อไปนี้ลงในไฟล์ Manifest ในส่วน <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>

หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการเชื่อมโยงแอปและเว็บไซต์ ให้อ่านเอกสารประกอบของ SmartLock สําหรับรหัสผ่านใน Android