Jira

We support Jira as an alerting destination.

1

Create a Jira API token

1. Create an API token here

2. Set the maximum expiration date of 365 days

3. Set scopes:

   1. read:jira-user

   2. read:jira-work

   3. write:jira-work

4. Select create and save the API token securely See Atlassian's API token documentation for API token setup.

2

Setup Jira Integration

Under Policy Maker, select the Jira integration and input the following:

1. User Email: the e-mail associated with the API token

2. Api Key: the API token saved in the previous step

3. Base Url:

   • For a token with scopes, including a service-account token, use https://api.atlassian.com/ex/jira/{cloudId}. Do not use the Jira tenant URL for this token type.

   • For a token without scopes, use the URL for your Jira tenant, e.g., https://customerName.atlassian.net

3

Add Jira notifications as an action

1. Create or edit a policy, and Add automated actions

2. Add an action to Create a Jira ticket

3. Provide the Project Key, Issue Type, Assignee, Reporter, and any custom fields. Ensure that the user has access to the project and that the fields exist for the Project and Issue Type.

It is recommended to add Jira notifications after a policy has been created and the initial violations populated. A ticket is created per violation, so ensure that policies are sufficiently scoped.