How to Edit the Blacklist

How to Add/Remove IP Addresses from the Blacklist

Add IP addresses to the blacklist to block known-bad IPs from accessing the backend of your application. It’s also possible to add User-Agents to the blacklist by defining a pattern to match. You should add known-good IP addresses to the whitelist to allow them to access your application. Find those instructions on How to Edit the Whitelist.

Add an Address Set

Click Blacklist on the menu.

Webscale blacklist page in the control panel

Under the Blacklist Address Set section click the dropdown menu and select an address set. Note: the IP addresses in the address set will not be reflected on this page.

Create or edit Address Sets

To add/remove IP addresses from an address set, click the hamburger icon on the upper left of the screen and select Address Sets from the menu. To create a new set, click the Create set button. To edit an existing set, click the pencil icon to the right.

  1. Choose the Type of set from the dropdown. Choices are combined, domains, dynamic, json-file, manual, or text-file.
  2. Give the set a name and description.
  3. Add the appropriate IP address or domains, or upload a JSON or text file. Note: a dynamic address set relies on Web Controls to work. See How to Configure Rate Limiting for more information.
  4. Click the Save button.

Add an IP Address

Click Blacklist on the menu.

Under Blacklist by IP address click the Comma/space-separated IP addresses/CIDRS text area and enter the IP addresses or ranges separated by commas or spaces. In the Description text area, enter a description so you can remember why you created this entry. Next to this field is a slider to select the duration of the blacklist. To create a blacklist entry that never expires, leave it as-is. When finished, click the Done button to add the entry.

After the Blacklist by IP address area is the Entries area. This shows a list of currently Blacklisted addresses, containing the following information:

  • IP address
  • Label
  • Expiration date
  • Created date
  • Creator

There are also two buttons: an edit button, and an X button that removes the IP address.

Add an IP address from the Traffic Viewer

You can add IP addresses to the blacklist from the Traffic Viewer. While in the Traffic Viewer, hover over the Request Address, Peer Address, Server Address or Proxy Address column, then click the small arrow that appears to display the popup menu. You can also right-click on any of the columns to bring up the popup menu. Once the menu is displayed, you can select Add to blacklist.

Add an IP address from the CSP Logs Viewer

You can add IP addresses to the blacklist from the CSP Logs Viewer. While in the CSP Logs Viewer, hover over the Request Address or Peer Address column, then click the small arrow that appears to display the popup menu. You can also right-click on any of the columns to bring up the popup menu. Once the menu is displayed, you can select Add to blacklist.

Add an IP address from the Pageviews Logs Viewer

You can add IP addresses to the blacklist from the Pageviews Logs Viewer. While in the Pageviews Logs Viewer, hover over the Request Address or Peer Address column, then click the small arrow that appears to display the popup menu. You can also right-click on any of the columns to bring up the popup menu. Once the menu is displayed, you can select Add to blacklist.

When you add an entry to the blacklist from either the Traffic Viewer, the CSP Logs Viewer or the Pageviews Logs Viewer, the entry will never expire. Note that the Add to blacklist item will only appear if the blacklist is using either a Manual address set or a Combined address set that includes a manual set. If the option does not appear and you believe it should, you may have to reload the page.

Edit an IP Address

To edit an IP address, click the edit button. Make any changes as explained above, and click the Update button. To cancel without making changes, click the Cancel button.

Remove an IP Address

To remove the IP address, click the X button.

Blacklist by User-Agent

To blacklist by User-Agent, click the “Edit Pattern” button. Type the pattern you want to match, then click “Save Pattern” to save the changes.

Further reading

Have questions not answered here? Please Contact Support to get more help.


Last modified February 25, 2021