Jira Notification action

Configure a Jira Notification action to create an incident in Jira when a trigger occurs. This is useful for addressing security concerns that require further action. Creating a Jira incident ensures you can easily plan, track, and implement solutions for these security issues.

To configure the action, you need to do the following:

1. Create a Jira service project and an API token in the Jira account for authentication purpose.
2. Create a Jira Notification action in FortiWeb.

Prerequisite

• The Jira account credential that is being used to create the Jira Notification action must have User Management Access.

• You have signed up for Jira Service Management for your Jira account.

To create a Jira service:

1. On the Jira Software site, log into your Jira account.
2. Click App Switch button and select Jira Service Management.
   
3. Click Create project to create a new project.
4. In Project templates, select Service management, then select IT service management.
5. Click Use template to continue.
6. In Add project details, assign a name, and click Create project.

Note: keep the Jira Service Project name for use later.

To create Jira API Token:

1. On the Jira site, click on the user icon drop down menu and select Account settings.
   
2. Select Security in the Account Settings menu.
3. In API token section, click Create and manage API tokens.
4. Click Create API token to create a new token.
5. Give a label for the API and click Create.
6. Copy the new API token for later use.

To create a Jira notification action:

1. Log in to FortiWeb.
2. Go to Security Fabric > Automation.
3. Select the Action tab.
4. Click Create New.
5. Select Jira Notification.
6. Enter a name and description.
7. Enter the account name and the API token you just created.
8. Enter the URL of your Jira account. Please leave the "https://" out when you paste the URL because the system will automatically append "https://" to the URL you enter.
9. Enter the message to send to Jira. The message should be in JSON format. Text format is not supported. Refer to Use Cases for the JSON message.
   Please be cautious when using the %%results%% variable in JSON messages. The output from this variable may include characters such as Tabs or Paragraph breaks, which can cause parsing errors when the message is displayed.
   It's important to provide sufficient information in the message so that your IT team can understand the issue and take appropriate actions. We have provided some message examples for your reference: Notification message examples.
   
10. Click OK.