Visitor Filters

CAPTCHA & Challenges

VisitorFilters ships a first-party CAPTCHA built on proof of work: suspicious visitors solve a small computational puzzle before they get through. There are no image grids, no third-party requests, and no tracking.

How the Built-in CAPTCHA Works

  1. A visitor who matches a challenge rule is sent to the challenge page instead of being blocked outright.
  2. Their browser solves a small hashcash-style puzzle automatically — there is nothing to read or click.
  3. The difficulty adapts to the visitor's risk score: low-risk visitors clear it in well under a second, high-risk automation pays a real computational cost.
  4. On success the browser receives an encrypted, replay-protected token bound to the visitor, and the request continues normally.

Using CAPTCHA in Rules

Choose Challenge as the action of any rule to present the CAPTCHA instead of a hard block. Two common setups:

  • Custom rules — challenge specific countries, ASNs, paths, or rate offenders while keeping them out of your logs as hard blocks.
  • Managed threat-feed rule — one toggle challenges every visitor whose IP appears on the managed threat intelligence feed.

Embedding on Your Own Forms

The same widget can protect your own forms — logins, signups, comments — independently of rules. The flow:

  1. Copy the embed snippet for your site from the dashboard's CAPTCHA settings; the widget script is served from our CDN.
  2. The widget renders inside your form and produces a response token when the visitor passes.
  3. Your backend verifies the token server-side against the site-verify endpoint before accepting the submission.

Tokens are single-use and expire quickly, so a captured token cannot be replayed.

External Providers

Prefer a third party? Cloudflare Turnstile and hCaptcha can be configured per site and used as the challenge instead of the built-in CAPTCHA.

Privacy

  • No third-party requests are made during a challenge.
  • No behavioral tracking or advertising identifiers — the puzzle is pure computation.
  • Fits the same GDPR posture as the rest of the platform.