strazactl
Straza admin CLI
Synopsis
A command that talks to strazad goes to --server, else $STRAZA_SERVER. It sends the admin API token in STRAZA_API_TOKEN, which a person mints in the console under Settings, API tokens, with the scope the commands need and an expiry. strazactl has no sign-in of its own. When the identity provider cannot sign anyone in, the break-glass admin uses Emergency sign-in on the console’s sign-in page and mints a token there. strazactl status sends no credential and needs the server alone.
Every command exits 0 when it did its job and 1 when it did not. An unknown verb exits 1 too. strazactl drafts and strazactl policy diff name other exit codes in their help. A retired verb exits 2 and names what replaced it.
Options
--server string strazad base URL (overrides $STRAZA_SERVER)
Commands
- strazactl api-token: Manage long-lived admin API tokens, the one credential for automation, connectors and an identity manager’s SCIM push
- strazactl approvals: List approval requests
- strazactl approvers: Inspect and revoke enrolled approver phones and browsers
- strazactl apps: Manage MCP servers
- strazactl assign: Assign a role to a user
- strazactl attestation: Manage the managed-install expected-hash registry
- strazactl audit: Query and verify the audit log
- strazactl bindings: List the access rows of roles on servers
- strazactl catalog: Inspect the effective tool catalog
- strazactl connect: Connect a user’s token to an MCP server; no server lists the user’s connections
- strazactl devices: Inspect and revoke a user’s enrolled devices
- strazactl disconnect: Remove a user’s connection to a server
- strazactl drafts: Check, store and review drafts of changes to MCP servers, roles, access rows and policy sets
- strazactl packs: Manage knowledge packs
- strazactl policy: Validate and manage PolicySets
- strazactl roles: Manage roles
- strazactl sessions: Inspect and revoke sessions
- strazactl signing-keys: List, rotate, promote and retire signing keys, and print a client assertion key’s certificate
- strazactl sinks: Inspect SIEM sinks and replay parked (dead-letter) events
- strazactl spec: Work with the Straza spec artifacts
- strazactl status: Report the resolved target server, then strazad health and version
- strazactl transcripts: Search recorded conversations by text or by a secret’s value
- strazactl unassign: Take a role away from a user
- strazactl users: Manage users
- strazactl version: Print version information