linux-credentials /credentialsd

Proposal for a Linux credential management xdg portal D-Bus specification, including webauthn/passkey support

★ 303⑂ 22👁 22⑃ 174● 93▤ 6
RustLGPL-3.0Created 2023-06-20
Download: v0.4.0v0.4.0 ↓0.4.02026-11-06
+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

Discussions

Latest release

v0.4.0 v0.4.0 Pre-release 2026-11-06
0.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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON