Compliance Scanner for PCF

Page last updated:

Compliance Scanner for PCF provides platform operators and auditors an assessment of each PCF Linux VM running on Xenial stemcells and, if it is compliant, with configuration guidelines.

The following VM types on an Pivotal Operations Manager instance are skipped for scanning and do not have Compliance Scanner deployed on them:

  • Linux VMs running on Trusty stemcells
  • Non-Linux VMs


Benchmarks for existing commercial configuration scanners are intended for use against traditional Ubuntu servers. This means that running these benchmark scans against a stemcell results in numerous false positives.

Compliance Scanner addresses this issue by tuning industry-recognized Ubuntu configuration benchmarks for stemcells.

Compliance Scanner packages the following files for deployment on each BOSH-managed Linux VM:

  • The OpenSCAP (OSCAP) scanner
  • XFiles: A group of YAML files that contains configuration tests written in YAML.
  • The XCCDF Generator (XGen): This translates XFiles tests to the SCAP format.

Compliance Scanner is installed through Ops Manager. As part of the installation, it deploys each packaged component to each PCF Linux VM and instantiates a new Linux VM, oscap_store, for log retrieval.

Scans are errands that are triggered through Ops Manager. After a successful scan, operators can retrieve reports through the tile. Operators can download these reports to their local machine.

For more information about the tests, test coverage, and test criteria covered by these benchmarks, see the PDF files included on the Compliance Scanner release page on Pivotal Network.

Key Features

Compliance Scanner includes the following key features:

  • Modified version of industry-recognized configuration benchmarks tuned for stemcells
  • Bundled tests written in YAML, allowing for easier readability
  • Reports of scan results for each Linux VM in the PCF deployment that highlight the compliance posture

Product Snapshot

The following table provides version and version-support information about Compliance Scanner.

Element Details
Tile version 1.0.0
Release date July 31, 2019
Software component version OpenSCAP 1.3.0
Compatible Ops Manager version(s) 2.3, 2.4, 2.5, 2.6, and 2.7
Compatible Pivotal Application Service version(s) 2.3, 2.4, 2.5, 2.6, and 2.7
IaaS support AWS, Azure, GCP, and vSphere
IPsec support Yes


Compliance Scanner uses the following ports:

VM Type Description Port
oscap_store The port used by oscap_store to receive the scan results from VMs with Compliance Scanner. The oscap_store VM initiates scan requests to other VMs and aggregates the results. 28894
VM with Compliance Scanner The port used by the scanning server running on each of the VMs with Compliance Scanner installed. 28893


Compliance Scanner has the following limitations:

  • Because of stemcell-related customization, benchmarks are not certified by a governing body.

  • Windows VMs are not supported at this time.

  • BOSH DNS cannot resolve the oscap_store VM URL if there is any capitalization in the network name.

Note: Compliance Scanner can only scan Linux VMs running on Xenial stemcells 97.x and 170.x and later.


Please provide any bugs, feature requests, or questions to the Pivotal Cloud Foundry Feedback list.