Permissions
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.
| Permission | Needed 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_datetime | Backup age, backup encryption and preference, SQL Agent jobs, discovery's SQL Agent summary |
SELECT on ReportServer.dbo.ExecutionLog3 | The Reporting Services execution log check |
| A login mapping on each linked server | Linked 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.
| Item | Least privilege |
|---|---|
| Account | A domain account, member of the local groups Performance Monitor Users, Event Log Readers and Remote Management Users on each host. Never a local administrator |
| Listener | WinRM over HTTPS on TCP 5986, restricted to the IP address of the Excubius server |
| Authentication | negotiate or ntlm; the collector image has no Kerberos configuration |
| Active Directory checks | A read-only domain account on a host with the Active Directory PowerShell module |
Linux over SSH
Collection over SSH is experimental.
| Item | Least privilege |
|---|---|
| Account | A 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 |
| Journal | Read access to the system journal, such as membership in systemd-journal, for authentication events |
| Host keys | Pinned 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.
| Role | Role ID | Scope | Needed by |
|---|---|---|---|
| Reader | acdd72a7-3385-48ef-bd42-f606fba81ae7 | Each subscription, or a management group | Azure Monitor inventory and fired alerts, Resource Graph checks, Azure Update Manager, cloud posture checks, role assignment changes |
| Monitoring Reader | 43d0d8ad-25c7-4714-9337-8ba259a9fe05 | Same | Platform metrics |
| Security Reader | 39bc4728-0917-49c7-9d2c-d95423bc2eb4 | Same | Defender for Cloud assessments |
| Key Vault Reader, or an access policy with List on secrets, keys and certificates | 21090545-7ca7-4776-b22c-e363652d74d2 | Each key vault | Key Vault expiry, metadata only |
| Data Factory run reader, a custom role | Created in your tenant | The factories or their resource groups | Data 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.
| Permission | Needed by |
|---|---|
RoleManagement.Read.Directory | Privileged roles without multifactor authentication |
AuditLog.Read.All | MFA registration details of users |
IdentityRiskEvent.Read.All | Risky sign-ins |
Application.Read.All | App 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.