iam

command module
v1.14.10 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 6, 2026 License: Apache-2.0 Imports: 1 Imported by: 0

README

Hanzo IAM

An open-source AI-first Identity and Access Management (IAM) /AI MCP gateway and auth server with web UI supporting MCP, A2A, OAuth 2.1, OIDC, SAML, CAS, LDAP, SCIM, WebAuthn, TOTP, MFA, Face ID, Google Workspace, Azure AD

Identity and Access Management for the Hanzo ecosystem.
UI-first centralized authentication / Single-Sign-On (SSO) platform supporting OAuth 2.0, OIDC, SAML, CAS, LDAP, SCIM, WebAuthn, TOTP, MFA, and RADIUS.

Build GitHub Release Docker Pulls Go Report Card License


Features

  • OAuth 2.0 / OIDC provider -- standards-compliant identity provider with full authorization code, implicit, client-credentials, and device-code flows
  • SAML / CAS / LDAP -- enterprise federation and directory integration
  • WebAuthn / Passkeys -- passwordless authentication with FIDO2 hardware keys and platform authenticators
  • TOTP / MFA -- time-based one-time passwords and multi-factor authentication
  • Social login -- 40+ identity providers (GitHub, Google, Apple, Microsoft, Discord, and more)
  • RBAC -- role-based access control with fine-grained permissions
  • Multi-tenancy -- multiple organizations and applications in a single deployment
  • API-first -- full REST API for programmatic user, application, and organization management
  • SCIM provisioning -- automated user lifecycle management
  • RADIUS -- network access authentication

Quick Start

Docker

docker run -d \
  --name hanzo-iam \
  -p 8000:8000 \
  hanzoai/iam:latest

Open http://localhost:8000 in your browser.

Docker Compose

# compose.yml
services:
  iam:
    image: hanzoai/iam:latest
    ports:
      - "8000:8000"
    volumes:
      - iam-data:/var/lib/iam
    restart: unless-stopped

volumes:
  iam-data:
docker compose up -d

From Source

git clone https://github.com/hanzoai/iam.git
cd iam
go build ./...

Domains

Hanzo IAM serves SSO across multiple organizations via white-label domain support:

Domain Purpose
hanzo.id Hanzo AI accounts

Additional domains can be configured per organization. Each domain gets its own branding, login flow, and user pool while sharing the same IAM infrastructure.

Documentation

Full documentation is available at docs.hanzo.ai.

License

Apache-2.0 — historical attribution and third-party notices in NOTICE.

Copyright 2025-2026 Hanzo AI Inc

Documentation

Overview

Root main.go — thin wrapper for backward compat. Canonical entrypoint is cmd/iamd/main.go.

Directories

Path Synopsis
cmd
iam command
Command iam is the administrative CLI for IAM.
Command iam is the administrative CLI for IAM.
iamd command
Command iamd is the IAM server daemon.
Command iamd is the IAM server daemon.
Package iamserver exports the IAM Beego server startup logic.
Package iamserver exports the IAM Beego server startup logic.
Package kms wraps the native-ZAP base/plugins/kms client for IAM.
Package kms wraps the native-ZAP base/plugins/kms client for IAM.
pkg
iam
Package iam exposes an in-process entry point for the Hanzo IAM server, mirroring the shape used by github.com/hanzoai/tasks/pkg/tasks.
Package iam exposes an in-process entry point for the Hanzo IAM server, mirroring the shape used by github.com/hanzoai/tasks/pkg/tasks.
Package routers @APIVersion 1.503.0 @Title IAM RESTful API @Description Swagger Docs of IAM Backend API @Contact support@hanzo.ai @SecurityDefinition AccessToken apiKey Authorization header @Schemes https,http @ExternalDocs Find out more about IAM @ExternalDocsUrl https://github.com/hanzoai/iam
Package routers @APIVersion 1.503.0 @Title IAM RESTful API @Description Swagger Docs of IAM Backend API @Contact support@hanzo.ai @SecurityDefinition AccessToken apiKey Authorization header @Schemes https,http @ExternalDocs Find out more about IAM @ExternalDocsUrl https://github.com/hanzoai/iam
Package ui embeds the IAM admin dashboard built with Vite + React.
Package ui embeds the IAM admin dashboard built with Vite + React.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL