*** title: Jira Service Management (Cloud) - Access Requirements excerpt: '' deprecated: false hidden: false metadata: title: '' description: '' robots: index next: description: '' --------------- # Create the Service Account in Jira ## Why do we need access to your Jira Service Management project? The bot will directly perform actions in Jira to create, update, and query information about tickets. **NOTE:** All end users are required to exist as "Customers" in the Jira Service Desk project in order to create/update/query tickets through the bot. You may replicate the steps below for your non-production instance/project. ## Service Account Setup In your Production Jira environment, create a Service Account for Moveworks. Follow the instructions in this guide: [https://support.atlassian.com/jira-cloud-administration/service-management/core-platform/user-identity/overview/](https://support.atlassian.com/jira-cloud-administration/service-management/core-platform/user-identity/overview/) The following settings are required: * Set the **timezone** for this account to `America/Danmarkshavn`. * In the Atlassian Admin page, assign the ***jira-servicedesk-users*** role * In the Jira Service Desk Project Settings, assign the ***Service Desk Team*** role ### Create the API Token API access for Jira Cloud is done through a username and API token. Here are the steps to create an API token for a Service Account: 1. Log in to [https://id.atlassian.com/manage/api-tokens](https://id.atlassian.com/manage/api-tokens) using the Service Account user credentials. 2. Click Create API token. 3. From the dialog that appears, enter a label for the token (Moveworks) and click Create. 4. Click Copy to clipboard, and use it when creating the connector in Moveworks Setup (described below). # Install the Moveworks Jira Marketplace App Due to Atlassian GDPR requirements, ingesting user information such as Jira ID, email, and name cannot be done with a service account and requires Atlassian approved application. The [Moveworks Jira Application](/service-management/access-requirements/ticketing-systems-itsms/jira-cloud-identity) is an Atlassian-approved application used to integrate Jira Cloud as an identity source in Moveworks, and must be installed. # Create the Connector in Moveworks Setup Navigate to **Core Platform** > **System Connectors** and create a new connector. Select Jira Service Desk and enter the information below: * **Connection Name**: jira\_service\_desk (recommended) * **Common Base Url**: Enter the URL of your Atlassian instance * **Authentication Type**: Jira Cloud Basic Auth * **Username**: Enter the username of the service account created earlier * **Password**: Enter the \_API token \_created earlier ![](https://files.readme.io/d6ee1e6d4aa5379d799e8648a4fb84096df66e488cec36519a1b0d3aa7245e6f-image.png) ## Enable checkbox for AccountID setting (REQUIRED) This checkbox is required for your AI Assistant to correctly identify users in Jira. ![](https://files.readme.io/38bf3d600a4ecf67a58183d4fcf43e79a655432af5c3e0b82a100c2dda4a9658-image.png)
# Appendix - Other Jira Settings ## Jira Workflow Export An XML export of your Jira Service Desk workflow can help with your Moveworks bot ticketing configuration. See instructions here on how to export your workflow: [https://support.atlassian.com/jira-cloud-administration/agent-studio/agent-studio/development-and-testing/import-and-export/](https://support.atlassian.com/jira-cloud-administration/agent-studio/agent-studio/development-and-testing/import-and-export/) ## Statuses Moveworks categorizes your statuses into the following buckets. If there is no corresponding status, your Moveworks team may recommend an additional status. * New / Reopened * In Progress * Waiting for User * Resolved / Closed ## Transitions In order for the Moveworks bot to transition tickets to the appropriate statuses, it is recommended to create the following transitions within your Jira workflows for all issue types that Moveworks will be interacting with. Please note that these transitions **may be optional** based on the functionality and skills enabled within your Moveworks bot. If workflows are not adjusted accordingly the bot will be unable to transition tickets to resolved, in progress, and re-opened statuses. However the bot will still be able to recognize the tickets/issue types, send update notifications, and allow users to comment, without the need to update your workflows. * `Any Status → Resolved` (or similar status) * This is to allow tickets to be resolved by an end user if they choose to do so. * This transition is **required** if the bot is performing an end-to-end resolution using the Software Access, Group Access, or Ticket Interception skills. * `Any Status → In Progress` (or similar status) * This is to allow tickets to be put in an "In Progress" status after a user has responded to an agent comment on a ticket. * `Any Status → Re-Opened` (or similar status) * This is to allow tickets to be re-opened if a user still requires help on the particular issue. Example of `Any Status → Resolved` transition: ![](https://files.readme.io/5c950fe-image.png) ## Setting Fields Upon Resolution Moveworks requires the *Assignee* field to be on the Resolved screen, so it can be set as the Assignee when an issue is resolved by the bot. Any other fields that must be set upon Resolution should also be present on this screen, so Moveworks can set the appropriate value. This is required even if the transition is restricted to API access only. [This article](https://confluence.atlassian.com/jirakb/map-a-screen-to-a-workflow-transition-in-jira-company-managed-projects-720634253.html) will walk through the steps of how to add a screen to a workflow transition and map it to the *resolve* transition. In this case, instead of the custom field called out in the document linked above, you can add the *Assignee* field. The field needs to be on the transition screen in order to be available to update during the transition. ## Restricting Transitions (optional) Transitions may be locked down to API-only use so agents can continue to follow their existing workflows without confusion: ![](https://files.readme.io/70dc590-small-Screen_Shot_2020-05-15_at_11.18.17_AM.png) ## Enhancing Bot Transitions (optional) Bot-specific transitions also allow JIRA admins to control static values. Here are some common use cases: 1. Set `Resolution` to `Done` 2. Reopen set assignee to `Unassigned` 3. Navigate to `Workflows`, select the `transition`, and click `Post Functions` from the pop-up. ![](https://files.readme.io/d4c552c-small-Screen_Shot_2020-11-19_at_8.28.30_PM.png) 4. Select the `Post Functions` tab and click `Add post function` ![](https://files.readme.io/78242c4-small-Screen_Shot_2020-11-19_at_8.32.02_PM.png) 5. Select `Update Issue Field` ![](https://files.readme.io/e234b4c-small-Screen_Shot_2020-11-19_at_8.33.00_PM.png) 6. Select the appropriate `Issue Field` and `Field Value` ![](https://files.readme.io/13b70a9-small-Screen_Shot_2020-11-19_at_8.33.57_PM.png) 7. Additional values will require additional `Post Functions`