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 ViewerView fleet — servers, metrics, live status
Read-only access to all connected servers and their health.
Owner Admin Analyst ViewerView alerts
See security events and their severity.
Owner Admin Analyst ViewerAcknowledge / snooze alerts
Mark alerts as reviewed; suppress repeat noise.
Owner Admin Analyst ViewerView network connections and port data
Read active connections, listening ports, and IP bans.
Owner Admin Analyst ViewerView detection coverage (MITRE ATT&CK)
See which attack techniques Vigilhold detects vs. has no visibility into.
Owner Admin Analyst ViewerContain
Action Owner Admin Analyst ViewerView override queue and pending AI actions
See what the AI recommended and what is awaiting human approval.
Owner Admin Analyst ViewerApprove 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 ViewerKill a process on a server
Terminate a running process remotely.
Owner Admin Analyst ViewerBan an IP address
Block an IP address on a server.
Owner Admin Analyst ViewerEnable or disable server lockdown
Lock down a server to drop all non-approved traffic.
Owner Admin Analyst ViewerRun a full-surface lockdown
Immediately isolate a server from the network.
Owner Admin Analyst ViewerView investigations
See open investigation cases and their current phase.
Owner Admin Analyst ViewerManage and close investigations
Progress, conclude, or close open cases.
Owner Admin Analyst ViewerEvidence
Action Owner Admin Analyst ViewerView 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 ViewerExport audit log
Download audit records as JSON or CSV.
Analysts can export when they have audit access.
Owner Admin Analyst ViewerVerify audit chain integrity
Cryptographically verify the audit trail has not been tampered with.
Owner-only. Requires full re-authentication.
Owner Admin Analyst ViewerGenerate compliance reports (CIS, SOC 2, PCI)
Export evidence bundles and posture scores for auditors.
Owner Admin Analyst ViewerView timeline and event correlation
Correlate alerts, actions, and metric spikes on a shared timeline.
Owner Admin Analyst ViewerConfigure
Action Owner Admin Analyst ViewerManage alert rules
Create, edit, or delete alert rules and thresholds.
Owner Admin Analyst ViewerManage team members and roles
Invite users, change roles, revoke access.
Owner Admin Analyst ViewerSet per-member permission overrides
Grant or revoke individual permissions beyond role defaults.
Admins can set overrides only within their own permissions.
Owner Admin Analyst ViewerConfigure integrations (Slack, PagerDuty, webhooks)
Connect Vigilhold to notification and ticketing systems.
Owner Admin Analyst ViewerManage billing and subscription
Change plan, update payment method, view invoices.
Owner Admin Analyst ViewerConfigure SSO / SAML / SCIM
Set up identity provider integration and directory sync.
Owner Admin Analyst ViewerConfigure automation policy (Assist / Autopilot)
Set how aggressively Vigilhold acts autonomously.
Owner Admin Analyst ViewerManage API keys
Create, view, and revoke API keys. Key values shown only once at creation.
Owner-only.
Owner Admin Analyst ViewerManage vault secrets
Store and retrieve encrypted credentials and tokens.
Owner Admin Analyst ViewerEmergency
Action Owner Admin Analyst ViewerEmergency 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 ViewerApprove 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 ViewerRoll back a destructive action
Restore system state after an AI or human action is confirmed harmful.
Owner Admin Analyst ViewerChoose 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 ViewerPer-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 →