Running a Discovery

This command enables you to start a new discovery.

Example: bright-cli discovery:run [options]

Discovery options

OptionDescription
--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=discoveryNameThe name of the discovery.
Required option.
--project, -pAllows 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-subdomainsCrawl parent path folders and subdomains [boolean] [default: false]
-c, --crawlerA list of specific URLs that should be included into crawler.
-a, --archiveA collection of your app's http/web sockets logs into HAR file. Usually you can use browser dev tools or our browser web extension
--concurrencyNumber of maximum concurrent requests allowed to be sent to the target, can range between 1 to 50 (default: 10).
--interactions-depthNumber of maximum interactions with nested objects, can range between 1 to 5 (default: 3). [number] [default: 3]