Chọn cách triển khai khoá truy cập phù hợp cho ứng dụng Android của bạn

Khoá truy cập đã trở thành tiêu chuẩn cho phương thức xác thực an toàn, thân thiện với người dùng và ngày càng có nhiều dịch vụ áp dụng khoá truy cập trên cả trang web và ứng dụng Android. Tuy nhiên, khi bắt đầu thêm khoá truy cập vào một ứng dụng Android, bạn thường gặp phải một câu hỏi quan trọng về cấu trúc: bạn gọi trực tiếp các API gốc, mở trang đăng nhập web hiện có trong thẻ trình duyệt hay chạy khoá truy cập bên trong WebView trong ứng dụng?

Tổng quan

Bạn có thể hỗ trợ khoá truy cập trong ứng dụng Android thông qua ba phương pháp chính: Trình quản lý thông tin xác thực, Thẻ xác thực và WebView. Tài liệu chính thức trình bày chi tiết từng bước triển khai cho mỗi lựa chọn. Để chọn một cấu trúc giúp giảm thiểu sự phiền hà cho người dùng trong khi vẫn kiểm soát được chi phí phát triển và bảo trì, bạn cần hiểu rõ đặc điểm và các quy tắc ràng buộc của từng lựa chọn ở cấp độ cao. Hướng dẫn này giải thích cách chọn phương pháp phù hợp dựa trên thiết kế của ứng dụng và cơ sở hạ tầng xác thực hiện có. Bảng sau đây so sánh các phương pháp này:

Tính năng Trình quản lý thông tin xác thực Thẻ xác thực WebView
Trường hợp sử dụng nên dùng Ứng dụng có giao diện người dùng đăng nhập gốc Sử dụng lại trang đăng nhập hiện có trên web hoặc nhà cung cấp dịch vụ danh tính (IdP) OAuth hoặc OpenID Connect (OIDC) Ứng dụng WebView kết hợp hiện có (chỉ miền của bên thứ nhất)
Giao diện người dùng và trải nghiệm người dùng Tích hợp tính năng tự động điền bằng bàn phím và bảng dưới cùng của hệ điều hành gốc Thẻ trình duyệt chuyên biệt, tối giản để xác thực Trang web nhúng có bảng dưới cùng của hệ điều hành gốc
Tự động điền và giao diện người dùng có điều kiện Được hỗ trợ (Tính năng tự động điền của Trình quản lý thông tin xác thực) Được hỗ trợ (Giao diện người dùng có điều kiện của WebAuthn) Không được hỗ trợ
Chia sẻ phiên và thông tin đăng nhập Chia sẻ khoá truy cập trên web và ứng dụng bằng assetlinks.json và rpId dùng chung (không chia sẻ cookie của Chrome) Chia sẻ cookie và trạng thái thông tin xác thực với Chrome (có thể tắt bằng cách sử dụng tính năng duyệt web tạm thời) Chia sẻ khoá truy cập bằng assetlinks.json, nhưng tách biệt cookie và phiên khỏi Chrome
Digital Asset Links (assetlinks.json) Bắt buộc trên miền web của bên Relying Party Bắt buộc đối với miền URI chuyển hướng của bạn cho các lệnh chuyển hướng HTTPS (nên dùng thay vì lược đồ tuỳ chỉnh, vốn không yêu cầu tệp này) Bắt buộc trên miền web của bên Relying Party (không thể dùng với IdP bên ngoài hoặc bên thứ ba)

Trình quản lý thông tin xác thực

Nếu ứng dụng Android của bạn có màn hình đăng nhập hoặc đăng ký gốc, thì thư viện Jetpack Trình quản lý thông tin xác thực là phương pháp chính được đề xuất.

