fail2ban

pdk
fail2ban Puppet module

Trey Dockendorf

treydock

5,792 downloads

2,787 latest version

5.0 quality score

Version information

  • 1.1.1 (latest)
  • 1.1.0
  • 1.0.1
  • 1.0.0
  • 0.0.1
released May 15th 2019
This version is compatible with:
  • Puppet Enterprise 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x
  • Puppet >= 5.0.0 < 7.0.0
  • RedHat
    ,
    CentOS
    ,
    Scientific

Start using this module

Documentation

treydock/fail2ban — version 1.1.1 May 15th 2019

puppet-module-fail2ban

Puppet Forge Build Status

Table of Contents

  1. Overview
  2. Usage - Configuration options
  3. Reference - Parameter and detailed reference to all options
  4. Limitations - OS compatibility, etc.
  5. Development - Guide for contributing to the module
  6. TODO
  7. Additional Information

Overview

This module manages Fail2ban.

Usage

fail2ban

Install and configure fail2ban with SSH jail.

class { 'fail2ban':
  jails => ['sshd'],
}

Configure fail2ban to not ban a local subnet

class { 'fail2ban':
  jails            => ['sshd'],
  default_ignoreip => ['10.0.0.0/8'],
}

Reference

http://treydock.github.io/puppet-module-fail2ban/

Limitations

This module has been tested on:

  • CentOS/RedHat 6 x86_64
  • CentOS/RedHat 7 x86_64

Development

Testing

Testing requires the following dependencies:

  • rake
  • bundler

Install gem dependencies

bundle install

Run unit tests

bundle exec rake test

If you have Vagrant >= 1.2.0 installed you can run system tests

bundle exec rake beaker

TODO

Further Information