> ## Documentation Index
> Fetch the complete documentation index at: https://projectdiscovery-fix-jira-custom-fields.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Tickets for Jira

> Create actionable follow up for exploitable vulnerabilities in Jira

## Summary

ProjectDiscovery Cloud Platform has provided you with comprehensive scan results on exploitable vulnerabilities - what's next? You want to get your team involved and have a more seamless pipeline between data visibility, discovery, and follow up.
For your organization this means getting important tasks into Jira!

In this example, we'll walk through setting up this important workflow for a brand new user. You will add assets, configure a Jira integration, and initiate a scan to create a ticket for your team to take action.

### What You'll Do

In this walkthrough we're going to go step-by-step to complete the following actions:

* Add Assets
* Configure Jira
* Configure ProjectDiscovery Cloud Platform for Jira ticketing
* Start a scan to test your new integration

### Prerequisites

To complete the integration you will need to have the correct permissions to access account details within Jira. Refer to [Atlassian's documentation](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/) for additional details.

<Note>If you are not a Jira administrator you may need your organization's Jira administrator for assistance in collecting these details. </Note>

**You will need the following:**

* Jira instance URL
* Jira Account ID
* Jira email
* Jira API Token
* Jira Project name

## Add Assets

For this example we're going to stick with the simplest path and add assets to your PDCP environment by uploading a .TXT file with the domains you want to include for scanning.

If you already have assets in ProjectDiscovery Cloud Platform, you can skip ahead to Connecting Slack. For for other Asset upload options check out the docs on [Adding Assets.](/cloud/assets/adding-assets)

<Steps>
  <Step title="Add New Assets">
    Navigate to the [Assets tab](https://cloud.projectdiscovery.io/assets) and select **Add New Assets**.
  </Step>

  <Step title="Choose Scope">
    On the Scope tab, use the **Upload files** option to add your .TXT file of domains.
  </Step>

  <Step title="Select Options">
    Select your preferred configuration options:

    * Auto Discovery is enabled by default, toggle to disable if desired.
    * If you choose to leave Auto Discovery enabled, select your desired frequency.
    * Navigate to the Advanced tab to modify individual discovery settings for subdomains, open ports, etc.
  </Step>

  <Step title="Complete your setup">
    Select **Add Assets** to complete the setup.
  </Step>
</Steps>

Once your assets, you will need to connect your ProjectDiscovery Cloud Platform to your Jira account.

If you have questions on Assets - check out the [Assets - FAQ](/cloud/assets/overview#faq).

## Connecting Jira

After adding your assets, you will need to connect your ProjectDiscovery Cloud Platform environment to Jira. There are two parts to this, the part you will need to complete in your Jira environment and the details you'll need to add to ProjectDiscovery Cloud Platform.

### Jira Setup

Logged in to Jira as an administrator visit [this link](https://id.atlassian.com/manage-profile/products) to locate your Jira instance URL.
You can also [use the REST API](https://developer.atlassian.com/cloud/jira/platform/rest/v3/) to obtain these details.

*Note: The format for URLs in Jira will vary depending on your account type (Jira Cloud vs on-prem)*

<Steps>
  <Step title="Find your Jira instance URL">
    Log in to your Jira account and locate the following information:

    * Jira instance URL
    * Jira Account ID
    * Jira Project Name

    *Note: To locate your Jira instant URL -  Click your Profile menu in the upper-right, then select **Profile**. In the URL after /people/ is your account ID.*

    **Save this information in a safe place.**
  </Step>

  <Step title="Create an API Token">
    * Logged in as a Jira administrator navigate to [https://id.atlassian.com/manage-profile/security/api-tokens](https://id.atlassian.com/manage-profile/security/api-tokens).
    * Click **Create API token**.
  </Step>

  <Step title="Save your API token">
    * In dialog that appears, enter a memorable label for your token and click **Create**.
    * Click **Copy to clipboard**, and save this information in a safe place.
  </Step>
</Steps>

Next up, you will be adding these details from Jira to your environment in ProjectDiscovery Cloud Platform!

### ProjectDiscovery Cloud Platform Setup

Before getting started with this part of the setup ensure that you have completed the configuration required in Jira.

<Steps>
  <Step title="Launch the Jira integration in PDCP">
    Navigate to **Scans → Configurations** and under Ticketing select Connect under the option for Jira.
  </Step>

  <Step title="Add your config details">
    In PDCP complete the information for Jira including:

    * A name for your Jira Configuration
    * Jira instance URL
    * Jira account ID
    * Jira Email
    * Jira API Token
    * *(Optional) Select Enable for all scans option if desired (you can also select this option during scan creation)*
    * Select **Next** to continue the Jira integration setup.
  </Step>

  <Step title="Continue adding your config Details">
    * Provide the **Jira Project name** for the project in which you want to create issues from ProjectDiscovery Cloud Platform.
    * Provide the **Jira Issue type** you want to have created.
    * Add the Closed status. (Default is "Done" but this field can be edited)
    * Choose your preferred options (toggle) for **Severity** and **Deduplication**.
    * Add any Custom field details you want to include. Enter one entry per field, each mapping `id`, `name` or `freeform` to a value:

      ```yaml theme={null}
      customfield_00001:
        name: 'Nuclei'
      customfield_00002:
        freeform: '{{.CVSSMetrics}}'
      priority:
        id: '{{if eq .Severity "critical"}}10104{{else}}4{{end}}'
      ```

          <Note>
            This box is the custom-fields block, so your entries go in directly. If you
            paste an example that still has a `custom-fields:` (or `custom_fields:`)
            line at the top, that line is ignored and the fields under it are used.
          </Note>

      * Use `id` or `name` for dropdown fields, and `freeform` for text fields.
      * Review Atlassian's documentation on [creating custom fields](https://support.atlassian.com/jira-cloud-administration/docs/create-a-custom-field/), or [locating existing custom field IDs](https://confluence.atlassian.com/jirakb/how-to-find-any-custom-field-s-ids-744522503.html).
  </Step>

  <Step title="Finalize your configuration for Jira">
    Once you're satisfied with your configuration select **Verify** to complete your Jira integration.
  </Step>
</Steps>

Now that your configuration is set up, you can create a scan and verify your Jira integration.

## Create a Scan

The final step is to create a scan, verify that your Jira integration is set up correctly, and check for the corresponding ticket in the Jira project you configured.

<Steps>
  <Step title="Create a new scan">
    From the Scans tab select **Create New Scan** to open the creation workflow.
  </Step>

  <Step title="Complete Scan Details">
    * Select from the Assets we added in the first step.
    * Choose the templates or template profile you want to use for scanning. *For this example we suggest keeping the Recommended template profile.*
  </Step>

  <Step title="Finalize your config">
    Provide a name, select a scan frequency, and complete any additional configurations (integrations, configurations, or variables).
  </Step>

  <Step title="Finish creating">
    Click **Create Scan** to start your new scan. This scan will be added to the Scans page with an in-progress status until it completes and provides the results of the scan with any vulnerabilities.
  </Step>

  <Step title="Check for Tickets">
    Check your Jira project to verify that your alert is working as expected!

    <img height="300" src="https://mintcdn.com/projectdiscovery-fix-jira-custom-fields/BwNlKCk8j0O_bzxV/images/platform/jiraticket.png?fit=max&auto=format&n=BwNlKCk8j0O_bzxV&q=85&s=796d08a17adcc55c6d4507138a289ed8" data-path="images/platform/jiraticket.png" />
  </Step>
</Steps>

## What's Next?

This example focuses on the process of integrating with Jira to create tickets for your team based on scan results.

ProjectDiscovery Cloud Platform also supports workflows for alerting for Slack, MS Teams, Email and custom webhooks.

Check out another example that sets up a workflow to create a scan and [sends out a Slack alert.](/cloud/examples/slackalert)