Skip to content

access

Manage authentication and agent identities.

grn agentbase access <command> [options]

Available commands

Agent ID

Command Description
agent-id create Create a new agent identity
agent-id list List agent identities
agent-id get Get an agent identity by name
agent-id update Update an agent identity
agent-id use Set the current agent identity
agent-id delete Delete an agent identity

Outbound Auth — Static / API key

Command Description
outbound-auth static create Create a static API key provider
outbound-auth static list List static API key providers
outbound-auth static get Get a static API key provider
outbound-auth static update Update a static API key provider
outbound-auth static delete Delete a static API key provider
outbound-auth static get-key Get the API key for an agent identity

Outbound Auth — Delegated

Command Description
outbound-auth delegated create Create a delegated API key provider
outbound-auth delegated list List delegated API key providers
outbound-auth delegated get Get a delegated API key provider
outbound-auth delegated delete Delete a delegated API key provider
outbound-auth delegated get-key Obtain a delegated API key for an agent identity

Outbound Auth — OAuth2

Command Description
outbound-auth oauth2 create Create an OAuth2 provider
outbound-auth oauth2 list List OAuth2 providers
outbound-auth oauth2 get Get an OAuth2 provider
outbound-auth oauth2 update Update an OAuth2 provider
outbound-auth oauth2 delete Delete an OAuth2 provider
outbound-auth oauth2 m2m-token Get an M2M OAuth2 token
outbound-auth oauth2 3lo-token Get a 3-legged OAuth2 token

Outbound Auth — Managed OAuth2 (read-only)

Platform-managed OAuth2 providers: credentials live server-side and are never exposed, so the surface is read-only plus 3LO token retrieval. Each provider has a fixed callbackUrl the delegated browser flow returns to.

Command Description
outbound-auth managed list List platform-managed OAuth2 providers
outbound-auth managed get Get a platform-managed OAuth2 provider
outbound-auth managed 3lo-token Get a 3-legged OAuth2 token (managed provider)