diff --git a/docs/platform-services/automation-service/app-central/integrations/atlassian-jira-cloud.md b/docs/platform-services/automation-service/app-central/integrations/atlassian-jira-cloud.md new file mode 100644 index 0000000000..c9d52cea37 --- /dev/null +++ b/docs/platform-services/automation-service/app-central/integrations/atlassian-jira-cloud.md @@ -0,0 +1,72 @@ +--- +title: Atlassian Jira Cloud +description: '' +--- + +import useBaseUrl from '@docusaurus/useBaseUrl'; + +atlassian-jira-v2 + +***Version: 1.0 +Updated: March 20 , 2025*** + +Jira is a proprietary issue tracking product developed by Atlassian that allows bug tracking and agile project management. + +## Actions + +* **Add Comment to Issue** *(Notification)* - Add a comment to the specified issue. +* **Create Issue** (*Notification*) - Create a new issue in the specified Jira project. +* **Delete Issue** (*Containment*) - Delete the specified issue. +* **Get Issue** *(Enrichment)* - Returns the details for an issue. +* **Get Issue Comments** *(Enrichment)* - Get the comments of issue. +* **List Issue Fields** *(Enrichment)* - List the issue fields. +* **List Issue Transitions** *(Enrichment)* - Returns either all transitions or a transition that can be performed by the user on an issue, based on the issue's status. +* **List Issue Types** *(Enrichment)* - List the types of issue. +* **List Projects** *(Enrichment)* - List the current projects. +* **List Statuses** *(Enrichment)* - Returns a list of the statuses. +* **List Users** *(Enrichment)* - Returns a list of all users. +* **Search Into Issues** *(Enrichment)* - Search Jira Issues. +* **Update Issue** (*Notification*) - Update the specified issue field with the specified value. + +## Atlassian Jira Cloud configuration + +Sign in to [Jira](https://id.atlassian.com) with your Atlassian account. + +atlassian-jira-v2-2 + +## Create an API token + +Create an API token from your Atlassian account: +1. Log in to https://id.atlassian.com/manage-profile/security/api-tokens. +1. Click **Create API token**. +1. From the dialog that appears, enter a memorable and concise **Label** for your token and click **Create**. +1. Click **Copy to clipboard**, then paste the token to your script, or elsewhere to save.
atlassian-jira-v2-3 + +## Revoke an API token + +A revoked token no longer works and is permanently removed from your account. If you revoke an API token currently being used, you can replace it with a new token. To revoke an API token: +1. Log in to https://id.atlassian.com/manage-profile/security/api-tokens. +1. Select **Revoke** next to the API token that you want to revoke. +1. To revoke all API tokens for your account, select **Revoke all API tokens**. + +## Atlassian Jira Cloud in Automation Service and Cloud SOAR + +1. Access integrations in the [Automation Service](/docs/platform-services/automation-service/automation-service-integrations/#view-integrations) or [Cloud SOAR](/docs/cloud-soar/automation). +1. After the list of the integrations appears, search for the integration and click on the row. +1. The integration details will appear. Click on the **"+"** button to add a new resource.
atlassian-jira-v2-4 +1. Label and populate all the required fields (\*). + 1. **Label**. Add a name for the resource. + 1. **URL API**. Enter your Atlassian site URL. For example, `https://your-atlassian-site.atlassian.net/`. + 1. **Username**. Enter your email address. + 1. **API Token**. Insert the previously copied token.
atlassian-jira-v2-8 +1. Click **SAVE**. +1. To make sure the resource is working, hover over the resource and then click the **TEST**.
atlassian-jira-v2-7 +1. You should receive a successful notification in the bottom right corner.
atlassian-jira-v2-6 + +## Category + +Ticketing System + +## Change Log + +* March 20, 2025 - First upload \ No newline at end of file diff --git a/docs/platform-services/automation-service/app-central/integrations/index.md b/docs/platform-services/automation-service/app-central/integrations/index.md index 606cdb92a4..ee8ecf577b 100644 --- a/docs/platform-services/automation-service/app-central/integrations/index.md +++ b/docs/platform-services/automation-service/app-central/integrations/index.md @@ -13,7 +13,7 @@ Please refer to the individual integration documentation for detailed informatio Some integrations are tailor-made for Cloud SOAR and are indicated as such within their respective documentation entries. These integrations only appear in the [App Central](/docs/cloud-soar/automation) in Cloud SOAR. ::: -## Integrations (336) +## Integrations (337) import DocCardList from '@theme/DocCardList'; import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; diff --git a/static/img/platform-services/automation-service/app-central/integrations/atlassian-jira-v2/atlassian-jira-v2-8.png b/static/img/platform-services/automation-service/app-central/integrations/atlassian-jira-v2/atlassian-jira-v2-8.png new file mode 100644 index 0000000000..494ade2127 Binary files /dev/null and b/static/img/platform-services/automation-service/app-central/integrations/atlassian-jira-v2/atlassian-jira-v2-8.png differ