veirox connector

Manage Connect connectors

Synopsis

veirox connector <subcommand> [args] [flags]

Description

Manage Connect connectors

Subcommands

CommandDescription
veirox connector add <name>Register a new connector
veirox connector auth-events <connector-id>Show recent auth events for a connector
veirox connector enroll <connector-id>Issue an enrollment token and (by default) wait for the connector to come online
veirox connector info <connector-id>Show one connector
veirox connector listList connectors
veirox connector logs <connector-id>Show recent commands run via this connector
veirox connector policyInspect or simulate connector policy
veirox connector revoke <connector-id>Revoke a connector's mTLS credential
veirox connector rm <connector-id>Delete a connector
veirox connector update <connector-id>Update a connector
veirox connector upstreamInspect connector upstreams

veirox connector add <name>

Register a new connector

FlagTypeDefaultDescription
--connector-contextstringconnector-facing context blob
--deny-commandstringSlice[]additional denylist entries
--descriptionstringhuman-readable description
--labelstringSlice[]key=value label (repeat for multiple)
veirox connector add prod-bastion --description 'prod jumpbox' --label env=prod

veirox connector auth-events <connector-id>

Show recent auth events for a connector

FlagTypeDefaultDescription
--limitint0page size
--offsetint0pagination offset
veirox connector auth-events <uuid> --limit 25

veirox connector enroll <connector-id>

Issue an enrollment token and (by default) wait for the connector to come online

FlagTypeDefaultDescription
--no-openboolfalsedon't try to open the install URL
--print-onlyboolfalseprint install command and exit
--runtimestringsystemdconnector runtime: systemd | docker | manual
veirox connector enroll <uuid> --runtime systemd

veirox connector info <connector-id>

Show one connector

veirox connector info <uuid>

veirox connector list

List connectors

FlagTypeDefaultDescription
--limitint0page size
--offsetint0pagination offset
veirox connector list --limit 25

veirox connector logs <connector-id>

Show recent commands run via this connector

FlagTypeDefaultDescription
--limitint0page size
--offsetint0pagination offset
veirox connector logs <uuid> --limit 25

veirox connector policy

Inspect or simulate connector policy

veirox connector revoke <connector-id>

Revoke a connector's mTLS credential

FlagTypeDefaultDescription
--yesboolfalseconfirm revoke
veirox connector revoke <uuid> --yes

veirox connector rm <connector-id>

Delete a connector

FlagTypeDefaultDescription
--yesboolfalseconfirm deletion
veirox connector rm <uuid> --yes

veirox connector update <connector-id>

Update a connector

FlagTypeDefaultDescription
--connector-contextstringnew connector context
--descriptionstringnew description
--labelstringSlice[]new key=value labels
--namestringnew name
veirox connector update <uuid> --name new-name --label env=stg

veirox connector upstream

Inspect connector upstreams

Exit codes

CodeMeaning
0Success.
1Generic error (network, API 5xx).
2Validation error (bad flag, missing required arg).
3Unauthenticated — run veirox login or set VEIROX_API_KEY.
4Not found (resource does not exist in this project).
5Permission denied (your role / API key lacks the scope).

See also