mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
hanzoskills.com/llms.txt now opens with the install line, the API reference index and the company index, so an agent that lands on any one of the three can find the rest. robots.txt claimed 537 documents while llms.txt counts 920. The number is gone from robots.txt; llms.txt derives it. public/ is regenerated from scripts/site.py, which it had fallen behind: the copy-prompt menu and agent bar were in the generator and not in the committed pages. tests/site.mjs passes against the result. Co-authored-by: Hanzo Dev <[email protected]>
346 lines
21 KiB
HTML
346 lines
21 KiB
HTML
<!doctype html>
|
|
<html lang="en"><head>
|
|
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>hanzo-kms</title>
|
|
<meta name="color-scheme" content="dark">
|
|
<style>
|
|
/* Committed to one visual world: a dark instrument panel. No light variant —
|
|
the dot field and the hairline rules only read on black, and a naive
|
|
inversion would wash both out. Every colour is painted explicitly so the page
|
|
never borrows a host background. */
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
|
|
|
|
:root{
|
|
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
|
|
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
|
|
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
|
|
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
|
|
--font-zen-pixel-square:'Zen Pixel Square',monospace;
|
|
--mono:var(--font-zen-mono);
|
|
--sans:var(--font-zen-sans);
|
|
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
|
|
--r:999px; --r-soft:14px;
|
|
}
|
|
*{box-sizing:border-box}
|
|
html{-webkit-text-size-adjust:100%}
|
|
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
|
|
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
|
|
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
|
|
|
|
/* The dot field. A halftone made of one repeating radial-gradient, faded out
|
|
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
|
|
/* No overflow clip here: the dot field is inset to the box already, and a clip
|
|
would cut off the copy-prompt menu. */
|
|
.hero{position:relative;border-bottom:1px solid var(--line)}
|
|
.hero::before{content:"";position:absolute;inset:0;
|
|
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
|
|
background-size:7px 7px;
|
|
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
pointer-events:none}
|
|
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
|
|
|
|
nav{border-bottom:1px solid var(--line)}
|
|
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
|
|
justify-content:space-between;align-items:center;gap:1rem}
|
|
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--ink);text-decoration:none;
|
|
display:inline-flex;align-items:center;gap:.6rem}
|
|
.brand i{font-style:normal;color:var(--faint)}
|
|
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
|
|
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--soft);text-decoration:none}
|
|
nav a.up:hover{color:var(--ink)}
|
|
|
|
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
|
|
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
|
|
h1 em{font-style:normal;color:var(--faint)}
|
|
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
|
|
|
|
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
|
|
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
|
|
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
|
|
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
|
|
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
|
|
line-height:1.2;font-weight:400}
|
|
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
|
|
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
|
|
.btn.solid:hover{background:#d8d8d4}
|
|
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
|
|
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
|
|
|
|
/* Copy-prompt selector. Each row copies the prompt for its own target. */
|
|
.copy{position:relative;display:inline-flex}
|
|
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
|
|
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
|
|
padding:.4rem;display:flex;flex-direction:column;
|
|
box-shadow:0 12px 32px rgba(0,0,0,.75)}
|
|
.menu[hidden]{display:none}
|
|
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
|
|
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
|
|
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
|
|
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
|
|
white-space:nowrap}
|
|
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
|
|
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
|
|
.mi:hover .mark{color:var(--ink)}
|
|
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
|
|
letter-spacing:.1em;text-transform:uppercase}
|
|
|
|
/* Works-with bar: one scrolling row, name and mark per agent. */
|
|
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
|
|
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
|
|
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
|
|
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
|
|
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
|
|
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
|
|
display:flex;align-items:center}
|
|
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
|
|
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
|
|
-webkit-overflow-scrolling:touch;
|
|
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
|
|
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
|
|
.bar::-webkit-scrollbar{display:none}
|
|
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
|
|
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
|
|
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
|
|
text-decoration:none;background:var(--ground)}
|
|
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
|
|
.agent .mark{width:.95rem;height:.95rem}
|
|
|
|
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
|
|
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
|
|
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
|
|
p{margin:0 0 1rem;max-width:70ch}
|
|
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
|
|
li{margin:.22rem 0}
|
|
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
|
|
text-decoration-color:var(--line-hi)}
|
|
a:hover{text-decoration-color:var(--ink)}
|
|
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
|
|
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
|
|
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
|
|
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
|
|
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
|
|
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
|
|
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
|
|
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
|
|
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
|
|
display:block;overflow-x:auto}
|
|
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
|
|
|
|
.curl{display:block;background:var(--panel);border:1px solid var(--line);
|
|
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
|
|
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
|
|
white-space:pre;line-height:1.9}
|
|
.curl b{color:var(--ink);font-weight:400}
|
|
.curl i{font-style:normal;color:var(--faint)}
|
|
|
|
/* index */
|
|
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
|
|
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
|
|
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
|
|
#q:focus{outline:none;border-color:var(--soft)}
|
|
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
|
|
text-transform:uppercase;margin:0 0 2rem}
|
|
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
|
|
padding-bottom:.45rem}
|
|
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
|
|
border-radius:var(--r-soft);text-decoration:none}
|
|
.row:hover{background:#0a0a0a}
|
|
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
|
|
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
|
|
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
|
|
color:var(--faint);font-size:.85rem}
|
|
footer a{color:var(--soft)}
|
|
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
|
|
margin:0 0 2rem;font-size:.85rem}
|
|
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
|
|
border-bottom:1px solid var(--line);padding-bottom:.4rem}
|
|
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
|
|
.fmap a:hover{text-decoration:underline}
|
|
.fmap div{color:var(--faint);line-height:1.5}
|
|
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
|
|
|
|
@media (max-width:640px){
|
|
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
|
|
.btns{gap:.5rem}
|
|
.btn{padding:.75rem 1.15rem;font-size:.68rem}
|
|
.copy,.copy .btn{width:100%;justify-content:center}
|
|
.menu{left:0;right:0;min-width:0}
|
|
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
|
|
.strip b{border-right:0;padding-right:0}
|
|
.bar{width:100%}
|
|
}
|
|
</style>
|
|
<link rel="alternate" type="text/markdown" href="/hanzo-kms.md">
|
|
|
|
<link rel="icon" href="/favicon.svg">
|
|
<link rel="canonical" href="https://hanzoskills.com/hanzo-kms">
|
|
</head>
|
|
<!-- Reading this with a machine? Every page here is also plain markdown.
|
|
This one: https://hanzoskills.com/hanzo-kms.md
|
|
Index: https://hanzoskills.com/llms.txt
|
|
Corpus: https://hanzoskills.com/all.md
|
|
Append .md to any path for the markdown twin. -->
|
|
<body>
|
|
<nav><div class="in">
|
|
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
|
|
<a class="up" href="/">All skills</a>
|
|
</div></nav>
|
|
|
|
<div class="wrap">
|
|
<h1>hanzo-kms</h1><p class="lede">Hanzo KMS is a centralized secret management platform for the Hanzo ecosystem.</p><p><!-- Updated: 2026-03-26T15:03:36Z --></p>
|
|
<h1>Hanzo KMS - Key and Secret Management</h1>
|
|
<p><strong>Category</strong>: Hanzo Ecosystem <strong>Related Skills</strong>: <code>hanzo/hanzo-id.md</code>, <code>hanzo/hanzo-platform.md</code>, <code>hanzo/hanzo-vault.md</code>, <code>hanzo/hanzo-k8s.md</code></p>
|
|
<h2>Overview</h2>
|
|
<p>Hanzo KMS is a <strong>centralized secret management platform</strong> for the Hanzo ecosystem. Fork of Hanzo KMS with Hanzo branding, 9 ported Vault subsystems, Universal Auth, and K8s-native secret sync via KMSSecret CRD. Live at <code>kms.hanzo.ai</code>. Every secret in the Hanzo stack flows through KMS -- no plaintext credentials in manifests, ever.</p>
|
|
<h2>When to use</h2>
|
|
<ul><li>Storing API keys, database credentials, tokens for any service</li><li>Syncing secrets to K8s workloads via KMSSecret CRD</li><li>CI/CD pipeline secret injection</li><li>Multi-org secret isolation</li><li>Auditing secret access</li><li>Generating dynamic secrets (database users, cloud IAM)</li><li>Encrypting/decrypting data via Transit encryption</li></ul>
|
|
<h2>Hard requirements</h2>
|
|
<ol><li><strong>KMS for ALL secrets</strong>: Never hardcode in manifests, env files, or git</li><li><strong>Universal Auth</strong> credentials (client ID + secret) for machine access</li><li><strong>Project slug minimum 5 characters</strong> (e.g., <code>hanzo-paas</code> not <code>paas</code>)</li><li><strong>RBAC enforced</strong> on all key and secret operations</li><li><strong>Audit logging</strong> enabled for all operations</li></ol>
|
|
<h2>Quick reference</h2>
|
|
<p>| Item | Value | |------|-------| | UI | <code>https://kms.hanzo.ai</code> | | API | <code>https://kms.hanzo.ai/api/v1</code> | | Auth | Universal Auth (client ID + secret) | | K8s CRD | <code>KMSSecret</code> | | Go SDK | <code>github.com/hanzoai/kms-go-sdk</code> | | Node SDK | <code>@hanzo/kms-node-sdk</code> | | Python SDK | <code>hanzo-kms</code> (pip) | | Upstream | Hanzo KMS | | Repo | <code>github.com/hanzoai/kms</code> | | K8s manifests | <code>universe/infra/k8s/kms/</code> | | Image | <code>ghcr.io/hanzoai/kms:latest</code> | | Operator | <code>hanzoai/kms-operator</code> | | Backend | Node.js/Fastify/TypeScript | | Frontend | React 18/Vite | | Database | PostgreSQL + Redis |</p>
|
|
<h2>Vault subsystems (9)</h2>
|
|
<ol><li><strong>Shamir Secret Sharing</strong> -- Split master key across N parties (M-of-N reconstruction)</li><li><strong>Transit Encryption</strong> -- Encrypt/decrypt without exposing keys (envelope encryption)</li><li><strong>Leases</strong> -- Time-bound secret access with automatic revocation</li><li><strong>Seal/Unseal</strong> -- Cold-start protection requiring quorum to activate</li><li><strong>ACL Policies</strong> -- Fine-grained access control per path/operation</li><li><strong>Token Management</strong> -- Scoped, renewable auth tokens with TTL</li><li><strong>Dynamic Secrets</strong> -- On-demand credential generation (DB users, cloud IAM)</li><li><strong>TFHE Bridge</strong> -- Fully homomorphic encryption for compute-on-encrypted-secrets</li><li><strong>Per-Org Root Key Isolation</strong> -- Each organization has its own root encryption key</li></ol>
|
|
<h2>CLI quickstart</h2>
|
|
<pre><code class="lang-bash"># Login via Universal Auth
|
|
export KMS_TOKEN=$(curl -s -X POST https://kms.hanzo.ai/api/v1/auth/universal-auth/login \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"clientId": "'$KMS_CLIENT_ID'", "clientSecret": "'$KMS_CLIENT_SECRET'"}' \
|
|
| jq -r '.accessToken')
|
|
|
|
# Fetch secrets
|
|
curl -s https://kms.hanzo.ai/api/v1/secrets \
|
|
-H "Authorization: Bearer ${KMS_TOKEN}" \
|
|
-G -d "workspaceId=${PROJECT_ID}&environment=production"</code></pre>
|
|
<h2>SDK quickstart</h2>
|
|
<h3>Go</h3>
|
|
<pre><code class="lang-go">import kms "github.com/hanzoai/kms-go-sdk"
|
|
|
|
client := kms.NewClient(kms.Config{
|
|
SiteURL: "https://kms.hanzo.ai",
|
|
ClientID: os.Getenv("KMS_CLIENT_ID"),
|
|
ClientSecret: os.Getenv("KMS_CLIENT_SECRET"),
|
|
})
|
|
|
|
secret, err := client.GetSecret(kms.GetSecretOptions{
|
|
ProjectID: "hanzo-paas",
|
|
Environment: "production",
|
|
SecretName: "DATABASE_URL",
|
|
})</code></pre>
|
|
<h3>Node.js</h3>
|
|
<pre><code class="lang-typescript">import { KMSClient } from "@hanzo/kms-node-sdk"
|
|
|
|
const client = new KMSClient({
|
|
siteUrl: "https://kms.hanzo.ai",
|
|
clientId: process.env.KMS_CLIENT_ID!,
|
|
clientSecret: process.env.KMS_CLIENT_SECRET!,
|
|
})
|
|
|
|
const secret = await client.getSecret({
|
|
projectId: "hanzo-paas",
|
|
environment: "production",
|
|
secretName: "DATABASE_URL",
|
|
})</code></pre>
|
|
<h3>Python</h3>
|
|
<pre><code class="lang-python">from hanzo_kms import KMSClient
|
|
|
|
client = KMSClient(
|
|
site_url="https://kms.hanzo.ai",
|
|
client_id=os.environ["KMS_CLIENT_ID"],
|
|
client_secret=os.environ["KMS_CLIENT_SECRET"],
|
|
)
|
|
|
|
secret = client.get_secret(
|
|
project_id="hanzo-paas",
|
|
environment="production",
|
|
secret_name="DATABASE_URL",
|
|
)</code></pre>
|
|
<h2>K8s secret sync (KMSSecret CRD)</h2>
|
|
<p>The KMS operator watches KMSSecret resources and auto-syncs to K8s Secrets:</p>
|
|
<pre><code class="lang-yaml">apiVersion: kms.hanzo.ai/v1
|
|
kind: KMSSecret
|
|
metadata:
|
|
name: my-app-secrets
|
|
namespace: hanzo
|
|
spec:
|
|
project: hanzo-paas
|
|
environment: production
|
|
syncInterval: 5m
|
|
secretRef:
|
|
name: my-app-secrets # K8s Secret created/updated
|
|
secrets:
|
|
- DATABASE_URL
|
|
- REDIS_URL
|
|
- HANZO_API_KEY</code></pre>
|
|
<p>Deployments reference the synced secret:</p>
|
|
<pre><code class="lang-yaml">spec:
|
|
containers:
|
|
- name: my-app
|
|
envFrom:
|
|
- secretRef:
|
|
name: my-app-secrets</code></pre>
|
|
<h2>Helm chart: auto-bootstrap</h2>
|
|
<pre><code class="lang-yaml"># values.yaml for kms-standalone chart
|
|
kms:
|
|
autoBootstrap:
|
|
additionalOrganizations:
|
|
- hanzo
|
|
- lux
|
|
- zoo
|
|
additionalOrganizationAdminEmails:
|
|
- [email protected]
|
|
additionalOrganizationsTokenSecretKey: token</code></pre>
|
|
<h2>CI/CD integration</h2>
|
|
<pre><code class="lang-yaml"># .github/workflows/deploy.yml
|
|
jobs:
|
|
deploy:
|
|
steps:
|
|
- name: Login to KMS
|
|
run: |
|
|
export KMS_TOKEN=$(curl -s -X POST $KMS_URL/api/v1/auth/universal-auth/login \
|
|
-d '{"clientId":"${{ secrets.KMS_CLIENT_ID }}","clientSecret":"${{ secrets.KMS_CLIENT_SECRET }}"}' \
|
|
| jq -r '.accessToken')
|
|
echo "KMS_TOKEN=$KMS_TOKEN" >> $GITHUB_ENV
|
|
|
|
- name: Fetch deploy secrets
|
|
run: |
|
|
DOCKERHUB_TOKEN=$(curl -s "$KMS_URL/api/v1/secrets/raw/DOCKERHUB_TOKEN?workspaceId=$PROJECT_ID&environment=production" \
|
|
-H "Authorization: Bearer $KMS_TOKEN" | jq -r '.secret.secretValue')</code></pre>
|
|
<h2>Authentication methods</h2>
|
|
<ul><li>Universal Auth (API key + secret) -- primary for machines</li><li>Kubernetes Service Account Auth</li><li>AWS IAM Auth</li><li>GCP IAM Auth</li><li>Azure AD Auth</li><li>OIDC Auth</li><li>JWT Auth</li></ul>
|
|
<h2>Environment variables</h2>
|
|
<p>| Variable | Required | Purpose | |----------|----------|---------| | <code>ENCRYPTION_KEY</code> | Yes | 16-byte hex key for platform encryption | | <code>AUTH_SECRET</code> | Yes | JWT signing secret | | <code>DB_CONNECTION_URI</code> | Yes | PostgreSQL connection string | | <code>REDIS_URL</code> | Yes | Redis connection string | | <code>SITE_URL</code> | Yes | Base URL for KMS frontend |</p>
|
|
<h2>Troubleshooting</h2>
|
|
<p>| Issue | Cause | Solution | |-------|-------|----------| | Slug error on project creation | Slug < 5 chars | Use <code>hanzo-paas</code> not <code>paas</code> | | Universal Auth login fails | Wrong client credentials | Regenerate in KMS UI | | KMSSecret not syncing | Operator not running | Check <code>kms-operator</code> pod | | Token key mismatch | Custom bootstrap template | Set <code>additionalOrganizationsTokenSecretKey</code> | | HSM connection failed | Wrong PKCS#11 path | Verify <code>HSM_LIBRARY_PATH</code> and slot number |</p>
|
|
<h2>Related Skills</h2>
|
|
<ul><li><code>hanzo/hanzo-id.md</code> -- IAM (KMS uses IAM for user auth)</li><li><code>hanzo/hanzo-vault.md</code> -- PCI card tokenization</li><li><code>hanzo/hanzo-platform.md</code> -- PaaS (uses KMS for secrets)</li><li><code>hanzo/hanzo-k8s.md</code> -- K8s infrastructure</li><li><code>hanzo/hanzo-deploy.md</code> -- Deployment workflow</li></ul>
|
|
<hr>
|
|
<p><strong>Last Updated</strong>: 2026-05-12 <strong>Category</strong>: Hanzo Ecosystem <strong>Related</strong>: secrets, kms, kms, encryption, security, vault <strong>Prerequisites</strong>: API key concepts, K8s basics</p>
|
|
<footer>
|
|
<div class="fmap">
|
|
<div><b>Build</b>
|
|
<a href="https://hanzo.app">hanzo.app</a> app builder
|
|
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
|
|
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
|
|
<div><b>Run</b>
|
|
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
|
|
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
|
|
<div><b>Account</b>
|
|
<a href="https://hanzo.id">hanzo.id</a> sign in
|
|
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
|
|
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
|
|
<div><b>Company</b>
|
|
<a href="https://hanzo.ai">hanzo.ai</a> canonical
|
|
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
|
|
</div>
|
|
<div class="fend"><a href="/hanzo-kms.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
|
|
</footer>
|
|
</div></body></html> |