About Hanko
Hanko is an open-source user authentication system with a focus on moving the login beyond passwords, while being 100% deployable today – without compromise.
- Built around latest passkey technology as introduced by Apple, Google, and Microsoft
- An API for passkeys, email passcodes, and optional password support
- Hanko web component ("login box") that integrates with just 2 lines of code
- API-first, small footprint, cloud-native
- FIDO2-certified
Hanko is built and maintained by Hanko.io, an active member of the FIDO Alliance. This project is the sum of 5 years of experience implementing FIDO and WebAuthn-based authentication in many different applications and platforms.
Hanko-intro.mp4
We take you on the journey beyond passwords ...
... and make sure your users won't get lost on the way. Passwordless logins have been promised to us for quite some time. But until now, "passwordless" was mostly a compromise that only worked for some of the users and had some severe drawbacks that ultimately led to passwords still being present at almost every login. It's only very recently that passkeys were announced and the ecosystem of devices, browsers, and operating systems is finally ready to truly move beyond passwords.
With most devices now shipping with passkey support and biometric sensors like Touch ID, Face ID, and Windows Hello, a truly fascinating login experience is enabled that has the potential to replace passwords for good. Hanko is built for that shift.
Build your passkey login in just 5 minutes – with two lines of code – and never look back.
Roadmap
We are currently in Beta and may still have critical bugs. Watch our releases, leave a star, join our Slack community, or sign up to our product news to follow the development. Here's a brief overview of the current roadmap:
Status | Feature |
---|---|
✅ | Passkeys |
Email passcodes | |
✅ | Passwords |
✅ | JWT signing |
User management API | |
📢 Hanko Alpha Release | |
<hanko-auth> web component |
|
✅ | Customizable CSS |
📢 Hanko Beta Release | |
JavaScript frontend SDK | |
✅ | Passkey autofill (Conditional UI) |
Audit logs API | |
⚙️ | <hanko-profile> web component |
⚙️ | Sessions |
Rate limiting (application level) | |
Custom translations for hanko-elements | |
Email templating | |
OAuth plugin system (Sign in with Google/Apple/GitHub/...) | |
Support for native Android and iOS apps | |
2FA to secure fallback auth methods |
Additional features that have been requested or that we would like to build but are not (yet) on the roadmap:
- SMS passcode delivery
- SAML support
- OpenID Connect
Quickstart
The fastest way to try out Hanko is with docker-compose.
First you need to clone this repository:
git clone https://github.com/teamhanko/hanko.git
Then, in the newly created hanko
folder, just run:
docker compose -f deploy/docker-compose/quickstart.yaml -p "hanko-quickstart" up --build
Note: Docker (Desktop) needs to be running in order for the command to run.
After the services are up and running, the login page can be viewed at localhost:8888
. To receive emails without your own
smtp server, we added mailslurper which will be available at localhost:8080
.
Note: Hanko services are not published to a registry yet and will be built locally before the services are started.
Monorepo
The Hanko project consists of
- backend - An authentication API powering passkeys, passcodes, and passwords, as well as user management and JWT token issuing
- hanko-elements - A slick web component made for Hanko backend that features a polished onboarding and login experience and is highly customizable
- hanko-frontend-sdk - A client package for using the Hanko API
- quickstart - The quickstart example app, showing off Hanko's login experience and acting as a reference implementation
- examples - Hanko example implementations for a number of frameworks
- docs - The Hanko documentation
Community
Join our Slack community if you have any questions about Hanko or just want to chat about passkeys, authentication, identity, or life in general. You can also follow us on Twitter or just reach out via email.
Licenses
hanko-elements and hanko-frontend-sdk are licensed under the MIT License. Everything else in this repository, including hanko backend, is licensed under the AGPL-3.0.