Skip to content

docs: add wallet attestation and verifier identity trust guides#54

Open
leifj wants to merge 1 commit into
mainfrom
docs/trust-identity-attestation
Open

docs: add wallet attestation and verifier identity trust guides#54
leifj wants to merge 1 commit into
mainfrom
docs/trust-identity-attestation

Conversation

@leifj

@leifj leifj commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

Adds two new pages to the Trust section of developers.siros.org:

Wallet Attestation (sirosid/trust/wallet-attestation.md)

  • OAuth 2.0 Attestation-Based Client Authentication (draft-ietf-oauth-attestation-based-client-auth)
  • WIA (Wallet Instance Attestation) vs Key Attestation PoP — claims, purpose, wire format
  • PDP trust delegation architecture
  • Go-Trust registry configuration (oidfed + whitelist)
  • Security model: PKCE + DPoP + PDP
  • Comparison with static client registration

Verifier Identity (sirosid/trust/verifier-identity.md)

  • Client ID schemes: x509_san_dns (default) and did (did:web)
  • DID Document auto-generation at /.well-known/did.json
  • OpenID Federation entity configuration at /.well-known/openid-federation
  • How wallets evaluate verifier trust (flowchart)

Context

These docs cover the features implemented in SUNET/vc PRs #514 (federation), #515 (DID identity), and #516 (wallet attestation).

New documentation for trust & identity in the SIROS ID ecosystem:

- docs/sirosid/trust/wallet-attestation.md: How wallets authenticate
  to issuers using OAuth 2.0 Attestation-Based Client Authentication
  (WIA + Key Attestation PoP), with PDP trust delegation

- docs/sirosid/trust/verifier-identity.md: How verifiers identify
  themselves to wallets (x509_san_dns, did:web) and participate in
  OpenID Federation for trust chain resolution

Covers:
- WIA vs Key Attestation distinction and wire format
- Spec references (draft-ietf-oauth-attestation-based-client-auth,
  OID4VCI §6, RFC 9126, RFC 9449)
- Go-Trust PDP configuration (oidfed + whitelist registries)
- Verifier client_id_scheme configuration
- Federation entity configuration endpoint
- Security model (PKCE + DPoP + PDP)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant