linux-credentials /credentialsd
Proposal for a Linux credential management xdg portal D-Bus specification, including webauthn/passkey support
★ 303⑂ 22👁 22⑃ 174● 93▤ 6
+1
Daily
303
stars
22
forks
22
watchers
174
prs
93
issues
6
releases
README
credentialsd A Linux Credential Manager API. (Previously called linux-webauthn-platform-api.) Goals The primary goal of this project is to provide a spec and reference implementation of an API to mediate access to web credentials, initially local and remote FIDO2 authenticators. See GOALS.md for more information. How to install From packages We have [precompiled RPM packages for Fedora and openSUSE][obs-packages] hosted by the Open Build Service (OBS). We also copy these for released versions to the [release page][release-page]. There are several sub-packages: - credentialsd: The core credential service - credentialsd-ui: The reference implementation of the UI component for credentialsd. - credentialsd-webextension: Binaries and manifest files required for the Firefox add-on to function [obs-packages]: https://build.opensuse.org/package/show/home:MSirringhaus:webauthn_devel/credentialsd [release-page]: https://github.com/linux-credentials/credentialsd/releases From source Alternatively, you can build the project yourself using the instructions in BUILDING.md. How to use Right now, there are three ways to use this service. Experimental Browser Extension There is a browser extension that allows you to test credentialsd without a custom browser build. It overrides navigator.credentials.create() and navigator.credentials.get() to route WebAuthn requests through the credentialsd D-Bus service. Two browsers are supported from a single unified codebase: - Firefox 140+ — Install the XPI from the [releases page][release-page] for the corresponding version of credentialsd-webextension package that you installed. - Edge/Chromium (Chrome 111+, Edge 111+) — Load as an unpacked extension from webext/add-on/ using the Chromium manifest. See webext/README.md for setup instructions. Currently, the extension only works for https://webauthn.io and https://demo.yubico.com, but can be used to test various WebAuthn options and hardware. Experimental Firefox Build There is also an experimental Firefox build that contains a patch to interact with credentialsd directly without an add-on. You can access a [Flatpak package for it on OBS][firefox-patch-flatpak] as well. [firefox-patch-flatpak]: https://download.opensuse.org/repositories/home:/MSirringhaus:/webauthn_devel/openSUSE_Factory_flatpak/ Contributing We welcome contributions! See CONTRIBUTING.md for details. Join the discussion on Matrix at credentials-for-linux:matrix.org. Mockups Here are some mockups of what this would look like for a user: Internal platform authenticator flow (device PIN) ! ! ! Alternatively, lock out the credential based on incorrect attempts. ! ! Hybrid credential flow ! ! ! ! Security key flow ! ! ! ! Related projects: - https://github.com/linux-credentials/libwebauthn (previously https://github.com/AlfioEmanueleFresta/xdg-credentials-portal) - authenticator-rs - webauthn-rs Security Policy See SECURITY.md for our security po
Top issues
#26Design third-party password management12 comments · 2025-05-21#32Enumerate available transports9 comments · 2025-05-22#41Firefox integration7 comments · 2022-10-22#2Where does the desktop environment come into this?7 comments · 2024-02-22#184Support permissions model via entitlements4 comments · 2026-06-29#257Send device name to backend3 comments · 2026-11-09#131Allow configuration of trusted clients and callers3 comments · 2026-02-06#124Feature Request: Support pre-computed clientDataHash (parity with Android/iOS APIs)3 comments · 2026-01-28
Discussions
#200Design needs2 comments · 2026-07-29#193Some kind of changelog / to-dos / readiness indicator for normal users?2 comments · 2026-07-18#185Origin attestation from websites1 comments · 2026-07-03#118Biometrics Support?1 comments · 2026-01-04#98v0.1.01 comments · 2025-08-15#11Origin Checking0 comments · 2025-04-16
Latest release
v0.4.0 v0.4.0 Pre-release 2026-11-060.4.0 [2026-11-05] This release contains some bug fixes for hybrid handling and cancellation, as well as integrating better with systemd and D-Bus. Packagers can also now specify building individual parts of the project with build flags, and the default profile has been named to release to be more clear. Improvements - build: Make daemon, credentialsd-ui, demo client and web extension optional - build: Rename default profile to release. - daemon: Don't log error if we get PresenceRequired over hybrid (Thank you, @michaelbeaumont!) - daemon: Cancel ceremony if UI disappears (Tha