# 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](https://docs.straza.ai/reference/cli/strazactl/strazactl_api-token/index.md): Manage long-lived admin API tokens, the one credential for automation, connectors and an identity manager's SCIM push
* [strazactl approvals](https://docs.straza.ai/reference/cli/strazactl/strazactl_approvals/index.md): List approval requests
* [strazactl approvers](https://docs.straza.ai/reference/cli/strazactl/strazactl_approvers/index.md): Inspect and revoke enrolled approver phones and browsers
* [strazactl apps](https://docs.straza.ai/reference/cli/strazactl/strazactl_apps/index.md): Manage MCP servers
* [strazactl assign](https://docs.straza.ai/reference/cli/strazactl/strazactl_assign/index.md): Assign a role to a user
* [strazactl attestation](https://docs.straza.ai/reference/cli/strazactl/strazactl_attestation/index.md): Manage the managed-install expected-hash registry
* [strazactl audit](https://docs.straza.ai/reference/cli/strazactl/strazactl_audit/index.md): Query and verify the audit log
* [strazactl bindings](https://docs.straza.ai/reference/cli/strazactl/strazactl_bindings/index.md): List the access rows of roles on servers
* [strazactl catalog](https://docs.straza.ai/reference/cli/strazactl/strazactl_catalog/index.md): Inspect the effective tool catalog
* [strazactl connect](https://docs.straza.ai/reference/cli/strazactl/strazactl_connect/index.md): Connect a user's token to an MCP server; no server lists the user's connections
* [strazactl devices](https://docs.straza.ai/reference/cli/strazactl/strazactl_devices/index.md): Inspect and revoke a user's enrolled devices
* [strazactl disconnect](https://docs.straza.ai/reference/cli/strazactl/strazactl_disconnect/index.md): Remove a user's connection to a server
* [strazactl drafts](https://docs.straza.ai/reference/cli/strazactl/strazactl_drafts/index.md): Check, store and review drafts of changes to MCP servers, roles, access rows and policy sets
* [strazactl packs](https://docs.straza.ai/reference/cli/strazactl/strazactl_packs/index.md): Manage knowledge packs
* [strazactl policy](https://docs.straza.ai/reference/cli/strazactl/strazactl_policy/index.md): Validate and manage PolicySets
* [strazactl roles](https://docs.straza.ai/reference/cli/strazactl/strazactl_roles/index.md): Manage roles
* [strazactl sessions](https://docs.straza.ai/reference/cli/strazactl/strazactl_sessions/index.md): Inspect and revoke sessions
* [strazactl signing-keys](https://docs.straza.ai/reference/cli/strazactl/strazactl_signing-keys/index.md): List, rotate, promote and retire signing keys, and print a client assertion key's certificate
* [strazactl sinks](https://docs.straza.ai/reference/cli/strazactl/strazactl_sinks/index.md): Inspect SIEM sinks and replay parked (dead-letter) events
* [strazactl spec](https://docs.straza.ai/reference/cli/strazactl/strazactl_spec/index.md): Work with the Straza spec artifacts
* [strazactl status](https://docs.straza.ai/reference/cli/strazactl/strazactl_status/index.md): Report the resolved target server, then strazad health and version
* [strazactl transcripts](https://docs.straza.ai/reference/cli/strazactl/strazactl_transcripts/index.md): Search recorded conversations by text or by a secret's value
* [strazactl unassign](https://docs.straza.ai/reference/cli/strazactl/strazactl_unassign/index.md): Take a role away from a user
* [strazactl users](https://docs.straza.ai/reference/cli/strazactl/strazactl_users/index.md): Manage users
* [strazactl version](https://docs.straza.ai/reference/cli/strazactl/strazactl_version/index.md): Print version information


- [strazactl api-token](https://docs.straza.ai/reference/cli/strazactl/strazactl_api-token/index.md): Manage long-lived admin API tokens, the one credential for automation, connectors and an identity manager's SCIM push
- [strazactl api-token create](https://docs.straza.ai/reference/cli/strazactl/strazactl_api-token_create/index.md): Mint a long-lived admin API token (shown exactly once)
- [strazactl api-token list](https://docs.straza.ai/reference/cli/strazactl/strazactl_api-token_list/index.md): List admin API token metadata
- [strazactl api-token revoke](https://docs.straza.ai/reference/cli/strazactl/strazactl_api-token_revoke/index.md): Revoke an admin API token by its name or its id
- [strazactl approvals](https://docs.straza.ai/reference/cli/strazactl/strazactl_approvals/index.md): List approval requests
- [strazactl approvals list](https://docs.straza.ai/reference/cli/strazactl/strazactl_approvals_list/index.md): List approval requests (default: pending)
- [strazactl approvers](https://docs.straza.ai/reference/cli/strazactl/strazactl_approvers/index.md): Inspect and revoke enrolled approver phones and browsers
- [strazactl approvers list](https://docs.straza.ai/reference/cli/strazactl/strazactl_approvers_list/index.md): List enrolled approver phones and browsers, with owner, key posture and push routes
- [strazactl approvers revoke](https://docs.straza.ai/reference/cli/strazactl/strazactl_approvers_revoke/index.md): Revoke an enrolled approver device (its approver credential fails on the next call)
- [strazactl apps](https://docs.straza.ai/reference/cli/strazactl/strazactl_apps/index.md): Manage MCP servers
- [strazactl apps bind](https://docs.straza.ai/reference/cli/strazactl/strazactl_apps_bind/index.md): Give a role the server owns access to its tools (a tool without access does not exist for the role)
- [strazactl apps disable](https://docs.straza.ai/reference/cli/strazactl/strazactl_apps_disable/index.md): Pause a server: stop it and keep it stopped until re-enabled
- [strazactl apps enable](https://docs.straza.ai/reference/cli/strazactl/strazactl_apps_enable/index.md): Clear a server's admin pause and (re)start it
- [strazactl apps export](https://docs.straza.ai/reference/cli/strazactl/strazactl_apps_export/index.md): Print a server's stored manifest as app.yaml on stdout, the document apps install takes
- [strazactl apps import](https://docs.straza.ai/reference/cli/strazactl/strazactl_apps_import/index.md): Convert an MCP registry server.json into an App manifest, by the registry import rules of the app manifest specification
- [strazactl apps install](https://docs.straza.ai/reference/cli/strazactl/strazactl_apps_install/index.md): Install or update MCP servers from app.yaml manifests
- [strazactl apps list](https://docs.straza.ai/reference/cli/strazactl/strazactl_apps_list/index.md): List MCP servers with live status, the reason behind it and the roles that reach each
- [strazactl apps logs](https://docs.straza.ai/reference/cli/strazactl/strazactl_apps_logs/index.md): Show recent runtime log lines for a server
- [strazactl apps objects](https://docs.straza.ai/reference/cli/strazactl/strazactl_apps_objects/index.md): Show what Straza last listed on a server, such as its repos, and the roles that cover each
- [strazactl apps objects draft](https://docs.straza.ai/reference/cli/strazactl/strazactl_apps_objects_draft/index.md): Open a draft that pins the objects a server declares in its tool marks
- [strazactl apps objects refresh](https://docs.straza.ai/reference/cli/strazactl/strazactl_apps_objects_refresh/index.md): List a server's objects again now instead of at the next 10-minute listing
- [strazactl apps recheck](https://docs.straza.ai/reference/cli/strazactl/strazactl_apps_recheck/index.md): Trigger an immediate health probe and print the refreshed state
- [strazactl apps remove](https://docs.straza.ai/reference/cli/strazactl/strazactl_apps_remove/index.md): Stop and remove a server
- [strazactl apps secret](https://docs.straza.ai/reference/cli/strazactl/strazactl_apps_secret/index.md): Manage a server's static secret (injected gateway-side, never client-visible)
- [strazactl apps secret remove](https://docs.straza.ai/reference/cli/strazactl/strazactl_apps_secret_remove/index.md): Remove the server's own secret, with --role the override one role uses, or with --listing the listing credential
- [strazactl apps secret set](https://docs.straza.ai/reference/cli/strazactl/strazactl_apps_secret_set/index.md): Store the server's own secret, with --role the override one role uses instead, or with --listing the listing credential
- [strazactl apps show](https://docs.straza.ai/reference/cli/strazactl/strazactl_apps_show/index.md): Show one server in full: health and its reason, tools, who has access and how each tool runs, the stored secrets
- [strazactl apps tools](https://docs.straza.ai/reference/cli/strazactl/strazactl_apps_tools/index.md): List exposed MCP tools with their upstream descriptions, every server or one
- [strazactl apps unbind](https://docs.straza.ai/reference/cli/strazactl/strazactl_apps_unbind/index.md): Remove a role's access to a server (the id is in bindings list and apps show)
- [strazactl assign](https://docs.straza.ai/reference/cli/strazactl/strazactl_assign/index.md): Assign a role to a user
- [strazactl attestation](https://docs.straza.ai/reference/cli/strazactl/strazactl_attestation/index.md): Manage the managed-install expected-hash registry
- [strazactl attestation add](https://docs.straza.ai/reference/cli/strazactl/strazactl_attestation_add/index.md): Register an expected measurement (allowed-set entry)
- [strazactl attestation list](https://docs.straza.ai/reference/cli/strazactl/strazactl_attestation_list/index.md): List registered measurements
- [strazactl attestation rm](https://docs.straza.ai/reference/cli/strazactl/strazactl_attestation_rm/index.md): Remove a measurement from the registry
- [strazactl audit](https://docs.straza.ai/reference/cli/strazactl/strazactl_audit/index.md): Query and verify the audit log
- [strazactl audit tail](https://docs.straza.ai/reference/cli/strazactl/strazactl_audit_tail/index.md): Show the most recent audit records
- [strazactl audit verify](https://docs.straza.ai/reference/cli/strazactl/strazactl_audit_verify/index.md): Verify the audit hash chain end to end
- [strazactl bindings](https://docs.straza.ai/reference/cli/strazactl/strazactl_bindings/index.md): List the access rows of roles on servers
- [strazactl bindings list](https://docs.straza.ai/reference/cli/strazactl/strazactl_bindings_list/index.md): List the access rows
- [strazactl catalog](https://docs.straza.ai/reference/cli/strazactl/strazactl_catalog/index.md): Inspect the effective tool catalog
- [strazactl catalog preview](https://docs.straza.ai/reference/cli/strazactl/strazactl_catalog_preview/index.md): Preview the tool catalog a subject would see: named roles, a real user's roles, or both
- [strazactl connect](https://docs.straza.ai/reference/cli/strazactl/strazactl_connect/index.md): Connect a user's token to an MCP server; no server lists the user's connections
- [strazactl devices](https://docs.straza.ai/reference/cli/strazactl/strazactl_devices/index.md): Inspect and revoke a user's enrolled devices
- [strazactl devices list](https://docs.straza.ai/reference/cli/strazactl/strazactl_devices_list/index.md): List a user's enrolled devices
- [strazactl devices revoke](https://docs.straza.ai/reference/cli/strazactl/strazactl_devices_revoke/index.md): Revoke a device enrollment (it stops starting sessions)
- [strazactl disconnect](https://docs.straza.ai/reference/cli/strazactl/strazactl_disconnect/index.md): Remove a user's connection to a server
- [strazactl drafts](https://docs.straza.ai/reference/cli/strazactl/strazactl_drafts/index.md): Check, store and review drafts of changes to MCP servers, roles, access rows and policy sets
- [strazactl drafts check](https://docs.straza.ai/reference/cli/strazactl/strazactl_drafts_check/index.md): Check documents against live state and print the verdict, storing nothing
- [strazactl drafts create](https://docs.straza.ai/reference/cli/strazactl/strazactl_drafts_create/index.md): Store the documents as a new draft and print its verdict
- [strazactl drafts discard](https://docs.straza.ai/reference/cli/strazactl/strazactl_drafts_discard/index.md): Discard an open draft, which changes nothing live
- [strazactl drafts list](https://docs.straza.ai/reference/cli/strazactl/strazactl_drafts_list/index.md): List drafts, newest first, the open ones unless --state names others
- [strazactl drafts rebase](https://docs.straza.ai/reference/cli/strazactl/strazactl_drafts_rebase/index.md): Check a draft again on live state, keeping the fields it changes and taking every other field from live
- [strazactl drafts revert](https://docs.straza.ai/reference/cli/strazactl/strazactl_drafts_revert/index.md): Make a new draft that undoes a published one, checked like any other
- [strazactl drafts show](https://docs.straza.ai/reference/cli/strazactl/strazactl_drafts_show/index.md): Show a draft: who proposed it, each object against live state, its verdict and who gains what
- [strazactl drafts update](https://docs.straza.ai/reference/cli/strazactl/strazactl_drafts_update/index.md): Replace an open draft's documents with a new revision and print its verdict
- [strazactl packs](https://docs.straza.ai/reference/cli/strazactl/strazactl_packs/index.md): Manage knowledge packs
- [strazactl packs bind](https://docs.straza.ai/reference/cli/strazactl/strazactl_packs_bind/index.md): Bind a knowledge pack to a role
- [strazactl packs create](https://docs.straza.ai/reference/cli/strazactl/strazactl_packs_create/index.md): Create a knowledge pack from --content or --file
- [strazactl packs delete](https://docs.straza.ai/reference/cli/strazactl/strazactl_packs_delete/index.md): Delete a knowledge pack that no role is bound to (unbind it first)
- [strazactl packs list](https://docs.straza.ai/reference/cli/strazactl/strazactl_packs_list/index.md): List knowledge packs
- [strazactl packs unbind](https://docs.straza.ai/reference/cli/strazactl/strazactl_packs_unbind/index.md): Unbind a knowledge pack from a role
- [strazactl policy](https://docs.straza.ai/reference/cli/strazactl/strazactl_policy/index.md): Validate and manage PolicySets
- [strazactl policy activate](https://docs.straza.ai/reference/cli/strazactl/strazactl_policy_activate/index.md): Publish one PolicySet's stored text after the server's checks, leaving every other set as published
- [strazactl policy apply](https://docs.straza.ai/reference/cli/strazactl/strazactl_policy_apply/index.md): Upload PolicySet YAML: a new set is stored off, and edits to a live set wait for policy activate
- [strazactl policy deactivate](https://docs.straza.ai/reference/cli/strazactl/strazactl_policy_deactivate/index.md): Turn a PolicySet off and recompile and distribute the snapshot
- [strazactl policy delete](https://docs.straza.ai/reference/cli/strazactl/strazactl_policy_delete/index.md): Delete a PolicySet that is off (turn a live one off first)
- [strazactl policy diff](https://docs.straza.ai/reference/cli/strazactl/strazactl_policy_diff/index.md): Diff the stored PolicySet against a local file
- [strazactl policy list](https://docs.straza.ai/reference/cli/strazactl/strazactl_policy_list/index.md): List stored PolicySets
- [strazactl policy show](https://docs.straza.ai/reference/cli/strazactl/strazactl_policy_show/index.md): Print a stored PolicySet: its story on stderr, the YAML alone on stdout
- [strazactl policy simulate](https://docs.straza.ai/reference/cli/strazactl/strazactl_policy_simulate/index.md): Ask what a call would do for a subject, against the live policies
- [strazactl policy validate](https://docs.straza.ai/reference/cli/strazactl/strazactl_policy_validate/index.md): Validate PolicySet YAML files locally against the v1beta1 spec
- [strazactl roles](https://docs.straza.ai/reference/cli/strazactl/strazactl_roles/index.md): Manage roles
- [strazactl roles create](https://docs.straza.ai/reference/cli/strazactl/strazactl_roles_create/index.md): Create a role
- [strazactl roles delete](https://docs.straza.ai/reference/cli/strazactl/strazactl_roles_delete/index.md): Delete a role; its assignments and access rows go with it
- [strazactl roles export](https://docs.straza.ai/reference/cli/strazactl/strazactl_roles_export/index.md): Print the role's canonical VCS document (spec/objects kind Role) to stdout
- [strazactl roles implications](https://docs.straza.ai/reference/cli/strazactl/strazactl_roles_implications/index.md): List the roles this role composes (holding it also holds these)
- [strazactl roles implications add](https://docs.straza.ai/reference/cli/strazactl/strazactl_roles_implications_add/index.md): Compose one role into another: holding the first also holds the second
- [strazactl roles implications remove](https://docs.straza.ai/reference/cli/strazactl/strazactl_roles_implications_remove/index.md): Stop composing one role into another (holding the first no longer holds the second)
- [strazactl roles list](https://docs.straza.ai/reference/cli/strazactl/strazactl_roles_list/index.md): List roles
- [strazactl roles update](https://docs.straza.ai/reference/cli/strazactl/strazactl_roles_update/index.md): Update a role's description (the name and the kind are fixed at create)
- [strazactl sessions](https://docs.straza.ai/reference/cli/strazactl/strazactl_sessions/index.md): Inspect and revoke sessions
- [strazactl sessions list](https://docs.straza.ai/reference/cli/strazactl/strazactl_sessions_list/index.md): List sessions
- [strazactl sessions revoke](https://docs.straza.ai/reference/cli/strazactl/strazactl_sessions_revoke/index.md): Revoke a session (kill switch)
- [strazactl sessions transcript](https://docs.straza.ai/reference/cli/strazactl/strazactl_sessions_transcript/index.md): Print a session's recorded conversation (recording is policy-opted-in)
- [strazactl signing-keys](https://docs.straza.ai/reference/cli/strazactl/strazactl_signing-keys/index.md): List, rotate, promote and retire signing keys, and print a client assertion key's certificate
- [strazactl signing-keys certificate](https://docs.straza.ai/reference/cli/strazactl/strazactl_signing-keys_certificate/index.md): Print the certificate of a client assertion key, to upload to an Entra agent blueprint
- [strazactl signing-keys list](https://docs.straza.ai/reference/cli/strazactl/strazactl_signing-keys_list/index.md): List every signing key with its purpose and status
- [strazactl signing-keys promote](https://docs.straza.ai/reference/cli/strazactl/strazactl_signing-keys_promote/index.md): Make a staged client assertion key the signing key
- [strazactl signing-keys retire](https://docs.straza.ai/reference/cli/strazactl/strazactl_signing-keys_retire/index.md): Retire one client assertion key at once, for a key that may have been copied
- [strazactl signing-keys rotate](https://docs.straza.ai/reference/cli/strazactl/strazactl_signing-keys_rotate/index.md): Stage a new key of one purpose: a session key promotes itself, a client assertion key waits for promote
- [strazactl sinks](https://docs.straza.ai/reference/cli/strazactl/strazactl_sinks/index.md): Inspect SIEM sinks and replay parked (dead-letter) events
- [strazactl sinks list](https://docs.straza.ai/reference/cli/strazactl/strazactl_sinks_list/index.md): List configured sinks with backlog, parked count, and the last failure
- [strazactl sinks replay](https://docs.straza.ai/reference/cli/strazactl/strazactl_sinks_replay/index.md): Re-deliver a sink's parked events to its receiver, oldest first
- [strazactl spec](https://docs.straza.ai/reference/cli/strazactl/strazactl_spec/index.md): Work with the Straza spec artifacts
- [strazactl spec conformance](https://docs.straza.ai/reference/cli/strazactl/strazactl_spec_conformance/index.md): Replay the published Tier-1 corpus against a hook implementation and score it
- [strazactl spec validate](https://docs.straza.ai/reference/cli/strazactl/strazactl_spec_validate/index.md): Validate documents against the embedded v1beta1 spec validators
- [strazactl status](https://docs.straza.ai/reference/cli/strazactl/strazactl_status/index.md): Report the resolved target server, then strazad health and version
- [strazactl transcripts](https://docs.straza.ai/reference/cli/strazactl/strazactl_transcripts/index.md): Search recorded conversations by text or by a secret's value
- [strazactl transcripts search](https://docs.straza.ai/reference/cli/strazactl/strazactl_transcripts_search/index.md): Find who said what: substring scan and/or exact-value match
- [strazactl unassign](https://docs.straza.ai/reference/cli/strazactl/strazactl_unassign/index.md): Take a role away from a user
- [strazactl users](https://docs.straza.ai/reference/cli/strazactl/strazactl_users/index.md): Manage users
- [strazactl users create](https://docs.straza.ai/reference/cli/strazactl/strazactl_users_create/index.md): Create a local user
- [strazactl users create-nhi](https://docs.straza.ai/reference/cli/strazactl/strazactl_users_create-nhi/index.md): Provision an AI agent or a service account (headless, no password, key-based)
- [strazactl users disable](https://docs.straza.ai/reference/cli/strazactl/strazactl_users_disable/index.md): Disable a user (status disabled, every session revoked, lifted by `strazactl users enable`)
- [strazactl users enable](https://docs.straza.ai/reference/cli/strazactl/strazactl_users_enable/index.md): Enable a disabled user: the status goes back to active, the user's revocations are lifted, and a device still enrolled needs no new enrollment
- [strazactl users entra-agent-id](https://docs.straza.ai/reference/cli/strazactl/strazactl_users_entra-agent-id/index.md): Manage the Entra agent identity an AI agent acts as at Entra
- [strazactl users entra-agent-id set](https://docs.straza.ai/reference/cli/strazactl/strazactl_users_entra-agent-id_set/index.md): Set the client id of the Entra agent identity the agent acts as
- [strazactl users entra-agent-id show](https://docs.straza.ai/reference/cli/strazactl/strazactl_users_entra-agent-id_show/index.md): Show the Entra agent identity the agent acts as
- [strazactl users entra-agent-id unset](https://docs.straza.ai/reference/cli/strazactl/strazactl_users_entra-agent-id_unset/index.md): Clear the agent's Entra agent identity
- [strazactl users list](https://docs.straza.ai/reference/cli/strazactl/strazactl_users_list/index.md): List users
- [strazactl users lock](https://docs.straza.ai/reference/cli/strazactl/strazactl_users_lock/index.md): Lock a user: a revocation that an identity manager cannot lift by enabling the user; the status stays as it is
- [strazactl users nhi-key](https://docs.straza.ai/reference/cli/strazactl/strazactl_users_nhi-key/index.md): Manage an agent identity's headless assertion key (straza keygen prints it)
- [strazactl users nhi-key set](https://docs.straza.ai/reference/cli/strazactl/strazactl_users_nhi-key_set/index.md): Register the agent identity's Ed25519 public key, or rotate it and end the agent's running sessions
- [strazactl users nhi-key unset](https://docs.straza.ai/reference/cli/strazactl/strazactl_users_nhi-key_unset/index.md): Revoke the agent identity's key, which ends its running sessions and refuses its next token request
- [strazactl users set-password](https://docs.straza.ai/reference/cli/strazactl/strazactl_users_set-password/index.md): Set a person's built-in-issuer password (rotation, or a credential for SCIM-born people)
- [strazactl users unlock](https://docs.straza.ai/reference/cli/strazactl/strazactl_users_unlock/index.md): Unlock a user: lift the user's revocations and leave the status as it is, so a disabled user still needs `strazactl users enable`
- [strazactl version](https://docs.straza.ai/reference/cli/strazactl/strazactl_version/index.md): Print version information
