Repository files navigation

A GUI tool that provides scanning, tailoring and validation functionality for SCAP content

SCAP Workbench is a GUI tool that provides scanning, tailoringand validation functionality for SCAP content. It uses openscap libraryto access SCAP functionalities.

Homepage of the project ishttps://www.open-scap.org/tools/scap-workbench/

1. Make sure you have installed all prerequisites

required dependencies:

#yum install cmake gcc-c++ openssh-clients util-linux openscap-devel qt5-qtbase-devel qt5-qtxmlpatterns-devel openssh-askpass

required dependencies (only for the git repo, not required for released tarballs):

#yum install asciidoc

optional dependencies:

#yum install polkit

On Ubuntu this is roughly equivalent to:

#apt install build-essential openssh-client libopenscap-dev libqt5xmlpatterns5-dev ssh-askpass#apt install asciidoc#apt install libpolkit-agent-1-0

2. Build SCAP Workbench:

$mkdir build;cd build$cmake ../$make

To build against locally built OpenSCAP library export following variables:

$export PKG_CONFIG_PATH="$PKG_CONFIG_PATH:/PATH/TO/DIR/WITH/.pcFILE/"$export LIBRARY_PATH=/PATH/TO/DIR/WITH/openscap.soFILE/

Additionally it is possible to use custom CMake definitions instead of exporting environment variables:

$cmake -DOPENSCAP_LIBRARIES:PATH=/local/openscap.so/filepath/ \    -DOPENSCAP_INCLUDE_DIRS:PATH=/local/openscap/include/path \    -DOPENSCAP_VERSION:STRING="X.Y.Z" \    ../$make

3. Install SCAP Workbench: (optional)

(inside the build folder):

$# may require superuser privileges if you didn't set different installation$# prefix (CMAKE_INSTALL_PREFIX)$make install

4a) Run SCAP Workbench: (if it was installed)

spawning open file dialog:

$scap-workbench

with an XCCDF file to load:

$scap-workbench /path/to/xccdf-file.xml

with a source datastream (SDS) to load:

$scap-workbench /path/to/sds-file

4b) Run SCAP Workbench: (straight from build dir, without installation)

Note: If you have built SCAP-Workbench against locally built OpenSCAP library, then run one of the following commands:

$ldconfig /PATH/TO/DIR/WITH/openscap.soFILE/

or

$export LD_LIBRARY_PATH=/PATH/TO/DIR/WITH/openscap.soFILE/

and then:

$cd build/$bash runwrapper.sh ./scap-workbench

You should have a built SCAP Workbench executable by now. Please refer to the user manual for documentation on how to use it.

There are 3 ways to get the user manual:

• ClickHelp -> User Manual in the application
• Open/usr/share/doc/scap-workbench/user_manual.html (installed system-wide) ordoc/user_manual.html (from the tarball) in your browser
• Open or downloaduser manual from the website

$mkdir build;cd build$cmake ../$make package_source