Ưu điểm chính của Trình quản lý thông tin xác thực là hợp nhất khoá truy cập, mật khẩu và tính năng Đăng nhập bằng Google vào một bảng dưới cùng của hệ thống, giúp đơn giản hoá quy trình. Khi đăng nhập, người dùng chỉ cần nhấn một lần để hoàn tất quy trình xác thực bằng sinh trắc học mà không cần rời khỏi ứng dụng của bạn, nhờ đó giảm bớt phiền toái khi đăng nhập. Ngay cả khi người dùng đóng bảng dưới cùng ban đầu và nhấn vào trường nhập dữ liệu tên người dùng hoặc mật khẩu, bạn vẫn có thể sử dụng PendingGetCredentialRequest để hiển thị khoá truy cập, mật khẩu và tính năng Đăng nhập bằng Google ngay trong bàn phím hoặc các đề xuất tự động điền trong trình đơn thả xuống. Phương án dự phòng này cung cấp một tính năng tích hợp tự động điền gốc tương đương với Giao diện người dùng có điều kiện của WebAuthn.

Bảng dưới cùng của Trình quản lý thông tin xác thực cho thấy các lựa chọn khoá truy cập, Đăng nhập bằng Google và mật khẩu.
Hình 1. Trình quản lý thông tin xác thực hợp nhất khoá truy cập, tính năng Đăng nhập bằng Google và mật khẩu trong một bảng dưới cùng của hệ thống.

Trình quản lý thông tin xác thực cũng cung cấp đầy đủ tính năng tương đương với các chức năng hiện đại của vòng đời khoá truy cập web. Với Trình quản lý thông tin xác thực, bạn có thể làm những việc sau:

  • Sử dụng tính năng tự động tạo khoá truy cập (isConditional = true trong CreatePublicKeyCredentialRequest) để tự động tạo khoá truy cập sau khi đăng nhập thành công bằng mật khẩu.
  • Sử dụng Signal API để duy trì tính nhất quán giữa thông tin xác thực và tên người dùng với các nhà cung cấp thông tin xác thực.
  • Triển khai tính năng Khôi phục thông tin đăng nhập để tự động đăng nhập lại người dùng vào ứng dụng của bạn khi họ thiết lập thiết bị mới.

Khoá truy cập được hỗ trợ trên các thiết bị chạy Android 9 (cấp độ API 28) trở lên, trong khi các thông tin đăng nhập khác (chẳng hạn như mật khẩu) vẫn được hỗ trợ trên các phiên bản Android thấp hơn thông qua Dịch vụ Google Play. Trên Android 14 (cấp độ API 34) trở lên, Trình quản lý thông tin xác thực cũng hoạt động với mọi trình cung cấp thông tin xác thực bên thứ ba do người dùng chọn. Các chức năng bổ sung, chẳng hạn như tích hợp tính năng tự động điền dựa trên View (PendingGetCredentialRequest) và Signal API, yêu cầu Android 15 (API cấp 35) trở lên.

Chia sẻ thông tin đăng nhập trên web và ứng dụng

Để bắt đầu, hãy làm theo Điều kiện tiên quyết để lưu trữ tệp Digital Asset Links (assetlinks.json) trên miền web của bạn nhằm liên kết trang web và ứng dụng Android của bạn. Việc liên kết trang web và ứng dụng thông qua assetlinks.json có nghĩa là chúng có cùng mã nhận dạng bên phụ thuộc (rpId), vì vậy, khoá truy cập được tạo trên trang web của bạn trong Chrome sẽ hoạt động trong ứng dụng Android gốc thông qua Trình quản lý thông tin xác thực và khoá truy cập được tạo trong ứng dụng sẽ hoạt động trên trang web của bạn. Trình quản lý thông tin xác thực chia sẻ thông tin xác thực trên trang web và ứng dụng của bạn; bạn chỉ cần Thẻ xác thực khi muốn sử dụng lại giao diện người dùng đăng nhập web hoặc trang IdP.

