> For clean Markdown of this page, append .md to its URL. For the complete documentation index, see https://www.superagent.sh/llms.txt.


Probe a live application with browser-driven DAST and review evidence as findings land.

# Applications

An application Red Teaming run points a security agent at a running application. The
agent drives a real browser against the application, probing for exploit paths
the way an external attacker would: no source code, just the public surface.
This is the black-box option.

Results stream to a live report page, and confirmed issues land in the [Findings](https://www.superagent.sh/docs/concepts/findings-and-reports) queue.

### Start an Application run

For a saved [application](https://www.superagent.sh/docs/concepts/applications), an organization owner can open **Red teaming**, configure the run with **Edit settings**, and select **New run**. Superagent uses the approved hosts from that application’s inventory.

To start a report directly from a URL:

1. Open **Red team** and select **New report**, or go to `/app/reports/new`.
2. Choose **Application**.
3. Enter the target URL and any optional configuration below.
4. Submit. The sandbox provisions and the run starts in the background.

| Field | Required | Notes |
| --- | --- | --- |
| Target URL | Yes | Public HTTP or HTTPS URL. Localhost, private IPs, and metadata hostnames are rejected |
| Generated credentials | No | Login email and password for a test account, auto-generated and editable. Encrypted at rest and injected only into the sandbox |
| Headers | No | Up to 20 custom browser headers. Encrypted at rest, applied only to requests to the application's hosts |
| Request throttle | No | Cap requests between 1 and 600 per minute |
| Specific prompt | No | A per-report goal prompt, up to 8,000 characters |
| Additional files | No | Source archives, documents, or images for context. Dashboard only; not available through the API |

If your WAF would block the scanner, the dashboard shows a static egress IP to allowlist when one is configured for your deployment.

### Scope and safety

The target URL sets the initial scope, including its `www.` variant and subdomains. On a saved application, marking a parent domain of the target host **Included** expands the scope to that domain and its subdomains. Other included DNS hosts add only the named host.

Custom headers apply to the target URL's scope and any included parent domain and its subdomains. The request throttle also applies to individually included hosts. Superagent encrypts credentials and headers at rest and omits them from API responses.

### Follow the run

Application red-team reports open at `/app/reports/web-app/[id]`. While the agent works you can watch:

- **Logs**: the live event feed of the agent's actions and reasoning
- **Live browser**: the browser session in real time, or the recording afterwards
- **Evidence**: recordings and screenshots captured during the run
- **Findings**: issues as they are confirmed, linked to the full finding page

From the report page you can **Rerun** the engagement or **Delete** the report.

### Findings

Application findings appear in the [Findings](https://www.superagent.sh/docs/concepts/findings-and-reports) queue with kind `web_app_red_team`, alongside findings from repository reports and GitHub advisories. Triage and remediation work the same way for every kind.

### API and MCP

`POST /api/v1/reports/web-app` starts a run programmatically with the same target, credential, header, throttle, and prompt fields, minus file attachments. The `create_web_app_report` [MCP tool](https://www.superagent.sh/docs/mcp) does the same from your coding agent. Both consume organization credits. See [Reports API](https://www.superagent.sh/docs/api/reports).

## Optional attack scenarios

**General assessment** is the default. Browse [Application attack scenarios](https://www.superagent.sh/docs/products/red-teaming/attack-scenarios#applications) for focused checks on session revocation and tenant isolation.

## Next steps

- [Review findings and reports](https://www.superagent.sh/docs/concepts/findings-and-reports)
- [Start runs with the Reports API](https://www.superagent.sh/docs/api/reports)
- [Subscribe to report events with Webhooks](https://www.superagent.sh/docs/webhooks)

---
Source: https://www.superagent.sh/docs/products/red-teaming/applications
Index: https://www.superagent.sh/llms.txt
