*BETA* Setting up a New Jira Connector for Remediation

Jira connectors for remediation are setup through the use of an Atlassian App that will create tickets in the right Jira project.

Get the required info from Delve

Contact Delve to obtain a custom connector app URL that will be installed in your JIRA Cloud instance. You need to provide us with your project key (the all-caps code used to represent a project, for example, EXPL) and the issue type remediation tasks should be. See https://confluence.atlassian.com/adminjiracloud/issue-types-844500742.html for the list of existing issue types. 

Add the Delve App in Atlassian

You must work with an Atlassian Administrator in order to be able to add apps to your Jira instance that are not from the Jira Marketplace.

Navigate to your Atlassian Settings side panel.

Choose the Apps settings.

Click on Manage Apps.

Under User-installed apps, click Settings.

Select Enable development mode, then click Apply.

Click on Upload App.

In the modal that appears, enter the URL that you were provided by the Delve Team, then click Upload.

Set the Access Rights for the Delve users in JIRA

In order to be able to create tickets on behalf of Delve users in JIRA, the Delve users that exist in JIRA need to have the "Browse Users and Groups" privileges.

The first step is to add these users to a new specific JIRA group (or use an existing group such as "jira-users") and then navigate to your JIRA Global permissions page and to add the correct privileges for this group of users.

JIRA_permissions

If the users don't have sufficient enough access rights, the connector will still create tasks in JIRA but they won't be created on behalf of the Delve users.

Configure Delve to Use this Connector

Find your unique connector app URL from Delve's API.

Log into Delve using your regular credentials and visit the following URL:

https://<YOUR_INSTANCE>.wardenscanner.com/api/v2/connectors

You should obtain the JSON information about your previously set up connectors, including their app URL:

{"items":[{"connectUrl":"https://<UUID>.wardenscanner.com/delve.json","family":"JIRA","id":"<UUID>","name":"JIRA Connector","status":"fail","statusUrl":"https://<UUID>.wardenscanner.com/status"}]}

You can find out what the status of your connector is by visiting the following URL:

https://<UUID>.wardenscanner.com/status

For instance if you have not completed the setup and authorized your Client ID to do API requests on your behalf, you will see the following "unusable credentials" status.

{"status": "fail", "details": {"monitor:status": [{"status": "fail", "monitor": "warden.monitor", "reason": "Unusable credentials"}, {"status": "pass", "monitor": "jira.monitor", "reason": null}]}}

Authorize your Client ID to do API requests on your behalf

The final step to activate your connector is to authorize your Client ID for a certain period of time to be able to do API calls on your behalf.

Once logged in Delve, you can start the authorization process by visiting the following URL (note the mandatory trailing slash).

https://<UUID>.wardenscanner.com/warden/

Then just follow the regular API authorization mechanism, which should activate your connector.