> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira Service Desk

export const title_4 = "Jira Service Desk";

export const title_3 = "Jira Service Desk";

export const title_2 = "Jira Service Desk";

export const title_1 = "Jira Service Desk";

export const title_0 = "Jira Service Desk";

## Setup Guide

Follow these steps to connect Jira Service Desk to your Connect AI account:

<Steps>
  <Step>
    Open the **Sources** page of the Connect AI navigation menu.
  </Step>

  <Step>
    Click **+ Add Connection** in the upper-right corner.
  </Step>

  <Step>
    Type *Jira Service Desk* into the search field, then click the data source name.
  </Step>

  <Step>
    On the **Basic Settings** tab of the new connection, enter a connection name or keep the default name.
  </Step>

  <Step>
    Select an **AuthScheme** and follow the relevant instructions below.
  </Step>
</Steps>

## Authentication Methods

<Tabs>
  <Tab title="Basic">
    <Steps>
      <Step>
        Enter the following information:

        * **User**—the Jira Service Desk username for authentication.
        * **Password**—the user password.
        * **URL**—the URL to your Jira Service Desk endpoint (for example, `https://yoursitename.atlassian.net`).
      </Step>

      <Step>
        At the top of the Connect AI **Add {title_0} Connection** page, click **Save & Test**.

        * If the connection test succeeds, a **Connection successfully saved** message appears, indicating that your connection has been created. The **Status** on the **Edit Connection** page also changes to **Authenticated**. View the data model of your successful connection in the right pane of the **Edit Connection** page, in the **Data Model** tab.
        * If the connection test fails, ensure that you entered your login information correctly with no stray spaces or other characters. Connect AI displays error messages under the required fields with missing data. Some data sources require that you sign in directly to the source website. If you did not, an error message appears under the **Sign in** button. Correct the errors and try again.
        * Unsuccessful connections are saved as drafts and have a **Status** of **Not Authenticated**. You can return to the connection and authenticate it later.
      </Step>
    </Steps>
  </Tab>

  <Tab title="OAuth">
    The **Callback URL**, or Redirect URL, is the URL you need (`https://oauth.cdata.com/oauth/`) when setting up your OAuth app. Copy this URL and paste it into your OAuth app.

    <Steps>
      <Step>
        Enter the following information:

        * **OAuth Client Id**—the client Id assigned when you registered your Jira Service Desk account for OAuth.
        * **OAuth Client Secret**—the client secret assigned when you registered your Jira Service Desk account for OAuth.
        * **URL**—the URL to your Jira Service Desk endpoint (for example, `https://yoursitename.atlassian.net`).
      </Step>

      <Step>
        Click **Sign in** to connect securely through OAuth. This action opens the Jira Service Desk sign-in page in a new tab.
      </Step>

      <Step>
        Log in to your Jira Service Desk account and provide the requested permissions (if applicable).
      </Step>

      <Step>
        At the top of the Connect AI **Add {title_1} Connection** page, click **Save & Test**.

        * If the connection test succeeds, a **Connection successfully saved** message appears, indicating that your connection has been created. The **Status** on the **Edit Connection** page also changes to **Authenticated**. View the data model of your successful connection in the right pane of the **Edit Connection** page, in the **Data Model** tab.
        * If the connection test fails, ensure that you entered your login information correctly with no stray spaces or other characters. Connect AI displays error messages under the required fields with missing data. Some data sources require that you sign in directly to the source website. If you did not, an error message appears under the **Sign in** button. Correct the errors and try again.
        * Unsuccessful connections are saved as drafts and have a **Status** of **Not Authenticated**. You can return to the connection and authenticate it later.
      </Step>
    </Steps>
  </Tab>

  <Tab title="APIToken">
    <Steps>
      <Step>
        Enter the following information:

        * **User**—the Jira Service Desk username for authentication.
        * **API Token**—to connect to a Connect AI account, you need to retrieve an API token. To generate one, log in to your Atlassian account and under **Security** settings, click **Create and manage API tokens** and then click **Create API token**.
        * **URL**—the URL to your Jira Service Desk endpoint (for example, `https://yoursitename.atlassian.net`).
      </Step>

      <Step>
        At the top of the Connect AI **Add {title_2} Connection** page, click **Save & Test**.

        * If the connection test succeeds, a **Connection successfully saved** message appears, indicating that your connection has been created. The **Status** on the **Edit Connection** page also changes to **Authenticated**. View the data model of your successful connection in the right pane of the **Edit Connection** page, in the **Data Model** tab.
        * If the connection test fails, ensure that you entered your login information correctly with no stray spaces or other characters. Connect AI displays error messages under the required fields with missing data. Some data sources require that you sign in directly to the source website. If you did not, an error message appears under the **Sign in** button. Correct the errors and try again.
        * Unsuccessful connections are saved as drafts and have a **Status** of **Not Authenticated**. You can return to the connection and authenticate it later.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Crowd">
    <Steps>
      <Step>
        Enter the following information:

        * **User**—the Jira Service Desk username for authentication.
        * **Password**—the user password.
        * **SSO Login URL**—the login URL associated with the Crowd account. You can find the IDP URL by navigating to **your application** > **SSO** > **SSO information** > **Identity provider single sign-on URL**.
        * **SSO Exchange URL**—the URL used to exchange the SAML token for Jira Service Desk cookies. This URL may have the following formats: `https://<authority of Jira Service Desk instance>/plugins/servlet/samlconsumer` or `https://<authority of Jira Service Desk instance>/plugins/servlet/samlsso`.
        * **SSO App Name**—the name of the application in which SSO is enabled.
        * **SSO App Password**—the password of the application in which SSO is enabled.
        * **URL**—the URL to your Jira Service Desk endpoint (for example, `https://yoursitename.atlassian.net`).
      </Step>

      <Step>
        At the top of the Connect AI **Add {title_3} Connection** page, click **Save & Test**.

        * If the connection test succeeds, a **Connection successfully saved** message appears, indicating that your connection has been created. The **Status** on the **Edit Connection** page also changes to **Authenticated**. View the data model of your successful connection in the right pane of the **Edit Connection** page, in the **Data Model** tab.
        * If the connection test fails, ensure that you entered your login information correctly with no stray spaces or other characters. Connect AI displays error messages under the required fields with missing data. Some data sources require that you sign in directly to the source website. If you did not, an error message appears under the **Sign in** button. Correct the errors and try again.
        * Unsuccessful connections are saved as drafts and have a **Status** of **Not Authenticated**. You can return to the connection and authenticate it later.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Okta">
    <Steps>
      <Step>
        Enter the following information:

        * **User**—the Jira Service Desk username for authentication.
        * **Password**—the user password.
        * **SSO Login URL**—the login URL associated with the Okta account. You can find the IDP URL by navigating to **your application** > **SSO** > **SSO information** > **Identity provider single sign-on URL**.
        * **SSO Properties**—enter all relevant properties with the format 'ssoproperty1=value1;ssoproperty2=value2;ssoproperty3=value3;'. Make sure to separate all property-value pairs with semicolons.
        * **SSO Exchange URL**—the URL used to exchange the SAML token for Jira Service Desk cookies. This URL may have the following formats: `https://<authority of Jira Service Desk instance>/plugins/servlet/samlconsumer` or `https://<authority of Jira Service Desk instance>/plugins/servlet/samlsso`.
        * **URL**—the URL to your Jira Service Desk endpoint (for example, `https://yoursitename.atlassian.net`).
      </Step>

      <Step>
        At the top of the Connect AI **Add {title_4} Connection** page, click **Save & Test**.

        * If the connection test succeeds, a **Connection successfully saved** message appears, indicating that your connection has been created. The **Status** on the **Edit Connection** page also changes to **Authenticated**. View the data model of your successful connection in the right pane of the **Edit Connection** page, in the **Data Model** tab.
        * If the connection test fails, ensure that you entered your login information correctly with no stray spaces or other characters. Connect AI displays error messages under the required fields with missing data. Some data sources require that you sign in directly to the source website. If you did not, an error message appears under the **Sign in** button. Correct the errors and try again.
        * Unsuccessful connections are saved as drafts and have a **Status** of **Not Authenticated**. You can return to the connection and authenticate it later.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## More Information

For more information about interactions between Connect AI and Jira Service Desk, see [this information page](https://cdn.cdata.com/help/GKM/cloud/default.htm#default).