Skip to content

Commit 1b6f83f

Browse files
authored
Update integrations.mdx (#70)
1 parent 24d57cd commit 1b6f83f

File tree

1 file changed

+29
-4
lines changed

1 file changed

+29
-4
lines changed

cloud/scanning/integrations.mdx

Lines changed: 29 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -57,21 +57,21 @@ For example, send a custom webhook to an internal alerting system in this format
5757

5858
## Ticketing
5959

60-
The integrations under Ticketing support ticketing functionality as part of scanning and include support for Jira, GitHub, and GitLab.
60+
The integrations under Ticketing support ticketing functionality as part of scanning and include support for Jira, GitHub, GitLab, and Linear.
6161

6262
<img height="300" src="/images/platform/scansticketing.png" />
6363

6464
### Jira
6565

66-
PDCP provides integration support for Jira that includes creating new tickets when vulnerabilities are found.
66+
PDCP provides integration support for Jira to create new tickets when vulnerabilities are found.
6767

6868
Provide a name for the configuration, the Jira instance URL , the Account ID, the Email, and the associated API token.
6969

7070
Details on creating an API token are available [in the Jira documentation here.](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/)
7171

7272
### GitHub
7373

74-
PDCP provides integration support for GitHub to support the creation of new tickets when vulnerabilities are found.
74+
PDCP provides integration support for GitHub to create new tickets when vulnerabilities are found.
7575

7676
Provide a name for the configuration, the Organization or username, Project name, Issue Assignee, Token, and Issue Label. The Issue Label determines when a ticket is created. (For example, if critical severity is selected, any issues with a critical severity will create a ticket.)
7777

@@ -82,14 +82,39 @@ Details on setting up access in GitHub [are available here.](https://docs.github
8282

8383
### GitLab
8484

85-
ProjectDiscovery Cloud Platform provides integration support for GitLab to support the creation of new tickets when vulnerabilities are found. Provide your GitLab username, Project name, Project Access Token and a GitLab Issue label. The Issue Label determines when a ticket is created.
85+
ProjectDiscovery Cloud Platform provides integration support for GitLab to create new tickets when vulnerabilities are found.
86+
87+
Provide your GitLab username, Project name, Project Access Token and a GitLab Issue label. The Issue Label determines when a ticket is created.
8688
(For example, if critical severity is selected, any issues with a critical severity will create a ticket.)
8789

8890
- The severity as label option adds a template result severity to any GitLab issues created.
8991
- Deduplicate posts any new results as comments on existing issues instead of creating new issues for the same result.
9092

9193
Refer to GitLab’s documentation for details on [configuring a Project Access token.](https://docs.gitlab.com/ee/user/project/settings/project_access_tokens.html#create-a-project-access-token)
9294

95+
### Linear
96+
97+
ProjectDiscovery Cloud Platform provides integration support for Linear to create new tickets when vulnerabilities are found.
98+
99+
Provide your Linear API Key, Linear Team ID, and Linear Open State ID to set up the integration. Here are the specific steps to access or generate each parameter from your Linear workspace.
100+
101+
- To generate your **Linear API Key**, navigate to Linear > Profile Icon > Preferences > API > Personal API keys > Create new API key. Or, navigate to linear.app/[workspace name]/settings/api.
102+
- To retrieve your **Linear Team ID**, you can use the following cURL command
103+
```bash
104+
curl -X POST https://api.linear.app/graphql \
105+
-H "Content-Type: application/json" \
106+
-H "Authorization: YOUR_API_KEY" \
107+
-d '{"query":"query { teams { nodes { id name } } }"}'
108+
```
109+
- To retrieve your **Linear Open State ID**, you can use the following cURL command
110+
```bash
111+
curl -X POST https://api.linear.app/graphql \
112+
-H "Content-Type: application/json" \
113+
-H "Authorization: YOUR_API_KEY" \
114+
-d '{"query":"query { workflowStates { nodes { id name } } }"}'
115+
```
116+
Refer to Linear's [documentation](https://developers.linear.app/docs/graphql/working-with-the-graphql-api) for details on their API.
117+
93118
## Scan Configs
94119
Use scan configurations to implement custom http headers, template variables, and custom interactsh server for your scans.
95120

0 commit comments

Comments
 (0)