27. CloudFlare
##############
This features provides interaction with the CloudFlare Firewall.
As CloudFlare is a reverse proxy, any attacking IP addresses (so far as
iptables is concerned) come from the CloudFlare IP's. To counter this, an
Apache module (mod_cloudflare) is available that obtains the true attackers
IP from a custom HTTP header record (similar functionality is available
for other HTTP daemons.
However, despite now knowing the true attacking IP address, iptables cannot
be used to block that IP as the traffic is still coming from the CloudFlare
servers.
CloudFlare have provided a Firewall feature within the user account where
rules can be added to block, challenge or whitelist IP addresses.
Using the CloudFlare API, this feature adds and removes attacking IPs from that
firewall and provides CLI (and via the UI) additional commands.
There are several restrictions to using this feature:
1. All lfd blocks will be temporary blocks so that csf/lfd can keep blocks in
sync with CloudFlare
2. Automatic blocks via lfd are limited to LF_MODSEC and LF_CXS triggers as
only through these can the domain name be determined. Any users that own
domains that are involved in the trigger will get a block in their
CloudFlare Firewall. Additionally, any users with the special case "any"
will also get blocks
3. The temporary/permanent config of the lfd settings are ignored and CF_TEMP
is used instead
4. LF_TRIGGER must not be used, the feature will not work with it enabled
5. mod_cloudflare or similar must be used to report real IP in the Apache logs
6. URLGET must be set to 2 (i.e. LWP) must be used
7. If PERMBLOCK is used, the last tempblock will remain and never be cleared.
So any CloudFlare Firewall entries must be manually cleared in CloudFlare
or via CLI
8. There are restrictions imposed by CloudFlare to the number of rules that
can be created depending on the type of account used. See
https://goo.gl/ssGu7v for more information
9. When restarting csf, any old temporary blocks will still be created for lfd
to clear when it restarts
10. All interaction with CloudFlare is at User-level, not Zone-level
11. If using the CloudFlare cPanel user plugin, it must be v7+
CF_TEMP should be configured taking into account the maximum number of rules
that the CloudFlare account allows:
https://goo.gl/ssGu7v
All CloudFlare users for the domains that are involved in LF_MODSEC and
LF_CXS triggers will have a CloudFlare rule added. Any CloudFlare account
configured to use the special case "any" field value in csf.cloudflare will
have a CloudFlare rule added regardless of domain.
NOTE: You should always list the CloudFlare IP addresses in /etc/csf/csf.ignore
to prevent them from being blocked by lfd from
https://www.cloudflare.com/ips/