Jenkins

DrDroid connects to Jenkins so DroidAgent can fetch job and build context when debugging deployment or CI failures. Add the integration from the Jenkins setup page or through the VPC agent.

Connection via dashboard

Open Agent Setup → Integrations → Jenkins, or go directly to aiops.drdroid.io/integrations/jenkins. Choose the authentication type that matches your Jenkins setup:

Jenkins Authentication with Crumb

Use this when your Jenkins instance has CSRF protection enabled (the default on many installations).

Field	Description
Integration Name	A label for this connector (e.g. `Production Jenkins`).
Jenkins URL	Base URL of your Jenkins server, e.g. `https://jenkins.example.com`. Do not include a trailing path.
Jenkins Username	Jenkins user with permission to read jobs and builds.
Jenkins API Token	API token for that user (see below).
Enable Crumb (CSRF Protection)	Turn on so DrDroid sends a valid crumb with each request.

Save and test the connection.

Jenkins Authentication without Crumb

Use this when CSRF protection is disabled or your Jenkins version does not require crumbs for API access. Fill in Integration Name, Jenkins URL, Jenkins Username, and Jenkins API Token the same way as above. Do not enable crumb handling for this connection type.

Create a Jenkins API token

Sign in to Jenkins as the user you will connect with.
Open your user menu → Configure (or Settings).
Under API Token, click Add new Token, name it (e.g. drdroid), and generate it.
Copy the token once and paste it into Jenkins API Token in DrDroid. You cannot view it again after leaving the page.

Use a dedicated service account or bot user with read access to the jobs and folders the agent should inspect.

Connection via VPC agent

If you run DrDroid through the VPC agent, add a Jenkins entry to your secrets.yaml:

connector_name:
  type: "JENKINS"        # do not change
  url: https://jenkins.example.com
  username: your_jenkins_username
  api_token: your_api_token
  crumb: "true"          # optional — "true" if CSRF crumbs are required, "false" otherwise (default)

See the Jenkins section in the credentials template. Restart or reload the agent after updating secrets.

Permissions

Grant the connected user Read access on the jobs, folders, and views you want available during investigations. Avoid admin-only accounts unless your security policy requires it.

GETTING STARTED

SETUP

MONITOR

INTEGRATIONS

FAQ

Open Source

Security & Privacy

Connection via dashboard

Jenkins Authentication with Crumb

Jenkins Authentication without Crumb

Create a Jenkins API token

Connection via VPC agent

Permissions

​Connection via dashboard

​Jenkins Authentication with Crumb

​Jenkins Authentication without Crumb

​Create a Jenkins API token

​Connection via VPC agent

​Permissions

Connection via dashboard

Jenkins Authentication with Crumb

Jenkins Authentication without Crumb

Create a Jenkins API token

Connection via VPC agent

Permissions