Vigilhold / Permissions HomeDocsTrustFAQSign in →

Access control

Who can do what

Vigilhold uses a four-level role model with per-member permission overrides. Every sensitive action is gated at the API layer — no UI-only restrictions.

Owner
Full control. Responsible for billing, security policy, and org-wide settings.
Admin
All operational actions except billing and ownership-level config. Can manage team.
Analyst
Detect and investigate. Can view audit, manage alerts. Cannot execute containment.
Viewer
Read-only. Sees servers, alerts, timeline. Cannot take any action.

This matrix shows role defaults — the permissions each role has out of the box. Actual team member assignments and per-member overrides are managed in Team.

Detect

Action Owner Admin Analyst Viewer

View fleet — servers, metrics, live status

Read-only access to all connected servers and their health.

Owner Admin Analyst Viewer

View alerts

See security events and their severity.

Owner Admin Analyst Viewer

Acknowledge / snooze alerts

Mark alerts as reviewed; suppress repeat noise.

Owner Admin Analyst Viewer

View network connections and port data

Read active connections, listening ports, and IP bans.

Owner Admin Analyst Viewer

View detection coverage (MITRE ATT&CK)

See which attack techniques Vigilhold detects vs. has no visibility into.

Owner Admin Analyst Viewer

Contain

Action Owner Admin Analyst Viewer

View override queue and pending AI actions

See what the AI recommended and what is awaiting human approval.

Owner Admin Analyst Viewer

Approve or deny AI-recommended actions

Decide whether a queued AI action should execute.

Needs the "approve actions" permission. Admins have it by default; an Analyst can be granted it.

Owner Admin Analyst Viewer

Kill a process on a server

Terminate a running process remotely.

Owner Admin Analyst Viewer

Ban an IP address

Block an IP address on a server.

Owner Admin Analyst Viewer

Enable or disable server lockdown

Lock down a server to drop all non-approved traffic.

Owner Admin Analyst Viewer

Run a full-surface lockdown

Immediately isolate a server from the network.

Owner Admin Analyst Viewer

View investigations

See open investigation cases and their current phase.

Owner Admin Analyst Viewer

Manage and close investigations

Progress, conclude, or close open cases.

Owner Admin Analyst Viewer

Evidence

Action Owner Admin Analyst Viewer

View audit log

Read every action taken — who, what, when, outcome.

Viewer role cannot access audit data. Analyst can with can_view_audit permission.

Owner Admin Analyst Viewer

Export audit log

Download audit records as JSON or CSV.

Analysts can export when they have audit access.

Owner Admin Analyst Viewer

Verify audit chain integrity

Cryptographically verify the audit trail has not been tampered with.

Owner-only. Requires full re-authentication.

Owner Admin Analyst Viewer

Generate compliance reports (CIS, SOC 2, PCI)

Export evidence bundles and posture scores for auditors.

Owner Admin Analyst Viewer

View timeline and event correlation

Correlate alerts, actions, and metric spikes on a shared timeline.

Owner Admin Analyst Viewer

Configure

Action Owner Admin Analyst Viewer

Manage alert rules

Create, edit, or delete alert rules and thresholds.

Owner Admin Analyst Viewer

Manage team members and roles

Invite users, change roles, revoke access.

Owner Admin Analyst Viewer

Set per-member permission overrides

Grant or revoke individual permissions beyond role defaults.

Admins can set overrides only within their own permissions.

Owner Admin Analyst Viewer

Configure integrations (Slack, PagerDuty, webhooks)

Connect Vigilhold to notification and ticketing systems.

Owner Admin Analyst Viewer

Manage billing and subscription

Change plan, update payment method, view invoices.

Owner Admin Analyst Viewer

Configure SSO / SAML / SCIM

Set up identity provider integration and directory sync.

Owner Admin Analyst Viewer

Configure automation policy (Assist / Autopilot)

Set how aggressively Vigilhold acts autonomously.

Owner Admin Analyst Viewer

Manage API keys

Create, view, and revoke API keys. Key values shown only once at creation.

Owner-only.

Owner Admin Analyst Viewer

Manage vault secrets

Store and retrieve encrypted credentials and tokens.

Owner Admin Analyst Viewer

Emergency

Action Owner Admin Analyst Viewer

Emergency access (break-glass)

Temporary elevated access for locked-out accounts. Requires re-authentication and is fully audited.

Emergency sessions are restricted — cannot vault-reveal, cannot write to config.

Owner Admin Analyst Viewer

Approve two-person actions

Second-factor human approval for highest-risk destructive operations.

Needs the "approve actions" permission, which Admins have by default.

Owner Admin Analyst Viewer

Roll back a destructive action

Restore system state after an AI or human action is confirmed harmful.

Owner Admin Analyst Viewer

Choose agent update rings

Put each server in the early, standard, cautious, or paused ring for agent updates.

Releases are signed by Vigilhold; you choose when your servers take them.

Owner Admin Analyst Viewer

Per-member permission overrides

Org Owners can grant or revoke individual permissions for any team member beyond their role defaults. Admins can do the same within their own permissions. For example, an Analyst can be granted can_approve_actions to serve as a second approver for two-person operations, without being promoted to Admin. Overrides are stored per-member and reflected immediately — no session restart required.

Permission changes are audited. Every grant or revocation is recorded in the audit log.

API keys

No scopes

A key with no scopes is rejected. Every key must name the areas it can use.

Scoped keys

A write scope is required for any state-changing operation, and each scope covers one area of the product (e.g. alerts:write only).

API key values are shown once at creation time and cannot be retrieved again. Key inventory is Owner-only.

System administrators

Vigilhold system admins (Vigilhold staff) bypass org-level permission checks and can access any org. Every change staff make in a customer's organization is logged. Single-tenant deployments: contact us.

Full trust and security overview →