# Edgescan

PlexTrac integrates with Edgescan, allowing users to import the findings from Edgescan's vulnerability detection into a PlexTrac report. This integration streamlines the process by leveraging Edgescan's automated vulnerability scanning capabilities and the reporting and management features of PlexTrac.&#x20;

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FrNYwthJ6rpUsGe4RHi0e%2Fedgescan%20new.jpeg?alt=media&#x26;token=a27df35e-5ead-4456-888f-a0f731ac7dc4" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="info" %}
This is a licensed feature.&#x20;
{% endhint %}

## Field Mappings

Below are the field mappings from Edgescan to PlexTrac, broken up by findings and assets.

Tables include the following columns:

* **Edgescan Field:** the field name that appears in Edgescan
* **PlexTrac Field:** the field name that appears in PlexTrac
* **Direction:** displays the direction in the flow of data occurring for the integration (a value of "x" means that the value is not imported)
* **Required:** denotes if a value is required in the field for the import to be successful
* **Notes:** additional information

### Findings Field Mappings

<table><thead><tr><th width="174">Edgescan Field</th><th width="104" align="center">Direction</th><th width="195">PlexTrac Field</th><th width="120" align="center">Required?</th><th>Notes</th></tr></thead><tbody><tr><td>Vulnerability Name</td><td align="center">--></td><td>Finding Title</td><td align="center">yes</td><td></td></tr><tr><td>Vulnerability Description</td><td align="center">--></td><td>Finding Description</td><td align="center">yes</td><td></td></tr><tr><td>Vulnerability Date Opened</td><td align="center">--></td><td>Finding Created At</td><td align="center">no</td><td></td></tr><tr><td>Vulnerability Date Closed</td><td align="center">--></td><td>Finding Closed At</td><td align="center">no</td><td></td></tr><tr><td>Vulnerability Status</td><td align="center">--></td><td>Finding Status</td><td align="center">yes</td><td></td></tr></tbody></table>

<table data-header-hidden><thead><tr><th width="175">Edgescan Field</th><th width="104" align="center">Direction</th><th width="192">PlexTrac Field</th><th width="125" align="center">Required?</th><th>Notes</th></tr></thead><tbody><tr><td>Status</td><td align="center"></td><td></td><td align="center"></td><td>Has multiple values, which are listed below in italics.</td></tr><tr><td><em>Open</em></td><td align="center">--></td><td><em>Finding ="OPEN"</em></td><td align="center">no</td><td></td></tr><tr><td><em>Closed</em></td><td align="center">--></td><td><em>Finding = "CLOSED"</em></td><td align="center">no</td><td></td></tr><tr><td><em>Risk Accepted</em></td><td align="center">x</td><td></td><td align="center">no</td><td></td></tr><tr><td>Vulnerability Remediation</td><td align="center">--></td><td>Finding Recommendations</td><td align="center">no</td><td></td></tr><tr><td>Vulnerability CVSS Score</td><td align="center">--></td><td>Finding CVSS</td><td align="center">no</td><td></td></tr><tr><td>Vulnerability CVSS Vector</td><td align="center">--></td><td>Finding Score Type</td><td align="center">no</td><td></td></tr><tr><td>Vulnerability CVSS Vector</td><td align="center">--></td><td>Finding CVSS</td><td align="center">no</td><td></td></tr><tr><td>Vulnerability Risk</td><td align="center">--></td><td>Finding Severity</td><td align="center">no</td><td></td></tr></tbody></table>

<table data-header-hidden><thead><tr><th width="177">Edgescan Field</th><th width="102" align="center">Direction</th><th width="192">PlexTrac Field</th><th width="127" align="center">Required?</th><th>Notes</th></tr></thead><tbody><tr><td>Severity</td><td align="center"></td><td></td><td align="center"></td><td>Has multiple values, listed below in italics.</td></tr><tr><td><em>Minimal</em></td><td align="center">--></td><td><em>Informational</em></td><td align="center">no</td><td></td></tr><tr><td><em>Low</em></td><td align="center">--></td><td><em>Low</em></td><td align="center">no</td><td></td></tr><tr><td><em>Medium</em></td><td align="center">--></td><td><em>Medium</em></td><td align="center">no</td><td></td></tr><tr><td><em>High</em></td><td align="center">--></td><td><em>High</em></td><td align="center">no</td><td></td></tr><tr><td><em>Critical</em></td><td align="center">--></td><td><em>Critical</em></td><td align="center">no</td><td></td></tr><tr><td>Vulnerability Custom Details Data</td><td align="center">--></td><td>Finding Custom Field "Edgescan Details"</td><td align="center">yes</td><td></td></tr><tr><td>Vulnerability Asset Tags</td><td align="center">--></td><td>Finding Tags</td><td align="center">no</td><td></td></tr><tr><td>Vulnerability ID</td><td align="center">--></td><td>Finding Tags</td><td align="center">no</td><td></td></tr><tr><td>Organization</td><td align="center">--></td><td>Findings Tag</td><td align="center">no</td><td></td></tr></tbody></table>

