How to Setup JIRA Notifications

To get started, you'll first want to create a new API token from your Atlassian account settings. This token will allow ZoneWatcher to create issues in your JIRA workspace on your behalf.

To create an API token:

1. Log in to your Atlassian account at https://id.atlassian.com
2. Navigate to Security → API tokens
3. Click Create API token
4. Give your token a descriptive label like "ZoneWatcher Integration"
5. Click Create and copy the token immediately (you won't be able to see it again)

Keep this API token secure - it provides access to your JIRA workspace. Store it safely as you'll need it in the next step.

You'll also need your JIRA Project Key. This is a short identifier (usually 2-10 uppercase letters) that represents your project.

To find your project key:

1. Open your JIRA workspace
2. Navigate to your project
3. The project key is displayed next to your project name (e.g., PROJ, DEV, SUPPORT)
4. You can also find it in the URL: https://your-domain.atlassian.net/browse/PROJ

Example project keys: ZW, DEVOPS, INFRA, DNS

ZoneWatcher allows you to create unlimited Notification Channels, which can be customized to send notifications to different JIRA projects.

Once you have your API token and project key, you can create a new Notification Channel by providing:

1. Channel Name: A descriptive name like "Infrastructure JIRA"
2. JIRA Endpoint: Your Atlassian domain (e.g., https://your-domain.atlassian.net)
3. Atlassian Account Email: The email address associated with your Atlassian account
4. API Token: The API token you generated in the previous step
5. Project Key: The project identifier where tickets will be created

You can also customize which events you want to receive notifications for. Current events include:

• Zone Changed
• New Zone Discovered
• Zone Expiring Soon
• Zone Expired
• Zone Renewed
• Zone Nameservers Changed
• Zone Certificate Issued
• Provider Auto-Disabled

When a DNS event occurs, ZoneWatcher will automatically create a JIRA ticket in your specified project with:

• Summary: A concise title describing the event (e.g., "DNS changes detected for example.com")
• Description: Detailed information about the DNS event, formatted using Atlassian Document Format
• Issue Type: Automatically selected based on the event (Task, Bug, or Incident)
• Priority: Set according to the severity of the event (Critical, High, Medium, or Low)

All tickets are created using the JIRA REST API v3 with Basic Authentication (your email and API token), ensuring compatibility with Atlassian Cloud and the latest JIRA features.

• API tokens are stored encrypted in ZoneWatcher's database
• Use a dedicated service account for the integration rather than a personal account
• Regularly rotate your API tokens for enhanced security
• Grant only the necessary permissions to the JIRA account used for the integration
• Monitor your JIRA audit logs for any unexpected activity