Role Detail

geerlingguy.security

Security software installation and configuration.
Downloads
24346
Type Ansible
Minimum Ansible Version 1.9
Installation $ ansible-galaxy install geerlingguy.security
Tags
security
system
Last Commit 2017-04-02 15:35:03 PM UTC
Last Imported 2017-05-10 02:41:02 AM UTC
Version History
Version Release Date
1.5.0 2016-11-21 17:45:05 PM
1.4.0 2016-08-16 19:38:07 PM
1.3.0 2016-05-24 22:01:10 PM
1.2.0 2016-04-22 15:01:03 PM
1.1.1 2016-03-08 05:06:05 AM
1.1.0 2016-02-09 21:46:09 PM
1.0.8 2015-12-28 15:49:03 PM
1.0.7 2015-11-17 20:22:08 PM
1.0.6 2015-10-20 19:02:07 PM
1.0.5 2015-10-05 12:00:12 PM
1.0.4 2015-07-28 18:46:06 PM
1.0.3 2015-04-23 20:13:08 PM
1.0.2 2014-08-01 14:23:02 PM
1.0.1 2014-07-08 13:19:01 PM
1.0.0 2014-06-14 03:48:03 AM
Supported Platforms
Platform Version
Debian etch
Debian jessie
Debian lenny
Debian sid
Debian squeeze
Debian stretch
Debian wheezy
EL 5
EL 6
EL 7
Ubuntu lucid
Ubuntu maverick
Ubuntu natty
Ubuntu oneiric
Ubuntu precise
Ubuntu quantal
Ubuntu raring
Ubuntu saucy
Ubuntu trusty
Ubuntu utopic
Ubuntu vivid
Ubuntu wily
Ubuntu xenial
Ubuntu yakkety
Last 10 Imports
Completed Status
2017-05-10 02:41:02 AM UTC SUCCESS
2017-05-10 02:39:02 AM UTC SUCCESS
2017-05-08 23:17:11 PM UTC SUCCESS
2017-05-08 23:13:11 PM UTC SUCCESS
2017-04-02 15:45:03 PM UTC SUCCESS
2017-03-09 13:33:01 PM UTC SUCCESS
2017-03-09 11:23:11 AM UTC SUCCESS
2017-01-22 04:13:04 AM UTC SUCCESS
2016-11-21 17:54:05 PM UTC SUCCESS
2016-11-21 17:51:05 PM UTC SUCCESS

Ansible Role: Security (Basics)

Build Status

First, a major, MAJOR caveat: the security of your servers is YOUR responsibility. If you think simply including this role and adding a firewall makes a server secure, then you're mistaken. Read up on Linux, network, and application security, and know that no matter how much you know, you can always make every part of your stack more secure.

That being said, this role performs some basic security configuration on RedHat and Debian-based linux systems. It attempts to:

  • Install software to monitor bad SSH access (fail2ban)
  • Configure SSH to be more secure (disabling root login, requiring key-based authentication, and allowing a custom SSH port to be set)
  • Set up automatic updates (if configured to do so)

There are a few other things you may or may not want to do (which are not included in this role) to make sure your servers are more secure, like:

  • Use logwatch or a centralized logging server to analyze and monitor log files
  • Securely configure user accounts and SSH keys (this role assumes you're not using password authentication or logging in as root)
  • Have a well-configured firewall (check out the geerlingguy.firewall role on Ansible Galaxy for a flexible example)

Again: Your servers' security is your responsibility.

Requirements

For obvious reasons, sudo must be installed if you want to manage the sudoers file with this role.

On RedHat/CentOS systems, make sure you have the EPEL repository installed (you can include the geerlingguy.repo-epel role to get it installed).

No special requirements for Debian/Ubuntu systems.

Role Variables

Available variables are listed below, along with default values (see defaults/main.yml):

security_ssh_port: 22

The port through which you'd like SSH to be accessible. The default is port 22, but if you're operating a server on the open internet, and have no firewall blocking access to port 22, you'll quickly find that thousands of login attempts per day are not uncommon. You can change the port to a nonstandard port (e.g. 2849) if you want to avoid these thousands of automated penetration attempts.

security_ssh_password_authentication: "no"
security_ssh_permit_root_login: "no"
security_ssh_usedns: "no"

Security settings for SSH authentication. It's best to leave these set to "no", but there are times (especially during initial server configuration or when you don't have key-based authentication in place) when one or all may be safely set to 'yes'.

security_sudoers_passwordless: []
security_sudoers_passworded: []

A list of users who should be added to the sudoers file so they can run any command as root (via sudo) either without a password or requiring a password for each command, respectively.

security_autoupdate_enabled: true

Whether to install/enable yum-cron (RedHat-based systems) or unattended-upgrades (Debian-based systems). System restarts will not happen automatically in any case, and automatic upgrades are no excuse for sloppy patch and package management, but automatic updates can be helpful as yet another security measure.

security_autoupdate_blacklist: []

(Debian/Ubuntu only) A listing of packages that should not be automatically updated.

security_autoupdate_mail_to: ""
security_autoupdate_mail_on_error: true

(Debian/Ubuntu only) If security_autoupdate_mail_to is set to an non empty value, unattended upgrades will send an e-mail to that address when some error occurs. You may either set this to a full email: ops@example.com or to something like root, which will use /etc/aliases to route the message. If you set security_autoupdate_mail_on_error to false you'll get an email after every package install.

security_fail2ban_enabled: true

Wether to install/enable fail2ban. You might not want to use fail2ban if you're already using some other service for login and intrusion detection (e.g. ConfigServer).

Dependencies

None.

Example Playbook

- hosts: servers
  vars_files:
    - vars/main.yml
  roles:
    - geerlingguy.security

Inside vars/main.yml:

security_sudoers_passworded:
  - johndoe
  - deployacct

License

MIT (Expat) / BSD

Author Information

This role was created in 2014 by Jeff Geerling, author of Ansible for DevOps.

None