Title: WebDecoy Bot Detection
Author: Web Decoy
Published: <strong>22 Temmuz 2026</strong>
Last modified: 30 Temmuz 2026

---

Eklentilerde ara

![](https://ps.w.org/webdecoy/assets/banner-772x250.png?rev=3618969)

![](https://ps.w.org/webdecoy/assets/icon-256x256.png?rev=3618969)

# WebDecoy Bot Detection

 [Web Decoy](https://profiles.wordpress.org/webdecoy1/) tarafından

[İndir](https://downloads.wordpress.org/plugin/webdecoy.2.4.0.zip)

 * [Detaylar](https://tr.wordpress.org/plugins/webdecoy/#description)
 * [Değerlendirmeler](https://tr.wordpress.org/plugins/webdecoy/#reviews)
 *  [Kurulum](https://tr.wordpress.org/plugins/webdecoy/#installation)
 * [Geliştirme](https://tr.wordpress.org/plugins/webdecoy/#developers)

 [Destek](https://wordpress.org/support/plugin/webdecoy/)

## Açıklama

WebDecoy is a **free, fully-functional** bot detection and protection plugin that
works 100% locally. Unlike CAPTCHA solutions that frustrate visitors, WebDecoy uses
invisible multi-layer detection — legitimate users never see challenges or interruptions.

**Works immediately on activation.** No account needed. No API key required. No 
external connections at all until you optionally connect a WebDecoy Cloud account.

#### Why WebDecoy?

 * **Zero friction** — Humans never see CAPTCHAs or challenges
 * **Zero configuration** — Install, activate, done
 * **Zero dependencies** — Everything runs locally on your server
 * **Multi-layer detection** — Server-side + client-side + proof-of-work challenges
 * **Free forever** — Full protection at no cost. Premium cloud features are optional.

#### Free Features (No API Key Needed)

**Server-Side Detection**
 * User-Agent analysis and HTTP header inspection * Good
bot verification (reverse DNS for Googlebot, Bingbot, etc.) * MITRE ATT&CK path 
analysis (admin probing, config file access) * Rate limiting with automatic blocking*
IP blocking (individual + CIDR, IPv4/IPv6, expiration)

**Client-Side Detection**
 * WebDriver detection (Selenium, Puppeteer, Playwright)*
Headless browser detection (Chrome headless, PhantomJS) * Automation framework detection*
Behavioral analysis (mouse movement, click patterns, scroll behavior) * Canvas/WebGL
fingerprinting * AI crawler detection (GPTBot, ClaudeBot, PerplexityBot)

**Invisible Proof-of-Work Challenges**
 * SHA-256 challenges solved in background(
no user interaction) * Challenge mode for suspicious requests (checkbox widget, 
auto-solves) * Difficulty scales based on threat signals * No external CAPTCHA service
needed

**Form Protection**
 * Comment spam protection * Login brute force protection * 
Registration spam prevention * Invisible honeypot fields on comment, login, and 
registration forms

**WooCommerce Protection**
 * Checkout carding attack prevention * Velocity limiting(
configurable attempts per time window) * Card testing pattern detection * WooCommerce
Blocks compatible

**Local Dashboard & Analytics**
 * Detection log with threat scores and MITRE tactic
mapping * Statistics page with 30-day trend charts * Blocked IPs management * Dashboard
widget with threat overview * CSV export * Automatic data cleanup (30 days)

**Smart Bot Recognition**
 * 60+ known good bots automatically allowed * Search 
engines, social media, monitoring services, SEO tools * Optional AI crawler blocking*
Custom allowlist support

#### Premium Features (Optional WebDecoy Cloud)

Connect an API key to unlock cloud-powered intelligence:

 * **WAF Integrations** — Arm your existing edge: push confirmed attackers to Cloudflare
   or AWS WAF so they’re blocked before a request ever reaches WordPress, plus webhooks
   for any other firewall
 * **IP Reputation** — AbuseIPDB integration, threat scoring
 * **VPN/Proxy Detection** — Identify visitors hiding behind VPNs, proxies, and 
   Tor
 * **GeoIP Enrichment** — Geographic data from MaxMind
 * **Cloud Sync** — Forward detections to centralized dashboard
 * **Cross-Site Intelligence** — Aggregate threat data from all WebDecoy customers
 * **Advanced Analytics** — Cloud dashboard at app.webdecoy.com with indefinite 
   history
 * **Webhooks & Alerts** — Automated response chains, email notifications

[Explore Plans](https://webdecoy.com/pricing) | [Start Free Trial](https://app.webdecoy.com/register)

#### Threat Scoring

WebDecoy uses an intelligent scoring system (0-100):

 * 0-19: MINIMAL — Allow (likely human)
 * 20-39: LOW — Log only
 * 40-59: MEDIUM — Optional challenge
 * 60-74: HIGH — Challenge or block
 * 75-100: CRITICAL — Automatic block

The threshold is fully configurable to match your site’s needs.

### External Services

This plugin can optionally connect to the following external services when you connect
a WebDecoy Cloud account — either with the one-click Connect button or by entering
an API key manually:

#### WebDecoy Cloud — app.webdecoy.com, api.webdecoy.com and ingest.webdecoy.com

This plugin only contacts WebDecoy Cloud after you explicitly start a connection
on the WebDecoy Cloud settings tab. With no connection made and no API key configured,
no data is ever sent to these services.

What is sent, and when:
 * When you click “Connect to WebDecoy Cloud”: your browser
is redirected to app.webdecoy.com to approve the connection (carrying your site 
URL, site name, a one-time nonce, and your monthly-report preference). After you
approve, the plugin exchanges a one-time token with api.webdecoy.com (sending the
token, your site URL and the nonce) to receive the site’s API keys. Cancelling sends
nothing further. * After connecting: the plugin fetches your plan entitlements from
ingest.webdecoy.com (authenticated with your API key) twice daily. * When a detection
or rule violation occurs: the visitor’s IP address, user agent, request path, threat
score and detection flags are sent to ingest.webdecoy.com so the event appears in
your cloud dashboard. * When you use an IP-reputation filter rule (e.g. ip.abuse_score,
ip.tor): the visitor’s IP address is sent to ingest.webdecoy.com to look up reputation/
geo data. * When validating your key or forwarding a WooCommerce checkout detection:
your API key, organization ID and the detection data above are sent to api.webdecoy.
com / ingest.webdecoy.com.

All requests are made server-side over HTTPS. This is an optional cloud service 
provided by WebDecoy.
 Terms of Service: https://webdecoy.com/terms Privacy Policy:
https://webdecoy.com/privacy

**Without an API key, the plugin operates 100% locally — no external connections
on the front end or back end.** Chart.js (used for the admin Statistics charts) 
is bundled with the plugin, not loaded from a CDN.

#### Bundled third-party libraries

Chart.js v4.5.1 (MIT license) is included at admin/js/vendor/chart.umd.min.js for
the admin Statistics charts. It is the official distribution build; the human-readable
source is available at https://github.com/chartjs/Chart.js/releases/tag/v4.5.1 .
No other third-party libraries are bundled.

#### Reference URLs in the good-bot database

The bundled good-bot list (sdk/src/GoodBotList.php) stores a documentation URL for
each known bot (e.g. developer.amazon.com/amazonbot, api.slack.com/robots) purely
as reference metadata shown alongside detections. These URLs are never requested
by the plugin — no connection of any kind is made to them.

### Privacy Policy

WebDecoy collects the following data locally for bot detection purposes:

 * IP addresses
 * User agent strings
 * HTTP headers
 * Browser fingerprint signals
 * Request patterns

This data is stored in your WordPress database and automatically cleaned up after
30 days. No data is sent externally unless you configure a WebDecoy Cloud API key.

For more information, see our [Privacy Policy](https://webdecoy.com/privacy).

## Ekran Görüntüleri

[⌊Protection settings — configure detection and blocking⌉⌊Protection settings — 
configure detection and blocking⌉[

Protection settings — configure detection and blocking

[⌊Statistics page — 30-day detection trends and threat distribution⌉⌊Statistics 
page — 30-day detection trends and threat distribution⌉[

Statistics page — 30-day detection trends and threat distribution

[⌊Detections log — view threats with scores and MITRE tactics⌉⌊Detections log — 
view threats with scores and MITRE tactics⌉[

Detections log — view threats with scores and MITRE tactics

[⌊Blocked IPs — manage blocked addresses with expiration⌉⌊Blocked IPs — manage blocked
addresses with expiration⌉[

Blocked IPs — manage blocked addresses with expiration

[⌊Dashboard widget — threat overview at a glance⌉⌊Dashboard widget — threat overview
at a glance⌉[

Dashboard widget — threat overview at a glance

[⌊WebDecoy Cloud — optional premium features⌉⌊WebDecoy Cloud — optional premium 
features⌉[

WebDecoy Cloud — optional premium features

[⌊WooCommerce checkout protection settings⌉⌊WooCommerce checkout protection settings⌉[

WooCommerce checkout protection settings

## Yükleme

 1. Upload the `webdecoy` folder to the `/wp-content/plugins/` directory, or install
    directly from the WordPress plugin repository
 2. Activate the plugin through the ‘Plugins’ menu in WordPress
 3. **That’s it!** Protection is active immediately with sensible defaults

#### Optional: Connect to WebDecoy Cloud

 1. Go to **WebDecoy > Settings > WebDecoy Cloud** tab
 2. Click **Connect to WebDecoy Cloud** — you approve the connection on app.webdecoy.
    com and are returned automatically; your API keys are provisioned for you
 3. Prefer manual setup? Expand **Advanced: manual configuration** and enter an API
    key from your [WebDecoy dashboard](https://app.webdecoy.com)
 4. Cloud features (threat intel, VPN detection, etc.) activate automatically

## SSS

### Do I need an API key?

**No.** WebDecoy works 100% locally without any API key or account. All detection,
blocking, rate limiting, form protection, and WooCommerce protection works out of
the box. The API key is only needed for optional cloud features like IP reputation
and VPN detection.

### What does WebDecoy Cloud add?

WebDecoy Cloud adds threat intelligence feeds (AbuseIPDB, VPNAPI, MaxMind), centralized
monitoring across multiple sites, indefinite detection history, automated response
features like webhooks and email alerts, and WAF integrations — confirmed attackers
can be pushed to Cloudflare or AWS WAF so they’re blocked at the edge, before ever
reaching your server. [Compare plans](https://webdecoy.com/pricing).

### Does WebDecoy slow down my site?

No. WebDecoy adds less than 5ms of latency to requests. Server-side detection runs
in milliseconds. The client-side scanner loads asynchronously with the `defer` attribute
and doesn’t block page rendering.

### Will it block legitimate visitors?

WebDecoy is designed to minimize false positives. You can adjust the sensitivity
and blocking threshold. Start with “Log only” mode to monitor before enabling blocking.
Good bots (Googlebot, Bingbot, etc.) are automatically recognized.

### Does it work with caching plugins?

Yes. WebDecoy works alongside popular caching plugins. The client-side scanner runs
after page load, and server-side checks happen before caching.

### What about search engine bots?

WebDecoy automatically recognizes and allows 60+ legitimate bots including Googlebot,
Bingbot, and other search engine crawlers. Good bot verification uses reverse DNS
lookup. Your SEO won’t be affected.

### Can I block AI training crawlers?

Yes. WebDecoy can identify and optionally block AI crawlers like GPTBot, ClaudeBot,
PerplexityBot, and others. Enable this in Settings > Good Bots.

### Does it work with WooCommerce?

Yes. WebDecoy includes specialized carding protection for WooCommerce including 
checkout velocity limiting, card testing detection, and automatic fraud blocking.
Compatible with both classic checkout and WooCommerce Blocks.

### Is my data secure?

Without an API key, the plugin makes **zero external connections** — visitors’ browsers
never contact third-party servers, and neither does your server. Chart.js (admin
charts) is bundled with the plugin. All detection data stays on your server, and
detection logs are automatically cleaned up after 30 days. When you optionally connect
WebDecoy Cloud, all communication is encrypted over HTTPS (see External Services
below).

### How does the proof-of-work challenge work?

When a suspicious visitor is detected and your block action is set to “Challenge”,
they see a checkbox widget. Clicking it starts a SHA-256 puzzle that solves in the
background (typically under 1 second for humans). Bots and automation tools take
much longer or fail entirely. No external CAPTCHA service is involved.

## İncelemeler

Bu eklenti için herhangi bir değerlendirme bulunmuyor.

## Katkıda Bulunanlar ve Geliştiriciler

“WebDecoy Bot Detection” açık kaynaklı yazılımdır. Aşağıdaki kişiler bu eklentiye
katkıda bulunmuşlardır.

Katkıda bulunanlar

 *   [ Web Decoy ](https://profiles.wordpress.org/webdecoy1/)

[“WebDecoy Bot Detection” eklentisini dilinize çevirin.](https://translate.wordpress.org/projects/wp-plugins/webdecoy)

### Geliştirmeyle ilgilenir misiniz?

[Kodu görüntüleyin](https://plugins.trac.wordpress.org/browser/webdecoy/), [SVN deposuna](https://plugins.svn.wordpress.org/webdecoy/)
göz atın ya da [RSS](https://plugins.trac.wordpress.org/log/webdecoy/?limit=100&mode=stop_on_copy&format=rss)
ile [geliştirme günlüğüne](https://plugins.trac.wordpress.org/log/webdecoy/) abone
olun.

## Değişiklik Kaydı

#### 2.4.0

 * Added: filter rules can read what the WebDecoy edge validator concluded about
   a request, using new edge.* fields — edge.class, edge.clearance, edge.present,
   and the shorthands edge.verified / edge.crawler / edge.script / edge.browser.
   edge.class is one of: verified (an identity Cloudflare attested, such as Googlebot—
   never degrade these), crawler (says it is a crawler, unproven), script (an HTTP
   client library, not a browser), or browser (nothing non-human fired). This was
   always matchable as req.header(“x-wd-class”), but nothing said so; the Rules 
   screen now documents the fields and what each value means. If the validator is
   not in front of a request, edge.present is false and every edge.* condition is
   false — that means “no information”, not “human”. Safe for blocking, throttling,
   logging and metering; the Rules screen also explains why you should not use it
   to serve different page content on a cacheable URL.

#### 2.3.4

 * Added: tripwires can Challenge (browser proof-of-work) or Log only, not just 
   block or serve deception. Log is the safest way to watch a tripwire you have 
   just armed. Challenge needs JavaScript and a click, so nothing automated completes
   it — on a tripwire that is the point.
 * Fixed: timestamps are stored in UTC and converted for display. They were written
   in site-local time and compared against UTC, so on any non-UTC site the Today/
   7d / 30d filters covered the wrong span and the WooCommerce checkout window was
   the wrong width. Older rows are left alone rather than shifted, since shifting
   is wrong for any site that has changed timezone; the discrepancy ages out.

#### 2.3.3

Follow-up to the 2.3.2 safety release. WooCommerce and reporting fixes.

 * Fixed (WooCommerce): the 2.3.2 card-testing fix did not reach stores using Cash
   on Delivery, Bank Transfer or Cheque — those gateways never mark an order paid,
   so every genuine order kept counting as a card-testing attempt. Now decided from
   the order’s status, which every gateway reaches.
 * Fixed (WooCommerce): a customer retrying a declined card could look like card
   testing on their own. The small-amount, decline-count and rapid-succession patterns
   now require more than one order or more than one card.
 * Fixed (WooCommerce): payment results arriving from a gateway callback did not
   close the checkout attempt they belonged to, so attempts stayed open and kept
   counting.
 * Fixed: the cross-site attacker list is actually read again — in 2.3.2 it was 
   synced hourly and consulted by nothing.
 * Fixed: two notices claimed an attacker was blocked network-wide, or would be 
   on Pro. Neither has been true since 2.3.2 stopped that list from blocking. They
   now say the actor is recognised.
 * Fixed: the monitor-mode summary no longer reports that nothing met the bar for
   enforcement while rate limiting is being withheld.

#### 2.3.2

Safety release — please update. This version deliberately makes the plugin do less
by default.

 * **Monitor mode is now the default.** WebDecoy detects, logs and reports everything
   and blocks nothing until you switch blocking on under Blocking  Monitor mode.
   Existing sites are moved to monitor mode by this update.
 * Fixed: behind Cloudflare, a load balancer or most managed hosts, every visitor
   resolved to the proxy’s address, so one hostile request could block real visitors
   for 24 hours. The plugin now detects that condition, refuses to block while it
   holds, and tells you in the admin.
 * Fixed: automatic blocks can no longer target loopback, private ranges, a trusted
   proxy, or your own CDN front door, and can no longer write a range wider than/
   24 (IPv4) or /48 (IPv6).
 * Fixed: block expiry was stored in UTC and compared against site-local time, so
   on sites at UTC+1 or further east a short block expired the instant it was written.
 * Fixed: a honeypot hit blocked the address permanently instead of for the configured
   duration.
 * Fixed (WooCommerce): three successful sub-$5 orders in an hour were classified
   as card testing. Completed orders no longer count toward card-testing patterns
   or the checkout velocity limit. Note: stores using only Cash on Delivery, Bank
   Transfer or Cheque are not covered by this fix yet, because those gateways never
   mark an order paid — monitor mode means it cannot cost you an order in this version.
 * Changed (WooCommerce): a suspicious checkout is refused and recorded; it no longer
   blocks the address across your whole site. Covers both the classic and the Blocks
   checkout.
 * Fixed: monitor mode and the kill switch now apply everywhere the plugin can act—
   the checkout, the honeytoken coupon, the challenge page, login, comments and 
   registration all previously kept refusing traffic while the admin said nothing
   was blocked.
 * Fixed: the monitor-mode setting is stored rather than only defaulted, so the 
   checkbox shows the real state and saving another setting no longer switches enforcement
   on by accident.
 * Changed: default block duration is 1 hour, was 24.
 * Changed: the cross-site actor feed is now advisory intelligence and no longer
   writes to your block list. Rows it previously wrote are removed on upgrade.
 * Added: `define('WEBDECOY_DISABLE', true);` in wp-config.php as an emergency off
   switch.

#### 2.3.1

 * Fixed: Detections forwarded from your site are now identified by the visitor’s
   own request signature. Previously they were identified by your server’s outgoing
   connection, which is the same for every visitor — so every visitor a site reported
   was grouped into a single “actor” in the dashboard. Only request header NAMES
   plus Accept-Language and Accept-Encoding are sent; no header values leave your
   site.

#### 2.3.0

 * Added: One-click WebDecoy Cloud connect — approve on app.webdecoy.com and your
   API keys are provisioned automatically; manual key entry moved under “Advanced:
   manual configuration”
 * Added: Optional monthly security report opt-in when connecting
 * Added: Plan entitlements sync after connecting (twice daily, fails open to the
   free tier)
 * Fixed: Statistics page charts could grow endlessly tall once detection data existed(
   Chart.js containers now have a fixed height)

#### 2.2.3

 * Changed: All CSS and JavaScript is now loaded via the WordPress dependency APIs(
   wp_register_style/script, wp_add_inline_script, wp_print_styles/scripts) — no
   more raw style/script tags
 * Changed: The “Protected by WebDecoy” credit on the challenge page is now opt-
   in (Settings > Blocking) and off by default
 * Changed: Updated bundled Chart.js to v4.5.1 (latest stable)
 * Changed: Removed the load_plugin_textdomain() call (unneeded since WordPress 
   4.6 for directory-hosted plugins)

#### 2.2.2

 * Fixed: A PHP 7.4 fatal error in good-bot verification (use of a PHP 8 function)
 * Fixed: Timezone-safe date handling throughout
 * Changed: The bundled SDK now uses the WordPress HTTP API exclusively (removed
   the raw cURL fallback)
 * Changed: Requires WordPress 6.1+; tested up to WordPress 7.0
 * Internal: Full WordPress Plugin Check compliance (resolved 69 flagged items)

#### 2.2.1

 * Changed: Chart.js (admin Statistics charts) is now bundled with the plugin instead
   of loaded from a CDN — the plugin makes no external requests until you connect
   a WebDecoy Cloud account
 * Changed: Clarified the External Services disclosure
 * Internal: Refactored the self-hosted updater into its own module

#### 2.2.0

 * Added: Tripwires — deterministic, zero-false-positive blocking of hidden honeypot
   paths (on by default)
 * Added: Honeytoken — auto-injected invisible decoy link armed as a tripwire (on
   by default)
 * Added: Filter rules — expression-based rules with an admin rule builder (ip.*/
   req.* fields)
 * Added: IP enrichment (VPN/proxy/Tor, geo, ASN, abuse score) powering ip.* filter
   fields
 * Added: wd_clearance enforcement loop — silent cookie minting + tripwire forwarding
   for rotation-proof device lockouts
 * Added: Stealth-browser (F1) detection — catches automation that patches native
   browser functions
 * Added: Deceptive tripwire responses — fake .env/wp-config/SQL/phpinfo with per-
   site canary credentials; canary logins flagged as critical
 * Added: WordPress-native traps — fake vulnerable-plugin paths, optional XML-RPC
   trap, author-enumeration canary
 * Added: WooCommerce honeytoken coupons — a hidden decoy coupon; applying it is
   a deterministic bot signal
 * Added: IP allowlist (Settings  Blocking)
 * Improved: Rate limiting runs as a rule — proper 429 + Retry-After + X-RateLimit-*
   headers, sliding-window algorithm, per-IP/route/user keying
 * Improved: Resilient violation reporting (DB spool + cron retry, no page latency)
 * Changed: Consolidated onto a single detector path; removed legacy dead code

#### 2.1.0

 * Added: JS execution verification — detects non-JS HTTP scrapers
 * Added: Challenge token meta tag for premium page serve tracking

#### 2.0.0

 * **Major: All detection and protection now works locally — no API key required**
 * Added: Invisible proof-of-work (PoW) challenge system
 * Added: Behavioral scoring for form submissions
 * Added: Statistics page with Chart.js detection trend charts
 * Added: Enhanced detections page with date filters, CSV export, bulk actions
 * Added: WebDecoy Cloud settings tab (optional premium features)
 * Added: Cloud upsell sections throughout dashboard
 * Improved: Settings page restructured — Protection tab is now default
 * Improved: Dashboard widget with cloud intelligence upsell
 * Changed: CDN update checker gated behind WEBDECOY_SELF_HOSTED constant
 * Changed: Version bump to 2.0.0 signaling architecture change
 * Fixed: PHP 7.4 str_ends_with polyfill (already present)

#### 1.3.8

 * Fixed: Removed no_plugins trigger (deprecated in modern browsers, caused false
   positives)

#### 1.3.7

 * Version bump

#### 1.3.6

 * Protection hooks only activate when API key is validated as active
 * E2E test compatibility

#### 1.3.5

 * Security improvements and code hardening
 * Updated WooCommerce compatibility to 9.4
 * Performance optimizations for detection checks

#### 1.3.0

 * Major performance improvements
 * Added bulk IP blocking/unblocking
 * Enhanced good bot detection (60+ bots)
 * Improved WooCommerce checkout protection

#### 1.0.0

 * Initial release

## Meta

 *  Sürüm **2.4.0**
 *  Son güncelleme **1 hafta önce**
 *  Etkin kurulumlar **10dan fazla**
 *  WordPress sürümü ** 6.1 veya üstü **
 *  Test edilen sürüm **7.0.3**
 *  PHP sürümü ** 7.4 veya üstü **
 *  Dil
 * [English (US)](https://wordpress.org/plugins/webdecoy/)
 * Etiketler
 * [bot detection](https://tr.wordpress.org/plugins/tags/bot-detection/)[firewall](https://tr.wordpress.org/plugins/tags/firewall/)
   [security](https://tr.wordpress.org/plugins/tags/security/)[spam protection](https://tr.wordpress.org/plugins/tags/spam-protection/)
   [woocommerce](https://tr.wordpress.org/plugins/tags/woocommerce/)
 *  [Gelişmiş görünüm](https://tr.wordpress.org/plugins/webdecoy/advanced/)

## Puanlar

Henüz inceleme gönderilmedi.

[Your review](https://wordpress.org/support/plugin/webdecoy/reviews/#new-post)

[Tüm değerlendirmeleri görün](https://wordpress.org/support/plugin/webdecoy/reviews/)

## Katkıda bulunanlar

 *   [ Web Decoy ](https://profiles.wordpress.org/webdecoy1/)

## Destek

Söyleyeceğiniz bir şey mi var? Yardım mı lazım?

 [Destek forumunu görüntüle](https://wordpress.org/support/plugin/webdecoy/)

## Bağış yap

Bu eklentinin geliştirilmesini desteklemek ister misiniz?

 [ Bu eklentiye bağış yap ](https://webdecoy.com)