Running a Discovery

This command enables you to start a new discovery.

Example: bright-cli discovery:run [options]

Discovery options

Option

Description

--header=headerName:headerValue, -H=headerName:headerValue

Extra headers to be passed with the archive file. It can also be used to remove a header by providing a name without content. For example, -H "Host:".

--smart

Enables you to use automatic smart decisions, such as skipping URLs or forms with duplicate parameter names but different values to reduce crawling time. When set to false (turned off), the crawler will run on all parameters, which can increase the coverage at the expense of discovery time.

Default: --smart true

--name=discoveryName, -n=discoveryName

The name of the discovery.
Required option.

--project, -p

Allows specifying the Bright project for a discovery using the project ID. You can find the project ID in the Projects section in the Bright app.

--auth=authObjectID,
-o=authObjectID

Specifies the ID of the authentication object to be connect to the discovery. Find more info about using an authentication object at Managing Your Authentications.

--crawl-parent-subdomains

Crawl parent path folders and subdomains [boolean] [default: false]

-c, --crawler

A list of specific URLs that should be included into crawler.

-a, --archive

A collection of your app's http/web sockets logs into HAR file. Usually you can use browser dev tools or our browser web extension

--concurrency

Number of maximum concurrent requests allowed to be sent to the target, can range between 1 to 50 (default: 10).

--interactions-depth

Number of maximum interactions with nested objects, can range between 1 to 5 (default: 3). [number] [default: 3]