Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ngxson/softu2f-fprintd-docker
Windows-Hello-like experience on Linux
https://github.com/ngxson/softu2f-fprintd-docker
fido2 fprintd libfprint u2f webauthn
Last synced: about 23 hours ago
JSON representation
Windows-Hello-like experience on Linux
- Host: GitHub
- URL: https://github.com/ngxson/softu2f-fprintd-docker
- Owner: ngxson
- License: gpl-3.0
- Created: 2023-08-18T15:30:00.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2023-08-18T15:30:03.000Z (about 1 year ago)
- Last Synced: 2024-04-24T03:25:26.191Z (5 months ago)
- Topics: fido2, fprintd, libfprint, u2f, webauthn
- Language: Shell
- Homepage:
- Size: 1.96 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# SoftU2F with fingerprint
This project aims to support U2F / FIDO2 using fingerprint reader on Linux (via libfprint). The goal is to have the same user experience with 2FA using Windows Hello.
This project is based on https://github.com/danstiner/rust-u2f with minor modification (see my fork: https://github.com/ngxson/rust-u2f-pkexec)
## Requirements
1. The command `fprintd-verify` works on your computer
2. Dbus (GNOME, KDE,...)
3. `uhid` support (verify using `ls -la /dev/uhid`)
4. Docker and docker compose installed
## Install
Make a new `docker-compose.yml` file:
```yml
version: '3'
services:
softu2f-fprintd:
image: ngxson/softu2f-fprintd-docker
container_name: softu2f-fprintd
network_mode: host # fix for "unix:abstract" dbus socket
restart: unless-stopped
environment:
- USER
- XDG_RUNTIME_DIR
- DBUS_SESSION_BUS_ADDRESS
- HOME=/data
volumes:
- softu2f-fprintd-volume:/data
- /run/user:/run/user
- /var/run/dbus:/var/run/dbus
- /var/lib/fprint/:/var/lib/fprint/:ro
devices:
- /dev/uhid
volumes:
softu2f-fprintd-volume:
```
Then, run it using:
```bash
docker compose up -d
```
⚠️ Do NOT run it using `sudo`. If you get permission denied, follow post-installation step of Docker: https://docs.docker.com/engine/install/linux-postinstall/
Finally, go to https://webauthn.io/ to test it out.