--- title: "Jira Cloud Prerequisites" slug: "jira-cloud" updated: 2026-04-09T21:13:27Z published: 2026-04-09T21:13:27Z canonical: "help.nucleussec.com/jira-cloud" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.nucleussec.com/llms.txt > Use this file to discover all available pages before exploring further. # Jira Cloud Prerequisites ## Overview This article describes the necessary prerequisites for configuring a Jira connector in Nucleus to use OAuth authentication. OAuth 2.0 is the **recommended authentication method** for all Jira integrations. Legacy authentication methods (such as OAuth 1.0a) may result in reduced performance, limited support, and weaker security, and should only be used when OAuth 2.0 is not supported. ### Connecting to Jira using OAuth 2.0 (Recommended) In order for Nucleus to authenticate to Jira using OAuth 2.0 authentication, you must enable OAuth 2.0 in Jira for the Nucleus application. This will be used later when [creating a Jira connector in Nucleus](/v1/docs/jira-ticketing-integration). Follow the steps below to enable OAuth 2.0 in Jira: 1. Log in to [developer.atlassian.com](https://developer.atlassian.com/), select your profile icon in the top-right corner, and from the dropdown, select **Developer console**. 2. Click the **Create** button, then select **OAuth 2.0 integration**. 3. Enter a **Name** for the integration, for example 'Nucleus', then click **Create**: ![image.png](https://cdn.document360.io/3888970a-6501-459e-acc9-c47b71c6d64c/Images/Documentation/image%28450%29.png) 4. Select **Distribution** from the left navigation panel. 5. You'll see your app is listed as private by default. To continue: 1. Click **Edit** 2. Select the **Sharing** option 3. Enter 'Nucleus' as the **Vendor Name** and 4. Set 'https://nucleussec.com/privacy-policy/' as the **Privacy Policy**. 5. Click **Save Changes**: ![image.png](https://cdn.document360.io/3888970a-6501-459e-acc9-c47b71c6d64c/Images/Documentation/image%28451%29.png) 6. Select **Permissions** from the left navigation panel, then click the **Add** next to the JIRA API option. 7. Click the **Configure** button, then click the **Edit Scopes** button at the top-right of the 'Jira Platform REST API' section. 8. Check the **View Jira issue data**, **View user profiles**, and **Create and manage issues** scopes, then click **Save**: ![image.png](https://cdn.document360.io/3888970a-6501-459e-acc9-c47b71c6d64c/Images/Documentation/image%28509%29.png) 9. Select **Authorization** from the left navigation panel and you'll see OAuth 2.0 listed as an Authorization type. Under Action, click **Add**. 10. Paste the Redirect URL copied from Nucleus into the **Callback URL** option, then click **Save Changes**. 11. Select **Settings** from the left navigation panel, then copy the **Client ID** and **Secret**, you will need these to complete setting up the connector in Nucleus: ![image.png](https://cdn.document360.io/3888970a-6501-459e-acc9-c47b71c6d64c/Images/Documentation/image%28453%29.png) You are now ready to continue [creating a Jira connector in Nucleus](/v1/docs/jira-ticketing-integration). ### Legacy Authentication Methods The following authentication methods are supported for backward compatibility but are not recommended for new integrations. #### Connecting to Jira using OAuth 1.0a (Legacy) OAuth 1.0a Deprecation Warning OAuth 1.0a is a deprecated authentication protocol and should not be used. This method may result in reduced performance, limited support, and weaker security compared to OAuth 2.0. OAuth 2.0 authentication is highly recommended for new Jira connectors, and existing connections using OAuth 1.0a should be updated. Migrate to OAuth 2.0 To migrate an existing connector: 1. Navigate to your Nucleus project, then **Integrations > Connector Setup** 2. Edit your Jira connector by clicking the pencil icon 3. Select **OAuth 2.0** as the authentication method 4. Follow the prompt to complete the OAuth 2.0 setup steps Re-authentication is required when switching authentication methods. In order for Nucleus to authenticate to Jira using OAuth 1.0a authentication, you must create an application link in Jira. This will be used later when [creating a Jira connector in Nucleus](/v1/docs/jira-ticketing-integration). Follow the steps below to create an application link in Jira: 1. Login to Jira as an administrator and navigate to **Jira Settings** page. 2. Click on the **Products** link. 3. Click **Application Links** 4. Enter the URL of the Nucleus instance you have been assigned then click **Create new link**. 5. In the popup, click **Continue**. 6. On the **Link Applications** popup: 1. For **Application Name:**, enter 'Nucleus'. 2. For **Application Type:**, select 'Generic Application'. 3. Check the **Create Incoming Link** checkbox at the bottom 4. Click **Continue** 7. On the next screen, complete the following fields then click **Continue**: 1. For **Consumer Key**, enter a 15 character (or more) password of your choice. 2. For **Consumer Name**, enter 'Nucleus'. 3. For **Public Key**, enter the public key displayed in Nucleus on the **Properties** tab of the New/Edit Connector dialog. 8. Click **Continue** to finish setting up your application link in Jira. OAuth 1.0a Troubleshooting Note: Support for OAuth 1.0a will be removed in a future release. When using OAuth 1.0a, Nucleus communicates with your Jira Server over HTTPS and relies on a callback from Jira to complete authentication. Your Jira Server must be able to establish outbound HTTPS connections (port 443) to your Nucleus instance. If your Jira instance is not internet-facing, firewall or network restrictions may prevent this connection and cause authentication to fail. Ensure that outbound connectivity to Nucleus over port 443 is allowed. This is not required when using OAuth 2.0. You are now ready to continue [creating a Jira connector in Nucleus](/v1/docs/jira-ticketing-integration). #### Basic Authentication Important Basic Authentication should only be used when OAuth cannot be supported. Nucleus recommends using a **dedicated service account** (for example, **Nucleus Bot**) rather than a personal user account. 1. In Jira Cloud, identify the user account that Nucleus will use for ticket creation and updates. 2. Generate an [API token](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/). This will be used as the password when authenticating via Basic Auth. 3. Copy the **Email Address** and **API Token** for the account. 4. When configuring the connector in Nucleus, select **Basic Auth**, then enter the **Email Address** and **API Token** in the corresponding fields. For more information, refer to Atlassian’s documentation on [managing API tokens for Jira Cloud](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/). You are now ready to continue [creating a Jira connector in Nucleus](/v1/docs/jira-ticketing-integration).