Create scan configuration

POST {{baseUrl}}/was/v2/configs

Creates a new scan configuration.

This operation is asynchronous and returns with an immediate 202. The scan configuration is guaranteed to be created at some point in the immediate future depending on resource load. To track the status of the operation, use the GET /was/v2/configs/{configid}/status/{trackingid} endpoint. The config_id and tracking_id can be retrieved from the URI provided in the Location header of the 202 Accepted response.

Requires SCAN MANAGER [40] user permissions and CAN CONFIGURE [64] scan permissions. Alternatively, SCAN OPERATOR [24] user permissions and CAN USE [16] policy permissions. See Permissions.

Request Body

{"name"=>"culpa sit dolor", "target"=>"https://example.com", "owner_id"=>"b018aed8-554f-4965-9b05-994eaa66d459", "template_id"=>"fe889212-69e8-14e5-926c-660ee52c5aec", "settings"=>{"target"=>"https://example.com", "description"=>"Security scan configuration for Facebook applications.", "timeout"=>"08:00:00", "debug_mode"=>true, "input_force"=>false, "credentials"=>{"credential_ids"=>["1763d235-61bd-2506-0940-6b9bf1c49526", "urn:uuid:4a09f29e-50d1-a2c8-7b30-e37cbf18eeeb"]}, "scope"=>{"option"=>"urls", "dom_depth_limit"=>5, "directory_depth_limit"=>10, "page_limit"=>10000, "decompose_paths"=>false, "exclude_binaries"=>false, "auto_redundant_paths"=>50643613, "openapi_file"=>"Duis Lorem ipsum in reprehenderit", "openapi_filename"=>"id Lorem labore", "crawl_script_filename"=>"cillum"}, "plugin"=>{"rateLimiter"=>{"requests_per_second"=>25, "autothrottle"=>true, "timeout_threshold"=>100}, "mode"=>"disable", "ids"=>[98000, 98001], "names"=>["path_traversal"], "families"=>["web_servers", "csrf"]}, "browser"=>{"screen_width"=>1600, "screen_height"=>1200, "ignore_images"=>true, "job_timeout"=>10000, "analysis"=>true, "pool_size"=>20085498}, "http"=>{"response_max_size"=>500000, "request_redirect_limit"=>1, "user_agent"=>"Nessus WAS/%v", "custom_user_agent"=>true, "request_concurrency"=>10, "request_timeout"=>5000}, "chrome_script"=>{"finish_wait"=>5000, "page_load_wait"=>10000, "command_wait"=>500}, "assessment"=>{"rfi_remote_url"=>"http://rfi.nessus.org/rfi.txt", "dictionary"=>"limited", "fingerprinting"=>true, "enable"=>true, "element_exclusions"=>[{"element_type"=>"dom_element", "selector_type"=>"attribute", "selector"=>"sit aliqua nostrud"}, {"element_type"=>"dom_element", "selector_type"=>"text", "selector"=>"cupidatat Duis ut Exc"}]}, "audit"=>{"forms"=>false, "cookies"=>false, "ui_forms"=>false, "ui_inputs"=>false, "headers"=>false, "links"=>false, "parameter_names"=>false, "parameter_values"=>false, "jsons"=>false, "xmls"=>false, "cookies_extensively"=>true, "with_raw_payloads"=>false, "with_both_http_methods"=>false, "with_extra_parameter"=>false}}, "description"=>"My cool scan configuration.", "folder_id"=>"urn:uuid:31510575-a9e5-d036-9141-524b1a5f2758", "user_template_id"=>"fcb105e7-f376-76de-3e0c-3fa056657c21", "scanner_id"=>15694568, "schedule"=>{"rrule"=>"FREQ=MONTHLY;BYDAY=MO,TU,WE,TH,FR;BYSETPOS=-1", "starttime"=>"19970105T083000 or 19970105T083000Z (utc)", "timezone"=>"America/New_York", "enabled"=>false}, "permissions"=>[{"permissions_id"=>"urn:uuid:fe9f363d-3bd7-d19d-ee13-60cb4489b9b8", "entity"=>"group", "entity_id"=>"d20edb09-147b-5550-48ea-15dc7a01da1a", "level"=>"configure"}, {"permissions_id"=>"eec9f0e6-55af-81eb-9ed3-e582e4fd5726", "entity"=>"user", "entity_id"=>"urn:uuid:cab1925e-6559-644c-7965-75317fb7cb20", "level"=>"no_access"}]}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring