Skip to content
Halo

Identity and access management

Open-source IAM. Self-hosted or managed.

Run Halo on your own infrastructure or use invite-only Halo Cloud, managed by Scala Studios. Sign in with passkeys, connect apps over OpenID Connect or SAML, and manage access policies and reviews.

curl -fsSL https://halo.scala.gg/install.sh | sh

Docker Compose on any Linux host, amd64 or arm64. Read the install script

  • Grafana
  • Forgejo
  • Aether
  • Nextcloud
  • Kubernetes
  • Proxmox VE
  • Outline
  • Headscale
  • AWS IAM Identity Center
  • Slack
  • Any OpenID Connect app
  • Any SAML 2.0 app

Use cases

On the desk, and in a pocket.

Try it. The phone sends the prompt. The laptop is where someone decides.

Users

Priya Shah

Invited · setup link sent

Waiting for a passkey

9:41

halo.example.com

Create a passkey

Halo will ask this phone to confirm.

01 / The console

A console that starts with what needs attention.

Users, groups, applications, policies, governance and logs, in one administration console. The overview leads with what an administrator should act on today.

The console opens on what needs attention: administrators who can still sign in without a passkey, application secrets about to expire, requests waiting on you and reviews past due.

The Halo console overview, listing administrators without phishing-resistant sign-in, expiring application secrets, pending access requests and an overdue access review

02 / Sign-in

Passkeys first. No passwords by default.

People sign in with a passkey or a security key: a fingerprint, a face, a screen lock or a hardware key such as a YubiKey. Halo has no password field and stores no passwords until an administrator turns passwords on, with an authenticator code by default.

  • Phishing-resistantA passkey only works on your Halo domain, so a lookalike site gets nothing it can replay.
  • No username to typeDiscoverable credentials let people pick their account straight from the passkey prompt.
  • Fallbacks you controlAuthenticator apps, recovery codes and email links can each be switched off.
  • Existing accountsSign in through Google, Microsoft Entra ID, GitHub or any OpenID Connect provider.

Lost a phone? Add a second passkey or keep recovery codes, and an administrator can reset someone's sign-in methods and send a new setup link.

How sign-in works

Animation: Luna chooses Continue with passkey, confirms with her fingerprint, and Halo signs her in with a phishing-resistant passkey.

Animation: registering Grafana in Halo. Choose OpenID Connect, enter the name and redirect URI, copy the client ID, client secret and issuer, then assign the Engineering group so its members can sign in.

03 / Single sign-on

Connect an application in minutes.

Register the application, assign the groups that may use it, and paste the client ID, secret and issuer into its settings. Each application page includes a setup guide for that product.

04 / Open standards

Built on standards, not lock-in.

Halo speaks the protocols your applications already support, so connecting one needs configuration, not a Halo SDK.

  • OpenID ConnectCore 1.0 · Discovery 1.0
    Single sign-on for web, single-page and native applications, with ID tokens signed with RS256.
  • OAuth 2.0RFC 6749 · 7636 · 8628
    Authorization code with PKCE, refresh tokens that rotate, client credentials and the device flow.
  • SAML 2.0Web browser SSO
    Identity provider for applications that only speak SAML, started by the app or by Halo.
  • SCIM 2.0RFC 7643 · 7644
    Provisioning in both directions: from Okta, Entra ID or HR systems, and out to your applications.
  • WebAuthnPasskeys · FIDO2
    Phishing-resistant sign-in with passkeys and security keys, without a username.
  • TOTPRFC 6238
    Six-digit codes from authenticator apps, as a fallback you can switch off.
  • Implemented on main. Halo has not been through OpenID Foundation certification yet.
/.well-known/openid-configuration
{  "issuer": "https://auth.example.com",  "authorization_endpoint": "https://auth.example.com/oauth2/authorize",  "token_endpoint": "https://auth.example.com/oauth2/token",  "userinfo_endpoint": "https://auth.example.com/oauth2/userinfo",  "jwks_uri": "https://auth.example.com/oauth2/keys",  "end_session_endpoint": "https://auth.example.com/oauth2/logout",  "device_authorization_endpoint": "https://auth.example.com/oauth2/device_authorization",  "introspection_endpoint": "https://auth.example.com/oauth2/introspect",  "revocation_endpoint": "https://auth.example.com/oauth2/revoke",  "response_types_supported": ["code"],  "grant_types_supported": ["authorization_code", "refresh_token", "client_credentials", "urn:ietf:params:oauth:grant-type:device_code"],  "scopes_supported": ["openid", "profile", "email", "offline_access", "groups"],  "code_challenge_methods_supported": ["S256"],  "id_token_signing_alg_values_supported": ["RS256"]}

Halo's discovery document, as any OpenID Connect client reads it.

05 / Access policies

Every sign-in is checked against your policies.

