Step by step instructions on installing the Nightfall for JIRA integration
This document explains the process of installing Nightfall for JIRA.
The installation of JIRA integration requires you to have the following prerequisites
An Atlassian tenant with JIRA enabled.
You must have access and must be logged in to the Atlassian account.
JIRA and Confluence are both products of Atlassian. Hence, the installation procedure for Nightfall for JIRA and Nightfall for Confluence is the same. You must first log in to your Atlassian account on which you wish to install the Nightfall for JIRA integration. This login must be done on the same browser from which you are accessing the Nightfall application. Nightfall automatically lists all the Atlassian accounts to which you are logged in. You must authorize Nightfall to your Atlassian account on which you wish to install Nightfall for JIRA. Once the authorization is completed, you must install the DLP for JIRA application from the Atlassian marketplace.
Log in to your Atlassian tenant on which you wish to install the Nightfall for JIRA integration.
Log in to the Nightfall application from the same browser used to log in to Atlassian.
Click Atlassian under MY INTEGRATIONS (Click Show 7 more if the Atlassian integration is not displayed).
You can see that Nightfall lists the Atlassian accounts to which you have logged in. In the following image, there are two Atlassian accounts.
Click + Add Site to authorize the Atlassian account.
If you do not have Confluence or JIRA set up on your Atlassian account, you cannot see the respective icon under the App(s) column.
You are navigated to the Atlassian site.
Under the Use app on drop-down menu, choose the Atlassian site that you wish to authorize and install the DLP for JIRA app.
If you have a single Atlassian account, Nightfall automatically selects the Atlassian account for authorization. This drop-down menu is active only when you have multiple Atlassian accounts.
Click Accept.
Click the JIRA icon for the Atlassian account that you authorized in the previous step.
You are navigated to the Atlassian Marketplace where the DLP for JIRA app is located.
Click Get it now.
Choose the Atlassian account that you authorized in step 4 under the Select a site to install this app drop-down menu.
Nightfall displays the list of JIRA products on which the app will be installed. This list is based on the JIRA products present in your Atlassian account.
Click Install app.
Click Get it now.
Once the installation is completed, you can view a pop-up box at the left bottom of your screen. You can click Manage app to customize the settings.
When you return to the Nightfall application, the appearance of the JIRA icon changes once the DLP for JIRA app is installed. This confirms the successful installation of the DLP for JIRA app.
Important
Once you install the DLP for JIRA application on an Atlassian account, Nightfall automatically configures the Alert platform with this JIRA account. You can confirm this by navigating to Settings -> Alert platforms in Nightfall.
In the Atlassian integration page, there is a phrase attached to this Atlassian account known as Alert Destination which also confirms that this JIRA is used as an Alert platform.
When you install DLP for JIRA on another Atlassian account, the alert destination automatically shifts to the new Atlassian account on which the DLP for JIRA is recently installed.
Nightfall sends alerts in real-time to the channels or platforms you configure. You can configure the following alerts:
Slack Alerts
Webhook
Jira Tickets
The Nightfall for JIRA integration allows you to configure alerts at the policy level and also at the integration level.
When you configure alert settings at the integration level, the alert settings apply to all the policies, created for the Nightfall for JIRA integration. However, when you configure alert settings specifically for a policy, created in the JIRA integration, the alert settings are applicable only for the specific policy.
This document explains how to configure alerts at the integration level. To learn about how to configure alerts at the policy level, read this document.
To use Slack as an alert method, you must first perform the required Slack configurations. You can refer to this document to learn more about how to configure Slack as an Alert platform.
To use Webhook as an alert method, you must first perform the required Webhook configurations. You can refer to this document to learn more about how to configure Webhook as an Alert platform.
You can configure alerts at the integration level once you have installed the Nightfall for GitHub integration.
To configure alerts at the integration level:
Navigate to the Nightfall for Github integration.
Scroll down to the Alerting section.
Nightfall provides you with the following alert methods.
Slack: Enter the name of the Slack channel to which the violation notifications from this integration must be directed and click Save.
Email: Enter the Email ID of the recipient to whom the violation notification must be sent and click Save.
Webhook: Enter the Webhook URL and HTTP headers and click Save.
JIRA: The JIRA alert platform is automatically activated once you install the DLP for JIRA integration. Select the JIRA project, issue type, enter comments, and click Save changes.
When you configure alerts to a Webhook, Nightfall AI sends occasional posts to:
To validate that the Webhook is properly configured before the policy is saved.
Periodically, thereafter to ensure that the Webhook is still valid.
The response to the test Webhooks is a 200 status code
if successful.
An example of Webhook request is as follows.
This is part of alert event consumption and can be ignored.
Customize End-User Notification: Enter a custom message to be sent to the end user. This message is sent in an Email. You can modify the default message provided by Nightfall and draft your message. The total character length allowed is 700 characters.