Như mô tả trong phần Tạo khoá truy cập, bạn cũng phải định cấu hình máy chủ để xác minh nguồn gốc ứng dụng Android (android:apk-key-hash:ENCODED_SHA256_HASH, được định dạng bằng hàm băm SHA-256 được mã hoá Base64URL không có khoảng đệm của chứng chỉ ký APK). Nếu ứng dụng của bạn có giao diện người dùng gốc và bạn muốn có trải nghiệm tích hợp với hệ điều hành để đăng nhập bằng khoá truy cập, hãy chọn Trình quản lý thông tin xác thực.

Thẻ xác thực

Nhiều dịch vụ vận hành một dịch vụ vi mô của nhà cung cấp dịch vụ danh tính (IdP) được xây dựng trên OAuth hoặc OpenID Connect (OIDC) hoặc muốn sử dụng lại trang đăng nhập web hiện có hỗ trợ khoá truy cập trên các ứng dụng di động. Trước đây, các ứng dụng sử dụng Thẻ tuỳ chỉnh cho các luồng này. Kể từ Chrome 137 và AndroidX Browser 1.9.0, Thẻ xác thực cung cấp một thẻ trình duyệt chuyên biệt được thiết kế riêng cho quy trình xác thực.

Thẻ xác thực hiển thị giao diện đăng nhập tối giản của trình duyệt mà không có các mục trong trình đơn của trình duyệt đa năng.
Hình 2. Thẻ xác thực cung cấp một giao diện trình duyệt tập trung, được điều chỉnh cho phù hợp với quy trình xác thực.

Thẻ tuỳ chỉnh tiêu chuẩn được thiết kế dưới dạng trình duyệt trong ứng dụng cho mục đích chung, hiển thị các phần tử trên giao diện người dùng không liên quan đến việc đăng nhập (chẳng hạn như trình đơn chia sẻ, dấu trang và Mở trong Chrome) có thể khiến người dùng mất tập trung. Các thư viện này cũng yêu cầu khai báo bộ lọc ý định trong tệp kê khai để nhận lệnh chuyển hướng sau khi xác thực, thêm mã nguyên mẫu và cần có biện pháp bảo vệ chống lại hành vi chặn ý định của các ứng dụng độc hại.

Thẻ xác thực giải quyết những thách thức cụ thể về việc xác thực này. Tính năng này loại bỏ giao diện người dùng không cần thiết của trình duyệt, chẳng hạn như nút thu nhỏ và trình đơn chia sẻ, đồng thời trình bày một giao diện tập trung chỉ có các chức năng đăng nhập thiết yếu, bao gồm cả khoá truy cập và tính năng tự động điền mật khẩu. Thay vì định tuyến thông qua ý định của hệ điều hành, Thẻ xác thực sẽ phân phối các lệnh chuyển hướng xác thực trực tiếp đến một lệnh gọi lại trong ứng dụng bằng cách sử dụng lược đồ tuỳ chỉnh hoặc URL loại HTTPS được xác minh bằng Digital Asset Links, giúp tăng cường bảo mật và giảm bớt mã nguyên mẫu triển khai.

Chia sẻ phiên và dự phòng Thẻ tuỳ chỉnh

Theo mặc định, Thẻ xác thực cũng chia sẻ cookie và trạng thái thông tin xác thực trực tiếp với trình duyệt Chrome của hệ thống. Việc chia sẻ này cho phép ứng dụng của bạn tận dụng các phiên đăng nhập đang hoạt động trong Chrome và chạy phương thức triển khai WebAuthn hiện có của bạn, bao gồm cả Giao diện người dùng có điều kiện và Chế độ giao diện người dùng tức thì (tương đương với preferImmediatelyAvailableCredentials của Trình quản lý thông tin xác thực trên web). Ngược lại, nếu trường hợp sử dụng của bạn yêu cầu một phiên xác thực riêng biệt không chia sẻ cookie hoặc nhật ký duyệt web với trình duyệt, thì bạn có thể bật tính năng duyệt web tạm thời bằng cách gọi AuthTabIntent.Builder.setEphemeralBrowsingEnabled(true).

