Feature Request: Support pre-computed clientDataHash (parity with Android/iOS APIs)
Les mainteneurs répondent en général sous 2 jours
Personne n'a encore pris cette issue.
Évaluation
- Difficulté
- 4/5
- Temps estimé
- 3-5 jours
- Accessibilité débutants
- 45/100
Piste de recherche
Commencez par la définition de l’interface D-Bus dans xyz.iinuwa.credentials.xml et l’analyse des requêtes dans credentialsd. Examinez ensuite les fonctions register() et sign() de libwebauthn afin de déterminer si elles acceptent un hash des données client. Le travail est considéré comme terminé lorsqu’une forme d’API compatible a été choisie et implémentée, que le hash est correctement transmis, que le comportement JSON existant est préservé et que les deux chemins sont couverts par des tests.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
Summary
Add support for accepting a pre-computed clientDataHash (SHA-256) as an alternative to clientDataJSON in the D-Bus API. This aligns with Android and iOS platform APIs, and enables a wider range of WebAuthn integration scenarios.
Background
The CTAP2 specification defines that authenticator operations (authenticatorMakeCredential and authenticatorGetAssertion) accept a hash of the client data, not the raw JSON:
hash (0x01): Hash of the serialized client data, provided by the client.
Reference: FIDO CTAP2 Specification §6.1
While browser-based WebAuthn flows typically construct clientDataJSON locally, there are several scenarios where the caller may already have the hash:
- Cross-device authentication (CTAP2 Hybrid/caBLE) - The initiating device may provide the hash directly
- Native application integrations - Apps may negotiate client data with their backend
- Remote desktop/VDI scenarios - The remote server constructs clientData and transmits only the hash
- Proxy/relay architectures - Intermediate systems may only forward the hash
Prior Art - Platform API Parity
Both Android and iOS platform APIs support this pattern:
Android (Credential Manager API)
val request = GetPublicKeyCredentialOption(
requestJson = "...",
clientDataHash = clientDataHashBytes // Optional pre-computed hash
)
Reference: Android Credential Manager Documentation
iOS (ASAuthorizationPublicKeyCredentialProvider)
let request = provider.createCredentialAssertionRequest(challenge: challenge)
request.clientDataHash = clientDataHash // Supports pre-computed hash
Reference: Apple Developer Documentation
Adding this support to credentialsd would bring Linux to feature parity with these platforms.
Proposed API Change
Add an optional client_data_hash parameter to the D-Bus methods:
Option A: New optional parameter (backward compatible)
<method name="MakeCredential">
<arg name="request_json" type="s" direction="in"/>
<arg name="client_data_hash" type="ay" direction="in"/> <!-- NEW: optional 32-byte SHA-256 -->
<arg name="response" type="a{sv}" direction="out"/>
</method>
Behavior:
- If
client_data_hashis provided (non-empty), use it directly - If
client_data_hashis empty, compute hash fromrequest_json.clientDataJSON(current behavior)
Option B: Separate methods
<method name="MakeCredentialWithHash">
<arg name="request_json" type="s" direction="in"/>
<arg name="client_data_hash" type="ay" direction="in"/>
<arg name="response" type="a{sv}" direction="out"/>
</method>
Use Case
This feature enables various integration scenarios where the caller has a pre-computed hash rather than raw JSON:
- Cross-device flows where another device initiated the WebAuthn ceremony
- Native applications with custom client data handling
- Remote desktop environments where authentication is redirected to the local machine
- Enterprise SSO integrations with proxy architectures
The key benefit is flexibility - allowing callers to provide either the raw JSON (current behavior) or a pre-computed hash when that's what they have available.
Security Considerations
This change maintains the same security model:
- The authenticator still requires user interaction (touch/PIN)
- The UI still displays the relying party information
- The cryptographic signature is still bound to the hash
The only difference is who computes the hash - the caller vs the credential service.
Implementation Notes
Looking at libwebauthn, the underlying register() and sign() functions may already work with the hash internally. The change would primarily be in:
- D-Bus interface definition (
xyz.iinuwa.credentials.xml) - Request parsing in
credentialsd - Passing the hash through to libwebauthn
Related
- W3C WebAuthn Level 3 §5.8.1 - client data hash computation
- FIDO CTAP2 Specification - authenticator protocol
- Android and iOS platform APIs (referenced above)
Questions
- Would you prefer Option A (optional parameter) or Option B (new method)?
- Are there any security considerations I might have missed?
- Is this something you're planning to implement, or would you be open to accepting a community contribution? I'd be happy to work on a PR if that would be helpful.
Thank you for considering this feature request!
- Langage dominant
- Rust
- Étoiles
- 310
- Forks
- 22
- Merge moyen
- 1 j 15 h
- PR mergées (30 j)
- 13
Préparer son environnement
- Aucun Dockerfile ni fichier Docker Compose
- Aucun modèle de pull request
- Lire le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de linux-credentials/credentialsd
-
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
linux-credentials/credentialsd#277 ·
Les mainteneurs répondent en général sous 2 jours
-
Update screenshotsOuvertedocumentation good first issue help wanted
Difficulté 2/5 Une demi-journée Accessibilité débutants 62/100
linux-credentials/credentialsd#87 · 2 commentaires ·
Les mainteneurs répondent en général sous 2 jours
-
`check_origin_from_privileged_client` drops browser signalling intermediate cross-origin iframesOuverte
Difficulté 3/5 1-2 jours Accessibilité débutants 57/100
linux-credentials/credentialsd#276 ·
Les mainteneurs répondent en général sous 2 jours
-
Difficulté 3/5 1-2 jours Accessibilité débutants 52/100
linux-credentials/credentialsd#275 · 3 commentaires ·
Les mainteneurs répondent en général sous 2 jours
-
Cancel request when client disconnectsPeut-être pris @kpanuragh l’a pris aujourd’hui. Ouverte
Difficulté 4/5 3-5 jours Accessibilité débutants 48/100
linux-credentials/credentialsd#274 ·
Les mainteneurs répondent en général sous 2 jours
Toutes les issues de linux-credentials/credentialsd
Issues similaires
-
Difficulté 2/5 1-3 heures Accessibilité débutants 65/100
-
needs triage
Difficulté 2/5 1-3 heures Accessibilité débutants 76/100
pbakaus/impeccable#1620 ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 1-3 heures Accessibilité débutants 78/100
swc-project/swc-next-issues#533 ·
-
bug
Difficulté 2/5 1-3 heures Accessibilité débutants 77/100
nautechsystems/nautilus_trader#5718 ·
Les mainteneurs répondent en général sous 1 jour
-
`luvus --remote` cannot start on a host whose login shell is NushellPeut-être pris @schlich l’a pris aujourd’hui. Ouvertestatus: needs triage
Difficulté 2/5 1-3 heures Accessibilité débutants 78/100
Les mainteneurs répondent en général sous 4 jours