# Creating and Running Security Scan Jobs

Security Scan Jobs allow users to create and schedule SCAP program (Security Content Automation Program) scans for groups of managed systems. These Jobs can call in existing SCAP packages and checklists, which are used to scan the targeted systems on-demand or on a scheduled basis. Historical data for these scans is saved in the Job Execution list and in the software section of server detail pages. Detailed scan reports can also be viewed for each system as needed once the scan is complete. See the [SCAP documentation](https://csrc.nist.gov/CSRC/media/Projects/Security-Content-Automation-Protocol/documents/docs/scap-nistir-7343.pdf) on the NIST website for information on developing your own scanning procedures.

NOTE

Creating and editing Security Scan Jobs requires the “Security: Scanning” Role permission set to Full. Viewing Security Scan Jobs and seeing the results for scanned servers requires at least a Read-level permission.

## Add a new Security Scan Job

### About this task

NOTE

New security scan packages are added in HPE Morpheus Enterprise Library rather than here in the Jobs section. Ensure you have uploaded the desired security package in Library > Templates > Security Packages before proceeding with new security Job creation.

### Procedure

1. Navigate to Provisioning > Jobs > Jobs Tab
2. Click +ADD
3. Set the Job type to “Security Scan Job” and provide a friendly name for the Job
4. Click NEXT 

   ![../../_images/2new_job.png](https://support.hpe.com/hpesc/public/api/document/sd00008375en_us/GUID-E8A3A8C8-27F1-48F1-8B98-2AF3AAE6E121-high.png)
5. Select a security package, see the previous section to add a new one
6. Enter your Scan Checklist (XML document) and Security Profile (XCCDF document), more information on these can be found in the SCAP documentation linked above
7. Set a schedule or leave as Manual to only run this scan on-demand (new execution schedules can be created in Library > Automationif needed)
8. Set a specific power state target if desired. This indicates whether the Job should run against workloads having any power state, just an “on” power state, or just an “off” power state
9. Set the context, can be Instance or Server. Select as many Instances or Servers as needed for this scanning run
10. Click NEXT
11. After final review, click COMPLETE 

    ![../../_images/3job_details.png](https://support.hpe.com/hpesc/public/api/document/sd00008375en_us/GUID-77399E18-27B9-465D-885C-F34C86B2EA19-high.png)

## Running Security Scan Jobs

### About this task

Once created, Security Scan Jobs will run based on the configured schedule. They can also be run on-demand when needed:

### Procedure

1. Navigate to Provisioning > Jobs > Jobs Tab
2. Click MORE
3. Click “Execute” 

   ![../../_images/4execute_scan.png](https://support.hpe.com/hpesc/public/api/document/sd00008375en_us/GUID-ECB853BF-5ACC-4D03-BCC3-AF5A1D2706A3-high.png)

## Viewing Completed Security Scan Jobs

### About this task

To view a list of completed Security Scan Jobs (and Jobs of other types):

### Procedure

1. Navigate to Provisioning > Jobs > Job Executions Tab
2. Additional details can be viewed by clicking (i) 

   ![../../_images/5execution_list.png](https://support.hpe.com/hpesc/public/api/document/sd00008375en_us/GUID-486B12EC-23D0-4977-9075-9BAE63439855-high.png)

### Results

To view scan results for specific servers:

1. Navigate to the server detail page (Infrastructure > Hosts > Virtual Machines tab > Selectedserver)
2. Click on the Software tab part way down the page, then click on the Security subtab
3. High level details on previous scans is viewable here

   ![../../_images/6server_results.png](https://support.hpe.com/hpesc/public/api/document/sd00008375en_us/GUID-FEF15F44-AFFC-4639-B948-E5077F44A1AA-high.png)
4. To view the full report, click (i)

   ![../../_images/7scan_report.png](https://support.hpe.com/hpesc/public/api/document/sd00008375en_us/GUID-87EF931F-9CF2-4909-BD82-654F0658AE7D-high.png)

## Security Drift

In addition to tracking the scan results over time as described in the previous section, HPE Morpheus Enterprise also provides detail into the change from the most recent scan to the one prior. This information is displayed in the Software tab (and Security subtab) of the detail page for the virtual machine (accessed from the associated Instance detail page or at Infrastructure > Hosts > Virtual Machines). The information surfaced by this view is listed below. If there is no change, you’ll simply see a “No Drift” message.

- **Title:** The criteria for the test that has newly passed or failed
- **Severity:** The severity level for the indicated security requirement
- **Result:** The indicator for whether this test has newly passed or failed
- **New Pass:** The number of tests that have newly passed compared to the prior scan
- **New Fail:** The number of tests that have newly failed compared to the prior scan
- **Status:** An indicator of the change in security posture since the prior scan. A net gain in test failures will yield a negative status indicator while net gains in passed tests (or no change) will yield a positive status indicator

![../../_images/8securityDrift.png](https://support.hpe.com/hpesc/public/api/document/sd00008375en_us/GUID-A56F50AC-F22B-4AB1-84B2-AE09A887951C-high.png)
