Overview
The Jenkins integration polls the Jenkins REST API and the Audit Trail Plugin log to collect:
- Job runs, build outcomes, and pipeline triggers
- Job and view configuration changes
- User logins and permission changes
- Plugin and credential modifications
- Master/agent connection events
Prerequisites
- A Jenkins controller reachable from Atatus (publicly accessible URL or via VPC peering).
- Jenkins Audit Trail Plugin installed (recommended) for richer event coverage.
- A Jenkins user with Overall → Read permission and access to the audit log.
Step 1: Install and configure the Audit Trail plugin
- Sign in to Jenkins as an administrator.
- Go to Manage Jenkins → Plugins → Available plugins.
- Search for Audit Trail, install it, and restart Jenkins if prompted.
- Go to Manage Jenkins → System → Audit Trail and add a Log file logger or a Console logger so events are captured.
Step 2: Generate an API token
- Click your username in the top-right and choose Configure.
- Under API Token, click Add new Token, name it
atatus-siem, and click Generate. - Copy the token value immediately.
Step 3: Connect Jenkins in Atatus
- In Atatus, go to Security → Cloud SIEM → Integrations.
- Locate the Jenkins card and click Connect.
- Fill in the form:
| Field | Description | Example |
|---|---|---|
| Jenkins URL | Base URL of your Jenkins controller. | https://jenkins.example.com |
| Username | Jenkins user that owns the API token. | atatus-siem |
| API Token | The token generated in Step 2. | •••••••• |
| Poll Interval (minutes) | How often to fetch new events. | 5 |
| Enabled | Turn collection on. | true |
- Click Connect.
Verification
- The Jenkins card shows Configured.
- Audit and build events appear in Security → Cloud SIEM → Audit Logs → Events with source
jenkins.
+1-415-800-4104