Pivotal Compliance Scanner

Page last updated:

Note: Pivotal has renamed Compliance Scanner for PCF to Pivotal Compliance Scanner.

Note: Pivotal has renamed Pivotal Cloud Foundry to Pivotal Platform.

Pivotal Compliance Scanner is certified by the Center for Internet Security (CIS). For more information about all the versions certified for CIS Benchmarks, see the Pivotal - Certified Products CIS page.

Pivotal Compliance Scanner provides platform operators and auditors an assessment of each Pivotal Platform 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

Overview

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 Pivotal Platform 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 on 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:

  • CIS certification
  • Compatible with DISA STIG Viewer v2.9
  • 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 Pivotal Platform 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.2.16
Release date October 28, 2019
Software component version OpenSCAP 1.3.1
Compatible Ops Manager version(s) 2.5, 2.6, 2.7, and 2.8
Compatible Pivotal Application Service version(s) 2.5, 2.6, 2.7, and 2.8
IaaS support AWS, Azure, GCP, and vSphere
IPsec support Yes

Ports

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. This starts the scan on the VM through the daemon client using the rpc_port. 28893
VM with Compliance Scanner The port bound to the loopback interface. The scanning server that receives the request passes the request to the RPC server using the port that is doing the scan. 28895

Limitations

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.

Feedback

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