Browse Source

Update blacklist-user-agents.conf
- Improved Commenting
- Notes about Over-Riding previously whitelisted User-Agents
- Fix some typos
- Spurred on by: #61

Mitchell Krog 7 years ago
parent
commit
4dbeab7d2b
1 changed files with 20 additions and 11 deletions
  1. 20 11
      blacklist-user-agents.conf

+ 20 - 11
blacklist-user-agents.conf

@@ -1,5 +1,6 @@
-# EDIT THIS FILE AS YOU LIKE TO BLACKLIST OR WHITELIST ANY BAD USER-AGENT STRINGS YOU WANT TO SCAN FOR
-# ****************************************************************************************************
+# EDIT THIS FILE AS YOU LIKE TO OVER-RIDE, BLACKLIST OR WHITELIST 
+# ANY BAD USER-AGENT STRINGS YOU WANT TO SCAN FOR
+# ****************************************************************************
 
 ##############################################################################
 #        ___                 __                                              #
@@ -14,8 +15,12 @@
 ##############################################################################
 
 # Add One Entry Per Line - List all the extra bad User-Agents you want to permanently block or whitelist.
+# You can also use this include file to over-ride user-agents like wget or curl which are previously
+# white-listed in the main list. This gives you full control over what you want to allow access.
+
+# This is for additional User-Agents that are not included in the main list of the bot blocker
+# This is also used to over-ride User-Agents in the main list
 
-# This is for User-Agents that are not included in the main list of the bot blocker
 # This file must exist on your system or Apache will fail a reload due to a missing file
 # This allows you finer control of keeping certain bots blocked and automatic updates will
 # Never be able to remove this custom list of yours 
@@ -31,19 +36,23 @@
 
 # Make sure any words that contain special characters are escaped and include word boundaries as per the Regex examples below.
 
-# Example the User-Agent name "someverybaduseragentname1" is entered as "\bsomeverybaduseragentname1\b"
-# Example the User-Agent name "some-very-bad-useragentname2" is entered as "\bsome\-very\-bad\-useragentname1\b" 
+# EXAMPLE 1: the User-Agent name "someverybaduseragentname1" is entered as "\bsomeverybaduseragentname1\b"
+# EXAMPLE 2: the User-Agent name "some-very-bad-useragentname2" is entered as "\bsome\-very\-bad\-useragentname1\b" 
+# EXAMPLE 3: if you want to block something like wget you would add the following "\bwget\b"
+
 # the "\b" are word boundaries which prevents partial matching and false positives.
 # Follow the regex formatting examples below.
 
-# ************************
-# BLACKLIST ADDITONAL BOTS
-# ************************
+# *************************
+# BLACKLIST ADDITIONAL BOTS
+# *************************
+
 BrowserMatchNoCase "^(.*?)(\bMyVeryBadUserAgentName\b)(.*)$" bad_bot
 BrowserMatchNoCase "^(.*?)(\bMy\ Bad\ User\ Agent\b)(.*)$" bad_bot
 
-# ************************
-# WHITELIST ADDITONAL BOTS
-# ************************
+# *************************
+# WHITELIST ADDITIONAL BOTS
+# *************************
+
 BrowserMatchNoCase "^(.*?)(\bMyVeryGoodUserAgentName\b)(.*)$" good_bot
 BrowserMatchNoCase "^(.*?)(\bMy\ Bad\ User\ Agent\b)(.*)$" good_bot