# Affected Assets

Affected assets are managed from the finding, as opposed to the client. Affected assets contain information about an affected asset and relational metadata about the finding it is tied to.&#x20;

An affected asset object on a finding will have a subset of fields compared to the client asset with the same ID. Some additional fields make sense when the finding and client asset are viewed together, such as the date the finding started affecting the client asset, the affected ports, location access to vulnerability, vulnerable parameters, and evidence of the affection.

{% hint style="info" %}
[Click here](https://docs.plextrac.com/plextrac-documentation/master/plextrac-api-overview/object-structures/asset-object#affected-asset-structure) for more information about the affected asset object structure and all the fields and values it might contain.
{% endhint %}

## Viewing Affected Assets

<mark style="background-color:yellow;">Step 1:</mark> From the **Reports** module, click the row of the impacted report.

<div align="left"><figure><img src="/files/k8nSj7yQSRHLm6gVbOCS" alt=""><figcaption></figcaption></figure></div>

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

<div align="left"><figure><img src="/files/2jkzOKF6rWplqBmc7HFA" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 3:</mark> Click the row of a finding.

<div align="left"><figure><img src="/files/P48Bc9Ouc0xDWBhkW2fD" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 4:</mark> If an affected asset(s) exist for this finding, they are listed on the Finding Detail modal.

<div align="left"><figure><img src="/files/dD4vLFP8dznROMNxt9Yh" alt=""><figcaption></figcaption></figure></div>

A parent asset can be accessed directly by clicking the provided link within the table.

<mark style="background-color:yellow;">Step 5:</mark> Click **View** under the "Actions" column of the affected asset to see more information.

<div align="left"><figure><img src="/files/Q3E47udMtFk2uuAoRlqU" alt=""><figcaption></figcaption></figure></div>

The Asset Detail modal appears with information about the affected asset and a link to any parent, if applicable.&#x20;

<div align="left"><figure><img src="/files/y68LjPMUh2eUDvh4mCC8" alt=""><figcaption></figcaption></figure></div>

## Configuring Views

The table view can be customized by clicking the column view icon to the right of the **Add assets** button.

<figure><img src="/files/MxtE8hXb07eUVajPbJo9" alt=""><figcaption></figcaption></figure>

Once clicked, a modal appears that lists all fields. To remove a column, click **X** within the bar.

<div align="left"><figure><img src="/files/RSDZb8dYQqjFHCcepxfh" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Fields that are required do not have an **X** available.
{% endhint %}

When fields are removed, an "Add Column" pulldown menu is added at the bottom left of the modal to store the field. Any removed fields can be added later by clicking **Add Column** and selecting the field to add. &#x20;

This modal represents the sequence of fields provided in the table, meaning the bar on top will be the column on the table's far left.&#x20;

The order of columns can be adjusted within this modal by clicking the six dots on the left of the bar for a field and dragging the bar to the desired sequence place.

<figure><img src="/files/4rOeEPETzME0iKpu6QvF" alt=""><figcaption></figcaption></figure>

Click **Save** when finished.&#x20;

## Creating an Affected Asset

<mark style="background-color:yellow;">Step 1:</mark> From the **Reports** module, click the impacted report.

<div align="left"><figure><img src="/files/ben6K3JKRcZF8uc7uWkF" alt=""><figcaption></figcaption></figure></div>

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

<div align="left"><figure><img src="/files/ip3HkxCldckEeJkRtExq" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 3:</mark> Click **Edit** of the finding the affected asset is being added to.

<div align="left"><figure><img src="/files/Qk8nhphQOgOqT4f9aex6" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 4:</mark> Click the **Affected Assets** tab.

<figure><img src="/files/2roUw692MVwE77fTYATj" alt=""><figcaption></figcaption></figure>

<mark style="background-color:yellow;">Step 5:</mark> Click the **Add Assets** button and select **Create new asset**.

<figure><img src="/files/rl11fbhJAihi6iOIPrt1" alt=""><figcaption></figcaption></figure>

<mark style="background-color:yellow;">Step 6:</mark> Enter information about the affected asset in the appropriate fields within the **Asset Information** tab.

<div align="left"><figure><img src="/files/oHU8rQYKXJRQrDcObwIu" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 7:</mark> Click the **Affected Areas** tab. Enter information about the following:

* **Affected Ports:** Network ports vulnerable to a security exploit or attack.
* **Location/URL:** The URL of the affected asset.
* **Vulnerable Parameters:** The inputs or settings in a system or program that an attacker can exploit to compromise the security or integrity of the system. These parameters can include usernames, passwords, API keys, and configuration files.
* **Notes:** A text box for any additional information to provide context on the affected asset.

<figure><img src="/files/U121zhav1DIHJikkMM98" alt=""><figcaption></figcaption></figure>

<mark style="background-color:yellow;">Step 8:</mark> Click the **Evidence** tab. This tab contains two text fields (title and description) per item but as many items of evidence can be added as needed. Evidence represents when or how the affected asset was found, and often is the scanner output from the scanning process.

<div align="left"><figure><img src="/files/e85ljJMcEFOwQvOA7kCZ" alt=""><figcaption></figcaption></figure></div>

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

The asset is now listed in the **Affected Assets** tab of the finding.&#x20;

## Editing an Affected Asset

<mark style="background-color:yellow;">Step 1:</mark> From the **Affected Assets** tab of a finding, click **Edit** under the "Actions" menu.

<div align="left"><figure><img src="/files/Xus3p4rkv8kEQ1cRdABl" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 2:</mark> Edit or add information as desired and click **Save**.&#x20;

## Deleting an Affected Asset

<mark style="background-color:yellow;">Step 1:</mark> From the **Affected Assets** tab of a finding, click **Remove** under the "Actions" menu.

<div align="left"><figure><img src="/files/PHnbuXTXK0Q9nMqjGahL" alt=""><figcaption></figcaption></figure></div>

A modal appears, confirming the deletion. Click **Remove**.&#x20;

## Adding Existing Assets

Assets already in PlexTrac can also be added as an affected asset for a finding.

<mark style="background-color:yellow;">Step 1:</mark> From the **Affected Assets** tab of a finding, click the **Add Assets** button and select **Add existing assets** from the pulldown menu.

<figure><img src="/files/q3NasHNwVrRGWOl52B95" alt=""><figcaption></figcaption></figure>

<mark style="background-color:yellow;">Step 2:</mark> Choose the asset(s) from the pulldown menu and click **Save**.

<div align="left"><figure><img src="/files/ADOtPts61ofVA4ioX1jO" alt=""><figcaption></figcaption></figure></div>

## Importing Affected Assets

Assets can be imported using a PlexTrac CSV Asset import template. [Click here](https://docs.plextrac.com/plextrac-documentation/product-documentation/clients/adding-assets-in-clients#importing-an-asset) to download the template and enter asset data to import.

<mark style="background-color:yellow;">Step 1:</mark> From the **Affected Assets** tab of a finding, click the **Add Assets** button and select **Import assets** from the pulldown menu.

<figure><img src="/files/0aSuhkLyrGAwsr69EyYy" alt=""><figcaption></figcaption></figure>

<mark style="background-color:yellow;">Step 2:</mark> Drag a file into the modal or click the box to navigate to the file on the computer.&#x20;

<div align="left"><figure><img src="/files/PCrl77KqeEaiWdMTtDp6" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 3:</mark> Click **Import**.&#x20;

<div align="left"><figure><img src="/files/kb7gMyeDsfznXmuUvPIe" alt=""><figcaption></figcaption></figure></div>

A message will appear confirming import.

The asset(s) are now listed in the **Affected Assets** tab.

## Bulk Importing Affected Assets

<mark style="background-color:yellow;">Step 1:</mark> From the **Affected Assets** tab of a finding, click the **Add Assets** button and select **Bulk paste** from the pulldown menu.

<figure><img src="/files/IsmqkXpJp1CLWnWZXoqI" alt=""><figcaption></figcaption></figure>

<mark style="background-color:yellow;">Step 2:</mark> Enter the assets into the box by separating each value with a comma. PlexTrac will parse the assets and add them to the finding. URLs with paths (ex., [www.plextrac.com/test/](http://www.plextrac.com/test/)) will be separated into parent and child assets. Click **Next**.

<div align="left"><figure><img src="/files/2i16e7dQ60Ofm13FccMp" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 3:</mark> Asset, ports, and child asset values are dynamically assigned. Review and uncheck the box next to any new assets that should not be added. Click **Next**.

<div align="left"><figure><img src="/files/9RDsFa2R1qIdwStD7dJh" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Any subdirectories listed for an asset's domain will be loaded as its asset and considered a 'child' in relation to the 'parent' domain. This relationship will be tracked and maintained within PlexTrac.\
\
For example, **[www.plextrac.com/home](http://www.plextrac.com/home)** will become two assets, with **/home** a child to \*\*[www.plextrac.com.\*\*\\](http://www.plextrac.com.**\\)
\
![](/files/i8qfoGw87yN6ENbHAaNv)
{% endhint %}

<mark style="background-color:yellow;">Step 4:</mark> Add any desired optional tags. Tags will be assigned to all added assets. Existing assets will retain current tags. Click **Add X assets**.

<div align="left"><figure><img src="/files/NB9ruHHruhHW7jbNdh9L" alt=""><figcaption></figcaption></figure></div>

The new assets are displayed in the **Affected Assets** tab of the findings.

<div align="left"><figure><img src="/files/Isbkx39lrZqmebxf0D8Z" alt=""><figcaption></figcaption></figure></div>

## Bulk Updating&#x20;

<mark style="background-color:yellow;">Step 1:</mark> From the **Affected Assets** tab of a finding, click the box in the header row to the left of "Asset."&#x20;

<div align="left"><figure><img src="/files/nXnIWam0lHCA9B3nPS3x" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 2:</mark> The "Actions" button appears with the following options:

* Add affected location/url
* Add affected ports
* Delete&#x20;

<div align="left"><figure><img src="/files/X0R3J9H1GLcromVAl2Df" alt=""><figcaption></figcaption></figure></div>

Click the desired task from the pulldown menu and continue reading for additional details on each action.

### Add Affected Location/URL

A modal will appear with a field to enter a URL. The query parameters will be parsed out into the inputs provided. Click **Add Parameter** to include vulnerable parameters. Click **Save** when finished.

<div align="left"><figure><img src="/files/HOdg8r6iRKeFB3D7rePT" alt=""><figcaption></figcaption></figure></div>

The new value appears on the **Affected Assets** tab under the "Location/URL" column.

<div align="left"><figure><img src="/files/M6yV4dnt1oIbHsowT6h0" alt=""><figcaption></figcaption></figure></div>

### Add Affected Ports

A modal will appear with a field to enter any affected ports. Click Add Port to repeat the process as needed. Click Save when done.

<div align="left"><figure><img src="/files/zSbNWF3O6BoHoAph5AyX" alt=""><figcaption></figcaption></figure></div>

The new values will appear under the appropriate columns on the **Affected Assets** tab.

<div align="left"><figure><img src="/files/zzQIrcaF5xxIpYyvzvfG" alt=""><figcaption></figcaption></figure></div>

### Delete

A modal will appear, asking for confirmation of the action. Click **Delete Assets**.&#x20;

<div align="left"><figure><img src="/files/2j0VEXdwKiNFtjhBsaBG" alt=""><figcaption></figcaption></figure></div>


---

# 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/reports/findings/affected-assets.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.
