WebAuthn Attestation purpose and neccessity is incorrect
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 70/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- javascript
- Domain
- documentation, security
Research direction
Open files/en-us/web/api/web_authentication_api/attestation_and_assertion/index.md and locate the Attestation section. Read the linked WebAuthn specification references before assessing the proposed wording and its claims about attestation, multi-factor credentials, and credential backup. Done means the section accurately reflects the agreed WebAuthn guidance and retains appropriate supporting links.
Written by the indexing model from the issue text.
Description
MDN URL
https://developer.mozilla.org/en-US/docs/Web/API/Web_Authentication_API/Attestation_and_Assertion
What specific section or headline is this issue about?
Attestation
What information was incorrect, unhelpful, or incomplete?
(Emphasis added)
The purpose of attestation is to cryptographically prove that a newly generated key pair came from a specific device. This provides a root of trust for a newly generated key pair as well as being able to identify the attributes of a device being used (how the private key is protected; if / what kind of biometric is being used; whether a device has been certified; etc.). It should be noted that while attestation provides the capability for a root of trust, validating the root of trust is frequently not necessary.
What did you expect to see?
(Changes in bold)
The purpose of attestation is to cryptographically prove that a newly generated key pair came from a specific device model or batch. This provides a root of trust for a newly generated key pair as well as being able to identify the attributes of a device being used (the provenance of the device; how the private key is protected; if / what kind of biometric is being used; what PIN complexity requirements apply; whether a device has been certified; whether it has been recalled for security defects; etc.). Verifying a credential's attestation is necessary to prove it is a self-contained multi-factor credential.
Do you have any supporting links, references, or citations?
Without valid attestation, credentials cannot be proven to be multi-factor - they only prove "something you know" (a credential's private key).
A multi-device credential can be copied. The user verification bit on these credentials cannot be trusted.
A hardware authenticator that has known security defects can also not be trusted to protect its key material or enforce user verification restrictions.
A credential can only be trusted as a self-contained multi-factor credential by verifying the attestation at registration time, and periodically revalidating attestation (if that was revoked due to defects).
Do you have anything more you want to share?
No response
MDN metadata
Page report details
- Folder:
en-us/web/api/web_authentication_api/attestation_and_assertion - MDN URL: https://developer.mozilla.org/en-US/docs/Web/API/Web_Authentication_API/Attestation_and_Assertion
- GitHub URL: https://github.com/mdn/content/blob/main/files/en-us/web/api/web_authentication_api/attestation_and_assertion/index.md
- Last commit: https://github.com/mdn/content/commit/941ade970fd7ebad52af692b6ac27cfd96f94100
- Document last modified: 2025-05-28T14:25:52.000Z
- Dominant language
- Markdown
- Stars
- 11k
- Forks
- 23.3k
- Avg merge
- 1d 16h
- Merged PRs (30d)
- 311
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from mdn/content
-
Content:Learn:CSS good first issue
Difficulty 1/5 Under an hour Newbie friendliness 95/100
-
accepting PR Content:WebAPI
Difficulty 1/5 Under an hour Newbie friendliness 92/100
-
Content:WebExt
Difficulty 1/5 Under an hour Newbie friendliness 92/100
-
Content:HTML needs info
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
-
Content:WebExt needs triage
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
Similar issues
-
user-reported
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
Kong/developer.konghq.com#7316 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
HarperFast/skills#96 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
infinispan/infinispan#18150 ·
-
bug triage:deciding
Difficulty 1/5 Under an hour Newbie friendliness 88/100
open-telemetry/otel-arrow#4132 ·
-
Ecosystem: ClawMetry — the Qwen Code reader is now free and open source (follow-up to #9294 / #9338) Opencategory/integration priority/P3 scope/documentation status/ready-for-human type/feature-request
Difficulty 1/5 Under an hour Newbie friendliness 84/100