Help center
Open dashboard

How to Whitelist Atarim When Your Site Uses Firewalls, WAF Rules, or IP Restrictions

Ensure Atarim loads and works correctly—even on websites protected by firewalls or maintenance mode.

Atarim team Updated 3 Aug 2026 · 4 min read
FAQs and Troubleshooting
An Atarim project failing to load behind a firewall, with the error state shown
Before you start

Relevant for

  • Web Developers and IT Admins
  • Project Managers troubleshooting website access issues
  • QA Engineers performing browser-based feedback
  • Agencies managing client websites with advanced security
  • Anyone seeing "site cannot load" or "screenshot error" in Atarim

Required knowledge

  • A basic understanding of website firewalls such as Cloudflare or Sucuri.
  • Familiarity with WordPress plugins or server-level configurations.
  • Some knowledge of HTTP headers and User-Agent strings is helpful, but not required.

Tools & resources needed

  • Access to firewall or WAF settings (e.g., Cloudflare dashboard, Sucuri panel)
  • Admin login to hosting control panel or plugin settings
  • Atarim Browser Extension (for local override)
  • Optional: DNS or server config access (if required for allowlisting)

If your website uses security measures such as Cloudflare, Wordfence, Sucuri, IP whitelists, or maintenance mode, you may notice that Atarim cannot load the page or generate screenshots for collaboration. This is because these tools often block automated or external access — including Atarim’s remote workers and screenshot engine.

This guide walks you through the officially supported methods to ensure Atarim can connect to your website: domain-level whitelisting, header-based exceptions, and the Atarim browser extension.

Atarim has no fixed IPs — whitelist by domain, not by address.

Why Your Site May Block Atarim

Common causes include:

  • Maintenance mode plugins blocking all external visitors
  • Cloudflare WAF rules (especially “Block non-US traffic”)
  • Wordfence, Sucuri, or server-level firewalls
  • Login walls or staging-site restrictions
  • Internal networks with IP-based access
  • Malwarebytes/Threatdown false positives
  • Cloudflare challenge pages replacing screenshots

How Atarim Connects to Your Site

There are three routes, in the order worth trying them.

RouteWhen to use it
Whitelist by domainThe recommended first step. Solves most issues.
Whitelist by request headersWhen domain whitelisting is not enough and your firewall supports header rules.
Atarim Browser ExtensionLogin walls, internal IP restrictions, maintenance mode — the universal fallback.

Option 1 — Whitelist Atarim by Domain (Recommended)

To load your website and generate screenshots, Atarim uses the domains below. Add each of them to your firewall or WAF allowlist:

DomainWhat it is for
atarim.ioThe Atarim platform itself.
atarimworker.ioWorker requests that load your site.
atarimworker.devWorker requests that load your site.
urlbox.comThe screenshot tool.
Note
Atarim does not have fixed IPs. IP-based whitelisting will fail.
Tip
If your tool supports wildcards (Cloudflare, Sucuri, and similar), also add *.atarimworker.io and *.atarimworker.dev.

This solves most issues, including:

  • Cloudflare blocking the collaboration link
  • Screenshot failures
  • Security plugins blocking worker requests
  • Country-based blocking (e.g., “Allow US only”)

Option 2 — Whitelist Atarim by Request Headers

If domain whitelisting doesn’t work and your firewall supports header rules, Atarim includes two permanent identifiers:

IdentifierValue
User-Agent containsatarim-worker
Custom headerProxied-For: Atarim

Create rules that:

  • Allow requests where User-Agent contains atarim-worker
  • Allow requests where header Proxied-For = Atarim
Recommendation
Use header rules if Cloudflare continues to trigger challenges even after domain whitelisting.

Supported by:

  • Cloudflare (WAF Custom Rules / Transform Rules)
  • Sucuri
  • Some hosting-level firewalls
  • Enterprise security appliances

Cloudflare Configuration

Cloudflare is the most common source of blocking. Typical issues include:

  • JS Challenge page instead of the site
  • WAF blocking worker requests
  • Non-US IP blocking rules
  • Screenshot shows Cloudflare test instead of the website

Step 1: Create Bypass Rules

Go to Security → WAF → Custom Rules → Create Rule, and allow:

  • atarimworker.io
  • atarimworker.dev
  • atarim.io
  • urlbox.com
The conditions set on a Cloudflare WAF custom rule allowing the Atarim domains
Conditions for the rule

Step 2: Add Header-Based Exceptions

If domain exceptions alone don’t work:

IF: Proxied-For = Atarim
THEN: Skip WAF / skip challenge

OR

IF: User-Agent contains atarim-worker
THEN: Allow request

A Cloudflare rule configured to skip the WAF when the Atarim header is present
The header-based exception in Cloudflare
The list of Cloudflare components that can be skipped under More Components to Skip
List of rules that can be skipped, via “More Components to Skip”
Tip
Header-based exceptions are the most reliable when Cloudflare strict mode is enabled.

Step 3: Fix Screenshot Issues

If screenshots show a Cloudflare JS challenge, whitelist urlbox.com.

Tip
Always whitelist urlbox.com. It solves most screenshot-related errors immediately.

Option 3 — Use the Atarim Browser Extension

Use the extension when:

  • The site is behind a login wall
  • Internal IP restrictions are active
  • Maintenance mode blocks all external visitors
  • Cloudflare continues to challenge requests
  • Screenshot engine (URLBox) is blocked

The extension loads the website directly from your browser and bypasses all external restrictions safely. Learn More About Installing The Atarim Chrome Extension

Note
If your team uses Safari, they’ll need to switch to Chrome temporarily to use the extension.

Malwarebytes / ThreatDown False Positives

Some users reported Malwarebytes/ThreatDown flagging ancillary-proxy.atarimworker.dev — detected as Phishing.Web.

What You Should Do

  • Add the domain to your allowlist
  • This is safe and expected
  • Atarim can submit a false positive report
  • Only the customer can submit an official correction to Threatdown
  • Threatdown may take weeks to update their blocklist
Note
This is a false positive. The block does not indicate any real security issue.

What Atarim Cannot Support

Atarim cannot:

  • Provide static IP addresses
  • Guarantee bypassing login walls without the extension
  • Debug or replicate complex Cloudflare or WAF setups internally
  • Guarantee timeline-based fixes for external security configurations
  • Override maintenance mode plugins that only allow IP-based access
Warning
IP whitelisting is not supported and will not work. Our IPs are dynamic and rotate automatically.
Recommendation
If all whitelisting fails, the Atarim Browser Extension is the universal fallback.

Common issues

1. Site loads maintenance or login page

✔ Use the Browser Extension
✔ Or disable maintenance mode temporarily

2. Cloudflare test page in screenshots

✔ Whitelist urlbox.com
✔ Add header bypass rules

3. Cloudflare blocking non-US IP traffic

✔ Add domain exceptions for Atarim domains
✔ Add header exceptions if needed

4. Wordfence/Sucuri blocking Atarim

✔ Whitelist all Atarim domains
✔ Allow the user-agent atarim-worker

5. Threatdown blocks Atarim

✔ Safe to whitelist
✔ Customer must file a false-positive report

Conclusion

To ensure Atarim can access and collaborate on protected websites:

  • Start with domain whitelisting
  • Add header-based firewall exceptions
  • Use the Atarim Browser Extension if all else fails

With one of these three supported options, your team can reliably collaborate on any website — even behind enterprise-grade security.

Related articles