diff --git a/doc/file.README.html b/doc/file.README.html index 0708c08..082daff 100644 --- a/doc/file.README.html +++ b/doc/file.README.html @@ -122,6 +122,11 @@
manage nagios monitoring for the service (optional)
+Optional
+manage remoteIP logging if running behind a Loadbalancer like HAproxy: if ae_use_lb is set to true, a configuration file etc/httpd/conf.d/loadbalancer-remoteip.confis created and configures apache/httpd to use the remote header. This allows proper fail2ban protection even behind the Loadbalancer. Make sure to set ae_trusted_proxyto the proper IP or range for the loadbalancer!
Maintenance
manage the service
diff --git a/doc/index.html b/doc/index.html index 7013215..4fd2c46 100644 --- a/doc/index.html +++ b/doc/index.html @@ -122,6 +122,11 @@manage nagios monitoring for the service (optional)
Optional
+manage remoteIP logging if running behind a Loadbalancer like HAproxy: if ae_use_lb is set to true, a configuration file etc/httpd/conf.d/loadbalancer-remoteip.confis created and configures apache/httpd to use the remote header. This allows proper fail2ban protection even behind the Loadbalancer. Make sure to set ae_trusted_proxyto the proper IP or range for the loadbalancer!
Maintenance
manage the service
diff --git a/doc/puppet_classes/confdroid_apache_3A_3Aparams.html b/doc/puppet_classes/confdroid_apache_3A_3Aparams.html index 96ea75a..720c808 100644 --- a/doc/puppet_classes/confdroid_apache_3A_3Aparams.html +++ b/doc/puppet_classes/confdroid_apache_3A_3Aparams.html @@ -129,118 +129,6 @@ inherited by all classes except defines.Whether or not to manage details for the httpd service user. This is generally only required when using httpd on a number of servers sharing storage resources, i.e. NFS, where UID and GID settings must be same across all nodes.
-Specify the user name for the httpd user. only active if ae_manage_user is set to true.
-Specify the UID for the httpd service user. only active if ae_manage_user is set to true.
Specify the user comment for /etc/passwd. Shows up in email notifications as sender information. only active if ae_manage_user is set to true.
Specify any secondary groups the httpd service user should be in. Must not contain the primary group. only active if ae_manage_user is set to true.
Specify the home of the httpd service user. only active if ae_manage_user is set to true.
Specify the shell for the httpd service user, which normally should not be allowed to log in . only active if ae_manage_user is set to true.
List of packages to install.
+whether to use load balancer or not. If true, a configuration file will be created to allow reading the client ips from the X-Forwarded-For header, and the httpd service will be restarted to apply the changes. This is required when using httpd behind a load balancer like haproxy, otherwise all client ips will be logged as the load balancer ip.
+the IP address of the trusted proxy, i.e. the load balancer. This is required when ae_use_lb is set to true, and defaults to ‘10.0.1.0/24’.
+37 +38 +39 +40 +41 +42 +43 +44 +45 +46 47 48 49 @@ -509,14 +443,10 @@ inherited by all classes except defines. 103 104 105 -106 -107 -108 -109 -110+106
# File 'manifests/params.pp', line 47
+ # File 'manifests/params.pp', line 37
class confdroid_apache::params (
@@ -540,6 +470,10 @@ class confdroid_apache::params (
String $ae_http_port = '80',
String $ae_https_port = '443',
+# loadbalancer
+ Boolean $ae_use_lb = false,
+ String $ae_trusted_proxy = '10.0.1.0/24',
+
) {
# facts
$fqdn = $facts['networking']['fqdn']
@@ -578,6 +512,8 @@ class confdroid_apache::params (
$ae_userdir_erb = 'confdroid_apache/userdir_conf.erb'
$ae_index_file = '/var/www/html/index.html'
$ae_index_erb = 'confdroid_apache/index_html.erb'
+ $ae_remoteip_file = '/etc/httpd/conf.d/loadbalancer-remoteip.conf'
+ $ae_remoteip_erb = 'confdroid_apache/loadbalancer_remoteip_conf.erb'
# includes must be last
include confdroid_apache::main::config
diff --git a/doc/puppet_classes/confdroid_apache_3A_3Aserver_3A_3Afiles.html b/doc/puppet_classes/confdroid_apache_3A_3Aserver_3A_3Afiles.html
index ca4bc62..ff94634 100644
--- a/doc/puppet_classes/confdroid_apache_3A_3Aserver_3A_3Afiles.html
+++ b/doc/puppet_classes/confdroid_apache_3A_3Aserver_3A_3Afiles.html
@@ -205,7 +205,22 @@
107
108
109
-110
+110
+111
+112
+113
+114
+115
+116
+117
+118
+119
+120
+121
+122
+123
+124
+125
# File 'manifests/server/files.pp', line 6
@@ -299,6 +314,21 @@ class confdroid_apache::server::files (
}
}
+ if $ae_use_lb == true {
+ file { $ae_remoteip_file:
+ ensure => file,
+ owner => 'root',
+ group => 'root',
+ mode => '0644',
+ selrange => s0,
+ selrole => object_r,
+ seltype => httpd_conf_t,
+ seluser => system_u,
+ content => template($ae_remoteip_erb),
+ notify => Service['httpd'],
+ }
+ }
+
# manage index.html
file { $ae_index_file: