Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ansible-lockdown/rhel6-stig

Ansible role for Red Hat 6 DISA STIG
https://github.com/ansible-lockdown/rhel6-stig

ansible-role rhel6 security security-hardening stig

Last synced: about 1 month ago
JSON representation

Ansible role for Red Hat 6 DISA STIG

Awesome Lists containing this project

README

        

# RHEL 6 DISA STIG

[![Galaxy](https://img.shields.io/badge/galaxy-nousdefions.STIG--RHEL6-blue.svg?style=flat)](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 comments in `tasks/cat1.yml, tasks/cat2.yml, tasks/cat3.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 for system hardening before or after an audit has been conducted.

## Installing from Ansible Galaxy

To install this role with `ansible-galaxy` use the following command:

`ansible-galaxy install -p roles nousdefions.STIG-RHEL6`

Based on [Red Hat Enterprise Linux 6 STIG Version 1 Release 18 - 2018-01-26](http://iasecontent.disa.mil/stigs/zip/U_RedHat_6_V1R18_STIG.zip).

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.

## 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_snmp_community` | `B0re4lis` | SNMP community string |
| `rhel6stig_pass_min_length` | `15` | Minimum password length |
| `rhel6stig_pass_min_days` | `1` | Minimum password age in days |
| `rhel6stig_pass_max_days` | `60` | Maximum password age in days |
| `rhel6stig_pass_reuse` | `60` | Maximum password age in days |
| `rhel6stig_pam_unix_params` | `sha512 shadow try_first_pass use_authtok remember=24` | PAM auth parameters |
| `rhel6stig_pam_cracklib_params` | `pam_unix.so try_first_pass` | PAM auth parameters |
| `rhel6stig_pam_auth_sufficient` | `try_first_pass retry=3 maxrepeat=3 minlen={{ rhel6stig_pass_min_length }} dcredit=-1 ucredit=-1 ocredit=-1 lcredit=-1 difok=4` | PAM cracklib parameters |
| `rhel6stig_selinux_pol` | `targeted` | SELinux policy to apply |
| `rhel6stig_antivirus_required` | `no` | Whether Anti-virus is required. To enable this you should configure the AV package settings as well. |
| `rhel6stig_av_package` | `complex` | AV Package settings |
| `rhel6stig_gpg_key_loc` | `complex` | GPG Key Location (URL or on disk) |
| `rhel6stig_use_dhcp` | `yes` | Whether the system should use DHCP or Static IPs. |
| `rhel6stig_update_all_packages` | `yes` | Perform a yum update for all packages. |
| `rhel6stig_maxlogins` | `10` | Max number of simultaneous system logins. |
| `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 target systems. Disables some changes if X Windows is not in use. |
| `rhel6stig_ipv6_required` | `yes` | Whether or not IPv6 is in use of the target system. |
| `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_system_is_router` | `no` | Whether on not the target system is acting as a router. Skips tasks that would break the system if it is a acting as a router |
| `rhel6stig_bootloader_password` | [Randomly generated and encrypted string] | The new GRUB password to use. |
| `rhel6stig_login_banner` | `[DOD banner]` | Banner used in `/etc/issue` and `/etc/issue.net` |

## Dependencies

python-jmespath

## 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
when:
- ansible_os_family == 'RedHat'
- ansible_distribution_major_version | version_compare('6', '=')
```

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 preliminary tasks that do things such as enumerate services on the system and check for the existence of various files will _always_ run unless explicitly skipped by using `--skip tags prelim_tasks`.

Some examples of using tags:

- Only run tasks that secure ssh

```sh
ansible-playbook site.yml --tags ssh
```

- Don't change SNMP or postfix

```sh
ansible-playbook site.yml --skip-tags postfix,mail,snmp
```

## License

MIT