← Back to Playbooks
Identity

Agent Identity & Know-Your-Agent (KYA)

Identity control plane — not a spend mandate, not harness egress

Operator recipe for treating Know-Your-Agent as the identity control plane for agents that act across networks. Distinct from /playbooks/agent-payments-spend-policy/ (capped payment capability, not PAN) and from /playbooks/harness-permission-outside-agent/ (host grants connectors/egress). Ant International, Mastercard, and Visa initiated collaboration on a KYA interoperability framework (PR Newswire / APAC, 2026-09-10) so card, wallet, agent-platform, and marketplace ecosystems can recognize agents from shared principles while each network keeps its own verification and decisioning. That collaboration is in progress — not a finished shared standard or live cert. Existing protocols named in the announcement: Visa Trusted Agent Protocol, Mastercard Verifiable Intent, Ant International Agentic Mobile Protocol. Pair identity with LangChain Connections: agent-owned vs caller/user-owned credentials. Workload and agent credentials are the blast radius: edit is not revoke; rotate exposed secrets; prefer managed identity or federation over long-lived client secrets; narrow delete roles; use CanNotDelete locks; alert on unusual workload-identity reads; keep dual-active secrets. The announcement cites McKinsey’s projection that AI agents could orchestrate US$3–5 trillion of global consumer commerce by 2030 (https://www.mckinsey.com/capabilities/quantumblack/our-insights/the-automation-curve-in-agentic-commerce) — a source citation, not an Institute metric. Primaries: https://www.prnewswire.com/apac/news-releases/ant-international-mastercard-and-visa-initiate-collaboration-on-know-your-agent-interoperability-to-scale-agentic-commerce-302874102.html ; https://www.langchain.com/blog/connections-managed-credentials-and-per-caller-identity-for-managed-deep-agents ; https://workos.com/blog/storm-3168-jadepuffer-azure-service-principal-attack. Related catalog: LangChain Managed Deep Agents, Nevermined, Stripe Link. Use the same registered agent ID in credentials and in audit events, and record the delegating user and the scope granted on every agent action, so that review and revocation work from identifiers your system issued, not a name the client typed. Sources: https://workos.com/blog/audit-logs-ai-agents-claude-compliance-api ; https://workos.com/blog/figma-mcp-403-forbidden-client-name. Model access is starting to depend on who the operator is verified to be. On 6 Oct 2026 Anthropic expanded its Cyber Verification Program into three tiers: Defense Access for defensive security work, Red Team Access for authorized penetration testing (organizations only), and Specialized Access for a limited set of verified organizations testing safety-critical systems. Generally available models keep conservative cyber safeguards, and enrolled organizations must accept data retention for misuse monitoring. An agent company that runs security work needs an organizational identity a model provider can vet and an authorization record for each target. Source: https://www.anthropic.com/news/cyber-verification-program Treat a person's app sign-in and their agent's access to the same app as separate grants. In WorkOS's Passport preview (7 Oct 2026), Notion signed the user in while Notion as an agent integration was still not connected. Source: https://workos.com/blog/init-2026-recap

Core Workflows (7)

Each workflow represents a critical business function. Click any workflow to see detailed automation architecture.

01

Keep identity distinct from spend and egress

Led by: Identity Operator

KYA answers who the agent is and which operator/principal it is attributed to. Spend policy answers how much it may pay (cap, clock, revoke). Harness permission answers which connectors and network egress the host grants. Do not collapse those three planes. A payment capability is not an identity document; an egress allowlist is not KYA. See /playbooks/agent-payments-spend-policy/ and /playbooks/harness-permission-outside-agent/.

Sub-Agents
Spend-Policy OperatorHost Authority
Skills Required
KYA (interop in progress)Spend mandatesHarness grants
Human TouchpointMap identity, spend, and egress as three control planes before onboarding an agent to a network
02

Inventory the three named protocols

Led by: Identity Operator

The collaboration announcement names protocols already rolled out: Visa Trusted Agent Protocol, Mastercard Verifiable Intent, and Ant International Agentic Mobile Protocol. Record which rail your agent actually hits today. Do not invent a fourth “IZHC KYA cert.” Do not quote executives. The work now is exploring common principles across those protocols, not replacing them.

Sub-Agents
Protocol Inventory
Skills Required
Visa TAPMastercard Verifiable IntentAnt AMP
Human TouchpointList which protocol each payment or wallet rail actually uses
03

Treat Ant / Mastercard / Visa KYA as in progress

Led by: Identity Operator

As of the 2026-09-10 announcement, the three organizations have begun collaboration on a KYA interoperability framework: shared principles, while each network preserves its own verification and decisioning. BuildFin.ai (MAS-convened) and the SAFR framework are named as the Singapore collaboration venue. There is no public technical spec, governance body, or rollout date in the announcement. Do not block launch on a finished shared cert that does not exist. Do not treat unsigned press as a live standard.

Sub-Agents
Interop Watch
Skills Required
KYA interoperability (in progress)BuildFin.ai / SAFR (venue)
Human TouchpointCalendar the collaboration; do not claim a cross-network KYA cert you cannot present
04

Design for the three announced themes

Led by: Identity Operator

The announcement centers KYA collaboration on: (1) cross-network operator traceability — each agent linked to a validated operator, cardholder, or business/organization; (2) shared certification requirements — security and behavioral assessment so the agent operates as expected; (3) continuous transaction monitoring — identity plus transaction signals for ongoing assessment. Use these as operator design themes. Implement what your current rail actually supports; do not invent a shared certification API.

Sub-Agents
Traceability StoreMonitoring
Skills Required
Operator attributionContinuous monitoring
Human TouchpointRecord the human/org principal behind each agent; keep monitoring on the identity plane
05

Pair KYA with Connections ownership

Led by: Connections Operator

LangChain Connections (Managed Deep Agents) stores named credentials in the LangSmith workspace. Owner is independent of credential type: agent-owned (shared by every caller; service-account path) vs caller/user-owned (resolved per person at runtime; on-behalf-of path). Ownership is fixed at create (`mda connections create`) and does not change later. `connections.get()` pauses for an OAuth grant when the caller has none. Match the identity you want on the ticket/charge (bot vs person) to the connection owner. See /resources/tools/langchain-managed-deep-agents/.

Sub-Agents
Identity Operator
Skills Required
LangChain ConnectionsAgent-owned vs caller-owned
Human TouchpointChoose agent-owned vs caller-owned when creating the connection; it will not change later
06

Do not ship a fake KYA badge

Led by: Identity Operator

Until networks publish interoperable verification you can actually present, keep your own operator attribution, Connections ownership, and rail-specific protocol. The McKinsey US$3–5T-by-2030 figure in the announcement is a cited projection of agent-orchestrated consumer commerce — not an Institute TAM and not a reason to skip identity. Revoke Connections and spend mandates on a separate clock from identity records.

Sub-Agents
Connections Operator
Skills Required
KYA (in progress)LangChain Connections
Human TouchpointNo marketing claim of a finished KYA standard; cite McKinsey only as the announcement’s source
07

Treat workload and agent credentials as the blast radius

Led by: Identity Operator

Agent and machine-to-machine credentials are the blast radius. WorkOS (2 Oct 2026) summarizes Microsoft Security Research (25 Sep) on Storm-3168 (Sysdig’s JADEPUFFER actor): two compromised Azure service principals enumerated a tenant for more than 15 hours, then deleted most of 100+ storage accounts plus a Key Vault, Function App, and App Service plan in about 7 minutes. No Azure CVE — the roles were already assigned. Likely entry: a client secret posted in a public GitHub issue, later edited out but still valid in edit history. Resource locks / deletion protection blocked some deletes; SQL deletes failed on an unsupported API version. Operator constraints: edit is not revoke — rotate any publicly exposed secret; prefer managed identity or federation over long-lived client secrets; narrow Contributor and delete roles; put CanNotDelete locks on critical resources; alert on unusual workload-identity reads; keep dual-active secrets so rotation is routine. Pair with spend-policy principals on /playbooks/agent-payments-spend-policy/.

Sub-Agents
Workload IdentitySecret Rotation
Skills Required
Managed identity / federationCanNotDelete locksSecret rotation
Human TouchpointRotate any exposed secret immediately; do not treat an edited-out leak as revoked