Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/teamhanko/hanko
Authentication and User Management solution for developers. Open source alternative to Clerk & Auth0.
https://github.com/teamhanko/hanko
2fa authentication ciam fido2 jwt oauth passkeys passwordless saml sign-in-with-apple sign-in-with-google sso user-management webauthn
Last synced: 5 days ago
JSON representation
Authentication and User Management solution for developers. Open source alternative to Clerk & Auth0.
- Host: GitHub
- URL: https://github.com/teamhanko/hanko
- Owner: teamhanko
- License: other
- Created: 2022-03-14T17:03:46.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-11-29T16:13:44.000Z (13 days ago)
- Last Synced: 2024-11-30T18:55:53.150Z (12 days ago)
- Topics: 2fa, authentication, ciam, fido2, jwt, oauth, passkeys, passwordless, saml, sign-in-with-apple, sign-in-with-google, sso, user-management, webauthn
- Language: Go
- Homepage: https://hanko.io
- Size: 41.1 MB
- Stars: 7,325
- Watchers: 37
- Forks: 939
- Open Issues: 73
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-hacktoberfest - Hanko
- awesome-repositories - teamhanko/hanko - Authentication and User Management solution for developers. Open source alternative to Clerk & Auth0. (Go)
README
---
[](https://github.com/teamhanko/hanko/actions/workflows/codeql-analysis.yml)
[](https://github.com/teamhanko/hanko/actions/workflows/go.yml)
[](https://goreportcard.com/report/github.com/teamhanko/hanko)
[](https://godoc.org/github.com/teamhanko/hanko)
[](https://www.npmjs.com/package/@teamhanko/hanko-elements)
[](https://www.npmjs.com/package/@teamhanko/hanko-frontend-sdk)
# About Hanko
Hanko is an open-source authentication and user management solution with a focus on moving the login beyond passwords while being 100% deployable today.
- Supports all modern authentication methods, incl. [passkeys](https://www.passkeys.io), social logins, and SAML SSO
- Highly flexible configuration options (e.g. optional/user-deletable passwords, passkey-only, OAuth-only)
- Fast integration with Hanko Elements web components (embeddable components for login/registration and account profile)
- API-first, small footprint, cloud-native
Available for self-hosting and on [Hanko Cloud](https://www.hanko.io).
# Features
To follow the development of this project, watch our releases, leave a star, sign up to our [Product News](https://www.hanko.io/updates) or join our [Discord Community](https://www.hanko.io/community). Here's a brief overview of Hanko's current and upcoming features:
| Status | Feature |
|:------:| :--- |
|✅| Email / username identifiers |
|✅| Passwords, passcodes, passkeys |
|✅| Hanko Elements web components |
|✅| OAuth SSO (Sign in with Apple/Google/GitHub etc.) |
|✅| i18n & custom translations |
|✅| SAML Enterprise SSO |
|✅| Webhooks |
|✅| Server-side sessions & remote session revocation |
|✅| MFA (TOTP, security keys) |
|⚙️| Custom Social SSO connections (OIDC/OAuth2) |
|⚙️| Privileged sessions & step-up authentication |
| | User impersonation |
| | Improved email templates & i18n |
| | `` web component |
| | Email security notifications |
| | Refresh tokens |
| | Custom user metadata / JWT claims |
| | iOS, Android, React Native, Flutter SDKs |
Visit our [Roadmap](https://www.hanko.io/roadmap) for more information.
# Contact us
Schedule a Hanko demo. Learn how Hanko will speed up your registration and login flows with passkeys.
# Architecture
The main building blocks of the Hanko project are
- [backend](/backend/README.md) - An authentication API for passkeys, passcodes, and (optional) passwords, OAuth SSO, as well as user management and JWT issuing
- [hanko-elements](/frontend/elements/README.md) - Web components made for Hanko backend that provide onboarding and login functionality and are customizable with CSS
- [hanko-frontend-sdk](/frontend/frontend-sdk/README.md) - A client package for using the Hanko API
The remainder of the repository consists of:
- [quickstart](/quickstart) - A quickstart example app showing off Hanko's login experience and acting as a reference implementation
- [examples](frontend/examples) - Example implementations for a number of frameworks
- docs - The Hanko documentation ([docs.hanko.io](https://docs.hanko.io)) -> Moved to its own repo here: https://github.com/teamhanko/docs
# Getting started
1. Try our hosted [live example](https://example.hanko.io) and our companion page [passkeys.io](https://www.passkeys.io) or use the [quickstart app](/quickstart/README.md) to get a feel for the user experience provided by an application that leverages the Hanko backend API and our custom web component
2. To run the project locally, there are two options available:
- Bare metal:
- Head over to the [backend](/backend/README.md) section to learn how to get it up and running for your own project. Use [Hanko Cloud](https://cloud.hanko.io) for a hosted backend.
- Docker:
- If you prefer to use [Docker](https://www.docker.com/) to run the project locally, please visit the [Run the quickstart](./quickstart/README.md#run-the-quickstart) for information on how to run the project. This will create everything, including frontend and backend components.
- If you wish to keep only the backend components, you can modify the [quickstart.yaml](./deploy/docker-compose/quickstart.yaml) to remove the unnecessary services. To make changes to the configuration to meet your needs, modify [config.yaml](./deploy/docker-compose/config.yaml).
3. Then, integrate [hanko-elements](/frontend/elements/README.md) – we provide [example applications](frontend/examples/README.md) and [guides](https://docs.hanko.io/guides/frontend) for your favourite frontend framework in the official documentation
4. if you have an [enterprise license](/backend/ee) or use [Hanko Cloud](https://cloud.hanko.io) you can also integrate [SAML SSO](/docs). Feel free to use [this guide](https://docs.hanko.io/guides/frontend) to start with SAML SSO
If you want to use the Hanko backend API but prefer to build your own UI, you can still make use of the [hanko-frontend-sdk](/frontend/frontend-sdk/README.md). It forms the basis of our web components, and the client it provides handles communication with the [Hanko backend API](https://docs.hanko.io/api-reference/introduction) and saves you the time of rolling your own.
# Community
## Questions, bugs, ideas
If you have any questions or issues, please check this project's [Q&A section in discussions](https://github.com/teamhanko/hanko/discussions/categories/q-a) and the [open issues](https://github.com/teamhanko/hanko/issues). Feel free to comment on existing issues or create a new issue if you encounter any bugs or have a feature request. For yet unanswered questions, feedback, or new ideas, please open a new discussion.
## Discord community & X
We invite you to join our growing [Discord Community](https://www.hanko.io/community) if you want to get the latest updates on passkeys, WebAuthn, and this project or if you just want to chat with us. You can also [follow us on X](https://x.com/hanko_io).
# Licenses
[hanko-elements](frontend/elements) and [hanko-frontend-sdk](frontend/frontend-sdk) are licensed under the [MIT License](frontend/elements/LICENSE). Everything else in this repository, including [hanko backend](backend), is licensed under the [AGPL-3.0](/LICENSE).