Skip to content

Commit 4a6e244

Browse files
authored
Add links to third-party docs (#5321)
1 parent 326d485 commit 4a6e244

File tree

13 files changed

+39
-20
lines changed

13 files changed

+39
-20
lines changed

docs/platform-services/automation-service/app-central/integrations/atlassian-jira-cloud.md

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -5,15 +5,15 @@ description: ''
55

66
import useBaseUrl from '@docusaurus/useBaseUrl';
77

8-
<img src={useBaseUrl('/img/platform-services/automation-service/app-central/logos/atlassian-jira-v2.png')} alt="atlassian-jira-v2" width="80"/>
8+
<img src={useBaseUrl('/img/platform-services/automation-service/app-central/logos/atlassian-jira-v2.png')} alt="Atlassian logo" width="80"/>
99

10-
***Version: 1.0
10+
***Version: 1.0
1111
Updated: March 20 , 2025***
1212

1313
Jira is a proprietary issue tracking product developed by Atlassian that allows bug tracking and agile project management.
1414

1515
:::note
16-
This integration uses the [Jira REST API v3](https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#version).
16+
This integration uses the [Jira REST API v3](https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#about).
1717
:::
1818

1919
## Actions
@@ -38,15 +38,15 @@ Sign in to [Jira](https://id.atlassian.com) with your Atlassian account.
3838

3939
<img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/atlassian-jira-v2/atlassian-jira-v2-2.png')} style={{border:'1px solid gray'}} alt="atlassian-jira-v2-2" width="300"/>
4040

41-
## Create an API token
41+
### Create an API token
4242

4343
Create an API token from your Atlassian account:
4444
1. Log in to https://id.atlassian.com/manage-profile/security/api-tokens.
4545
1. Click **Create API token**.
4646
1. From the dialog that appears, enter a memorable and concise **Label** for your token and click **Create**.
4747
1. Click **Copy to clipboard**, then paste the token to your script, or elsewhere to save.<br/><img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/atlassian-jira-v2/atlassian-jira-v2-3.png')} style={{border:'1px solid gray'}} alt="atlassian-jira-v2-3" width="300"/>
4848

49-
## Revoke an API token
49+
### Revoke an API token
5050

5151
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:
5252
1. Log in to https://id.atlassian.com/manage-profile/security/api-tokens.
@@ -59,17 +59,18 @@ import IntegrationsAuth from '../../../../reuse/integrations-authentication.md';
5959

6060
<IntegrationsAuth/>
6161

62+
For information about Atlassian, see [Atlassian documentation](https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#about).
63+
6264
1. Access integrations in the [Automation Service](/docs/platform-services/automation-service/automation-service-integrations/#view-integrations) or [Cloud SOAR](/docs/cloud-soar/automation).
6365
1. After the list of the integrations appears, search for the integration and click on the row.
6466
1. The integration details will appear. Click on the **"+"** button to add a new resource.<br/><img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/atlassian-jira-v2/atlassian-jira-v2-4.png')} style={{border:'1px solid gray'}} alt="atlassian-jira-v2-4" width="100"/>
6567
1. Label and populate all the required fields (\*).
6668
1. **Label**. Add a name for the resource.
67-
1. **URL API**. Enter your Atlassian site URL. For example, `https://your-atlassian-site.atlassian.net/`.
69+
1. **URL API**. Enter your Atlassian site URL. For example, `https://your-atlassian-site.atlassian.net/`. For information about Atlassian, see [Atlassian documentation](https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#about).
6870
1. **Username**. Enter your email address.
69-
1. **API Token**. Insert the previously copied token.<br/><img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/atlassian-jira-v2/atlassian-jira-v2-8.png')} style={{border:'1px solid gray'}} alt="atlassian-jira-v2-8" width="400"/>
71+
1. **API Token**. Insert the previously copied token.<br/><img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/atlassian-jira-v2/atlassian-jira-v2-5.png')} style={{border:'1px solid gray'}} alt="atlassian-jira-v2-8" width="400"/>
72+
1. To make sure the resource is working, click **TEST**. You should receive a successful notification in the bottom right corner.<br/><img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/atlassian-jira-v2/atlassian-jira-v2-6.png')} style={{border:'1px solid gray'}} alt="atlassian-jira-v2-6" width="250"/>
7073
1. Click **SAVE**.
71-
1. To make sure the resource is working, hover over the resource and then click the **TEST**.<br/><img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/atlassian-jira-v2/atlassian-jira-v2-7.png')} style={{border:'1px solid gray'}} alt="atlassian-jira-v2-7" width="150"/>
72-
1. You should receive a successful notification in the bottom right corner.<br/><img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/atlassian-jira-v2/atlassian-jira-v2-6.png')} style={{border:'1px solid gray'}} alt="atlassian-jira-v2-6" width="250"/>
7374

7475
## Category
7576

docs/platform-services/automation-service/app-central/integrations/atlassian-jira-v2.md

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -5,15 +5,15 @@ description: ''
55

66
import useBaseUrl from '@docusaurus/useBaseUrl';
77

8-
<img src={useBaseUrl('/img/platform-services/automation-service/app-central/logos/atlassian-jira-v2.png')} alt="atlassian-jira-v2" width="80"/>
8+
<img src={useBaseUrl('/img/platform-services/automation-service/app-central/logos/atlassian-jira-v2.png')} alt="Atlassian logo" width="80"/>
99

1010
***Version: 2.10
1111
Updated: September 2 , 2024***
1212

1313
Jira is a proprietary issue tracking product developed by Atlassian that allows bug tracking and agile project management.
1414

1515
:::note
16-
This integration uses the [Jira REST API v2](https://developer.atlassian.com/cloud/jira/platform/rest/v2/intro/#version).
16+
This integration uses the [Jira REST API v2](https://developer.atlassian.com/cloud/jira/platform/rest/v2/intro/#about).
1717
:::
1818

1919
## Actions
@@ -42,15 +42,15 @@ Sign in to [Jira](https://id.atlassian.com) with your Atlassian account.
4242

4343
<img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/atlassian-jira-v2/atlassian-jira-v2-2.png')} style={{border:'1px solid gray'}} alt="atlassian-jira-v2-2" width="300"/>
4444

45-
## Create an API token
45+
### Create an API token
4646

4747
Create an API token from your Atlassian account:
4848
1. Log in to https://id.atlassian.com/manage-profile/security/api-tokens.
4949
1. Click **Create API token**.
5050
1. From the dialog that appears, enter a memorable and concise **Label** for your token and click **Create**.
5151
1. Click **Copy to clipboard**, then paste the token to your script, or elsewhere to save.<br/><img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/atlassian-jira-v2/atlassian-jira-v2-3.png')} style={{border:'1px solid gray'}} alt="atlassian-jira-v2-3" width="300"/>
5252

53-
## Revoke an API token
53+
### Revoke an API token
5454

5555
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:
5656
1. Log in to https://id.atlassian.com/manage-profile/security/api-tokens.
@@ -63,20 +63,21 @@ import IntegrationsAuth from '../../../../reuse/integrations-authentication.md';
6363

6464
<IntegrationsAuth/>
6565

66+
For information about Atlassian, see [Atlassian documentation](https://developer.atlassian.com/cloud/jira/platform/rest/v2/intro/#about).
67+
6668
1. Access integrations in the [Automation Service](/docs/platform-services/automation-service/automation-service-integrations/#view-integrations) or [Cloud SOAR](/docs/cloud-soar/automation).
6769
1. After the list of the integrations appears, search for the integration and click on the row.
6870
1. The integration details will appear. Click on the **"+"** button to add a new resource.<br/><img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/atlassian-jira-v2/atlassian-jira-v2-4.png')} style={{border:'1px solid gray'}} alt="atlassian-jira-v2-4" width="100"/>
6971
1. Label and populate all the required fields (\*).
7072
1. **Label**. Add a name for the resource.
71-
1. **URL API**. Enter your Atlassian site URL. For example, `https://your-atlassian-site.atlassian.net/`.
73+
1. **URL API**. Enter your Atlassian site URL. For example, `https://your-atlassian-site.atlassian.net/`. For information about Atlassian, see [Atlassian documentation](https://developer.atlassian.com/cloud/jira/platform/rest/v2/intro/#about).
7274
1. **Username**. Enter your email address.
7375
1. **API Token**. Insert the previously copied token.<br/><img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/atlassian-jira-v2/atlassian-jira-v2-5.png')} style={{border:'1px solid gray'}} alt="atlassian-jira-v2-5" width="400"/>
7476
1. Optional fields in the resource are used for actions.
7577
* Populate **Jira Project Name** when using the Issues **Jira Daemon** action.
7678
* Populate **Cloud SOAR API URL** and **Cloud SOAR JWT (token)** when using the **Add Issue Attachment To Incident** action.
79+
1. To make sure the resource is working, click **TEST**. You should receive a successful notification in the bottom right corner.<br/><img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/atlassian-jira-v2/atlassian-jira-v2-6.png')} style={{border:'1px solid gray'}} alt="atlassian-jira-v2-6" width="250"/>
7780
1. Click **SAVE**.
78-
1. To make sure the resource is working, hover over the resource and then click the **TEST**.<br/><img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/atlassian-jira-v2/atlassian-jira-v2-7.png')} style={{border:'1px solid gray'}} alt="atlassian-jira-v2-7" width="150"/>
79-
1. You should receive a successful notification in the bottom right corner.<br/><img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/atlassian-jira-v2/atlassian-jira-v2-6.png')} style={{border:'1px solid gray'}} alt="atlassian-jira-v2-6" width="250"/>
8081

8182
## Category
8283

docs/platform-services/automation-service/app-central/integrations/cisco-meraki.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -47,6 +47,8 @@ import IntegrationsAuth from '../../../../reuse/integrations-authentication.md';
4747

4848
<IntegrationsAuth/>
4949

50+
For information about Cisco Meraki, see [Cisco Meraki documentation](https://developer.cisco.com/meraki/api-v1/authorization/#authorization).
51+
5052
## Change Log
5153

5254
* February 28, 2019 - First upload

docs/platform-services/automation-service/app-central/integrations/cortex-xdr.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -41,6 +41,8 @@ import IntegrationsAuth from '../../../../reuse/integrations-authentication.md';
4141

4242
<IntegrationsAuth/>
4343

44+
For information about Cortex XDR, see [Cortex XDR documentation](https://docs-cortex.paloaltonetworks.com/r/Cortex-XDR-REST-API/Get-Started-with-Cortex-XDR-APIs).
45+
4446
## Change Log
4547

4648
* July 20, 2021 - First upload

docs/platform-services/automation-service/app-central/integrations/cuckoo.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,8 @@ import IntegrationsAuth from '../../../../reuse/integrations-authentication.md';
2929

3030
<IntegrationsAuth/>
3131

32+
For information about Cuckoo, see [Cuckoo documentation](https://cuckoo.readthedocs.io/en/latest/usage/api/).
33+
3234
## Change Log
3335

3436
* September 19, 2019 - First upload

docs/platform-services/automation-service/app-central/integrations/cyberark-aam.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,8 @@ import IntegrationsAuth from '../../../../reuse/integrations-authentication.md';
2222

2323
<IntegrationsAuth/>
2424

25+
For information about CyberArk, see [CyberArk documentation](https://docs.cyberark.com/portal/latest/en/docs.htm).
26+
2527
## Change Log
2628

2729
* October 5, 2020 - First upload

docs/platform-services/automation-service/app-central/integrations/cyberark-pam.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ CyberArk Privileged Access Manager (PAM) secures privileged access, centralizes
2727

2828
import IntegrationsAuth from '../../../../reuse/integrations-authentication.md';
2929

30-
<IntegrationsAuth/>
30+
<IntegrationsAuth/> For information about CyberArk, see [CyberArk documentation](https://docs.cyberark.com/portal/latest/en/docs.htm).
3131

3232
1. Access integrations in the [Automation Service](/docs/platform-services/automation-service/automation-service-integrations/#view-integrations) or [Cloud SOAR](/docs/cloud-soar/automation).
3333
1. After the list of the integrations appears, search for the integration and click on the row.
@@ -40,9 +40,8 @@ import IntegrationsAuth from '../../../../reuse/integrations-authentication.md';
4040
* **Client Certificate**. Client Certificate in Base64 encoded format. This certificate contains your public key and is used to authenticate your identity to the server. If you have a combined .pem file that includes both the Certificate and the Private Key, use this field. Field requirement conditional on CyberArk.
4141
* **Client Private Key**. Client Private Key in Base64 encoded format. Keep your private key confidential. It is used to securely authenticate and establish an encrypted connection. If your Private Key is included in the combined Client Certificate .pem file, leave this field empty. Field requirement conditional on CyberArk.
4242
* **Root CA Certificate**. The Root CA Certificate in Base64 encoded format. Required if your server uses a certificate not trusted by default by your system or browser. This root certificate establishes trust with the server's SSL/TLS certificate. <img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/cyberark-pam/cyberark-pam-4.png')} style={{border:'1px solid gray'}} alt="cyberark-pam" width="400"/>
43-
1. To make sure the resource is working, hover over the resource and then click the pencil icon that appears on the right.<br/><img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/cyberark-pam/cyberark-pam-5.png')} style={{border:'1px solid gray'}} alt="cyberark-pam" width="400"/>
44-
1. Click **TEST SAVED SETTINGS**.<br/><img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/cyberark-pam/cyberark-pam-6.png')} style={{border:'1px solid gray'}} alt="cyberark-pam" width="400"/>
45-
1. You should receive a successful notification in the bottom right corner.<br/><img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/cyberark-pam/cyberark-pam-7.png')} style={{border:'1px solid gray'}} alt="cyberark-pam" width="400"/>
43+
1. To make sure the resource is working, click **TEST**. You should receive a successful notification in the bottom right corner.<br/><img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/cyberark-pam/cyberark-pam-7.png')} style={{border:'1px solid gray'}} alt="cyberark-pam" width="400"/>
44+
1. Click **SAVE**.
4645

4746
## Note
4847

docs/platform-services/automation-service/app-central/integrations/hatching-triage.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,8 @@ import IntegrationsAuth from '../../../../reuse/integrations-authentication.md';
2828

2929
<IntegrationsAuth/>
3030

31+
For information about Hatching Triage, see [Triage documentation](https://tria.ge/docs/).
32+
3133
## Change Log
3234

3335
* June 19, 2020 - First upload

docs/platform-services/automation-service/app-central/integrations/microsoft-onedrive.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,8 @@ import IntegrationsAuth from '../../../../reuse/integrations-authentication.md';
2525

2626
<IntegrationsAuth/>
2727

28+
For information about Microsoft OneDrive, see [OneDrive documentation](https://learn.microsoft.com/en-us/onedrive/developer/rest-api/getting-started/authentication?view=odsp-graph-online).
29+
2830
## Change Log
2931

3032
* August 5, 2019 - First upload

docs/platform-services/automation-service/app-central/integrations/microsoft-sharepoint.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,8 @@ import IntegrationsAuth from '../../../../reuse/integrations-authentication.md';
3232

3333
<IntegrationsAuth/>
3434

35+
For information about Microsoft SharePoint, see [SharePoint documentation](https://learn.microsoft.com/en-us/sharepoint/dev/sp-add-ins/sharepoint-admin-apis-authentication-and-authorization).
36+
3537
## Change Log
3638

3739
* August 14, 2019 - First upload

0 commit comments

Comments
 (0)