### Asset Field Mappings

<table><thead><tr><th>Edgescan Field</th><th width="110" align="center">Direction</th><th width="195">PlexTrac Field</th><th width="134" align="center">Required?</th><th>Notes</th></tr></thead><tbody><tr><td>Vulnerability Asset</td><td align="center">--></td><td>Affected Assets</td><td align="center">no</td><td></td></tr><tr><td>Asset/Location</td><td align="center">--></td><td>Affected Assets</td><td align="center">no</td><td></td></tr><tr><td>Asset Name (Including Numeric ID)</td><td align="center">--></td><td>Asset Parent</td><td align="center">no</td><td></td></tr><tr><td>Locations</td><td align="center">--></td><td>Child Asset</td><td align="center">no</td><td></td></tr><tr><td>Asset Url(s)</td><td align="center">--></td><td>Asset Host FQDN</td><td align="center">no</td><td></td></tr><tr><td>Asset Host Name</td><td align="center">--></td><td>Asset Host Name</td><td align="center">no</td><td></td></tr><tr><td>Asset Ip(s)</td><td align="center">--></td><td>Asset Known Ip Address(s)</td><td align="center">no</td><td></td></tr><tr><td>Request</td><td align="center">--></td><td>Asset Evidence- Scan Output</td><td align="center">no</td><td></td></tr><tr><td>Response</td><td align="center">--></td><td>Asset Evidence- Scan Output</td><td align="center">no</td><td></td></tr><tr><td>Asset Type </td><td align="center"></td><td></td><td align="center"></td><td>Asset Type has multiple values, listed below in blue.</td></tr><tr><td><mark style="color:blue;">Network</mark></td><td align="center">--></td><td><mark style="color:blue;">Network Device</mark></td><td align="center">no</td><td></td></tr><tr><td><mark style="color:blue;">Web Application</mark></td><td align="center">--></td><td><mark style="color:blue;">Application</mark></td><td align="center">no</td><td></td></tr><tr><td><mark style="color:blue;">Container</mark></td><td align="center">x</td><td></td><td align="center">no</td><td></td></tr></tbody></table>

