Skip to content

docs: add EdDSA/Ed25519 to allowed WebAuthn signature schemes#6239

Closed
sea-snake wants to merge 2 commits into
dfinity:masterfrom
sea-snake:sea-snake/spec-ed25519-webauthn
Closed

docs: add EdDSA/Ed25519 to allowed WebAuthn signature schemes#6239
sea-snake wants to merge 2 commits into
dfinity:masterfrom
sea-snake:sea-snake/spec-ed25519-webauthn

Conversation

@sea-snake
Copy link
Copy Markdown
Contributor

Summary

Update the IC interface specification to allow EdDSA on curve Ed25519 as a third WebAuthn signature scheme (alongside ECDSA P-256 and RSA PKCS#1v1.5), mirroring the implementation change in dfinity/ic#10081.

Changes

  • docs/references/ic-interface-spec.md §Web Authentication: add EdDSA on curve Ed25519 to the allowed-schemes list; clarify the signature encoding note to call out that Ed25519 WebAuthn signatures are the raw 64-byte R || s concatenation from RFC 8032 §5.1.6 (not DER-wrapped, which only applies to ECDSA).
  • docs/references/_attachments/interface-spec-changelog.md: new entry. The version number (0.61.0) is a placeholder — happy to adjust to whatever the maintainers prefer.

Context

Was triggered by the implementation work in dfinity/ic#10081 to accept Ed25519 WebAuthn keys (e.g. NitroKey 3A authenticators emit kty=OKP / alg=EdDSA / crv=Ed25519). Reviewer @eichhorl asked whether there's a corresponding spec PR — this is it.

The COSE parser and validator are being extended in dfinity/ic#10081 to
accept Ed25519 WebAuthn keys (COSE kty=OKP, alg=EdDSA, crv=Ed25519),
matching authenticators such as the NitroKey 3A. Update the interface
specification to mirror that: list EdDSA on Ed25519 as a third allowed
WebAuthn signature scheme, and clarify that EdDSA WebAuthn signatures
use the raw 64-byte R || s encoding from RFC 8032 §5.1.6 rather than
DER (which only applies to ECDSA).

Refs: dfinity/internet-identity#3835
@sea-snake sea-snake requested review from a team as code owners May 11, 2026 14:36
@github-actions github-actions Bot added the interface-spec Changes to the IC Interface Specification label May 11, 2026
@mraszyk
Copy link
Copy Markdown
Contributor

mraszyk commented May 13, 2026

Moved to dfinity/developer-docs: dfinity/developer-docs#250

@mraszyk mraszyk closed this May 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

interface-spec Changes to the IC Interface Specification

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants