---
title: Jira
summary: null
url: https://www.fastly.com/documentation/guides/next-gen-waf/integrations/jira
---

Our Jira integration (alert) creates an issue when certain activities occur on the Next-Gen WAF.

> **HINT:** 
>
> Want to set up alerting for your CDN or Compute service? Check out our [Observability](/guides/observability/alerts/about-alerts/) guides.
>
>
>

## Setting up Jira integrations (alerts)

Jira integrations (alerts) are configured per project. To set up a Datadog integration (alert), [create an API token](https://www.fastly.com/documentation/guides/next-gen-waf/integrations/jira#creating-api-tokens-for-new-jira-users) for a new Jira user and then [add the integration (alert)](https://www.fastly.com/documentation/guides/next-gen-waf/integrations/jira#adding-jira-integrations-alerts).

### Creating API tokens for new Jira users

Before you can add the Jira integration (alert), you need to create a new user in Jira and an API token for that user:

1. [Create a new user in JIRA](https://confluence.atlassian.com/adminjiraserver/create-edit-or-remove-a-user-938847025.html) for the integration (alert) to use.
2. [Create an API token](https://id.atlassian.com/manage/api-tokens) for that user.

### Adding Jira integrations (alerts)

After creating an API token for a new Jira user, you can set up a Jira integration (alert):

### Next Gen Waf Control Panel

1.   Log in to the [Next-Gen WAF control panel](https://dashboard.signalsciences.net).

2.   From the **Sites** menu, select a site if you have more than one site.

3. From the **Manage** menu, select **Site Integrations**.
4. Click **Add site integration**.
5. Select the **Jira Issue** integration.
6. In the **Host** field, enter the URL of your JIRA instance.
7. In the **Username** field, enter the username you created in JIRA.
8. In the **API Token** field, enter the API token you created in JIRA.
9. In the **Project Key** field, enter the key of the JIRA project to create new issues in.
10. In the **Issue Type** field, enter the type of issue that should be created.
11.   Select if you want to be alerted regarding **All activity** or **Specific activity**. If you selected **Specific activity**, then in the **Activity** menu choose the activity types that you want the integration to create alerts for.

12. Click **Create site integration**.

### Fastly Control Panel

1.   Log in to the [Fastly control panel](https://manage.fastly.com).

2.   Go to **Security** > **Next-Gen WAF** > [**Workspaces**](https://manage.fastly.com/security/ngwaf/workspaces).

3.   Click the gear <span class="inline-icons"><img src="/img/icons/gear.png" alt="Gear icon" /></span> next to the workspace that you want to modify.

4. Click **Alerts** and then **Add alert**.
5. Fill out the **Add alert** form as follows:
   - From the **Integration type** menu, select **Jira**.
   - In the **Host** field, enter the URL of your JIRA instance.
   - In the **Username** field, enter the username you created in JIRA.
   - In the **Project name** field, enter the name of the Jira project to create new issues in.
   - In the **API key** field, enter the API token you created in JIRA.
   - In the **Issue Type** field, enter the type of issue that should be created.
   - In the **Select activities** menu, leave **Flagged IPs** checked.
6. Click **Add workspace alert**.

## Activity types

> **IMPORTANT:** This section only applies to Next-Gen WAF customers with access to the [Next-Gen WAF control panel](https://dashboard.signalsciences.net).

When setting up a Jira integration (alert) in the Next-Gen WAF control panel, you can select from the following activity types:

| Activity type | Description                  |
| ------------- | ---------------------------- |
| `flag`        | An IP address was flagged    |
| `agentAlert`  | An agent alert was triggered |

## Related content

- [Using an API with the Next-Gen WAF](https://www.fastly.com/documentation/guides/next-gen-waf/developer/using-an-api-with-the-next-gen-waf)