Version information
released Dec 13th 2018
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
- , , , , ,
This module has been deprecated by its author since Jun 28th 2023.
The reason given was: No longer maintained
The author has suggested markt-wforce as its replacement.
Start using this module
Documentation
fraenki/wforce — version 0.1.0 Dec 13th 2018
puppet-wforce
Table of Contents
Overview
This module will setup the weakforced Anti-Abuse server, also known as "wforce".
Requirements
- Puppet 5 or higher
- Access to wforce binary packages (either through a subscription or custom builds)
Usage
Beginning with wforce
Basic usage requires only a password for the wforce HTTP server:
class { 'wforce':
password => 'secretpassword'
}
Furthermore, a number of simple options are available:
class { 'wforce':
# Add networks to the access control list for the HTTP server.
acls => [ '172.16.99.0/24', '10.100.200.0/24' ],
# Change settings of the default databases (or add new databases).
databases => {
24HourDB => {
max_size => 750000,
v4prefix => 24,
},
MyDB => {
window_size: 900
num_windows: 32
max_size: 500000
field_map: 'default_field_map'
replication: false
},
},
# Replicate changes to db and blacklist to these hosts.
siblings => [ "10.99.0.1:4001:udp", "10.99.0.2:4001:udp", "10.99.0.3:4001:udp" ],
# On startup, try to replicate databases from the following host.
sync_enable => true,
sync_host => '10.99.0.1',
sync_password => 'secretpassword',
sync_uptime => 3600,
# Whitelist certain IP networks and hosts to avoid accidential blacklisting
whitelist => [ "10.199.0.0/24", "10.222.0.123/32" ],
}
Reference
Public Classes
Class: wforce
TBD
Private Classes
Class: wforce::config
Class: wforce::package
Class: wforce::service
Class: wforce::repo
Development
Contributing
Please use the GitHub issues functionality to report any bugs or requests for new features. Feel free to fork and submit pull requests for potential contributions.
Copyright (C) 2018 Frank Wall All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.