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

# Jira

export const CommonAuthSchemeLdap = ({siteName = "CData Sync", siteNameShort = "Sync", datasource = "the data source"}) => {
  return <>
      <p>To connect with LDAP credentials, specify the following properties:</p>
      <ul>
        <li><strong>Auth Scheme:</strong> Select <strong>LDAP</strong>.</li>
        <li><strong>User:</strong> Enter the username that you use to authenticate to your {datasource} account.</li>
        <li><strong>Password:</strong> Enter the password that you use to authenticate to your {datasource} account.</li>
      </ul>
    </>;
};

export const CommonAuthSchemeOktaSso = ({siteName = "CData Sync", siteNameShort = "Sync", datasource = "the data source"}) => {
  return <>
      <p>To connect with single sign-on (SSO) via Okta, specify the following properties:</p>
      <ul>
        <li><strong>Auth Scheme:</strong> Select <strong>OKTA</strong>.</li>
        <li><strong>User:</strong> Enter the username that you use to authenticate to your Okta account.</li>
        <li><strong>Password:</strong> Enter the password that you use to authenticate to your Okta account.</li>
        <li><strong>SSO Login URL:</strong> Enter the login URL that is used by your SSO provider.</li>
        <li><strong>SSO Properties:</strong> Enter a semicolon-separated list of the single sign-on (SSO) properties that you want to use (for example, <em>SSOProperty1</em>=<em>Value1</em>;<em>SSOProperty2</em>=<em>Value2</em>;...).</li>
      </ul>
    </>;
};

export const CommonAuthSchemeBasic = ({siteName = "CData Sync", siteNameShort = "Sync", datasource = "the data source"}) => {
  return <>
      <p>To connect with your user credentials, set the following properties:</p>
      <ul>
        <li><strong>Auth Scheme:</strong> Select <strong>Basic</strong>.</li>
        <li><strong>User:</strong> Enter the username that you use to authenticate to your {datasource} account.</li>
        <li><strong>Password:</strong> Enter the password that you use to authenticate to your {datasource} account.</li>
      </ul>
    </>;
};

export const CommonAuthSchemeOauthEmbedded = ({siteName = "CData Sync", siteNameShort = "Sync", datasource = "the data source"}) => {
  return <>
      <p>
        {siteName} provides an embedded OAuth application with which to connect. To use the application, select <strong>OAuth</strong> for <strong>Auth Scheme</strong>. No additional properties are required.
      </p>
    </>;
};

export const CommonDatasourceMoreInformation = ({datasource = "the data source", advancedurl = "", siteName = "CData Sync", driverVersion = ""}) => {
  return <>
      <p>
        For more information about interactions between {siteName} and {datasource}, see{' '}
        <a href={`https://cdn.cdata.com/help/${advancedurl}${driverVersion}/synch/default.htm`}>
          {datasource} Connector for {siteName}
        </a>.
      </p>
    </>;
};

export const CommonDatasourceAddConnector = ({datasource = "the data source", title = "the connector", destination = false, siteNameShort = "Sync"}) => {
  return <>
      <p>
        To enable {siteNameShort} to use data from {datasource}, you first must add the
        connector, as follows:
      </p>
      <ol>
        <li>Open the <strong>Connections</strong> page of the {siteNameShort} dashboard.</li>
        <li>Click <strong>Add Connection</strong> to open the <strong>Select Connectors</strong> page.</li>
        <li>
          Click the <strong>{destination ? "Destinations" : "Sources"}</strong> tab and locate
          the <strong>{title}</strong> row.
        </li>
        <li>
          Click the <strong>Configure Connection</strong> icon at the end of that row to open
          the <strong>New Connection</strong> page. This action opens the{' '}
          <strong>Add Connection</strong> dialog box.
          <br />
          <strong>Note:</strong> If the <strong>Configure Connection</strong> icon is not
          available, click the <strong>Download Connector</strong> icon to install
          the {title} connector.
        </li>
        <li>Enter a name for your connection in the <strong>Add Connection</strong> dialog box.</li>
        <li>Click <strong>Add</strong> to open the <strong>Settings</strong> tab for your connector.</li>
      </ol>
      <p>
        For more information about installing new connectors, see{' '}
        <a href="../connections">Connections</a>.
      </p>
    </>;
};

export const CommonDatasourceIntroSource = ({datasource = "the data source", siteName = "CData Sync"}) => {
  return <p>
      You can use the {datasource} connector from the {siteName} application to capture data
      from {datasource} and move it to any supported destination. To do so, you need to add
      the connector, authenticate to the connector, and complete your connection.
    </p>;
};

export const driverVersion = "M";

export const siteNameShort = "Sync";

export const siteName = "CData Sync";

