Major Hayden d56468f98a Docs: Add developer guide for security role
This patch adds detailed instructions for developers who are working on
the security role. The patch also adds CentOS/RHEL 7 support to the
run_tests.sh script.

Change-Id: I0ab79f1e4abdb3deeca9b48da3b9e4f42be37980
2016-06-08 13:07:06 -05:00

66 lines
2.7 KiB
ReStructuredText

Security hardening for openstack-ansible
========================================
The openstack-ansible-security role provides security hardening for `OpenStack`_
environments deployed with `openstack-ansible`_. The role has multiple goals:
* Provide additional security in a highly configurable, integrated way without
disrupting a production OpenStack environment.
* Make it easier for organizations to meet the requirements of compliance
programs, such as `Payment Card Industry Data Security Standard (PCI-DSS)`_.
* Document all changes to allow deployers to make educated decisions on which
security configuration changes to apply.
At this time, the role follows the requirements of the US Government's
`Security Technical Implementation Guide (STIG)`_ for Red Hat Enterprise Linux 6.
The easiest method for reviewing the STIG configurations and the relevant
metadata is through the `STIG Viewer`_ service provided by `UCF`_.
.. _OpenStack: http://www.openstack.org/
.. _openstack-ansible: http://docs.openstack.org/developer/openstack-ansible/
.. _Payment Card Industry Data Security Standard (PCI-DSS): https://en.wikipedia.org/wiki/Payment_Card_Industry_Data_Security_Standard
.. _Security Technical Implementation Guide (STIG): https://en.wikipedia.org/wiki/Security_Technical_Implementation_Guide
.. _STIG Viewer: https://www.stigviewer.com/stig/red_hat_enterprise_linux_6/
.. _UCF: http://www.unifiedcompliance.com/
Newton: Development
===================
The openstack-ansible-security role is currently under development for the
Newton release. The Newton release will add support Ubuntu 16.04 and CentOS 7
in addition to the existing support for Ubuntu 14.04.
.. toctree::
:maxdepth: 2
benefits.rst
configuration.rst
getting-started.rst
controls.rst
developer-guide.rst
Mitaka: Stable release
===================================================
The Mitaka release of the openstack-ansible-security role was first released
with the 13.0.0 tag on April 1st, 2016. Refer to the `release notes
<http://docs.openstack.org/releasenotes/openstack-ansible-security/mitaka.html>`_
for more details on the improvements and fixes.
* `openstack-ansible-security Mitaka Documentation`_
.. _openstack-ansible-security Mitaka Documentation: http://docs.openstack.org/developer/openstack-ansible-security/mitaka/
Liberty: Previous stable release (EOL: 2016-11-17)
==================================================
Refer to the `release notes
<http://docs.openstack.org/releasenotes/openstack-ansible-security/liberty.html>`_
for more details on the improvements and fixes.
* `openstack-ansible-security Liberty Documentation`_
.. _openstack-ansible-security Liberty Documentation: http://docs.openstack.org/developer/openstack-ansible-security/liberty/