> For the complete documentation index, see [llms.txt](https://copilot-docs.bugbase.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://copilot-docs.bugbase.ai/enterprise/run-assessment-wizard.md).

# Run Assessment Wizard

The five-step Run Assessment wizard for Web and Network assessments, including intents, configuration choices, scheduling, and review.

Every Web and Network run starts from a five-step wizard. The steps differ slightly by module:

| Module                        | Steps                                                                | Open                                                | Phase guides                                                                                                                                                                                                                                                                                                                                                                   |
| ----------------------------- | -------------------------------------------------------------------- | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Web**                       | **Asset**, **Intent**, **Scan settings**, **Automation**, **Review** | **Modules -> Web Assessment -> Run Assessment**     | [Web Discovery](https://copilot-docs.bugbase.ai/enterprise/how-to-trigger-a-web-assessment/web-discovery.md) · [Web Assessment Phase](https://copilot-docs.bugbase.ai/enterprise/how-to-trigger-a-web-assessment/web-assessment-phase.md) · [AI Configure and Vetting](https://copilot-docs.bugbase.ai/enterprise/how-to-trigger-a-web-assessment/ai-configure-and-vetting.md) |
| **Network** (including cloud) | **Intent**, **Scope**, **Scan settings**, **Automation**, **Review** | **Modules -> Network Assessment -> Run Assessment** | [Network Discovery](https://copilot-docs.bugbase.ai/enterprise/how-to-trigger-a-network-assessment/network-discovery.md) · [Network Assessment Phase](https://copilot-docs.bugbase.ai/enterprise/how-to-trigger-a-network-assessment/network-assessment-phase.md)                                                                                                              |

This page covers the parts that work the same way in both modules, and the Web steps that differ. The module pages cover what is specific to each phase.

Code Assessment uses a four-step version of the wizard without the Intent step. See [How to Trigger a Code Assessment](https://copilot-docs.bugbase.ai/enterprise/how-to-trigger-a-code-assessment.md).

## Shared-Trial Banner

*Web, shared trials only.* When your trial can't start a scan yet, a banner at the top of **Run Assessment** says why and what to do next. It stays on every step until the trial is ready.

| Banner                               | What it says                                                                                         | Button                                                             |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
| **Activate your trial to run scans** | Your shared trial is not activated yet. Activate it to unlock your discovery and assessment credits. | **Activate trial**, which opens **Settings -> Usage**              |
| **Your trial has ended**             | Upgrade to a dedicated plan to keep scanning.                                                        | **View plans**, which opens **Settings -> Usage**                  |
| **This workspace is read-only**      | You can view results, but new scans are paused. Contact <queries@bugbase.ai> to turn scans back on.  | None                                                               |
| **Add your root domain**             | Scans run on your root domain and its subdomains. Add the root domain to continue.                   | **Add domain**, which opens **Settings -> Domain Verification**    |
| **Verify your root domain**          | Verify that you own your root domain before running scans on it.                                     | **Verify domain**, which opens **Settings -> Domain Verification** |
| **Your workspace is not set up yet** | Contact <queries@bugbase.ai> to finish setting it up.                                                | None                                                               |
| **Your trial credits are used up**   | Shown when both Discovery and Assessment credits are used up. Upgrade your plan to keep scanning.    | **View plans**, which opens **Settings -> Usage**                  |

For every banner except **Your trial credits are used up**, the **Asset** step also shows the banner's title, for example **Activate your trial to run scans.**, and you can't continue until it is resolved. When credits are used up, the **Intent** step stops you instead. See [Credits and Usage](https://copilot-docs.bugbase.ai/enterprise/settings/credits-and-usage.md#vetting-and-ai-configure).

## Asset

*Web only.* A Web run tests one domain. Select it on the **Asset** step.

<figure><img src="https://232193438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwolEZzMm5QD9NoFKutSj%2Fuploads%2Fgit-blob-c4f6c001bfbb9b443107d435c2f103b0aa1f54bf%2Fweb-scope-asset.webp?alt=media" alt="Asset step with a search box, a list of domains showing Verified, Whitelisted, vetting status and last scan, and a pager"><figcaption><p>Search the inventory and select one domain per run.</p></figcaption></figure>

* **Search domains and IP addresses** searches your whole inventory. The list shows 10 assets per page; use the pager for more.
* Each row shows the asset's badges, its last vetting result (when [AI configure](https://copilot-docs.bugbase.ai/enterprise/how-to-trigger-a-web-assessment/ai-configure-and-vetting.md) is available), and **Last scan**.
* Use **Manage target assets** to add a root domain that is not listed. Subdomains are found by Discovery; you do not need to add them.

| Badge                                   | Meaning                                                                                                                                         |
| --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| **Whitelisted**                         | The domain is approved in **Settings -> Domains**. A domain must be whitelisted before a run.                                                   |
| **Add to whitelist**                    | Select it to add the domain to the whitelist from the wizard.                                                                                   |
| **Verified**                            | The domain's root passed ownership verification.                                                                                                |
| **Verify ownership** / **Not verified** | The root is not verified. **Verify ownership** means your deployment requires it; select the badge to open **Settings -> Domain Verification**. |

A link to **Run Assessment** can name the domain, for example from a domain's **Analysis** page or a **Scan** button on an alert. The wizard then selects that domain and opens on **Intent**.

## Intent

The intent decides which phases run.

<figure><img src="https://232193438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwolEZzMm5QD9NoFKutSj%2Fuploads%2Fgit-blob-e96ec397193a72be35ae67bdba6ea92761f3af14%2Fweb-intent-both.webp?alt=media" alt="Intent step with Discovery plus Assessment selected and the Configuration cards below"><figcaption><p>Discovery + Assessment is selected by default. Web runs also choose a Configuration here.</p></figcaption></figure>

| Intent                                 | What runs                                                                  | Choose it when                                                                                                               |
| -------------------------------------- | -------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| **Discovery + Assessment** *(default)* | Discovery, then Assessment automatically on what that Discovery run found. | Most runs, and every first Web run. You do not need to hand-pick what is tested.                                             |
| **Discovery**                          | Discovery only. Nothing is attacked.                                       | Active testing is not approved yet, or you want to review the inventory first. Recommended as the first Network run.         |
| **Assessment**                         | Assessment only, on what earlier Discovery runs stored.                    | You want to hand-pick what to test, such as specific Web trajectories or Network entities, or re-test without mapping again. |

On a shared trial, each Web intent card shows the credits you have left for the phases it runs, for example **Discovery: 4.0 credits left · Assessment: 10.0 credits left**. An intent whose phases have no credits left says so, for example **No Assessment credits left. Upgrade your plan in Settings › Usage.**, and you can't continue with it. Choose another intent, or add credits in **Settings -> Usage**.

{% hint style="warning" %}
**Network:** changing the intent clears the targets selected in **Scope**, because each intent lists targets differently.
{% endhint %}

### Configuration (Web)

When [AI configure](https://copilot-docs.bugbase.ai/enterprise/how-to-trigger-a-web-assessment/ai-configure-and-vetting.md) is available for your deployment, the Web **Intent** step also asks how the domain's **scan configuration**, the saved Discovery and Assessment settings, is set up. **AI configure** is selected for you when it can run on the domain.

| Configuration                    | Summary                                                                                                                     |
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| **AI configure** *(Recommended)* | Pentest Copilot vets the domain and sets up the scan for you. When the domain is **Scannable**, the scan starts on its own. |
| **Manual**                       | You set authentication coverage, starting URL, browser sessions, and concurrency yourself.                                  |
| **Use existing configuration**   | Starts the scan with the scan configurations saved by the domain's last scannable vetting run.                              |

See [AI Configure and Vetting](https://copilot-docs.bugbase.ai/enterprise/how-to-trigger-a-web-assessment/ai-configure-and-vetting.md#choose-a-configuration) for when to use each. When AI configure is not available, the **Configuration** choice is not shown and every Web run is **Manual**.

### What Changes With the Intent

|                                           | Web                                                   | Network                                                                                               |
| ----------------------------------------- | ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| **Discovery only**                        | **Max crawler runs**                                  | **AWS resource name prefixes**, **Max discovery runtime**                                             |
| **Assessment only**                       | **Trajectory scope** (Manual)                         | Discovered roots, **Entity scope**, **Validate pre-existing vulnerabilities**, **Max module runtime** |
| **Assessment and Discovery + Assessment** | **Attack vectors**                                    | **Attack selection**, per-subnet attack settings, Intercept interfaces                                |
| **Discovery + Assessment only**           | **Assessment runtime after discovery**                | **Assessment runtime after discovery**                                                                |
| **Every intent**                          | Access, egress, rate limits, Advanced, custom headers | Execution agent                                                                                       |

## Scope

*Network only.* Scope selects what the run may touch. Pentest Copilot only lists targets that are already in your workspace: the subnets reported by the selected agent for Discovery, and the subnets and cloud scopes found by earlier Discovery runs for Assessment.

## Scan Settings

Scan settings control access, traffic, depth, and, for intents that include Assessment, what may be tested.

For Web, **Scan settings** opens with **Access**, which depends on the configuration:

* **AI configure**: an **Accounts** box and **Self-signup**. See [AI Configure and Vetting](https://copilot-docs.bugbase.ai/enterprise/how-to-trigger-a-web-assessment/ai-configure-and-vetting.md#write-the-accounts).
* **Manual**: authentication coverage, starting URL, and browser sessions, plus **Trajectory scope** for the **Assessment** intent. See [Common Web Settings](https://copilot-docs.bugbase.ai/enterprise/how-to-trigger-a-web-assessment/configure-scan-settings-for-web-assessment.md).
* **Use existing configuration**: a read-only **Saved scan configuration** summary, with anything the last vetting run left to fix. No other settings are shown.

With **AI configure** and **Manual**, the sections that follow, **Rate limit & egress**, **Attack vectors** (intents that include Assessment), **Custom request headers**, and **Advanced**, are described in [Common Web Settings](https://copilot-docs.bugbase.ai/enterprise/how-to-trigger-a-web-assessment/configure-scan-settings-for-web-assessment.md). For Network, see the phase guides.

## Automation

<figure><img src="https://232193438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwolEZzMm5QD9NoFKutSj%2Fuploads%2Fgit-blob-e37ddf72a34027ae094a3e4c6fe182c88f33f85b%2Fautomation-schedule.webp?alt=media" alt="Automation step with Schedule selected, Run at, Repeat this schedule, Interval 1, and Unit Days"><figcaption><p>Schedule a one-time or repeating run from the same configuration.</p></figcaption></figure>

| Option                   | Behavior                                                       |
| ------------------------ | -------------------------------------------------------------- |
| **Run now**              | Starts as soon as you confirm **Review**.                      |
| **Schedule**             | Starts at **Run at**, in your local time zone.                 |
| **Repeat this schedule** | Repeats every **Interval** **Days**, **Weeks**, or **Months**. |

For Web, scheduling is available with **Manual** only. **AI configure** and **Use existing configuration** always run now. A scheduled **Manual** run keeps the domain's saved scan configuration, including one saved by vetting, for every section you do not change.

A schedule stores the configuration you submitted. If browser sessions, target scope, agents, or approvals change later, delete the schedule in **Activity -> Schedule** and create a new one. See [Scheduling](https://copilot-docs.bugbase.ai/enterprise/activity/scheduling.md).

## Review

**Review** is the final summary of what will run. Check the intent, targets, configuration, start time, and the **Scan settings** card, then start the run. Use **Edit** to go back to a step.

<figure><img src="https://232193438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwolEZzMm5QD9NoFKutSj%2Fuploads%2Fgit-blob-1dcae59cf003efaad1cd6005f22775698930d949%2Fweb-review.webp?alt=media" alt="Final configuration review showing Web Assessment, the domain, the intent, the configuration, Run now, and the Scan settings card"><figcaption><p>Review shows the domain, intent, configuration, and every scan setting the run will use.</p></figcaption></figure>

The start button depends on the Web configuration:

| Configuration                  | Button                             | What the Scan settings card shows                                                                              |
| ------------------------------ | ---------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| **Manual**                     | **Start run**, or **Schedule run** | **Egress**, **Request rate**, **Attack vectors**, **Authentication**, **Custom request headers**, **Advanced** |
| **AI configure**               | **Start vetting**                  | **Accounts**, **Self-signup**, **Egress**, **Request rate**, **Attack vectors**, **Custom request headers**    |
| **Use existing configuration** | **Start scan**                     | The saved scan configurations, one per account, plus **Scan rate**, **Egress**, and **Starting URL**           |

With **AI configure**, Review notes that vetting usually takes 60–90 minutes, that the scan starts on its own if the domain is scannable, and that vetting is billed like a rate calibration run. See [Credits and Usage](https://copilot-docs.bugbase.ai/enterprise/settings/credits-and-usage.md#vetting-and-ai-configure).

With **Manual**, Review also shows a scan estimate once you change the scan settings.

### Saved for This Domain

Pentest Copilot remembers the settings last used for each domain, separately for each phase. With **Manual**, a section you did not change shows **Saved for this domain**, and the run reuses the saved values for that section, not the defaults on screen. To apply new values, open the section and change them.

### Launch Blocks

**Review** stops the launch when something must be fixed first:

| Message                                                   | Fix                                                                                                                                                                                                                                   |
| --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| A step's validation message, such as **Select a domain.** | A previous step has a missing or invalid value. Go back to that step.                                                                                                                                                                 |
| **Browser session validation is required**                | *Manual.* These browser sessions must pass validation before the scan can start, for example because one is pending, failed, or expired. Validate them again, or record them again with **Re-configure browser session**.             |
| **Browser replay is limited**                             | *Manual.* The saved sign-in works, but signing in again from scratch with the recorded steps did not. Confirm **I understand** to continue with the saved sign-in, or record the session again with **Re-configure browser session**. |
| **Browser session validation will be skipped**            | *Manual.* You turned on **Skip browser session validation**. Confirm **I understand** to continue.                                                                                                                                    |
| **Vetting is already running for this domain**            | *AI configure.* Only one vetting run per domain can run at a time. Use **View progress** to follow it, or cancel it first.                                                                                                            |
| **No usable scan configuration**                          | *Use existing configuration.* The domain's last vetting run did not end **Scannable** or **Scannable with limitations**. Choose **AI configure** or **Manual**.                                                                       |
| **Not enough credits**                                    | *AI configure, Use existing configuration.* The workspace does not have enough credits. Add credits with **Go to Usage**, then start again.                                                                                           |
| **Your trial can't start scans yet**                      | *AI configure, Use existing configuration, shared trial.* The message gives the reason. Use **Verify domain** or **Go to Usage** to fix it. See [Shared-Trial Banner](#shared-trial-banner).                                          |
| **No Discovery time left** / **No Assessment time left**  | *AI configure, Use existing configuration, shared trial.* The trial has used all its time for that phase. Upgrade your plan with **Go to Usage**.                                                                                     |
| Permission or verification messages                       | Your role or domain verification does not allow the run. The same rules apply to API and MCP launches.                                                                                                                                |

## After You Start

With **AI configure**, the wizard shows vetting progress, then the outcome. See [While Vetting Runs](https://copilot-docs.bugbase.ai/enterprise/how-to-trigger-a-web-assessment/ai-configure-and-vetting.md#while-vetting-runs).

With **Use existing configuration**, the wizard confirms **Scan started with the saved configuration**. Select **Open scan** to follow it in **Analysis**.

With **Manual**, and for Network, **Start run** opens **Activity -> Activity**. Each phase appears as its own row:

<figure><img src="https://232193438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwolEZzMm5QD9NoFKutSj%2Fuploads%2Fgit-blob-29df57265a89b84306123ae93836a4005bc60ec9%2Factivity.webp?alt=media" alt="Activity page listing WEB_CALIBRATION, WEB_DISCOVERY with an Auto-run badge, and WEB_ASSESSMENT rows, with target names blurred"><figcaption><p>Discovery and Assessment are separate rows. Auto-run marks a Discovery that will start Assessment when it finishes.</p></figcaption></figure>

| Row                                           | Meaning                                                                                           |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| `WEB_DISCOVERY` / `NETWORK_DISCOVERY`         | A Discovery phase. An **Auto-run** badge means Assessment starts automatically when it completes. |
| `WEB_ASSESSMENT` / `NETWORK_ASSESSMENT`       | An Assessment phase.                                                                              |
| `WEB_CALIBRATION`                             | An **Auto-calibrate** or rate-calibration run.                                                    |
| **Authenticated** / **Unauthenticated** badge | The authentication context of a Web row. Each browser session gets its own row.                   |

Follow a Web domain's vetting and scans in **Modules -> Web Assessment -> Analysis**. When the run finishes, review findings in **Attack Paths**. See [Analysing Scan Results](https://copilot-docs.bugbase.ai/enterprise/analysing-scan-results.md).