export const datasource = "Jira";
export const pageTitle = "Jira";
export const advancedurl = "BJ";
export const oauthschemes = "OAuth";

<CommonDatasourceIntroSource datasource={datasource} siteName={siteName} />

## Add the Jira Connector

<CommonDatasourceAddConnector datasource={datasource} title={pageTitle} destination={false} siteNameShort={siteNameShort} />

## Authenticate to Jira

After you add the connector, you need to set the required properties.

**URL:** Enter the URL for your Jira endpoint (for example, https\://*YourSiteName*.atlassian.net).

{siteName} supports authenticating to {datasource} in several ways. Select your authentication method below to proceed to the relevant section that contains the authentication details.

* [**OAuth**](#oauth)
* [**PAT**](#personal-access-token)
* [**APIToken**](#api-token)
* [**Basic**](#basic)
* [**Crowd**](#crowd)
* [**OKTA**](#okta)
* [**LDAP**](#ldap)

### OAuth

<CommonAuthSchemeOauthEmbedded siteName={siteName} siteNameShort={siteNameShort} datasource={datasource} />

### Personal Access Token

To connect with a personal access token, specify the following properties:

* **Auth Scheme:** Select **PAT**.
* **PAT:** Enter your personal access token (PAT). You can create a PAT either via from the Atlassian **Settings** menu or by using a REST API.

  **From the Atlassian application:**

  1. Select your profile photo at the top right of the screen.

  2. From the drop-down list, select **Settings > Profile**.

  3. In the left pane, select **Personal Access Tokens**.

  4. Click **Create token**. Then, give the new token a name.

  5. (Optional) Set your token to expire automatically after a certain number of days. (Atlassian displays a reminder message five days before the token actually expires, which gives you time to create a new token.)

     <Note>According to the <a href="https://developer.atlassian.com/server/jira/platform/oauth/" target="_blank" rel="noopener noreferrer">Atlassian Developer guide</a>, the PAT persists for five years by default.</Note>

  6. Click **Create**. After the token is created, make sure to copy and save it because you cannot view or retrieve it later.

  **From a REST API:**

  To create a PAT by using the REST API, see "Creating PATS using REST API" in the Atlassian <a href="https://confluence.atlassian.com/enterprise/using-personal-access-tokens-1026032365.html" target="_blank" rel="noopener noreferrer">Using Personal Access Tokens</a> documentation.

### API Token

To connect with an API token, specify the following properties:

* **Auth Scheme:** Select **Token**.
* **User:** Enter the username that you use to authenticate to your {datasource} account.
* **API Token:** Enter your API token.

  To generate an API token in Atlassian:

  1. Log in to your Atlassian account.
  2. Select **Security > Create and manage API tokens > Create API token**.

### Basic

<CommonAuthSchemeBasic siteName={siteName} siteNameShort={siteNameShort} datasource={datasource} />

### Crowd

To connect with single sign-on (SSO) via Atlassian Crowd, specify the following properties:

* **Auth Scheme:** Select **Token**.
* **User:** Enter the username that you use to authenticate to your {datasource} account.
* **Password:** Enter the password that you use to authenticate to your {datasource} account.
* **SSO Login URL:** Enter the login URL that is used by your SSO provider.
* **SSO Exchange UrI:** Enter the URL that is used to exchange the Security Assertion Markup Language (SAML) token for Jira cookies. This URL can be in either of the following formats:
  * https\://*AuthorityofJiraInstance*/plugins/servlet/samlconsumer
  * https\://*AuthorityofJiraInstance*/plugins/servlet/samlsso
* **SSO App Name:** Enter the name of the application in which SSO is enabled.
* **SSO App Password:** Enter the password of the application in which SSO is enabled.

### Okta

<CommonAuthSchemeOktaSso siteName={siteName} siteNameShort={siteNameShort} datasource={datasource} />

* **SSO Exchange UrI:** Enter the URL that is used to exchange the Security Assertion Markup Language (SAML) token for Jira cookies. This URL can be in either of the following formats:
  * https\://*AuthorityofJiraInstance*/plugins/servlet/samlconsumer
  * https\://*AuthorityofJiraInstance*/plugins/servlet/samlsso

### LDAP

<CommonAuthSchemeLdap siteName={siteName} siteNameShort={siteNameShort} datasource={datasource} />

## Complete Your Connection

To complete your connection:

1. Define advanced connection settings on the **Advanced** tab. (In most cases, though, you should not need these settings.)
2. {oauthschemes ? `If you authenticate with ${oauthschemes}, click` : "Click"} **Connect to {datasource}** to connect to your {pageTitle} account.
3. Click **Create & Test** to create your connection.

## More Information

<CommonDatasourceMoreInformation datasource={datasource} advancedurl={advancedurl} siteName={siteName} driverVersion={driverVersion} />