User Guide
User Manual:
Open the PDF directly: View PDF .
Page Count: 51
Download | |
Open PDF In Browser | View PDF |
VMware SCAP Edit User Guide Revision 1.0 – 11-Jul-2016 Table of Contents Introduction ..................................................................................................................... 3 Installation and getting started ........................................................................................ 3 System Requirements ................................................................................................. 3 Installation ................................................................................................................... 4 Using the tool .................................................................................................................. 4 Creating a new OVAL file ............................................................................................ 5 Adding a new OVAL definition ............................................................................... 10 Opening an existing OVAL file ............................................................................... 46 Creating XCCDF file from an existing OVAL file .................................................... 48 References .................................................................................................................... 51 Introduction VMware SCAP Edit is an updated version of the Enhanced SCAP Content Editor tool by G2, Inc. The modified tool builds on similar capabilities but few subtle differences required to build OVAL content based on latest OVAL schema. The major changes done by VMware are as below: Added support for OVAL 5.11 for Independent, Unix, Linux and Windows schemas Added support for XCCDF 1.2 creation from OVAL Refreshed the tool with modern UI Dropped broken capabilities from previous versions of the tool Dropped obsolete schemas and all other seldom used features Updated libraries to latest versions Updated CPE version to 2.3 Restructured the code Removed obsolete and unneeded libraries These changes make the tool simple and intuitive to build OVAL content specially aligned with the latest 5.11 OVAL schema. Also, it can now create XCCDF 1.2 content directly from OVAL file. Note: This tool and the documentation below assumes that you are fairly aware of SCAP, OVAL, XCCDF and the surrounding scheme of things. If you are not, please take a moment and familiarize yourself with these before proceeding further. Installation and getting started System Requirements A Java Runtime Environment (JRE) preferably 1.8 or later. 1 GB of memory. Supported OS – Microsoft Windows and Linux (with support for JRE). Installation 1) Extract the VMware SCAP Edit 1.0.0.zip file. 2) Navigate to the extracted directory. 3) If you are running a Microsoft Windows system, execute startEditor.bat file. This will launch the tool. If you are running a Linux system, execute startEditor.sh file to launch the tool. These scripts will call Java with the appropriate arguments. These can be edited if you need to give Java more memory or set some other system property. Editing these files is only recommended for advanced users. Using the tool Launch the tool. You would see the tool interface as below: As you immediately notice, the tool has been simplified from its parent version. It now just has a file menu that offers you below core capabilities: 1) Creating a new OVAL file 2) Opening an existing OVAL file 3) Creating a XCCDF file from an existing OVAL file All other functionalities from the parent version have been taken out. Now, let us see each of the three functionalities in depth. Creating a new OVAL file Launch the tool. Navigate to File New OVAL. This opens a new dialog box with default OVAL 5.11 schema chosen. We have removed all other obsolete schema. Click Next. Now, select the target platform. You may now only choose between Independent, Linux, Unix and Windows. We have dropped the support for any other platform. For example, let us choose Unix. Click Next. Finally, choose the file name. Click Finish. This creates a new and blank OVAL file. This tool helps you define various OVAL components: Definitions Tests Objects States and Variables You can define those components individually and then link them up together later. But, for this example, let us walk through a typical flow in creating an OVAL definition. Adding a new OVAL definition Let us take an example that we want to write an OVAL definition that verifies that the /etc/passwd file is owned and group-owned by root and has permissions of 644. Start with adding a Test. Right click on Tests and then click Add Test. For your first test only, you will have to define OVAL base identifier. For this example, let us set the base identifier to com.vmware.unix. You can set this up as you would require. Click OK. Now, choose the target platform for which you are writing this test. Let us choose Unix here. Click Next. Now choose Test type or OVAL probe against which you want to define the test. Check out the references to read about these in detail. For this example, let us choose file_test. Using this test type we can check various attributes on files such as ownership and permissions. Click Next. As you know, each test is comprised of objects and states. On this screen, we will define objects and states to match our requirements (checking /etc/passwd file for ownership and group-ownership to be root and permissions of 644). As you notice above, the base identifier is preset. Also, you don’t have to manage the ids yourself once you define the base identifier. The tool keeps incrementing the ids as you add more tests. The same holds true for any other OVAL components such as definitions, objects, states and variables that you write. All the ids are taken care of by the tool. Also, all the OVAL defaults for various fields such as Check, Check Existence and State Operator are preset. You can use the drop down to pick and choose the various options as matching your requirements. Now, let us go ahead and define the test as needed by our requirement. We start by giving a Comment. Now click on Choose Object. This opens up Object wizard. Click New. This opens up New Object wizard. Give a comment. Right click on the below shown area to add parameters. Since, we chose test type as file_test, only below corresponding object parameters are available. Here, let us choose to give absolute path of the file. In our example, it is /etc/passwd. Click OK. Right click and select Edit to set the value for filepath object parameter. In this wizard, click on Edit and define the parameter value. Click OK. The value gets set for filepath. Click OK. The object is now defined. Click Finish. Object is now chosen for the corresponding test. Click OK. You will now see that the object id is populated in the test. Now, let us follow similar steps and define states. You can define multiple states per test. In our example, the states to be defined are: group_id = 0 user_id = 0 Permissions 644 o o o o o uexec = 0 gwrite = 0 gexec = 0 owrite = 0 oexec = 0 In the state definition area, click on Add. The state wizard opens up. Click New. Define a new state. First, give a Comment. Then, add all the state parameters needed from the parameter drop down list, one at a time. Then select each parameter and click Edit to set the desired value. Click Finish. Choose the state you just created. Click OK. Now, the test is complete. We defined all the test elements. The next step is to link the test to an OVAL definition. Right click on Definitions and select Add a definition. This would open OVAL definition wizard. In this wizard, choose the definition Class from the drop down and provide a suitable Title and Description for the definition. Click Next. Add references if you want to. This is optional. Click Next. Add affected platforms and products. Right click on Affected elements and select Add affected element. In our example, we will choose Unix. Click OK. Then, define a specific platform or product. Right click on Affectedand choose the target as needed. For our example, let us give SLES 11 as the target platform. An entry for it will look like below. Click OK. Click Finish. This adds a new OVAL definition. Now, we will link this definition with a test. Definitions can have one or more tests. In our example, we will associate this definition with the test we created in earlier steps. Click on Criteria tab. Right click on No Criteria defined and then choose Add criteria. Choose criteria operators (defaults are preset) and provide a Comment and then click OK. Now right click on Criteria to choose Add criterion elements via tests. Select the desired Test and click on Choose selected. Click Ok. This will add the test to the definition. Go to File menu and choose Save. Done! This completes adding your first OVAL definition and the required elements. The generated XML file looks like below: Now, you can run this OVAL definition using a tool such as VMware STIG compliance tool on the target platform. Opening an existing OVAL file To open an existing OVAL file, go to File Open OVAL. Browse the file, select it and click Open. This would open up the OVAL file that we just created. You may then add, edit or remove any OVAL elements to this file as desired. Do not forget to Save the file each time you have made changes to it that should be persisted. Creating XCCDF file from an existing OVAL file Using the tool, you can directly create a minimal XCCDF 1.2 file from an existing OVAL file. To do this, just launch the tool and click on File XCCDF from OVAL. Browse the file, select it and click Open. Provide the desired reverse DNS string and click OK. Provide desired XCCDF file name and click Save. This would create a XCCDF 1.2 file from chosen OVAL file. Click OK. The generated XCCDF XML file looks like below: Modify the XML tags such as status, title, description and version and then your XCCDF file is good to go. Optionally, you can manually create XCCDF profiles and groups, if required. You can then do XCCDF assessments or use the XCCDF to create SCAP source data stream, if required. References Below are some useful references. OVAL core definition schema – https://oval.mitre.org/language/version5.11/ovaldefinition/documentation/ovaldefinitions-schema.html OVAL independent definition schema – http://oval.mitre.org/language/version5.11/ovaldefinition/documentation/independentdefinitions-schema.html OVAL Linux definition schema – http://oval.mitre.org/language/version5.11/ovaldefinition/documentation/linux-definitionsschema.html OVAL Unix definition schema – http://oval.mitre.org/language/version5.11/ovaldefinition/documentation/unix-definitionsschema.html OVAL Windows definition schema – http://oval.mitre.org/language/version5.11/ovaldefinition/documentation/windowsdefinitions-schema.html VMware STIG compliance tool – https://blogs.vmware.com/security/2016/05/vmware-releases-stig-compliance-app-forfree.html
Source Exif Data:
File Type : PDF File Type Extension : pdf MIME Type : application/pdf PDF Version : 1.5 Linearized : No Page Count : 51 Language : en-US Tagged PDF : Yes Author : Pravin Goyal Creator : Microsoft® Word 2016 Create Date : 2016:07:06 17:08:03+05:30 Modify Date : 2016:07:06 17:08:03+05:30 Producer : Microsoft® Word 2016EXIF Metadata provided by EXIF.tools