Skip to content

OIDC Extensions

Overview

ByWrit extends standard OIDC with three additions:

  1. KYC claims - kyc_verified and verified_at
  2. Agent claims - identity of the AI agent initiating the flow
  3. Discovery extensions - advertise agent claim support

All extensions are additive. Standard OIDC consumers process ByWrit tokens without modification.

These are issuer capabilities. The current self-service SP registration flow is centered on openid, profile, and email, with openid email as the practical default for account creation.

KYC Claims

ClaimTypeDescription
kyc_verifiedbooleanWhether the developer passed KYC
verified_atstring (ISO 8601)When KYC was completed

Scopes

ScopeClaims Returned
openidsub
emailemail, email_verified
kyckyc_verified, verified_at
agentagent_type, agent_model, agent_provider, agent_instance_id