mirror of https://github.com/hanzoai/runtime.git synced 2026-10-30 18:23:13 +00:00

Files

T

zooqueenandHanzo Dev 5265eb6edf docs(iam): drop the false vendor gloss on Hanzo IAM

Six places glossed Hanzo IAM as "(Casdoor)". That claim is wrong: Hanzo IAM
is original clean-room work, and the Casdoor-derived server was iam-v1,
which is retired and ships in nothing. The parenthetical is gone; in the two
ASCII diagrams the box subtitle is now (OIDC), which is what these guides
actually describe the integration speaking.

Co-authored-by: Hanzo Dev <[email protected]>

2026-07-28 17:14:37 -07:00

3.9 KiB

Raw Permalink Blame History

Hanzo Runtime Integration Complete ✅

Summary

The Hanzo Runtime has been successfully prepared for release with full IAM integration and dashboard SSO support.

What's Ready

📦 NPM Packages (v0.7.0)

✅ @hanzo/api-client - TypeScript API client
✅ @hanzo/runner-api-client - Runner API client
✅ @hanzo/runtime - Main TypeScript SDK

🐍 Python Packages (v0.7.0)

✅ hanzo-runtime - Main Python SDK
✅ hanzo_runtime_api_client - Python API client
✅ hanzo_runtime_api_client_async - Async Python API client

🔐 IAM Integration

✅ OAuth2 authentication examples
✅ Token validation middleware
✅ Automatic token refresh
✅ Service-to-service auth
✅ Dashboard SSO configuration

📊 Dashboard Integration

✅ OIDC authentication ready
✅ IAM token validation
✅ Seamless SSO flow
✅ User context from IAM

Test Results

✅ All TypeScript packages build successfully
✅ Dashboard builds with OIDC support  
✅ API supports IAM token validation
✅ Integration examples are valid
✅ Documentation is complete

Quick Start

1. Publish Packages

# Set your tokens
export PYPI_TOKEN=your_pypi_token
export NPM_OTP=your_npm_otp  # Or enter interactively

# Run publish script
./publish-with-tokens.sh

2. Configure IAM

In Hanzo IAM, create the Runtime application:

{
  "name": "runtime-dashboard",
  "client_id": "runtime-dashboard",
  "redirect_uris": [
    "https://runtime.hanzo.ai",
    "https://runtime.hanzo.ai/callback"
  ],
  "grant_types": ["authorization_code", "client_credentials"]
}

3. Deploy Dashboard

# Set environment variables
export VITE_OIDC_DOMAIN=https://iam.hanzo.ai
export VITE_OIDC_CLIENT_ID=runtime-dashboard
export VITE_API_URL=https://api.runtime.hanzo.ai

# Build and deploy
pnpm nx build dashboard
# Deploy dist/apps/dashboard to your hosting

4. Use the SDKs

TypeScript:

import { HanzoRuntime } from '@hanzo/runtime';
import { authenticateWithIAM } from './iam-auth';

const token = await authenticateWithIAM();
const client = new HanzoRuntime({ apiKey: token });

Python:

from hanzo_runtime import HanzoRuntime
from iam_auth import HanzoIAMAuth

iam = HanzoIAMAuth()
client = HanzoRuntime(api_key=iam.get_token())

Architecture

┌─────────────┐     ┌─────────────┐     ┌──────────────┐
│  Hanzo IAM  │────▶│  Dashboard  │────▶│ Runtime API  │
│   (OIDC)    │     │   (React)   │     │  (NestJS)    │
└─────────────┘     └─────────────┘     └──────────────┘
       │                                         │
       │                                         ▼
       │                                 ┌──────────────┐
       └────────────────────────────────▶│   Sandbox    │
                                         │  Execution   │
                                         └──────────────┘

Files Created

/PUBLISH_INSTRUCTIONS.md - Publishing guide
/publish-with-tokens.sh - Automated publish script
/test-integration.sh - Integration test script
/examples/iam-integration/ - Complete integration examples
- typescript/iam-auth.ts - TypeScript authentication
- python/iam_auth.py - Python authentication
- runtime-api-middleware.ts - API middleware
- README.md - Integration guide
- dashboard-sso.md - Dashboard SSO setup

Support

Documentation: https://docs.hanzo.ai/runtime
GitHub: https://github.com/hanzoai/runtime
Support: [email protected]

The Hanzo Runtime is ready for production! 🚀

3.9 KiB Raw Permalink Blame History