Skip to main content

Findings

probely findings - CLI interface​

List existing findings

probely findings {get,retest,self-review} ...

probely findings get​

List findings. Use filters or identifiers to narrow the list

probely findings get [-h] [--api-key API_KEY] [--debug] [--f-scans F_SCANS [F_SCANS ...]]
                     [--f-severity {LOW,MEDIUM,HIGH,CRITICAL} [{LOW,MEDIUM,HIGH,CRITICAL} ...]]
                     [--f-state {FIXED,NOT_FIXED,ACCEPTED,RETESTING} [{FIXED,NOT_FIXED,ACCEPTED,RETESTING} ...]]
                     [--f-target F_TARGET [F_TARGET ...]] [--f-search SEARCH_TERM]
                     [--f-is-new {TRUE,FALSE}]
                     [--f-target-label F_TARGET_LABEL [F_TARGET_LABEL ...]]
                     [--f-target-label-logical-operator {AND,OR}]
                     [--f-last-found-gte ISO_8601_DATETIME]
                     [--f-last-found-lte ISO_8601_DATETIME]
                     [--f-changed-gte ISO_8601_DATETIME] [--f-changed-lte ISO_8601_DATETIME]
                     [-o {YAML,JSON,TABLE,IDS_ONLY}]
                     [FINDING_ID ...]

probely findings get positional arguments​

  • FINDING_ID - Identifiers of the findings to list

probely findings get options​

  • -h, --help - show this help message and exit
  • --api-key API_KEY - Authorization token to make requests to the API
  • --debug - Enables debug mode setting
  • -o OUTPUT_FORMAT, --output OUTPUT_FORMAT - Changes the output formats based on presets

probely findings get Available Filters​

  • --f-scans F_SCANS - Filter findings by list of origin scans
  • --f-severity F_SEVERITY - Filter findings by list of severities
  • --f-state F_STATE - Filter findings by list of states
  • --f-target F_TARGET - Filter findings by list of origin targets
  • --f-search SEARCH_TERM - Filter findings matching definition name, value, labels, or the target URL
  • --f-is-new F_IS_NEW - Filter new findings
  • --f-target-label F_TARGET_LABEL - Filter findings by target label ids
  • --f-target-label-logical-operator F_TARGET_LABEL_LOGICAL_OPERATOR - Logical operator to apply when filtering target labels
  • --f-last-found-gte ISO_8601_DATETIME - Filter findings last found after, or at, timestamp. Eg: 2020-07-05 or 2020-07-05T12:45:30
  • --f-last-found-lte ISO_8601_DATETIME - Filter findings last found before, or at, timestamp. Eg: 2020-07-05 or 2020-07-05T12:45:30
  • --f-changed-gte ISO_8601_DATETIME - Filter findings changed after, or at, timestamp. Eg: 2020-07-05 or 2020-07-05T12:45:30
  • --f-changed-lte ISO_8601_DATETIME - Filter findings changed before, or at, timestamp. Eg: 2020-07-05 or 2020-07-05T12:45:30

probely findings retest​

Retest your vulnerability fix. Use filters or identifiers to narrow the list

probely findings retest [-h] [--api-key API_KEY] [--debug] [--f-scans F_SCANS [F_SCANS ...]]
                        [--f-severity {LOW,MEDIUM,HIGH,CRITICAL} [{LOW,MEDIUM,HIGH,CRITICAL} ...]]
                        [--f-state {FIXED,NOT_FIXED,ACCEPTED,RETESTING} [{FIXED,NOT_FIXED,ACCEPTED,RETESTING} ...]]
                        [--f-target F_TARGET [F_TARGET ...]] [--f-search SEARCH_TERM]
                        [--f-is-new {TRUE,FALSE}]
                        [--f-target-label F_TARGET_LABEL [F_TARGET_LABEL ...]]
                        [--f-target-label-logical-operator {AND,OR}]
                        [--f-last-found-gte ISO_8601_DATETIME]
                        [--f-last-found-lte ISO_8601_DATETIME]
                        [--f-changed-gte ISO_8601_DATETIME]
                        [--f-changed-lte ISO_8601_DATETIME] [-o {YAML,JSON,TABLE,IDS_ONLY}]
                        [-f YAML_FILE_PATH] [--ignore-blackout-period]
                        [--scan-profile SCAN_PROFILE_ID]
                        [FINDING_ID ...]

probely findings retest positional arguments​

  • FINDING_ID - Identifiers of the findings to retest

probely findings retest options​

  • -h, --help - show this help message and exit
  • --api-key API_KEY - Authorization token to make requests to the API
  • --debug - Enables debug mode setting
  • -o OUTPUT_FORMAT, --output OUTPUT_FORMAT - Changes the output formats based on presets
  • -f YAML_FILE_PATH, --yaml-file YAML_FILE_PATH - Path to file with content to apply. Accepts same payload as listed in API docs
  • --ignore-blackout-period - Start Scans even if Target’s in blackout period
  • --scan-profile SCAN_PROFILE_ID - Scan Profile resulting Scans utilize, bypassing Target’s configuration

