# Scans

This page contains the list of existing scans, summary information regarding to these scans, and allows you to operate on these existing scans.

Tooltip provider that is above and right side on the table allows us to;

* **Search**: Search in the scans table according to their names.
* **Export**: Exports all scans and respective information that is listed in this table as a CSV file.
* **New Scan**: Start an Active Directory security scan from scratch.

The table contains the regarding information about the scans and allows us to perform operations on these scans with the help of a three-dot button.

<figure><img src="/files/FIY3JUaqTPCLrwxXyWep" alt=""><figcaption><p>Scan List</p></figcaption></figure>

## Information

**Date**: Starting date and time of the existing scans.

**Elapsed Time**: Elapsed time to complete for the existing scans.

**Name**: Name of the existing scans.

**Policy**: Name of the scan policy that has been applied to the scans. (See details in REFERANS)

**Issue Counts**: The number of the identified vulnerabilities and their distribution according to their severity.

Colours of the badges are categorized as;

|                         Colour                        |   Severity   |
| :---------------------------------------------------: | :----------: |
| ![scan\_list\_colour\_1](/files/u1r9IMtG69HwKYI6RAl0) | **Critical** |
| ![scan\_list\_colour\_2](/files/gKFC4TBLFFxn2COAcKRT) |   **High**   |
| ![scan\_list\_colour\_3](/files/J8fAGK5xb6WyLTj4Sbsf) |  **Medium**  |
| ![scan\_list\_colour\_4](/files/GE50CIQqlJdjiVgfhogi) |    **Low**   |
| ![scan\_list\_colour\_5](/files/UmuXdjyZE7J6sQFuHWHW) |   **Info**   |

**Risk**: The overall risk score of the scan. The risk score has been calculated according to the identified issues' severity distribution, number of the affected entities from the issues, number of attack paths that the issue can cause, percentage of the affected entities to the total entities, etc.

**Exposure Point**:It shows the total exposure points, representing the overall risk level of vulnerabilities within the system.

**Recurring**: Recurring frequency of the scan. (See details in New Scan Continous Assesment)

**Status**: Status of the scan.

Colours, text representations, and the definitions of the possible status values are;

<table><thead><tr><th width="218" align="center">Status</th><th align="center">Definition</th></tr></thead><tbody><tr><td align="center"><img src="/files/SVIWMxxkHnWebJjEnPNG" alt="scan_list_status_1"></td><td align="center">Scan has been scheduled and going to start in a short period.</td></tr><tr><td align="center"><img src="/files/hXrc717wPRXRZaSfeGRS" alt="scan_list_status_2"></td><td align="center">Scan is running.</td></tr><tr><td align="center"><img src="/files/WozQuBnR0nUWirat0mpQ" alt="scan_list_status_3"></td><td align="center">The necessary enumerations and assessments have been done. Currently, generating the output reports regarding scan results.</td></tr><tr><td align="center"><img src="/files/BQlFEhhsEcszxfIhNfiX" alt="scan_list_status_4"></td><td align="center">The scan has been completed successfully.</td></tr><tr><td align="center"><img src="/files/AR4GJJv1q38I9XdqX3L7" alt="scan_list_status_5"></td><td align="center">The scan has been completed with failure.</td></tr><tr><td align="center"><img src="/files/w1OeFj9L5O7hRrulFJIc" alt="scan_list_status_6"></td><td align="center">The scan has been canceled from the user interface. Graceful shutdown operations for the current scan are continuing.</td></tr><tr><td align="center"><img src="/files/6jhqIzGVyN7n2fDaMThz" alt="scan_list_status_7"></td><td align="center">The scan has been canceled from the user interface. Graceful shutdown operations has been completed. Scan has been completely stopped.</td></tr><tr><td align="center"><img src="/files/LY4CONfvh72nnc7WYLLm" alt="scan_list_status_8"></td><td align="center">Deletion operations for the current scan are continuing.</td></tr></tbody></table>

## Operation

Three-dot button on the each row allows us to perform following operations on a **finished** scan;

<figure><img src="/files/5auv6KIWz7sdR5wD9o66" alt=""><figcaption><p>Actions for Scan</p></figcaption></figure>

### **Edit**

On the **Edit Scan** page, you can update the names and descriptions for both one-time sub-scans and main scans.

![Editing the Scan](/files/3bChbdtd0T50a1teTgf6)

The fields organized for the main scan that runs at certain intervals are a bit more. Policy and frequency changes can be made for child scans that are formed from the main scan.

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

### **Clone**

Redirects the user to the New Scan page by cloning the all information of the selected scan.

![Cloning the Scan](/files/dEhIm0HXOt2DN4WQzEnG)

### **Summary PDF**

Downloads the summary pdf report of the selected scan.

### **Download as PDF**

Downloads the full pdf report(contains the affected entities) of the selected scan.

### **Download as Excel**

Downloads the full Excel report of the selected scan.

### **Send Report via Email**

Sends report email about related selected scan.

### **Delete**

Deletes the current scan.

### **Stop**

In addition to the operations on a finished scan mentioned above, scans that are in **Running** or **Generating Reports** states have one additional **Stop** option. This operation, sends a stop signal to the scanner engine to stop this scan gracefully.


---

# 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.forestall.io/fsprotect/scans/scans.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.
