Skip to main content
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).
FieldDescription
Integration NameA label for this connector (e.g. Production Jenkins).
Jenkins URLBase URL of your Jenkins server, e.g. https://jenkins.example.com. Do not include a trailing path.
Jenkins UsernameJenkins user with permission to read jobs and builds.
Jenkins API TokenAPI 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

  1. Sign in to Jenkins as the user you will connect with.
  2. Open your user menu → Configure (or Settings).
  3. Under API Token, click Add new Token, name it (e.g. drdroid), and generate it.
  4. 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.