Skip to content

Identity

Identity signs in humans and agents, issues every key and session, and connects single sign-on and directory sync for Customers.

Identity signs in Humans and Agents, issues every key and token, and connects single sign-on and directory sync for Customers. One issuer serves the whole platform.

Contract

WhoSigns in byHolds
A HumanMagic link or a connected account, with multi-factor requiredSigned-in Apps, plus keys for code
An AgentIts own identity, minted per AgentOne api.sb token, a Mailbox and a chat user
CI and machinesExchanging an OIDC token for a scoped tokenNo stored secret
A Customer's peopleSingle sign-on (SAML or OIDC) into the Customer's TenantRoles in that Tenant, kept current by directory sync (SCIM)

An exchanged token lasts 15 minutes and names both the Person and the acting Agent. A token narrows its scope, never widens it, and no admin token exists outside Identity.

An Integration's tokens reach the platform at call time and never reach agent code. Every token served is an Event.

Terminal
# The CLI looks for a key in this order: environment variable, credentials file, browser sign-in
npx startup-builder login

Verbs

Interfaces

Example

cohortly.io, retention analytics Software, sells to a 400-person company that requires single sign-on. The Customer's IT admin connects their directory once. When an employee leaves, directory sync removes them from the Tenant and their tokens stop working.