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]>
296 lines
25 KiB
HTML
296 lines
25 KiB
HTML
<!doctype html>
|
|
<html lang="en"><head>
|
|
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>hip-0519</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="/hip-0519.md">
|
|
|
|
<link rel="icon" href="/favicon.svg">
|
|
<link rel="canonical" href="https://hanzoskills.com/hip-0519">
|
|
</head>
|
|
<!-- Reading this with a machine? Every page here is also plain markdown.
|
|
This one: https://hanzoskills.com/hip-0519.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>hip-0519</h1><p class="lede">HIP-519: One Identity Boundary. Status Final. Hanzo architectural specification.</p><h1>HIP-0519: One Identity Boundary</h1>
|
|
<h2>Abstract</h2>
|
|
<p>Identity is verified <strong>exactly once, at the edge</strong>, against IAM. Everything behind that boundary READS the assertion and forwards it unchanged. No service re-validates a token. No service mints an identity header. No service carries its own copy of the rule.</p>
|
|
<p><strong>The edge is a ROLE, not a component.</strong> This HIP is about the property — one verification, at the entry point, and nothing behind it re-deciding — never about which binary holds it. In this estate the role is held by the <code>cloud</code> binary's own edge (<code>SanitizeIdentity</code>): the standalone gateway was deliberately retired, <code>api.hanzo.ai</code> resolves through Hanzo Ingress (HIP-0068) straight to <code>cloud</code>, and the ingress holds no JWKS client and mints none of the headers below. <code>cloud</code>'s middleware is therefore not a second implementation — <strong>it is the one this HIP requires</strong>, and deleting it deletes the estate's only identity boundary.</p>
|
|
<p>A spec that named the component instead of the property would read as an instruction to delete the boundary. This one names the property.</p>
|
|
<h2>Motivation</h2>
|
|
<p>HIP-0026 says who ISSUES identity: Hanzo IAM. It never said who ENFORCES it, and in the absence of that sentence two failures became possible, one of which happened and one of which nearly did.</p>
|
|
<p><strong>What happened.</strong> The identity a service-to-service call carried drifted from the identity the edge asserts. For a period an internal call forwarded five of the nine headers, and the four it dropped — project, minted name, owner, org-admin — are precisely the ones a callee DECIDES on. A billing subject prefers the minted name over the opaque id; platform sudo is read off <code>owner</code>, never off <code>isOrgAdmin</code>. The same handler therefore reached one conclusion over REST and a different one over a call, silently, in the direction that bills or admits the wrong principal.</p>
|
|
<p><strong>What nearly happened.</strong> Reading the edge's own middleware as a <em>duplicate</em> of a gateway that no longer exists, and deleting it. The standalone gateway was retired and <code>cloud</code> inherited the role; a reader who knew the old topology and not the new one sees two verifiers where there is one. That reading gets as far as a demonstrated cross-tenant secret read.</p>
|
|
<p>Both failures come from the same missing sentence, so this HIP states the property rather than the topology: <strong>one verification, at whatever holds the edge, and nothing behind it re-deciding.</strong> A count of implementations is not the rule; the rule is that exactly one of them is at the entrance.</p>
|
|
<h2>Specification</h2>
|
|
<h3>The boundary</h3>
|
|
<pre><code> client ──TLS──▶ ingress TLS TERMINATION ONLY. No identity, no authz.
|
|
──PQ ZAP/QUIC──▶ gateway THE EDGE: JWT verify, authz, rate limit.
|
|
─────────────▶ cloud Holds NOTHING. Reads the assertion.
|
|
──ZAP/UDS────▶ plugins Capabilities, EAFP.</code></pre>
|
|
<p>One transport family end to end — ZAP over QUIC across hosts, ZAP over a unix socket on-host — and one identity verification, at the gateway.</p>
|
|
<p>Each tier holds exactly one concern. Ingress terminates TLS and decides nothing. The gateway is the edge: it strips, verifies and mints. Cloud holds nothing and reads what the gateway asserted. Plugins receive capabilities and use them.</p>
|
|
<p><strong>The edge role moves WHOLE or not at all.</strong> All three steps below live in one tier, and the headers are minted before the first service reads one. Splitting them is how a tier ends up trusting a header nobody verified.</p>
|
|
<p><strong>Two things named "gateway" are not the same thing.</strong> <code>hanzoai/gateway</code> holds the edge — the JWT verify, the strip, the mint. <code>cloud/apps/gateway</code> is the edge CONFIG plane (<code>/v1/gateway/config</code>: CORS allowlist, rate-limit knobs, cache TTL) that the edge READS. A deployment carrying the second without the first has the edge's dials and none of its decision, which is precisely how a service behind the edge came to grow a boundary of its own.</p>
|
|
<p><strong>The edge MUST</strong>, for every request entering the estate:</p>
|
|
<ol><li>Delete every identity header the client supplied, before anything reads one.</li><li>Validate the caller's credential against IAM — a signed JWT verified against</li></ol>
|
|
<p> IAM's JWKS, or an IAM API key resolved through IAM.</p>
|
|
<ol><li>Mint the header set below from the VERIFIED claims, and only from those.</li></ol>
|
|
<p><strong>A service behind the edge MUST NOT</strong>:</p>
|
|
<ul><li>validate a token, fetch a JWKS, or hold an issuer or audience list;</li><li>mint, rewrite, or default any header in the set below;</li><li>accept an identity from anywhere other than the request it was given.</li></ul>
|
|
<p><strong>A service MAY</strong> read the set, forward it unchanged to the next hop, and apply its own AUTHORIZATION to it. Authorization is a service's own business. Authentication is not.</p>
|
|
<h3>The header set</h3>
|
|
<p>Nine headers, named once, forwarded whole. A partial set is a defect: the missing field is the one a callee decides on.</p>
|
|
<p>| header | meaning | |---|---| | <code>X-Org-Id</code> | the org being ACTED ON (the effective org) | | <code>X-Project-Id</code> | the project narrowing that org; absent means the default | | <code>X-User-Id</code> | the opaque user id | | <code>X-User-Name</code> | the minted name; a billing subject prefers this over the id | | <code>X-User-Email</code> | the verified email | | <code>X-User-Owner</code> | the org the principal BELONGS TO (the home org) | | <code>X-User-IsAdmin</code> | platform sudo: member of the reserved admin org | | <code>X-User-IsOrgAdmin</code> | administers their OWN org — NOT platform authority | | <code>X-Request-Id</code> | ties the hops together in the logs |</p>
|
|
<p><code>X-User-Owner</code> and <code>X-User-IsOrgAdmin</code> are DIFFERENT authorities and reading one for the other is a privilege escalation. Platform sudo is <code>owner == admin-org</code> and nothing else.</p>
|
|
<h3>Behind the edge: the trust domain</h3>
|
|
<p>Services co-located on a host reach each other over ZAP on a unix socket. That socket is the boundary of the trust domain:</p>
|
|
<ul><li>it is <code>0600</code> in a <code>0700</code> directory, so the filesystem decides who may connect;</li><li><code>SO_PEERCRED</code> attests the peer process to the kernel, which the peer cannot</li></ul>
|
|
<p> forge because the peer never sends it.</p>
|
|
<p>Inside the domain a caller forwards the edge's assertion (<code>Ctx.Forward()</code>), or — for background work with no request behind it — states the tenant it acts for explicitly (<code>zip.WithCaller</code>). <strong>An inbound request always wins over a stated one</strong>, so a job can supply an identity where there is none and can never launder one.</p>
|
|
<p>The socket is NOT a boundary between our own services. A peer is already one of ours and could name any org it liked; never read a caller-supplied org as an authorization decision on its own.</p>
|
|
<h3>The one predicate set</h3>
|
|
<p>Every authorization check reads the SAME three predicates. A service that spells its own is a second rule:</p>
|
|
<pre><code>principal.Validated(c) a principal is present at all
|
|
principal.IsSuperAdmin(c) platform sudo (owner == admin org)
|
|
principal.IsOrgAdmin(c) admin of their OWN org</code></pre>
|
|
<p>A gate admitting either writes <code>IsSuperAdmin(c) || IsOrgAdmin(c)</code> — explicit, so the superset is visible AT the gate rather than hidden inside a predicate.</p>
|
|
<h3>Ingress that is not identity</h3>
|
|
<p>Two things look like authentication and are not. Both are permitted, and neither may grant a principal:</p>
|
|
<ul><li><strong>Key-shape predicates</strong> (<code>isAPIKey</code>, publishable-key detection) — used to</li></ul>
|
|
<p> redact a credential from an audit record, and to refuse to treat a publishable key as authentication. They classify a string; they do not authenticate.</p>
|
|
<ul><li><strong>Tenant attribution</strong> (<code>OrgForKey</code>) — resolves a key to the org whose beacon</li></ul>
|
|
<p> it is, so an ingest endpoint can attribute analytics. Resolvable is not authenticated, and a publishable key MUST NOT resolve to a principal.</p>
|
|
<h3>Conformance</h3>
|
|
<p>A repository conforms when all of these hold:</p>
|
|
<ol><li>No JWKS client, issuer set, or audience allowlist outside the EDGE and IAM.</li><li>No middleware that writes any header in the set above.</li><li>Every authorization check reads the three predicates, and no other.</li><li>Service-to-service calls forward the whole set — a projection that carries a</li></ol>
|
|
<p> subset is a defect, and is testable by asserting all nine cross.</p>
|
|
<h2>Security Considerations</h2>
|
|
<p><strong>Direct reachability.</strong> The model rests on every request traversing the edge. A listener reachable without doing so accepts whatever headers a caller sends: a forged <code>X-Org-Id</code> + <code>X-User-Id</code> + <code>X-User-IsAdmin</code> reads another tenant's secret VALUE, which the estate's own red-team probe demonstrates.</p>
|
|
<p>The obligation is met by the TOPOLOGY — ingress terminates TLS and forwards to the gateway, which is the only thing that reaches cloud — and a network policy merely enforces what the topology already says. Two policies that appear to enforce it today do not:</p>
|
|
<ul><li><code>network-policy-cloud-api.yaml</code> selects <code>app: cloud</code>. Operator-rendered pods</li></ul>
|
|
<p> carry <code>app.kubernetes.io/name</code> + <code>app.kubernetes.io/instance</code>, so the selector matches ZERO pods and has never restricted anything.</p>
|
|
<ul><li><code>cilium-allow-cluster-ingress.yaml</code> allows every pod, every port, from the</li></ul>
|
|
<p> whole cluster. Cilium UNIONS allows and has no deny that overrides one, so even a correctly-selected policy is re-opened by it.</p>
|
|
<p>Both are hand-applied and absent from every kustomization, so git and the cluster can disagree with nothing to detect it. <strong>A policy that selects nothing is worse than no policy: it reads as protection.</strong></p>
|
|
<p><strong>Removing a service's own boundary is a REPLACEMENT, never a deletion.</strong> A service that grew one because the edge was absent may drop it in the same change that puts the edge in front, so the boundary never stops running for a single request. Deleting first and wiring second is the cross-tenant read above.</p>
|
|
<p><strong>Why verifying twice is not defence in depth.</strong> A second verifier does not add a check; it adds a second answer. When the two disagree the effective rule is whichever ran last, and nobody wrote that rule down.</p>
|
|
<p><strong>Rules that live inside the boundary.</strong> Four decisions live in the edge and have production incidents attached; whoever holds the role holds these, and moving the role without them reintroduces the incident:</p>
|
|
<ol><li>The tenant is <code>orgs[0]</code> of the signed membership set, NOT the <code>owner</code> claim —</li></ol>
|
|
<p> IAM stamps the APPLICATION's org into <code>owner</code>, which made the tenant caller-selectable (a hanzo user authenticating via lux-cloud billed lux).</p>
|
|
<ol><li>Org-admin is role ∈ {owner, admin}, with the org compared VERBATIM — matching</li></ol>
|
|
<p> only "admin" refused every self-serve founder from their own admin surface.</p>
|
|
<ol><li>A machine principal never gets SuperAdmin, even carrying <code>owner == adminOrg</code>.</li></ol>
|
|
<p> A machine is one with an EMPTY membership set: IAM signs <code>orgs: nil</code> on exactly one path, client_credentials, and every human path resolves memberships through the org store. It is not a principal carrying <code>type: "application"</code> — IAM's signed claim set has no <code>type</code> field, so a reader keying on one admits every machine it means to refuse. Authority is membership.</p>
|
|
<ol><li><code>X-Billing-Account-Id</code> and <code>X-Project-Id</code> are minted from signed claims only,</li></ol>
|
|
<p> with the client copy deleted on ingress. <strong>Who pays is an identity field.</strong></p>
|
|
<p><strong>Why verifying twice is not defence in depth.</strong> A second verifier does not add a check; it adds a second answer. When the two disagree the effective rule is whichever ran last, and nobody wrote that rule down. The failure above was exactly this shape, and it was silent in both directions.</p>
|
|
<p><strong>Blast radius of the trust domain.</strong> Any process inside it can act for any tenant. That is a deliberate consequence of verifying once, and it is why the socket's mode and peer credential are load-bearing, and why a service must never read a peer's stated org as authorization.</p>
|
|
<h2>References</h2>
|
|
<ul><li>HIP-0026 — Identity & Access Management Standard (who issues identity)</li><li>HIP-0106 — Wire protocol stack (JSON is the boundary format; ZAP behind it)</li></ul>
|
|
<h2>Copyright</h2>
|
|
<p>Released under the MIT License.</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="/hip-0519.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
|
|
</footer>
|
|
</div></body></html> |