Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/samdoran/ansible-role-rhel6stig
Ansible role for Red Hat 6 DISA STIG
https://github.com/samdoran/ansible-role-rhel6stig
Last synced: about 2 months ago
JSON representation
Ansible role for Red Hat 6 DISA STIG
- Host: GitHub
- URL: https://github.com/samdoran/ansible-role-rhel6stig
- Owner: samdoran
- License: mit
- Created: 2014-07-15T21:38:09.000Z (over 10 years ago)
- Default Branch: develop
- Last Pushed: 2016-07-25T21:20:58.000Z (over 8 years ago)
- Last Synced: 2023-05-21T08:35:16.902Z (over 1 year ago)
- Language: Python
- Homepage:
- Size: 397 KB
- Stars: 23
- Watchers: 11
- Forks: 8
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
RHEL 6 DISA STIG
================
[](https://galaxy.ansible.com/nousdefions/STIG-RHEL6)
Configure RHEL 6 to be DISA STIG compliant. CAT I findings will be corrected by default. CAT II and CAT III findings can be corrected by setting the appropriate variable to enable those tasks.
Not all findings can be remediated automatically, or they require more complex automation specific to your environment in order to be remediated appropriately. See `tasks/not_automated.yml` for these findings.
This role **will make changes to the system** that could break things. This is not an auditing tool but rather a remediation tool to be used after an audit has been conducted, though auditing functionality is in the works.
## IMPORTANT INSTALL STEP ##
To install this role with `ansible-galaxy` use the following command:
`ansible-galaxy install -p roles nousdefions.STIG-RHEL6,devel`
Based on [Red Hat Enterprise Linux 6 STIG Version 1 Release 6 - 2015-01-23](http://iase.disa.mil/stigs/os/unix-linux/Pages/index.aspx).
This repo originated from work done by [Sam Doran](https://github.com/samdoran/ansible-role-rhel6stig)
Requirements
------------
You should have a general understanding of the nature of the changes this role will make to the system. See the [DISA IASE site](http://iase.disa.mil/stigs/os/unix-linux/Pages/index.aspx) for details[1].
Role Variables
--------------
There are many role variables defined in defaults/main.yml. Here are the most important ones. Feel free to look through `defaults/main.yml` to see what other configuration options are available.
| Name | Default Value | Description |
|-------------------|---------------------|----------------------|
| `rhel6stig_cat1` | `yes` | Correct CAT I findings |
| `rhel6stig_cat2` | `no` | Correct CAT II findings |
| `rhel6stig_cat3` | `no` | Correct CAT III findings |
| `rhel6stig_use_dhcp` | `yes` | Whether the system should use DHCP or Static IPs. |
| `rhel6stig_system_is_router` | `no` | Whether on not the target system is acting as a router. Disables settings that would break the system if it is a acting as a router |
| `rhel6stig_root_email_address` | `[email protected]` | Address where system email is sent. |
| `rhel6stig_xwindows_required` | `no` | Whether or not X Windows is is use on taregt systems. Disables some changes if X Windows is not in use. |
| `rhel6stig_ipv6_in_use` | `no` | Whether or not ipv6 is in use of the target system. This is set automatically to 'yes' if ipv6 is found to be in use. (Default: false) |
| `rhel6stig_tftp_required` | `no` | Whether or not TFTP is required. If set to `yes`, this will prevent the removal of `tftp` and `tftp-server` packages. It will also reconfigure the `tftp-server` to run securely. |
| `rhel6stig_rhnsatellite_required` | `no` | Whether or not Red Hat Satellite is required in the environment. If not required, `rhnsd` will be stopped and disabled. |
| `rhel6stig_bootloader_password` | [Randomly generated and encrypted string] | The new grub password to use if `rhel6stig_change_grub_password` is **True** |
| `rhel6stig_update_all_packages` | `yes` | Whether to install all system updates. |
Dependencies
------------
None.
Example Playbooks
-----------------
Correct CAT I and CAT II findings but don't apply all updates.
```yaml
- hosts: all
become: yes
vars:
rhel6stig_update_all_packages: no
roles:
- { role: nousdefions.STIG-RHEL6,
rhel6stig_cat1: yes,
rhel6stig_cat2: yes,
rhel6stig_cat3: no
}
```
Prompt for the GRUB password.
```yaml
- hosts: servers
become: yes
vars:
rhel6stig_update_all_packages: no
vars:
rhel6stig_cat1: yes
rhel6stig_cat2: yes
rhel6stig_cat3: no
vars_prompt:
name: "rhel6stig_bootloader_password"
prompt: "Enter the bootloader password: "
private: yes
confirm: yes
roles:
- role: nousdefions.STIG-RHEL6
```
Tags
----
Each task is tagged with its category, severity, whether or not it is a patch or audit task, and the finding ID, e.g., V-38462. In addition to these four basic tags that all tasks have, there are human-friendly tags such as "ssh" or "dod_logon_banner".
A number of prilimary tasks that do things such as enumerate services on the system and check for the existence of various file will _always_ run unless explicitly skipped by using `--skip tags prelim_tasks`.
Some examples of using tags:
# Only remediate ssh
ansible-playbook site.yml --tags ssh
# Don't change SNMP or postfix
ansible-playbook site.yml --skip-tags postfix,mail,snmp
License
-------
MIT
[1](#note1): A web based STIG viewer is available [here](https://stigviewer.com/stig/red_hat_enterprise_linux_6/). They are not associated in any way with DISA but have provided a useful tool for viewing the STIGs.