Accounts, connections, and product access
Shared sign-in does not share product authorization. Keep the following boundaries explicit in your application.
Application login
Your application initiates an OIDC Authorization Code flow with PKCE through a maintained library. Its backend validates the callback, owns its local session, and enforces its own cookies, CSRF controls, expiration, and membership policy. See web sign-in.
Product connection
IdentityProductUserClient verifies a separate resource token and connects the verified actor to a registered product. The token must be bound to the same independently established subject, broker session, and authentication time. The connection returns an opaque product subject.
An email match, a successful login, or a product connection does not enroll a person in your organization, household, workspace, or other application context. Your product must make that membership decision explicitly.
Lifecycle service
IdentityServiceClient is a machine principal. It reads status and lifecycle events only within its registered scope. It is not a user token and cannot act as an authenticated customer.
IdentityConsumer and a product-owned store can maintain revocation floors, current snapshots, an inbox, a cursor, and pending acknowledgements. Read the lifecycle guide before using the resulting projection in an authorization decision.
Owner account operations
IdentityOwnerClient handles its approved owner account/session operations. Its authority must come from an independently validated, active backend session. A command may return a pending operation. Acceptance of a command is not proof of provider-wide completion.
Keep data local to the product
Identity owns the shared account and its supported account lifecycle. Each product owns its application sessions, memberships, domain permissions, data, and final effects. An Identity credential is not a universal bearer for other product APIs.
This SDK does not establish personhood, prove that an actor is human, identify an executing AI model, or implement a general agent-delegation platform.
Public preview 0.7.0-preview.1 · Not production ready · Status and releases