Aller au contenu
Se connecter

Hanko

Conteneur LXC DevScripts backend/v3.1.0

Script en développement. À essayer sur une machine de test seulement.
Script en développement : le projet demande de ne pas l'utiliser en production.

Accès par défaut

Adresse
http://ADRESSE-IP:8000Remplacez ADRESSE-IP par l'adresse donnée à la fin de l'installation.
Compte et mot de passe
Aucun identifiant fixe publié par la source : voir ci-dessous.
Console et SSH
Console du conteneur dans l'interface Proxmox : compte root, connexion automatique sans mot de passe. Le SSH de root n'est ouvert que si vous l'avez demandé à l'installation.
Configuration
/opt/hanko_data/config.yaml
  • Hanko is a headless authentication API, not a web app. Port 8000 is the public API that your own application's login talks to through Hanko Elements or the SDKs; opened in a browser it only shows an API status page. The self-hosted backend has no admin UI, the Hanko Console is part of the closed-source Hanko Cloud.
  • Before an app can use Hanko, replace the example.com placeholders in /opt/hanko_data/config.yaml: webauthn.relying_party.id is your domain, webauthn.relying_party.origins and cors.allow_origins the https:// URL of the app that embeds the login. Then run systemctl restart hanko. Hanko 3 reads the top-level cors key and ignores the server.public.cors of older upstream examples.
  • Sign-up, email verification and passcode login send emails. Set email_delivery (from_address and the smtp host, port, user and password) in /opt/hanko_data/config.yaml to your mail server; until then these flows fail. Users created through the admin API with a password can still sign in.

Hanko is an open-source authentication and user management backend, an alternative to Auth0 or Clerk. It provides passkeys, passwords, email passcodes, TOTP and security-key MFA, OAuth/OIDC and SAML single sign-on, sessions and JWTs, and web apps add the login through the Hanko Elements web components or SDKs. This script runs the Hanko backend (public and admin API) with PostgreSQL.

Site ↗ Documentation ↗ Dépôt de l'application ↗ Voir le code du script ↗

Installer

Cœurs
1
Mémoire
512 Mo
Disque
4 Go
Système
Debian 13
bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/DevScripts/main/ct/hanko.sh)"

Configuration : /opt/hanko_data/config.yaml

Dans le shell du nœud Proxmox. Exécutez cette commande dans le shell du nœud Proxmox, pas dans une VM. Lisez le script d'abord.

Générateur : préparer la commande avec vos réglages

Remplissez seulement ce que vous voulez changer. Les valeurs vides gardent le réglage par défaut du script.

Tutoriel pas à pas

De l'interface de Proxmox jusqu'à la première connexion, pour Hanko.

  1. Ouvrez l'interface de Proxmox dans votre navigateur et connectez-vous.

  2. Dans l'arbre de gauche, cliquez sur votre nœud, puis sur « Shell ».

  3. Vérifiez que le nœud a la place pour ce conteneur : 1 cœur, 512 Mo de mémoire, 4 Go de disque.

  4. Copiez cette commande, collez-la dans le shell et appuyez sur Entrée.

    bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/DevScripts/main/ct/hanko.sh)"

  5. À la question « Use Default Settings? », répondez oui pour garder les réglages par défaut. Répondez non pour choisir vous-même l'identifiant, l'adresse, le disque ou le réseau.

  6. Attendez la fin de l'installation : le script affiche l'adresse du conteneur.

  7. Ouvrez http://ADRESSE-IP:8000 dans votre navigateur, en remplaçant ADRESSE-IP par l'adresse affichée.

  8. Pour entrer dans le conteneur : sélectionnez-le dans Proxmox, puis « Console ». La session root s'ouvre sans mot de passe.

  9. Pour mettre à jour plus tard : tapez update dans la console du conteneur.

  10. Le fichier de configuration se trouve ici : /opt/hanko_data/config.yaml

À savoir

  • Passkeys only work over HTTPS on a domain name: browsers refuse WebAuthn on an IP address, and the session cookie is marked Secure. Publish port 8000 through a TLS reverse proxy (e.g. https://auth.example.com) instead of using http://<IP>:8000 directly.
  • The admin API (users, sessions, webhooks) has no authentication of its own, so it only listens on 127.0.0.1:8001, e.g. curl http://127.0.0.1:8001/users inside the container. Change server.admin.address only behind a firewall or an authenticating proxy: anyone who reaches it can create sessions for any user.
  • Back up secret_keys from /opt/hanko_data/config.yaml together with the database. It encrypts the JWT signing key stored in PostgreSQL, and without it Hanko can no longer issue session tokens.

Notes de la version backend/v3.1.0

Hanko v3.1 introduces Organizations and Roles for building B2B applications, alongside Custom Claims and Mapping for bringing identity provider attributes into your application. This release also adds session lifecycle webhooks, improves user imports, and includes several security fixes.

Organizations and Roles

You can now group users into organizations within a Hanko tenant and assign roles to their memberships. This gives applications a foundation for managing customer accoun…

Dans la même catégorie

2FAuth

Conteneur LXC

2FAuth is a web based self-hosted alternative to One Time Passcode (OTP) generators like Google Authenticator, designed for both mobile and desktop. It aims to ease you …

Mise à jour Port 80

Authelia

Conteneur LXC

Authelia is an open-source authentication and authorization server and portal fulfilling the identity and access management (IAM) role of information security in providi…

Mise à jour Port 443 Accès par défaut

BunkerWeb

Conteneur LXC

BunkerWeb is a security-focused web server that enhances web application protection. It guards against common web vulnerabilities like SQL injection, XSS, and CSRF. It f…

Mise à jour

CertMate

Conteneur LXC

CertMate is a self-hosted SSL/TLS certificate manager. It issues and renews certificates over ACME (Let's Encrypt, ZeroSSL or a private ACME CA) with DNS-01 across many …

Mise à jour Port 8000

Certimate

Conteneur LXC

Certimate is an open-source SSL certificate management tool that automates the application, deployment, and renewal of SSL certificates, supporting integration with vari…

Mise à jour Port 8090 Accès par défaut

CrowdSec

Complément

CrowdSec is a free and open-source intrusion prevention system (IPS) designed to provide network security against malicious traffic. It is a collaborative IPS that analy…