AuthenticatorAttestationResponse

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.

* Some parts of this feature may have varying levels of support.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

Giao diện AuthenticatorAttestationResponse của Web Authentication API là kết quả của việc đăng ký thông tin xác thực WebAuthn. Nó chứa thông tin về thông tin xác thực mà máy chủ cần để thực hiện các phép xác nhận WebAuthn, chẳng hạn như mã định danh thông tin xác thực và khóa công khai của nó.

Một đối tượng AuthenticatorAttestationResponse có sẵn trong thuộc tính response của đối tượng PublicKeyCredential được trả về từ lệnh gọi CredentialsContainer.create() thành công.

Giao diện này kế thừa từ AuthenticatorResponse.

AuthenticatorResponse AuthenticatorAttestationResponse

Note: Giao diện này bị giới hạn trong các ngữ cảnh cấp cao nhất. Việc dùng các tính năng của nó bên trong phần tử <iframe> sẽ không có tác dụng.

Thuộc tính thực thể

Đồng thời kế thừa các thuộc tính từ giao diện cha của nó, AuthenticatorResponse.

AuthenticatorAttestationResponse.attestationObject Read only

Một ArrayBuffer chứa dữ liệu authenticator và một attestation statement cho cặp khóa mới do authenticator tạo ra.

AuthenticatorResponse.clientDataJSON Read only

Được kế thừa từ AuthenticatorResponse, thuộc tính này chứa biểu diễn tuần tự tương thích JSON của dữ liệu được truyền từ trình duyệt tới authenticator để tạo thông tin xác thực này, tức là khi CredentialsContainer.create() được gọi với tùy chọn publicKey. Dữ liệu này chứa một phần thông tin từ các tùy chọn được truyền vào lệnh gọi create(), và một phần thông tin do trình duyệt kiểm soát.

Phương thức thực thể

AuthenticatorAttestationResponse.getAuthenticatorData()

Trả về một ArrayBuffer chứa dữ liệu authenticator nằm trong thuộc tính AuthenticatorAttestationResponse.attestationObject.

AuthenticatorAttestationResponse.getPublicKey()

Trả về một ArrayBuffer chứa SubjectPublicKeyInfo dạng DER của thông tin xác thực mới (xem Subject Public Key Info), hoặc null nếu không có sẵn.

AuthenticatorAttestationResponse.getPublicKeyAlgorithm()

Trả về một số bằng với một COSE Algorithm Identifier, biểu thị thuật toán mật mã được dùng cho thông tin xác thực mới.

AuthenticatorAttestationResponse.getTransports()

Trả về một mảng chuỗi mô tả các phương thức truyền tải nào (ví dụ: usb, nfc) được cho là được authenticator hỗ trợ. Mảng có thể rỗng nếu thông tin này không có sẵn.

Ví dụ

Xem Creating a public key credential để có ví dụ chi tiết.

Thông số kỹ thuật

Specification
Web Authentication: An API for accessing Public Key Credentials - Level 3
# authenticatorattestationresponse

Khả năng tương thích với trình duyệt

Xem thêm