You can integrate Deepfactor with Jira Cloud or Jira Server and raise Jira tickets for alerts directly from the Deepfactor Portal by following the process below:
1. From the left-side navigation menu, Click ‘Integrations’.
2. On the left-sidebar, navigate to ‘Project Management’.
Integrate Deepfactor with Jira Cloud
To integrate Deepfactor with your Jira Cloud account, follow the steps below:
- Click “Connect JIRA Cloud.”
This will take you to an authorization screen on your Jira cloud. - Click “Accept.”
After you click “Accept,” you will be redirected to Deepfactor, and your Deepfactor account will now be integrated with Jira.
Integrate Deepfactor with Jira Server #
To integrate Deepfactor with your Jira Server account, follow the steps below:
- Create an application link in your Jira Server using the steps outlined in the following article
OAuth. - On your Deepfactor Portal UI, under Jira Server, click “Configure Jira Server.”
- Enter the details from Step 1 and click “Save.”
This will take you to an authorization screen on your Jira Server.
- Enter the credentials.
- Click “Login.”
- Click “Allow” to grant Deepfactor access.
After you click ‘Allow,’ you will be redirected to Deepfactor, and your Deepfactor account will now be integrated with Jira.
Create Jira Issues #
You can now create a Jira for each Deepfactor alert on the alert detail page.
To create a JIRA:
- On the alert detail page, click the “Create Jira” icon.
Create JIRA pop-up window appears.
- Click the “Edit” icon.
- From the Jira Project drop-down, select a JIRA project.
- Depending upon the mandatory fields set in your Jira project settings, a form with those fields will be shown on the Deepfactor UI. Please enter the values in the create jira form to create a jira issue.
- Click “Create Jira.”
After a Jira ticket is created, you will see the link of the Jira ticket on the alert detail page in the Deepfactor Portal.
Handling Mandatory fields #
In Jira project settings, you can specify mandatory fields which are required to create a Jira issue in that project. On the create Jira form in Deepfactor portal UI, once you select the project and issue type, Deepfactor calls a Jira API to get the list of mandatory fields and renders them in the form for you to fill so we can create a Jira issue in that project.
Deepfactor handles the following field types:
type: string/number/user
type: array/option/version where allowedValues field is not an empty array
Deepfactor does not handle the following field types:
type: array, items:json (Ex: Sprint, user)
type: date/datetime/issuerestriction/parent
type: array, items: issuelinks
type: array/option/version where allowedValues is an empty array
If Deepfactor cannot handle any of the mandatory fields, an error will be shown on the UI along with the names of such fields. In order to create Jira issues from Deepfactor in such a project, you can either mark those fields as non-mandatory or set default values for them in your Jira project’s settings.