HelioAuth Demo

A passwordless authentication solution for modern web applications

View Demo · Documentation · Report Bug · Request Feature

📔 Table of Contents

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

🌟 About the Project

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

👾 Tech Stack

Server

• Java
• Spring Boot
• Spring Security

Database

• PostgreSQL

DevOps

• Docker
• Kubernetes

🎯 Features

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

🔑 Environment Variables

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

🧰 Getting Started

‼️ Prerequisites

This project uses Java 22 and Maven

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

🏃 Run Locally

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

👋 Contributing

Contributions are always welcome!

⚠️ License

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

🤝 Contact

HelioAuth: https://helioauth.com/

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

💎 Acknowledgements

• java-webauthn-server by Yubico