Khi người dùng tạo khoá truy cập, máy chủ của bên Relying Party sẽ lưu một số thông tin chi tiết, trong khi trình cung cấp thông tin xác thực (chẳng hạn như Trình quản lý mật khẩu của Google) sẽ lưu các thông tin khác. Cụ thể:
- Máy chủ của bên Relying Party sẽ lưu thông tin xác thực khoá công khai.
- Nhà cung cấp thông tin xác thực lưu tên người dùng, tên hiển thị, khoá riêng tư và siêu dữ liệu liên quan khác. Siêu dữ liệu này giúp người dùng xác định và chọn khoá truy cập cần thiết trong quá trình đăng nhập.
Sự không nhất quán tiềm ẩn giữa dữ liệu được lưu trên máy chủ của bên Relying Party và nhà cung cấp thông tin xác thực có thể dẫn đến trải nghiệm người dùng không tốt. Vấn đề có thể phát sinh trong các trường hợp sau:
- Thông tin xác thực bị xoá trên máy chủ của bên Relying Party nhưng không bị xoá trên nhà cung cấp thông tin xác thực, dẫn đến việc nhà cung cấp thông tin xác thực hiển thị thông tin xác thực đã xoá cho người dùng.
- Tên người dùng hoặc tên hiển thị được cập nhật trên máy chủ của bên Relying Party nhưng không được cập nhật trên nhà cung cấp thông tin xác thực, dẫn đến việc nhà cung cấp thông tin xác thực hiển thị thông tin chi tiết đã lỗi thời.
Signal API của Trình quản lý thông tin xác thực cho phép bên Relying Party giao tiếp với nhà cung cấp thông tin xác thực để xoá thông tin xác thực và cập nhật siêu dữ liệu của người dùng, chẳng hạn như tên người dùng và tên hiển thị. Có 3 loại yêu cầu được hỗ trợ cho các trường hợp khác nhau:
SignalUnknownCredentialRequest- Cho biết rằng một thông tin xác thực cụ thể không còn hợp lệ và cần được ẩn hoặc xoá khỏi trình cung cấp thông tin xác thực.
SignalAllAcceptedCredentialIdsRequest- Cung cấp danh sách mã thông tin xác thực được chấp nhận cho trình cung cấp thông tin xác thực.
SignalCurrentUserDetailsRequest- Cập nhật thông tin chi tiết về siêu dữ liệu của người dùng.
Khả năng tương thích của phiên bản
Signal API có trên các thiết bị chạy Android 15 trở lên và có từ phiên bản 1.6.0-beta03 của thư viện androidx.credentials.
Triển khai
Để sử dụng Signal API, hãy làm theo các bước sau:
Thêm phần phụ thuộc Trình quản lý thông tin xác thực vào dự án của bạn.
Kotlin
dependencies { implementation("androidx.credentials:credentials:1.7.0-alpha02") }
Groovy
dependencies { implementation "androidx.credentials:credentials:1.7.0-alpha02" }
Gọi Signal API
Để gửi yêu cầu tín hiệu đến trình cung cấp thông tin xác thực, hãy sử dụng yêu cầu tín hiệu được hỗ trợ. Mỗi loại yêu cầu tín hiệu đều cần có một yêu cầu JSON, như trong các ví dụ sau:
Thông tin xác thực không xác định (
SignalUnknownCredentialRequest)Sử dụng
SignalUnknownCredentialRequestđể báo hiệu rằng bên tin cậy không nhận dạng được mã thông tin xác thực. Khi nhận được tín hiệu này, trình cung cấp thông tin xác thực sẽ ẩn hoặc xoá thông tin xác thực.Tác dụng
Chỉ gửi tín hiệu này sau khi xác định rằng bên Relying Party không nhận dạng được mã thông tin xác thực, chẳng hạn như khi thông tin xác thực đã bị xoá khỏi máy chủ. Các lỗi xác minh xác nhận khoá truy cập khác, chẳng hạn như thử thách đã hết hạn hoặc lỗi chữ ký, không phải là lý do chính đáng để gửi tín hiệu này. Việc gửi tín hiệu này cho một mã thông tin xác thực được nhận dạng có thể khiến nhà cung cấp thông tin xác thực ẩn hoặc xoá thông tin xác thực hợp lệ.
Các tham số JSON bắt buộc cho yêu cầu này là
rpIdvàcredentialId. Để biết thêm thông tin về cấu trúc JSON, hãy xem phần tuỳ chọn signalUnknownCredential.credentialManager.signalCredentialState( SignalUnknownCredentialRequest( requestJson = JSONObject().apply { put("rpId", rpId /* [String] RP ID of the relying party */) put("credentialId", credentialId /* [String] Credential ID of the credential to be hidden or deleted */) }.toString() ) )Tất cả thông tin xác thực được chấp nhận (
SignalAllAcceptedCredentialIdsRequest)Sử dụng
SignalAllAcceptedCredentialIdsRequestđể thông báo cho nhà cung cấp thông tin xác thực về tập hợp tất cả thông tin xác thực được chấp nhận. Sau khi nhận được tín hiệu, trình cung cấp thông tin xác thực sẽ ẩn hoặc xoá mọi thông tin xác thực không có trong danh sách này, hoặc hiện mọi thông tin xác thực đã ẩn trước đó mà hiện có trong danh sách.Tác dụng
Sử dụng tín hiệu này khi bên xác thực không xác minh được khoá truy cập. Lỗi này có nghĩa là khoá truy cập không hợp lệ và phải bị nhà cung cấp thông tin xác thực ẩn hoặc xoá. Bạn cũng có thể sử dụng tín hiệu này bất cứ khi nào cần truyền phát tập hợp mã thông tin xác thực đã biết đến các nhà cung cấp thông tin xác thực.
Các tham số JSON bắt buộc cho yêu cầu này là
rpId,userIdvàallAcceptedCredentialIds. Để biết thêm thông tin về cấu trúc JSON, hãy xem phần các tuỳ chọn signalAllAcceptedCredential.credentialManager.signalCredentialState( SignalAllAcceptedCredentialIdsRequest( requestJson = JSONObject().apply { put("rpId", rpId /* [String] RP ID of the relying party */) put("userId", userId /* [String] User ID of the current user */) put( "allAcceptedCredentialIds", JSONArray(credentialIdsList /* [List<String>] List of accepted Credential IDs */) ) }.toString() ) )Thông tin chi tiết về người dùng hiện tại (
SignalCurrentUserDetailsRequest)Sử dụng
SignalCurrentUserDetailsRequestđể thông báo cho nhà cung cấp thông tin xác thực rằng siêu dữ liệu (chẳng hạn như tên người dùng và tên hiển thị của một người dùng nhất định) đã được cập nhật và sẽ xuất hiện trong nhà cung cấp thông tin xác thực.Tác dụng
Sử dụng tín hiệu này khi người dùng hoặc bên Relying Party cập nhật siêu dữ liệu khoá truy cập liên kết với tài khoản người dùng.
Các tham số JSON bắt buộc cho yêu cầu này là
rpId,userId,namevàdisplayName. Để biết thêm thông tin về cấu trúc JSON, hãy xem phần tuỳ chọn signalCurrentUserDetails.credentialManager.signalCredentialState( SignalCurrentUserDetailsRequest( requestJson = JSONObject().apply { put("rpId", rpId /* [String] RP ID of the relying party */) put("userId", userId /* [String] User ID of the current user */) put("name", name /* [String] New Name to be updated for the current user */) put("displayName", displayName /* [String] New display name to be updated for the current user */) }.toString() ) )
Kiểm thử quá trình triển khai
Để kiểm tra việc triển khai API Tín hiệu, hãy hoàn tất các bước sau:
Cài đặt mẫu trình cung cấp thông tin xác thực có tên là MyVault.
Bật MyVault làm trình cung cấp thông tin xác thực trong phần Cài đặt > Mật khẩu, khoá truy cập và tài khoản > Dịch vụ ưu tiên.
Bật tất cả thông báo cho MyVault trong phần Cài đặt > Ứng dụng > MyVault > Thông báo.
Xác minh rằng chế độ Pop on screen (Hiện trên màn hình) đang bật cho thông báo trong phần Settings (Cài đặt) > Apps (Ứng dụng) > MyVault > Notifications (Thông báo) > Categories (Danh mục) > Signal API Notification Channel (Kênh thông báo API tín hiệu).
Trong ứng dụng, hãy kích hoạt các luồng gửi yêu cầu tín hiệu đến nhà cung cấp thông tin xác thực. Bạn sẽ thấy thông báo từ MyVault trên màn hình. Thao tác này xác minh rằng nhà cung cấp thông tin xác thực đã nhận được yêu cầu.