mirror of
https://github.com/hanzoai/iam.git
synced 2026-11-19 18:37:16 +00:00
WorkOS auth.md agent registration, the service_auth shape only. An agent names its person's email at POST /v1/iam/oauth/agent/identity (no credential) and gets a claim_token, stored only as its SHA-256, and a user code. The person approves on the device page they already use, under a stricter rule than a device sign-in: only the account whose verified email is the login_hint, and only an admin of a tenant home org, checked at approval and again at the claim. The agent polls the token endpoint with the claim grant and is answered as a device is. On approval, once, a service account is filed in the person's org (no sk- key, its tag the registration) with an agent-claim audit row, and the answer is its access token and a 7-day identity_assertion, never a refresh token. jwt-bearer exchanges that assertion for a fresh token for as long as the account exists; deleting it revokes the agent. Any other jwt-bearer assertion is the workload grant's, unchanged. A registration is a device row named ag-<reg>: the device poll never redeems one, the claim poll never redeems a device row, and neither is an authorization code. Discovery carries agent_auth only where IAM_AGENT_SKILL_MAP names the issuer, and only what is implemented: no anonymous, no identity_assertion, no claim or events endpoint. IAM_AGENT_CLIENT names the app registrations belong to; the boot refuses half a configuration. Refs hanzo-inc/app#85