Major Hayden 4cdf533565 [Docs] More cleanup
This patch cleans up various parts of the security role docs:

* Updates README files
* Uses jinja2 includes rather than sphinx includes (faster builds)
* Adds sphinx refs for each STIG control and implementation status
* Adds ToC's to pages that didn't have them
* Updated getting started and special notes guide
* Makes deviations more clear

Change-Id: I1eed2705c64a857bd94577dbe735f2516ca87732
2016-09-14 12:18:30 -05:00

37 lines
1.6 KiB
ReStructuredText

Security hardening controls in detail
=====================================
The Security Technical Implementation Guide (STIG) for Red Hat Enterprise Linux
6 contains over 200 security controls. The links below will allow you to review
each control based on a certain set of criteria.
Controls are divided into groups based on certain properties:
* **Severity:** Normally high, medium and low. High severity items are the ones
which should be completed first, since they pose the greatest threat to the
security of a system.
*(These severity levels are set within the STIG.)*
* **Implementation status:** Each control is assessed thoroughly before Ansible
tasks are written. Some controls may be listed as *exceptions* since they
can't be implemented with automation, or they could cause damage to an
existing system. Other controls are listed as *opt-in* when they are
implemented, but they require a deployer to enable them.
*(This categorization comes from openstack-ansible-security, not the STIG.)*
* **Tag:** The controls are also separated based on which parts of the system
they act upon. Something that secures ``grub`` would be tagged with *boot*
while controls for ``sshd`` would be tagged with *auth*.
*(This categorization comes from openstack-ansible-security, not the STIG.)*
You can also review the STIG controls in one very large page. This can be
helpful when you need to search using your web browser.
.. toctree::
:maxdepth: 2
auto_controls-by-severity.rst
auto_controls-by-status.rst
auto_controls-by-tag.rst
auto_controls-all.rst