Mặc dù bạn gói androidx.browser:browser (phiên bản 1.9.0 trở lên) với ứng dụng, nhưng việc Thẻ xác thực có chạy trong thời gian chạy hay không còn tuỳ thuộc vào trình duyệt mặc định của người dùng. Nếu trình duyệt mặc định là phiên bản Chrome thấp hơn 137 hoặc trình duyệt của bên thứ ba không hỗ trợ Thẻ xác thực, thì Thẻ xác thực sẽ tự động quay lại để chạy Thẻ tuỳ chỉnh tiêu chuẩn. Khi xảy ra trường hợp dự phòng này, lệnh chuyển hướng sau khi xác thực sẽ trả về thông qua một bộ lọc ý định trong AndroidManifest.xml như trong Thẻ tuỳ chỉnh tiêu chuẩn, thay vì thông qua lệnh gọi lại của Thẻ xác thực (ActivityResultCallback). Trong phiên bản chính thức, Google khuyên bạn nên kiểm tra trước khả năng hỗ trợ của trình duyệt mặc định bằng cách sử dụng CustomTabsClient.isAuthTabSupported(context, provider) để phân nhánh luồng hoặc giữ lại bộ lọc ý định trong tệp kê khai để ứng dụng có thể xử lý kết quả từ một trong hai đường dẫn. Để biết ví dụ cụ thể về cách triển khai dự phòng, hãy xem bài viết Trình trợ giúp trình duyệt Android.

Yêu cầu bảo mật đối với OAuth và OIDC

Thẻ xác thực chỉ bảo mật và đơn giản hoá kênh chuyển hướng phía máy khách từ trình duyệt trở lại ứng dụng của bạn; thẻ này không tự động bảo mật giao thức OAuth hoặc OIDC. Đặc biệt là khi có hành vi dự phòng của Thẻ tuỳ chỉnh, bạn phải tuân theo OAuth 2.0 cho ứng dụng gốc (RFC 8252). Cụ thể, hãy kết hợp PKCE (Khoá xác thực cho việc trao đổi mã, RFC 7636) bằng cách sử dụng các tham số code_challenge và code_verifier để ngăn chặn việc chặn mã uỷ quyền, xác thực tham số state để ngăn chặn hành vi giả mạo yêu cầu trên nhiều trang web (CSRF) và tấn công cố định phiên, đồng thời tạo và xác thực tham số nonce trong OpenID Connect để ngăn chặn các cuộc tấn công phát lại mã thông báo nhận dạng. Khi áp dụng các biện pháp bảo vệ này, Google khuyên bạn nên di chuyển cấu trúc đăng nhập dựa trên nền tảng web từ Thẻ tuỳ chỉnh tiêu chuẩn sang Thẻ xác thực.

WebView

Một số ứng dụng được xây dựng dựa trên cấu trúc WebView kết hợp, trong đó việc chỉ tách màn hình đăng nhập thành giao diện người dùng gốc (Trình quản lý thông tin xác thực) hoặc thẻ trình duyệt (Thẻ xác thực) là không thực tế. Trong những trường hợp đó, bạn có thể bật tính năng hỗ trợ WebAuthn ngay trong WebView.

Để sử dụng khoá truy cập trong WebView, hãy thêm cả thư viện AndroidX WebKit (androidx.webkit:webkit phiên bản 1.12.0 trở lên) và các phần phụ thuộc của Trình quản lý thông tin xác thực (androidx.credentials:credentials và androidx.credentials:credentials-play-services-auth) vào tệp build.gradle của bạn. Tiếp theo, hãy kiểm tra khả năng hỗ trợ tính năng bằng cách sử dụng WebViewFeature.isFeatureSupported(WebViewFeature.WEB_AUTHENTICATION) và bật rõ ràng tính năng hỗ trợ WebAuthn bằng cách gọi WebSettingsCompat.setWebAuthenticationSupport(webView.settings, WebSettingsCompat.WEB_AUTHENTICATION_SUPPORT_FOR_APP). Cấu hình này tự động kết nối các yêu cầu tạo và xác thực khoá truy cập từ các trang web trong WebView với Trình quản lý thông tin xác thực.