probely findings retest Available Filters​

  • --f-scans F_SCANS - Filter findings by list of origin scans
  • --f-severity F_SEVERITY - Filter findings by list of severities
  • --f-state F_STATE - Filter findings by list of states
  • --f-target F_TARGET - Filter findings by list of origin targets
  • --f-search SEARCH_TERM - Filter findings matching definition name, value, labels, or the target URL
  • --f-is-new F_IS_NEW - Filter new findings
  • --f-target-label F_TARGET_LABEL - Filter findings by target label ids
  • --f-target-label-logical-operator F_TARGET_LABEL_LOGICAL_OPERATOR - Logical operator to apply when filtering target labels
  • --f-last-found-gte ISO_8601_DATETIME - Filter findings last found after, or at, timestamp. Eg: 2020-07-05 or 2020-07-05T12:45:30
  • --f-last-found-lte ISO_8601_DATETIME - Filter findings last found before, or at, timestamp. Eg: 2020-07-05 or 2020-07-05T12:45:30
  • --f-changed-gte ISO_8601_DATETIME - Filter findings changed after, or at, timestamp. Eg: 2020-07-05 or 2020-07-05T12:45:30
  • --f-changed-lte ISO_8601_DATETIME - Filter findings changed before, or at, timestamp. Eg: 2020-07-05 or 2020-07-05T12:45:30

probely findings self-review​

Accept or reject findings. Use filters or identifiers to narrow the list

probely findings self-review [-h] [--api-key API_KEY] [--debug]
                             [--f-scans F_SCANS [F_SCANS ...]]
                             [--f-severity {LOW,MEDIUM,HIGH,CRITICAL} [{LOW,MEDIUM,HIGH,CRITICAL} ...]]
                             [--f-state {FIXED,NOT_FIXED,ACCEPTED,RETESTING} [{FIXED,NOT_FIXED,ACCEPTED,RETESTING} ...]]
                             [--f-target F_TARGET [F_TARGET ...]] [--f-search SEARCH_TERM]
                             [--f-is-new {TRUE,FALSE}]
                             [--f-target-label F_TARGET_LABEL [F_TARGET_LABEL ...]]
                             [--f-target-label-logical-operator {AND,OR}]
                             [--f-last-found-gte ISO_8601_DATETIME]
                             [--f-last-found-lte ISO_8601_DATETIME]
                             [--f-changed-gte ISO_8601_DATETIME]
                             [--f-changed-lte ISO_8601_DATETIME]
                             [-o {YAML,JSON,TABLE,IDS_ONLY}] [-f YAML_FILE_PATH]
                             [--review-status {ACCEPTED,REJECTED}]
                             [--justification JUSTIFICATION]
                             [FINDING_ID ...]

probely findings self-review positional arguments​

  • FINDING_ID - Identifiers of the findings to self-review

probely findings self-review options​

  • -h, --help - show this help message and exit
  • --api-key API_KEY - Authorization token to make requests to the API
  • --debug - Enables debug mode setting
  • -o OUTPUT_FORMAT, --output OUTPUT_FORMAT - Changes the output formats based on presets
  • -f YAML_FILE_PATH, --yaml-file YAML_FILE_PATH - Path to file with content to apply. Accepts same payload as listed in API docs
  • --review-status REVIEW_STATUS - The new review status for the finding: 'accepted' or 'rejected'.
  • --justification JUSTIFICATION - Justification for accepting or rejecting the finding.

probely findings self-review Available Filters​

  • --f-scans F_SCANS - Filter findings by list of origin scans
  • --f-severity F_SEVERITY - Filter findings by list of severities
  • --f-state F_STATE - Filter findings by list of states
  • --f-target F_TARGET - Filter findings by list of origin targets
  • --f-search SEARCH_TERM - Filter findings matching definition name, value, labels, or the target URL
  • --f-is-new F_IS_NEW - Filter new findings
  • --f-target-label F_TARGET_LABEL - Filter findings by target label ids
  • --f-target-label-logical-operator F_TARGET_LABEL_LOGICAL_OPERATOR - Logical operator to apply when filtering target labels
  • --f-last-found-gte ISO_8601_DATETIME - Filter findings last found after, or at, timestamp. Eg: 2020-07-05 or 2020-07-05T12:45:30
  • --f-last-found-lte ISO_8601_DATETIME - Filter findings last found before, or at, timestamp. Eg: 2020-07-05 or 2020-07-05T12:45:30
  • --f-changed-gte ISO_8601_DATETIME - Filter findings changed after, or at, timestamp. Eg: 2020-07-05 or 2020-07-05T12:45:30
  • --f-changed-lte ISO_8601_DATETIME - Filter findings changed before, or at, timestamp. Eg: 2020-07-05 or 2020-07-05T12:45:30