Authorization

When you add a Jira Service Management card to a flow for the first time, Okta prompts you to configure the connection.

This connection enables you to connect your Jira Service Management account, save your account information, and reuse the connection in new flows.

You can create multiple unique connections and manage them from the Connections page in the Okta Workflows Console.

Configure your Jira Service Management environment

Confirm permissions

To use the event cards for the Jira Service Management connector, you must create an API token from an account that has the Administer Jira global permission. See Manage Global Permissions to understand the definitions.

Because this permission is applied at a group level, you must know which group your user account belongs to before you begin. Complete the following steps:

  1. Sign in to your Jira account as a user with administration privileges.

  2. Switch to your Jira Service Management dashboard.

  3. Click the gear icon and select System.

  4. Click Global Permissions.

  5. Click Configure permissions in user management under the Administer Jira permission section.

  6. Under Product access, add the group to Jira Service Management. This grants all users of this group access to Jira Service Management.

  7. Under Administration access, add the group to Jira Administration. This grants all users of this group Administer permission.

Beginning January 2, 2024, each Jira instance has a limit of up to 100 active Jira admin webhooks.

Create API token

To build flows using the event or action cards of your Jira Service Management connector, you must have a valid API token for your Atlassian account. To create your API token, see Manage API tokens for your Atlassian account.

Configure your connection in Okta Workflows

To create a connection from an event or action card:

  1. Click New Connection.

  2. Enter a Connection Nickname. Make this nickname unique so you can authorize multiple Jira accounts.

  3. Select the Domain where your Jira Service Management instance is located. The default is atlassian.net.

  4. Enter a Subdomain for your Jira Service Management instance. For example, if your Jira domain is your-company.atlassian.net, enter your-company.

  5. Enter your Username and your Jira API Token.

    To create and manage API tokens for your Jira Service Management instance, see Manage API tokens for your Atlassian account.

  6. Click Create to save your configuration.

If you revoke or delete your API token, you must generate a new token and update all of your connections to use the new token. See Connections page.

Jira automatically locks you out of the API if four calls are made with old or incorrect passwords or tokens. If any active flows attempt to use an old token, all API calls will fail (including those that use the correct credentials). To regain API access, you must change your password.

Related topics

Jira Service Management connector

Workflow elements

Jira Service Management API