Các quy tắc ràng buộc về miền và trải nghiệm người dùng

Giống như khi tích hợp Trình quản lý thông tin xác thực gốc, bạn phải tuân theo Điều kiện tiên quyết để lưu trữ tệp Digital Asset Links (assetlinks.json) trên miền web của bên tin cậy để liên kết ứng dụng của bạn. Máy chủ của bạn nhận được android:apk-key-hash:ENCODED_SHA256_HASH (hàm băm chứng chỉ SHA-256 được mã hoá Base64URL) làm nguồn gốc. Vì phương pháp này yêu cầu lưu trữ assetlinks.json trên miền của bên Relying Party để tin tưởng chứng chỉ ký của ứng dụng Android, nên phương pháp này chỉ hoạt động khi bạn kiểm soát miền web của bên Relying Party (đăng nhập web của bên thứ nhất). Nếu quy trình xác thực của bạn chuyển hướng đến một IdP bên ngoài hoặc bên thứ ba, nơi bạn không thể lưu trữ assetlinks.json cho gói ứng dụng của mình, thì bạn phải sử dụng Thẻ xác thực (hoặc tính năng Đăng nhập bằng Google gốc thông qua Trình quản lý thông tin xác thực) thay vì WebView.

Hãy lưu ý đến hai hạn chế về chức năng và trải nghiệm người dùng: WebView không hỗ trợ Giao diện người dùng có điều kiện (tích hợp tính năng tự động điền mediation: "conditional" khi người dùng tập trung vào một trường nhập dữ liệu) và không chia sẻ cookie hoặc phiên đăng nhập với trình duyệt Chrome của hệ thống. Do những quy định ràng buộc này, Google khuyên bạn nên sử dụng Trình quản lý thông tin xác thực hoặc Thẻ xác thực khi thiết kế quy trình xác thực mới. Tuy nhiên, nếu muốn thêm tính năng hỗ trợ khoá truy cập vào một ứng dụng kết hợp hiện có của bên thứ nhất mà không cần thay đổi cấu trúc lớn, bạn có thể tích hợp khoá truy cập với WebView.

Tóm tắt

Bắt đầu từ giao diện người dùng và cơ sở hạ tầng xác thực hiện tại của ứng dụng sẽ giúp bạn chọn phương pháp khoá truy cập phù hợp:

  • Nếu ứng dụng của bạn có giao diện người dùng đăng nhập gốc và bạn muốn có trải nghiệm tích hợp với hệ điều hành mà không cần chuyển sang màn hình trình duyệt, hãy chọn Trình quản lý thông tin xác thực để đăng nhập bằng khoá truy cập.
  • Nếu bạn vận hành một dịch vụ vi mô IdP OAuth hoặc OIDC, chuyển hướng đến một IdP bên ngoài hoặc muốn sử dụng lại trang đăng nhập web hiện có hỗ trợ khoá truy cập (bao gồm cả Giao diện người dùng có điều kiện) và chia sẻ các phiên hoạt động của trình duyệt với Chrome, hãy sử dụng Thẻ xác thực và triển khai các yêu cầu bảo mật trong OAuth 2.0 cho ứng dụng gốc (RFC 8252) – cụ thể là PKCE, state và nonce.
  • Nếu ứng dụng của bạn được xây dựng trên cấu trúc WebView kết hợp, trong đó quy trình đăng nhập phải diễn ra trong màn hình web nhúng của bên thứ nhất, hãy sử dụng WebView trong khi tính đến việc thiếu tính năng hỗ trợ Giao diện người dùng có điều kiện và cookie tách biệt.

Các bước tiếp theo