Getting Started
Nightfall installs into your Jira account as an Atlassian Connect app, so the installation is completed in the Atlassian UI.

Step 1. Install from Atlassian Marketplace

Before you install the app, ensure that you’ve provided your Nightfall Account Manager with the base URL for your Atlassian instance so that we can configure it in our platform. Once you’ve done that, navigate to the DLP for Jira - Nightfall AI listing in the Atlassian Marketplace and click Get it now.
Choose the Atlassian site where you would like to install your app and follow the instructions to finish the installation.
Once you have completed these steps, log in to your Nightfall dashboard and click on the Jira tab in the left sidebar to validate that the app is successfully installed.

Step 2. Create Detection Rule

First, we will configure our Detection Rule that defines the types of sensitive data we are looking for in Jira. The detection rule is the Nightfall aggregation of detectors and confidence levels/findings that will dictate whether a violation or finding is recorded.
To learn more about Detection Rules and how to set them up, please refer to this article .
In the left sidebar, click "Detection Rules".
We strongly recommend configuring a simple detection rule to start as follows:
Detector
Minimum Confidence
Minimum Count
Credit Card Number
Likely
1
US Social Security Number
Likely
1
API Key
Likely
1
Now that our Detection Rule has been created, we will create our Jira policy that will use this Detection Rule.

Step 3. Create Policy

Navigate to the Policies option, under the Jira option on the left sidebar of the Nightfall console view.
To create your first policy, please select the ‘+ New Policy’ option:
The first step for policy creation will be naming the policy. The example screenshot policy below is called ‘High risk sensitive data’.

Define Policy Scope

The second step is to define the scope of the policy. The options for Scope are:
  • Everything - will scan all Jira projects and spaces
  • Choose projects - allows for specific Jira projects to be searched. These can be added by their Project Key

Apply Detection Rule

Next, we will apply the Detection Rule we created in the prior step to this Policy. This means the Policy will be evaluating content against this Detection Rule to determine if it meets the criteria for a Violation or not.

Alerting

Similar to some of our other integrations, there are three alerting options for Jira Real-TIme scanning with Nightfall:
  1. 1.
    Slack Channel
  2. 2.
    Email
  3. 3.
    Webhook
Please find an example alerting section below that is sending Jira violation alerts to a Slack channel, with the name #nf-jira-alerts.
Once this has been configured to your liking, you can save the policy with the option on the bottom of the screen.

Changing Jira Sites

If you would like to change the Jira Site (e.g. newsite.atlassian.net) that Nightfall is connected to, please follow the steps below:
  1. 1.
    Follow the steps above to install Nightfall into your new Jira Site.
  2. 2.
    Notify Nightfall by emailing your Customer Success Manager or [email protected] with your new Jira domain (e.g. newsite.atlassian.net), and your old/existing Jira Site domain (e.g. oldsite.atlassian.net).
    1. 1.
      Nightfall will unlink your existing Jira Site and link your new one.
    2. 2.
      Please do not run any scans during this time.
  3. 3.
    Once you have received confirmation from Nightfall that the re-linking process is complete, you can uninstall the Nightfall app from your old Jira Site by clicking "Uninstall" on the app in your installed apps, as shown below. Please do not uninstall until you have received confirmation from Nightfall.
Last modified 24d ago