Authorizing Crowdcontrol to Access Jira

To manage issues within Jira, Crowdcontrol must have access to your instance. Bugcrowd provides OAuth solutions to enable this access, for both Jira Cloud and Server products.

Note: You must have administrator access in Jira for authorizing Crowdcontrol to access your Jira account.

To authorize Crowdcontrol to access your Jira account, specify the following information on the Authorization page:

  • Display name: Name for the integration.
  • Site: URL for your Jira domain.

display-name-site

You can authorize Crowdcontrol to access Jira using Jira Cloud OAuth, Jira Server / Jira Data Center OAuth, or Username and password.

Clients must allow list the following IPs. The IPs are a cluster of proxies that provide high availability for outgoing integration requests.IPs:

  • 52.1.126.10
  • 52.86.183.27
  • 52.86.229.29

Port:

  • 443

The default port used for Jira is 443 SSL/TLS but it may vary depending on your Jira configuration. If you have any issues, please submit a support ticket through the Bugcrowd Support Portal.

Authorizing Jira Cloud (OAuth 2.0)

  1. If your Jira instance is hosted at *.atlassian.net, then select the Jira Cloud OAuth option.

    jira-cloud-auth

  2. Click Authorize.

    authorize

  3. In Authorize for, select the Jira instance hosted at *.atlassian.net and click Accept.

    accept

    The Integration authorized message is displayed. Also, the Jira integration details section displays the Cloud ID and Instance name automatically, and Authorization in the left pane shows a tick mark indicating that authorization is complete for Jira Cloud.

    integration-authorized

    After authorizing Jira Cloud, configure the Jira project. For information, see configuring Jira project.

Authorizing Jira Server (OAuth 1.0)(Deprecated)

Please note that Atlassian has ended the support for Server products on February 15, 2024. Therefore Bugcrowd will deprecate authorizing with Jira Server in the next few months. If you are using Jira Data Center, please use the instructions for Authorizing Jira Data Center [OAuth 2.0].

  1. If your Jira instance is self-hosted Jira Server, select the Jira Server OAuth option.

    jira-server-oauth

  2. Log in to Jira and go to Settings > Products.

  3. In Integrations, click Application Links.

    The Configure Application Links page is displayed on the right.

  4. Specify https://tracker.bugcrowd.com as the URL for creating a new link.

    configure-application-links

    The No Response was received.. error message is displayed.

  5. Provide the same URL and click Continue.

    application-url

    The Link applications page is displayed.

  6. Specify the following details:
    • Application Name: Descriptive name for the integration.
    • Application Type: Select Generic Application.
    • Service Provider Name: Provide name as Bugcrowd.
    • Consumer Key: Use the same Consumer key you provided in Crowdcontrol integration.

    The following values are only used for an Outgoing Authentication flow, which is currently not leveraged. Hence, use the provided arbitrary values:

    • Shared Secret: Bugcrowd.
    • Refresh Token URL: https://tracker.bugcrowd.com.
    • Access Token URL: https://tracker.bugcrowd.com.
    • Authorize URL: https://tracker.bugcrowd.com.

    Select the Create Incoming link option.

    link-applications

    Click Continue.

  7. Specify the following details:
    • Consumer Key: Use the same Consumer key you entered within the Crowdcontrol Jira Integration.
    • Consumer Name: Use a name for the integration, we recommend Crowdcontrol.
    • Public Key: Enter in the public key from the Crowdcontrol Jira integration.

    public-key

  8. Click Continue. The Application Link is persisted within Jira.

  9. Go back to Crowdcontrol Jira integration page and click Authorize.

    server-authorize

    The Integration updated message is displayed. After authorizing Jira Server, configure the Jira project. For information, see configuring Jira project.

Authorizing Jira Data Center (OAuth 2.0)

  1. If your Jira instance is self hosted Jira Data Center, select the Jira Data Center option.

    jira-data-center

  2. Log in to Jira and go to Settings > Applications.

    jira-data-center-application

  3. In Applications, click Application Links.

    application-links

    The Application Links page is displayed on the right.

  4. Click on Create link on the top right of the table.

    create-link

    The Create link form is shown.

    create-link-form

    • In the Application type, select External application.
    • In Direction, select Incoming.
    • Click Continue.
  5. The Configure an incoming link page is shown.

    incoming-link-form

    • Enter a name for the Integration.
    • In the Redirect URL, paste the URL that you copied from the Bugcrowd integration page. link-copied-from-bugcrowd
    • In the Permission, select Write. save-permission
  6. Click on Save.

    The Credentials page is displayed.

    jira-credentials

  7. Copy the Client ID and Client secretfields.

    Note: Please be sure to copy the Client secret. Once you leave the page the Client secret will not be available.

  8. Now you will see the newly created Application link in the Application links page.

    application-links-page

  9. Paste the Client ID and Client secret in the Bugcrowd Integration page and click Authorize.authorize-jira-data-center

    authorize-jira-data-center

    The Integration updated message is displayed. After authorizing Jira Data Center, configure the Jira project. For information, see configuring Jira project.

Authorizing Jira Using Username and Password

  1. On the Jira Integration page, select the Basic Authentication option.

    username-password

  2. Specify the following:
    • Username: Your Jira user name.
    • Password: API token generated in Jira. For information about generating API tokens, see Jira documentation.

    username-pass-details

  3. Click Test authorization.

    test-authorization

    The Jira authentication successful message is displayed. After authorizing Jira, configure the Jira project. For information, see configuring Jira project.