• About the Project
  • Tech Stack
  • Features
  • Environment Variables
• Getting Started
  • Prerequisites
  • Installation
  • Run Locally
• Usage
• Roadmap
• Contributing
  • Code of Conduct
• License
• Contact
• Acknowledgements

An example implementation of WebAuthn passkey authentication in a Spring Boot application.

• WebAuthn (passkey) authentication
• Magic link fallback authentication (work in progress)
• User dashboard

To run this project, you will need to add the following environment variables:

DATABASE_URL - JDBC-compatible database url e.g. jdbc:postgresql://localhost:5432/demodb

RELYINGPARTY_DISPLAY_NAME - The name that shows up on the client when registering/authenticating with WebAuthn, e.g. HelioAuth Demo

RELYINGPARTY_HOSTNAME - The origin (domain) where the application is hosted, e.g. demo.usepasskeys.dev

This project uses Java 22 and Maven

 git clone https://github.com/helioauth/passkeys-api-demo.git

Go to the project directory

 cd passkeys-api-demo

Install dependencies

 ./mvnw install

Start PostgreSQL server

 docker-compose up -d

Start the demo

 ./mvnw spring-boot:run

Contributions are always welcome!

Distributed under the MIT License. See LICENSE for more information.

HelioAuth: https://helioauth.com/

Project Link: https://github.com/helioauth/passkeys-api-demo

• java-webauthn-server by Yubico