Skip to main content

Tenable scanner reference for STO

You can scan your application instances and ingest results from Tenable.

For more information

The following topics contain useful information for setting up scanner integrations in STO:

Security step settings for Tenable scans in STO

Target and variant

The following settings are required for every Security step:

  • target_name A user-defined label for the code repository, container, application, or configuration to scan.
  • variant A user-defined label for the branch, tag, or other target variant to scan.
note

Make sure that you give unique, descriptive names for the target and variant. This makes navigating your scan results in the STO UI much easier.

You can see the target name, type, and variant in the Test Targets UI:

Target name, type, and branch

For more information, go to Targets, baselines, and variants in STO.

Tenable settings

  • product_name = tenableio
  • scan_type = instance
  • policy_type = orchestratedScan, or ingestionOnly
  • When policy_type is set to orchestratedScan:
    • product_domain
    • product_access_id
    • product_access_token
    • product_policy_id
    • product_scanner_id
    • product_template_uuid
  • product_config_name
    • Accepted values(s):
      • legacy-web-application-scan — Use legacy nessus scan inside tenableIO
  • fail_on_severity - See Fail on Severity.

Instance scan settings

The following settings apply to Security steps where the scan_type is instance.

  • instance_domain
  • instance_path
  • instance_protocol
  • instance_port
  • instance_username The username for authenticating with the external scanner.
  • instance_password You should create a Harness text secret with your encrypted password and reference the secret using the format <+secrets.getValue("project.container-access-id")>. For more information, go to Add and reference text secrets.

Ingestion file

If the policy_type is ingestionOnly:

  • ingestion_file = The path to your scan results when running an Ingestion scan, for example /shared/scan_results/myscan.latest.sarif.
  • The data file must be in a supported format for the scanner.

  • The data file must be accessible to the scan step. It's good practice to save your results files to a shared path in your stage. In the visual editor, go to the stage where you're running the scan. Then go to Overview > Shared Paths. You can also add the path to the YAML stage definition like this:

        - stage:
    spec:
    sharedPaths:
    - /shared/scan_results

Fail on Severity

Every Security step has a Fail on Severity setting. If the scan finds any vulnerability with the specified severity level or higher, the pipeline fails automatically. You can specify one of the following:

  • CRITICAL
  • HIGH
  • MEDIUM
  • LOW
  • INFO
  • NONE — Do not fail on severity

The YAML definition looks like this: fail_on_severity : critical # | high | medium | low | info | none