After a [finding from Edgescan is imported into a report](https://docs.plextrac.com/plextrac-documentation/product-documentation/reports/findings/importing-findings-via-an-integration), metadata and content are presented within PlexTrac on the Finding Detail page, as shown below.\
\
The finding source value is "Edgescan," and any tags associated with the finding from Edgescan are provided along with any added within PlexTrac when imported.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FcSBjFqZG6e2NReV1O5zt%2Fimage.png?alt=media&#x26;token=3c9a7634-b0bf-49fd-84e4-b6df62486642" alt=""><figcaption></figcaption></figure></div>

## Deduplication Logic

If a duplicate finding title is found during import, the finding title in PlexTrac is appended with the Edgescan `Vulnerability ID` in parenthesis at the end of the finding title.&#x20;

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FekuJ5aDODqveJp1BHHs3%2Fimage.png?alt=media&#x26;token=1d9cb681-a350-47be-b8c5-ee357880bdf1" alt=""><figcaption></figcaption></figure></div>

## &#x20;Integrating with Edgescan

<mark style="background-color:yellow;">Step 1</mark>: From the **Admin Dashboard**, click **Integrations** under the "Tools & Integrations" header.

![](https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FbBK4JfGkJZnOSqx41nqY%2Fimage.png?alt=media\&token=260033ae-bc58-4c36-a81b-bf682f18130c)

<mark style="background-color:yellow;">Step 2</mark>: Click the Edgescan box.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FSR2CBs0ruiIqsjFRNzS6%2Fimage.png?alt=media&#x26;token=48e59067-527c-4f03-8732-82437e3ae994" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 3</mark>: Click **New connection**.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FAXmwlpwBsdAX31Dvqq7e%2Fimage.png?alt=media&#x26;token=d086eee3-ff3c-4f49-ba63-7d330d202f94" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 4</mark>: On the **Configuration Details** tab, enter a name for the integration, the Edgescan URL value, the Edgescan API key, and if closed vulnerabilities should be included.&#x20;

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FJyLTSFTBKvnF9fGTfxj5%2Fimage.png?alt=media&#x26;token=c379eaca-f52b-41f8-9cdf-6ce456358bc0" alt=""><figcaption></figcaption></figure></div>

* **Integration name:** A name for this integration. When importing findings, this value will appear elsewhere in the platform along with other enabled integrations, so pick a unique but accurate name.
* **Edgescan URL:** The Edgescan instance URL.
* **Edgescan API Key:** The Edgescan instance API key. Visit [Edgescan support](https://support.edgescan.com/support/solutions/articles/44002143613-creating-api-and-authentication-tokens) for information on generating an API key.&#x20;
* **Closed Vulnerabilities**: Determines whether to include closed vulnerabilities and, if yes, the time of closure to consider for inclusion.

<mark style="background-color:yellow;">Step 5</mark>: On the **Mapping** tab, review the mappings and select the fields to import into PlexTrac by validating that the checkbox next to the field is selected. To ignore a field upon import, uncheck the box under the "Sync" column. Required fields (checkbox is greyed out) cannot be altered.&#x20;

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FoWpT90uuekbw8KIJaSC0%2Fimage.png?alt=media&#x26;token=1f98abe0-faf4-4865-9736-1f5dcfa41a90" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 6</mark>: Click **Save**.

<mark style="background-color:yellow;">Step 7</mark>: A message on the **First Synch** tab will confirm if the synch was successful. If successful, click **Got It**.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2F54oxGWTkJnce3ihycssy%2Fimage.png?alt=media&#x26;token=ba17e61d-9521-4874-aa92-53f90a9824ff" alt=""><figcaption></figcaption></figure></div>

The connection is now listed.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FSJ90DpGowpK6FVn0XeI9%2Fimage.png?alt=media&#x26;token=d5b3ce40-1663-4ffa-bb6d-f65926ddb5e9" alt=""><figcaption></figcaption></figure></div>

## Editing Existing Connections

Connections are edited by clicking **Edit** under the "Actions" column.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2F3k0DphfDmuSua3ZNRHow%2Fimage.png?alt=media&#x26;token=87da700a-bdca-4171-a268-100895c2aa5d" alt=""><figcaption></figcaption></figure></div>

Connections can be disabled by clicking the toggle bar under the "Enabled" column.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2F71dXv91bPRBGAAP2aZDx%2Fimage.png?alt=media&#x26;token=5bd716c6-9217-4803-b36c-869c5de05e3f" alt=""><figcaption></figcaption></figure></div>

Connections can be manually synchronized by clicking **Sync** under the "Actions" column.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FLNiqu0cD910F69u7h5Xs%2Fimage.png?alt=media&#x26;token=a414750d-8680-443f-a431-5a366abbe94d" alt=""><figcaption></figcaption></figure></div>

Connections can be deleted by clicking the three dots under the "Actions" column and then **Delete**. A modal will appear, asking for confirmation of action.&#x20;

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FEEiKqQVc2TOmLYYHNVmb%2Fimage.png?alt=media&#x26;token=ae726a29-0eee-4d54-85c4-56d3b20f3bec" alt=""><figcaption></figcaption></figure></div>

Findings from Edgescan can now be[ imported into a report](https://docs.plextrac.com/plextrac-documentation/product-documentation/reports/findings/importing-findings-via-an-integration).

## Viewing Logs

<mark style="background-color:yellow;">Step 1:</mark> Click **Edit** of the connection to review.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FPcTNIArBs4QEMdwFl8kI%2Fimage.png?alt=media&#x26;token=c9fffa63-7842-4a9e-91db-dae1227b79e2" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 2:</mark> Click the **Synch Log** tab.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2F1elzyv50uPSdaYNHgPAW%2Fimage.png?alt=media&#x26;token=0e024c18-2a57-46c8-b490-390c40311d24" alt=""><figcaption></figcaption></figure></div>

A list of all synchronization records and status results is provided.&#x20;

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FTkVJj2d2R5QtLq40JN4i%2Fimage.png?alt=media&#x26;token=c14834da-4457-493d-b0c5-19612a4b1d66" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 3:</mark> Click **View** to obtain more information about a specific record.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FEejz4EKrQi8NKgMAUbRl%2Fimage.png?alt=media&#x26;token=75238a8f-6304-46f2-8dd9-b9d0cfe013ee" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 4:</mark> More details about remote URLs and JSON responses are available by clicking the headers below to expand the section.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FH9B41KJFGkjPrd77oIcW%2Fimage.png?alt=media&#x26;token=e3750880-cd15-4a94-ac37-5c01169c758c" alt=""><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FobaM8lkjpVRrd14lLlZs%2Fimage.png?alt=media&#x26;token=d5b4754a-2f76-4a1b-9efa-0f2f22bc083f" alt=""><figcaption></figcaption></figure></div>

Click **Ok** or **Cancel** to return to the previous modal.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.plextrac.com/plextrac-documentation/product-documentation-1/account-management/account-admin/integrations-and-webhooks/integrations-api/edgescan.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