A policy combines who is signing in, to which application, from which network, on which device, at what risk and with which method. It allows the sign-in, blocks it, or asks for a passkey or security key.

Run a new policy in report-only mode first. Halo records what it would have done to real sign-ins, so you see the effect before anyone is locked out.

Access policies

How Halo decides

Luna → AWS IAM Identity Center

Method
Passkey
Device
Trusted
Network
Office
Risk
None
  • Block high-risk sign-insEnforced
    No match
  • Require a passkey for administratorsEnforced
    Satisfied
  • Require a trusted device for productionReport-only
    No match
Allowed

Every matching policy is satisfied.

06 / Governance

Access that ends on its own.

Instead of asking an administrator in chat, people request an access package from their account portal. An approver decides, the grant runs for a set number of days, and Halo removes it when time is up.

Governance

Animation: Luna requests the Kubernetes cluster admins package for two days. Priya Raman approves it, Luna is added to the group, and two days later Halo removes her automatically.

  1. 01

    Joiner

    An account is invited in the console, provisioned over SCIM or created on first sign-in, and lifecycle rules add the person to the groups their profile matches.

  2. 02

    Request

    People ask for an access package from the Access page of their account portal, instead of chasing an administrator in chat.

  3. 03

    Approve

    An approver decides from the email, the account portal or the console. Nobody can approve their own request.

  4. 04

    Expire

    The grant ends when its duration runs out. Halo checks every minute and removes the person from the groups the grant added.

  5. 05

    Review

    Reviewers keep or remove every member of a group by a due date, and Halo applies the removals when the review completes.

  6. 06

    Leaver

    When someone leaves, a rule suspends the account and revokes its sessions.

07 / Infrastructure access

SSH certificates that expire, not keys that linger.

halo login signs you in on the command line through your browser. halo ssh-cert then issues a certificate for the principals your groups map to, valid for eight hours by default.

Servers trust Halo's certificate authority once: download its public key and add one line to sshd_config.

Infrastructure access
luna@laptop
$ halo login --server https://auth.example.comOpen https://auth.example.com/device?user_code=WDJB-MJHTand check that the page shows the code WDJB-MJHT.Waiting for you to approve the sign-in…Signed in to https://auth.example.com as Luna <luna@example.com>.$ halo ssh-certWrote certificate 1042 to /home/luna/.ssh/id_ed25519-cert.pub.Log in as ops, deploy until 5 October 17:41 CEST.$ ssh ops@db-1.internal

08 / Self-hosting

Your identity provider, on your own servers.

Halo is one Go server, one Next.js web interface and PostgreSQL. No Redis, no message queue, and no external service to depend on.

What runsdeploy/compose.yml
Internet
CaddyTLS · :443Certificates for your domain
halo-webNext.js · :3200Console, account portal, sign-in
halo-serverGo · :8080Protocols, policies, API, jobs
PostgreSQL 17DatabaseAll state, in one place
halo-server also talks to
  • SMTP for email
  • Webhooks
  • SCIM to applications
  • Google, Entra ID, GitHub

Install

curl -fsSL https://halo.scala.gg/install.sh | sh

Asks for your domain and organization name, generates the secrets and starts the four containers.

Requirements

A Linux host with Docker Engine and the Compose plugin, a domain pointing at it, and ports 80 and 443 open. In testing, the four containers used about 200 MB of memory at idle.

Operations

Back up the database and HALO_SECRET_KEY. Upgrades are a pull and a restart, and the key rotates with halo rotate-secret-key.

10 / Security

Boring security, written down.

Identity is the front door to everything else, so Halo's security model is documented in full, including what isn't finished yet. Halo has not had an independent audit.

Hashed
Session tokens, client secrets, API keys and refresh tokens are stored only as SHA-256 hashes and compared in constant time.
Sealed
Signing keys, authenticator seeds, provider secrets and the SSH CA are encrypted with AES-256-GCM. The key can be rotated.
Audited
Every administrative change checks the actor's role and writes an audit event in the same database transaction.
Same-origin
Requests that change state must come from Halo's own pages. Cross-site requests are refused.
HTTPS only
Halo refuses to start on plain HTTP outside development, and session cookies are Secure, HttpOnly and SameSite=Lax.
Disclosed
Vulnerabilities are reported privately, with response targets written down in the security policy.

11 / Open source

Built in the open.

All of Halo lives in one public repository under the Apache License 2.0. There is no closed edition and no license key: what you read is what you run.

The licence and the tree

On the roadmap

  • Multiple organizations per installationPlanned
  • Mutual TLS client authenticationPlanned
  • Organization-wide OAuth client policiesPlanned

Run it yourself

Run Halo on your own infrastructure.

One command on a Linux host with Docker. Then create your administrator and register a passkey.

curl -fsSL https://halo.scala.gg/install.sh | sh