Review and resolve blocked IPs
The Blocked IPs report lists addresses that Clearplane is currently refusing: active automatic and manual bans and addresses matched by an IP filter source in Block mode. Lifted and expired bans are hidden until you turn on Include lifted and expired. Matches of Observe-mode sources are not blocked, so they appear on the IP filters Observed tab instead. The report requires the Bans.Read and IpFilters.Read permissions.
When someone reports that they are blocked, start with Address lookup: it also covers rate limits, access control, challenges and the WAF.
It is also where operators manage bans. New ban adds a manual ban for an address or CIDR range, globally or for one route, with a reason and duration (Bans.Write). Resolve โ Lift ban ends a ban early (Bans.Manage).
Filters and columns
Each row shows the address, its country, the reason, the source or ban origin, the route, first and last seen, expiry and hit count. With Include lifted and expired on, ban rows that were lifted also show when they were lifted; IP filter rows are unaffected. An Allowlisted marker shows that a valid allowlist entry covers the address.
Filter by kind (ban or IP filter), country code, IP filter source and route. Choosing a source hides bans, which have no source. Rows are ordered by last seen.
Resolve
Resolve on a row opens a dialog with guidance and the actions that fit the row.
For a ban:
- Lift the ban. The address can reach the service again; it can be banned again if it repeats the behavior.
- Allowlist the address, globally or for the row's route, with a reason and optional expiry. It is never banned again while the entry is valid.
- A link to the auto-ban policy that created the ban, when there is one.
For an IP filter block:
- Allowlist the address, globally, for the row's route or for this source only.
- Switch the source to Observe, which stops blocking. Its later matches appear on the Observed tab.
- Disable the source.
An allowlist entry is not deleted when you lift a ban; manage entries under the IP filters allowlist.
Country codes
The country is a two-letter ISO code looked up when a ban or block is first recorded. It stays empty when GeoIP is disabled or its data is not loaded yet, and is not filled in later.
The data, its providers, licences and refresh schedule are described in Country geolocation.
Privacy
Clearplane stores the IP addresses of visitors that an IP filter source matched, in Block or Observe mode, so you can review and resolve them:
- Matched visitor addresses are stored in Core's IP-data database for a retention period. The default is 30 days; you can set it from 1 to 365 days with Matched address retention in the IP filter settings. Core removes older records during its IP filter update job.
- You can turn Record matched addresses off in the IP filter settings. Counters and aggregates continue, but no per-address rows are written for either mode.
- Nothing is sent to Clearplane Cloud.
- Bans keep their own lifetime and are not governed by this retention period.
ip-data.db is created automatically and is part of Core's backup scope with the other databases.