Skip to main content

How To Integrate Jira With APIsec Cloud


Prerequisites

APIsec platform needs Email, API token, App URL and Project Key to configure Jira issue tracker.

  • Use the Email address of your Atlassian account (the one you use to log in to Jira)

  • Follow the steps below to obtain API token

    alt text

    • Give your token a Name that describes what is does and select an expiration date and Click Create. alt text

    • Copy your API token alt text

  • Jira App URL: This is your Jira site URL, visible in the browser when you log in to Jira

  • Project Key: Visit Project settings and get the Project key alt text


Open your browser and visit: https://<your-tenant>.apisecapps.com


Visit the application

  • Click on "Integrations" alt text

Create a JIRA Integrations

  • Click on "Issue Tracker" tab alt text

  • You will found the JIRA Issue Tracker

    • Click "Configure Applications" alt text

    • There are two scenarios here, first if already existing JIRA integrations, then it will list item with "New Connection" Button alt text this case you need to click "New Connection".

    • Or you will directly get the form for create JIRA integrations alt text

    • Fill the form with all the required fields.

      • Name – Enter Name.
      • E-mail – Enter E-mail.
      • API Token – Enter API token for authentication.
      • Jira App URL – Enter the URL of your Jira application.
      • Project Key – Specify the key of the Jira project.
      • Severity Selection – A multi-select dropdown with options Critical, High, Medium, and Low. So, users can have control over which severity levels (Critical, High, Medium, Low) are synced to their issue tracker.
      • Labels – Enter single-word labels without spaces. For multiple labels, separate them with commas (,).
    • Click Test Connection alt text

    -Test connection successful. alt text

  • Click Create Connection

alt text

  • Check name is present in the integrations list alt text

Edit a JIRA Integrations

  • Click "Configure Applications" alt text

  • Click "Manage" for desired JIRA Integration to update. alt text

  • Edit the connection details. Now you can also update severity filters for the existing connection (If they are not updated). Changes will apply for future scans and close the tickets automatically that doesn't match the severity to maintain consistency. However, the corresponding vulnerabilities will still exist in the platform.

    alt text

  • Click Test Connection alt text

  • Test connection successful. alt text

  • Click Update Connection alt text


Delete a JIRA Integrations

  • Click "Configure Applications" alt text

  • Click icon "Delete" alt text

  • This will take more confirmation, alt text


Setting Up Jira connection with the application

You can integrate Jira with the application to automatically track and manage issues. This integration will be used to create tickets in Jira for easier tracking and resolution.

  • Navigate to: https://<your-tenant>.apisecapps.com

  • From the Applications window, click on the See More option for the application where you want to set up the Jira integration.

    alt text

  • Now, click on the Administration menu.

alt text

  • From the drop down menu select Set up Issue Tracker option

alt text

  • Now you found the list of Issue Trackers available in the tenant. alt text

    From here, if you want to create a new Jira connection, then click on the "New Issue Tracker" button and create a new connection.

  • From that list, select Jira connection and click on the ""Test Connection" to test the connection.

    alt text

  • Test Connection successful

    alt text

  • Now click on the Activate Connection

alt text

  • Connection activated

    alt text

    Now the configured connection will appear in the list as First connection.

    note

    user role with View permissions can not configure Jira issue tracker in shared application.

  • To remove the connection from the application, Click on the Delete icon beside the configured connection”

    alt text

  • This will take more confirmation,

    alt text

    note

    user role with View permissions can not remove Jira issue tracker from shared application.