Skip to main content
Version: 0.4 · current

Permissions

ReferenceReviewed October 11, 2026
Applies to:Excubius 0.4Roles: Entity admin, Installer (Linux administrator)
PlansFree · Core · Pro · EnterpriseDeploymentSelf-hosted

Every account, key and role you give Excubius only reads, except the two that deliver what you ask for: the Slack bot posts messages and the Jira account creates and comments on issues. This reference lists the least privilege per platform in one place. Grant only what the modules you use need.

SQL Server​

A plain SQL login on every instance and replica, with the same SID on every replica of an availability group. The script is in Prerequisites for availability groups.

PermissionNeeded by
VIEW SERVER STATE, or on SQL Server 2022 and later the role ##MS_ServerStateReader##Performance counters, waits, requests, availability group state, the error log, audit status, database encryption keys
VIEW ANY DEFINITION, or on SQL Server 2022 and later the role ##MS_DefinitionReader##Availability groups, replicas, listeners, files, logins, server roles, linked server login mappings, audits
CONNECT ANY DATABASE (optional)Per-database checks, such as orphaned users, in every user database without a user in each. It gives no access to data
SELECT on msdb.dbo.backupset, sysjobs, sysjobhistory; EXECUTE on msdb.dbo.agent_datetimeBackup age, backup encryption and preference, SQL Agent jobs, discovery's SQL Agent summary
SELECT on ReportServer.dbo.ExecutionLog3The Reporting Services execution log check
A login mapping on each linked serverLinked server tests, which run as the monitoring login

Never sysadmin, securityadmin or db_owner, and never db_datareader on user databases. The instance must accept SQL Server authentication: Windows-integrated authentication is not supported.

Reporting Services portal​

A Windows account (DOMAIN\user) with the Browser role on the folder of the test report, or on the home folder when you test no report. NTLM is used; portals that require Kerberos only, or Extended Protection set to Require, are not supported.

PostgreSQL​

A login role that is a member of pg_monitor, plus the pg_stat_statements extension and read access to pg_hba_file_rules for the full set of checks. Native PostgreSQL collection is not available in this release; see PostgreSQL.

Windows over WinRM​

Collection over WinRM is experimental.

ItemLeast privilege
AccountA domain account, member of the local groups Performance Monitor Users, Event Log Readers and Remote Management Users on each host. Never a local administrator
ListenerWinRM over HTTPS on TCP 5986, restricted to the IP address of the Excubius server
Authenticationnegotiate or ntlm; the collector image has no Kerberos configuration
Active Directory checksA read-only domain account on a host with the Active Directory PowerShell module

Linux over SSH​

Collection over SSH is experimental.

ItemLeast privilege
AccountA dedicated, non-root user in a dedicated group, signing in with a key. The checks do not call sudo; never give the user sudo to a shell
JournalRead access to the system journal, such as membership in systemd-journal, for authentication events
Host keysPinned in the credential's known_hosts option

Azure​

Use the Excubius server's managed identity, or an app registration stored as an Azure service principal credential. Role IDs are those of the Azure built-in roles.

RoleRole IDScopeNeeded by
Readeracdd72a7-3385-48ef-bd42-f606fba81ae7Each subscription, or a management groupAzure Monitor inventory and fired alerts, Resource Graph checks, Azure Update Manager, cloud posture checks, role assignment changes
Monitoring Reader43d0d8ad-25c7-4714-9337-8ba259a9fe05SamePlatform metrics
Security Reader39bc4728-0917-49c7-9d2c-d95423bc2eb4SameDefender for Cloud assessments
Key Vault Reader, or an access policy with List on secrets, keys and certificates21090545-7ca7-4776-b22c-e363652d74d2Each key vaultKey Vault expiry, metadata only
Data Factory run reader, a custom roleCreated in your tenantThe factories or their resource groupsData Factory pipeline runs, trigger runs and integration runtime status

The custom role grants the read actions of Data Factory and the three query actions for runs, trigger runs and integration runtime status, and nothing else. Its definition and the commands to create it are in A read-only role for Data Factory. Do not use the built-in Data Factory Contributor: it includes write access.

Microsoft Graph​

Application permissions of the identity Excubius uses, all read-only, with admin consent.

PermissionNeeded by
RoleManagement.Read.DirectoryPrivileged roles without multifactor authentication
AuditLog.Read.AllMFA registration details of users
IdentityRiskEvent.Read.AllRisky sign-ins
Application.Read.AllApp registration secret expiry

Registration details need Entra ID P1 or P2. Full risk detections need P2; P1 gives basic risk events.

New Relic​

A User API key (NRAK-…) of a user whose role is read only on the account, for example the built-in All product read only role. License, browser and ingest keys do not work. A source in Webhook only mode needs no key.

NinjaOne​

An API client app of the platform API Services (machine-to-machine), with the grant type Client Credentials and the scope Monitoring only. Never Management or Control, which can change devices and run scripts. Registering the webhook URL is a one-time call that an administrator makes with another app, never with this client.

Wazuh​

A read-only Wazuh user with read access to the wazuh-alerts-* and wazuh-states-vulnerabilities-* indices and, optionally, agents:read on the manager API. Excubius sends only searches and the manager's sign-in call.

Jira​

The account behind the Jira credential needs these project permissions in the target projects: Browse projects, Create issues, Add comments and Link issues. No administration right is needed. Excubius never transitions, edits or deletes issues. See Create Jira issues from alerts.

Slack​

A Slack app with a bot token and the scope chat:write. Invite the bot to every channel it posts to. See Configure Slack notifications.