Whitelisting & Import

Whitelist trusted IP addresses to ensure they are never blocked by your rules. This is useful for office IPs, monitoring services, and known partners.

Adding IPs to the Whitelist

Single IP

1. Navigate to Rules → Whitelist.
2. Enter an IPv4 or IPv6 address.
3. Optionally add a label (e.g., "Office VPN").
4. Click Add to Whitelist.

CIDR Ranges

You can also whitelist entire subnets using CIDR notation:

• 192.168.1.0/24 — All 256 addresses in the subnet.
• 10.0.0.0/8 — Entire private range.

Bulk Import

For large numbers of IPs, use the bulk import feature:

1. Click Bulk Import in the whitelist page.
2. Paste or upload a list of IPs (one per line).
3. Review the preview showing valid entries and any invalid lines.
4. Click Import to add them all.

Import Format

The importer accepts:

• One IP per line
• IPv4 and IPv6 addresses
• CIDR notation
• Lines starting with # are treated as comments and skipped
• Empty lines are ignored

Import Results

After import, you'll see a summary:

• Number of IPs successfully imported
• Number of invalid entries skipped
• Number of duplicates ignored

Managing the Whitelist

The whitelist table shows all entries with:

• IP / Range — The whitelisted address or CIDR.
• Label — Optional description.
• Added — When it was created.
• Added By — Which team member added it.

Click the trash icon to remove an entry. Removal takes effect immediately.

How Whitelisting Works

Whitelisted IPs are evaluated before all other rules. If a visitor's IP matches a whitelist entry, they bypass all block rules, rate limits, and challenges.

This means:

• Whitelisted visitors are never blocked, even by geo rules.
• Events from whitelisted IPs are still recorded in analytics.
• Whitelist entries apply tenant-wide across all sites.

Blacklist (Block List)

The blacklist works the same way but in reverse — matching IPs are always blocked regardless of other rules. Access it from Rules → Blacklist. It supports the same single-add and bulk import workflow.