Enterprise Integrations

Bot Detection That Powers Your Entire Security Stack

WebDecoy is not just a standalone tool. It is the intelligence layer that connects your CDN, WAF, SIEM, and observability platforms into a unified bot defense system.

Choose your platform

Start with the setup that matches where your site runs. Monitoring, request verification, and provider firewall actions are separate choices.

WebDecoy installation and protection options by platform
Platform and setup guideDetectionProtection
NetlifyExtension injects a crawler sensor at build time.Opt-in clearance checks on protected paths; Monitor first, then Enforce.
CloudflareManaged Worker observes requests before your origin.Worker clearance validation and separately configured WAF response actions.
VercelLog drain on Pro or Enterprise; Next.js SDK alternative.Configure Firewall actions or SDK policy separately from the monitoring install.
AWS CloudFrontBrowser script or SDK for detection.Lambda@Edge clearance validator; optional AWS WAF integration.
WordPressPlugin adds browser detection and decoy surfaces.WordPress rules and form protection; an edge validator extends coverage before PHP.
RailwaySDK middleware for Express, Next.js, Fastify or Hono; one-click starters.SDK policy in your app: Monitor first, then Enforce returns a 403.
RenderSDK middleware for Express, Next.js, Fastify or Hono; one-click starters.SDK policy in your app: Monitor first, then Enforce returns a 403.
ShopifyApp embed and Web Pixel cover storefront and checkout activity.Order tagging and risk assessments support merchant decisions; no edge validator installed by the app.

Netlify: monitor traffic, then protect selected paths

The WebDecoy extension injects an edge sensor during your build. Three environment variables enable monitoring. Add WEBDECOY_ENFORCEMENT=on and redeploy to include clearance validation, then choose protected paths and review Monitor activity before enabling Enforce in WebDecoy.

Next.js middleware runs before the validator. Crawler exceptions depend on DNS verification or signed requests. WebDecoy does not manage Netlify Firewall Traffic Rules.

AI assistants: install and ask through MCP

WebDecoy runs a hosted MCP (Model Context Protocol) server at https://mcp.webdecoy.com/mcp. Connect your AI assistant and ask it to install WebDecoy in your app with the right package and code for your stack, then confirm the install is reporting. After that, ask about your sites: whether protection is actually enforced, which bots were seen (including forged crawlers like a fake Bingbot), what an actor did, and what your policy is configured to do.

  • Works with your assistant

    Claude Code (/plugin marketplace add WebDecoy/claude-plugins, then /plugin install webdecoy@webdecoy), Claude.ai and Claude Desktop (Settings, Connectors, Add custom connector), ChatGPT (developer mode connector), Codex (codex mcp add webdecoy --url https://mcp.webdecoy.com/mcp), and any assistant that runs local MCP servers through the WebDecoy CLI (webdecoy mcp).

  • OAuth sign-in, per-site access

    Sign in with your WebDecoy account; there is no API key to copy. You choose which sites each assistant may see, and you can review or disconnect any assistant in Settings, Connected apps.

  • Read-only by default

    Setup tools (add a site, create decoys with ready-to-paste embed code, create a site’s script tag, check a page serves the tag) work only if you tick “Also allow setup”. The assistant can never change policies, enforcement, settings or billing, and never receives secret keys: install guides name the environment variables, and you set them.

Available on every WebDecoy plan, including Free.

Developer Tools

Bot Scanner SDK & REST API

Embed behavioral analysis directly in your application. Our JavaScript SDK detects headless browsers and automation frameworks, then triggers your response actions automatically.

  • JavaScript SDK

    npm install @webdecoy/node - MIT licensed, no API key required

  • REST API

    Full programmatic control: create decoys, query detections, manage responses

  • Webhooks

    HMAC-signed payloads with retry logic and event filtering

SDK Quick Start
// Install: npm install @webdecoy/node
import { WebDecoy, tripwire, honeytoken } from '@webdecoy/node';

// A hidden decoy link, plus the secret path it points at.
const trap = honeytoken();

const wd = new WebDecoy({
  rules: [
    // Blocks the honeytoken path and the built-in scanner bait
    // (/.env, /.git/config, /wp-config.php, ...).
    // Runs locally, in memory. No account, no API key.
    tripwire({ paths: [trap.path], action: 'DENY' }),
  ],
});

// Inject the invisible, rel=nofollow decoy link into your HTML.
// Real users never see it; a link-following scraper requests it
// and gets a 403.
body = body.replace('</body>', trap.linkHtml + '</body>');

10+

Native Integrations

<5min

Setup Time

<50ms

Detection Latency

<1s

Response Time

Integration Categories

Connect WebDecoy to every layer of your infrastructure. From edge CDNs to observability platforms, our integrations ensure bot intelligence flows exactly where you need it.

CDN & Edge

Cloudflare, Netlify, AWS

Cloud WAF

AWS WAF, Cloudflare WAF

SIEM & SOC

Splunk, Elastic, CrowdStrike

Observability

Datadog, Metrics, Logs

Platforms

Vercel, WordPress, Shopify

Working in an AI assistant? Connect it through MCP to install WebDecoy and ask about your sites.

New · One-Click Install

Cloudflare Edge Sensor

A WebDecoy Worker that runs in front of your origin and does two jobs your page tag cannot do from inside the browser: it detects the clients that never run JavaScript (Googlebot’s crawl pass, GPTBot, ClaudeBot, CCBot, curl), and it enforces, stopping clients you have already denied before they reach your origin. Connect Cloudflare, pick a zone, deploy.

Key Capabilities

  • Deploy and Uninstall in One Click

    A zone picker populated from your account, an editable route pattern, and a live status card with a 24-hour detection count. Uninstall removes every route and the script. We don’t offer an install we can’t reverse.

  • Preflight That Refuses

    A third-party Worker already on your route pattern is a hard refusal, naming the conflict. A DNS-only zone is blocked before anything is written, because Worker routes only fire on proxied records and would silently never run.

  • Invocation Control

    Negating routes for Astro, Next, Nuxt, SvelteKit, Vite, Hugo, and WordPress static prefixes keep the sensor off your assets, so a busy site doesn’t burn the Workers Free plan on .js and .css.

  • Fails Open, Measured

    The origin response returns unconditionally and the beacon is never awaited on the response path. An adversarial test suite proves the response survives ingest failing, timing out, or the filter throwing.

  • Or Deploy It Yourself

    The Worker is public at github.com/WebDecoy/edge with a Deploy to Cloudflare button that clones it into your own account.

Explore the Edge Sensor
Edge Sensor: install
Integrations → Cloudflare → Edge Sensor

  zone      example.com
  route     example.com/*
  excluded  /_astro/*  /_next/*  /assets/*
            /static/*  /wp-content/*  /cdn-cgi/*

✓ preflight: zone proxied, no route conflict
✓ worker deployed
✓ routes bound

detection  → reports, never blocks
enforcement→ stops clients you already denied

// one click to uninstall, removes everything

Runs on the Cloudflare Free plan: negating routes keep the sensor off your static assets

CDN & WAF Integration

Cloudflare WAF Integration

Close the loop from detection to enforcement. WebDecoy pushes a composite actor signature (fingerprint plus network plus path scope, never a bare JA4) into your Cloudflare WAF, and defaults to a Managed Challenge before it ever blocks. Every rule auto-expires, starts in monitor mode, and is reversible in one click. Zero latency. Zero configuration drift. This is the datacenter-bot layer of a two-layer model: browser-grade rotators are handled by session clearance, which a decoy hit revokes on every IP.

Key Capabilities

  • Composite Actor Signatures

    Confirmed datacenter and scripted actors are enforced as composite rules: JA4 combined with network and path scope, never a bare fingerprint that could catch users who share it. Challenge first; block only on honeypot-grade evidence.

  • Monitor Mode & Auto-Expiry

    Every integration starts in dry-run so you preview would-block traffic before enforcing. Rules carry a TTL, self-heal, and are revocable in one click. Verified bots always pass.

  • Custom Firewall Rules

    Create sophisticated rules based on bot scores, user agents, and behavior patterns

  • Real-Time Threat Sync

    Bot scores shared bidirectionally for enhanced threat intelligence

  • Zero-Latency Edge Blocking

    Bots blocked at the nearest edge location, 200+ data centers worldwide

Use case: Detect and respond to price-scraping traffic at the edge before it reaches an e-commerce origin. Start in monitor mode and measure the effect against your own traffic before enforcing.

cloudflare-config.json
{
  "integration": "cloudflare",
  "api_token": "cf_xxx_your_token",
  "zone_id": "your_zone_id",
  "actions": {
    "on_bot_detected": "block",
    "on_suspicious": "challenge",
    "on_ai_scraper": "managed_challenge"
  },
  "rules": {
    "auto_create_firewall_rules": true,
    "sync_bot_scores": true,
    "block_duration": "24h"
  }
}

Configuration takes less than 2 minutes with our setup wizard

Vercel monitoring and Firewall actions

The marketplace integration provisions a log drain for connected projects on Vercel Pro or Enterprise. See crawler requests, including cache hits, without adding middleware or redeploying. On Hobby, use the Next.js SDK.

The drain reports requests after Vercel answers them. To block or challenge traffic, configure the separate Vercel Firewall integration or an application policy. IP visibility and drain sampling affect monitoring coverage.

Ready to Unify Your Bot Defense?

Connect WebDecoy to your existing infrastructure in minutes. No code changes required for most integrations.

Start Free Integration Opens in a new tab
Observability Integration

Datadog Integration

Stream bot detection metrics directly to Datadog. Correlate bot activity with application performance, create custom dashboards, and trigger alerts when attack patterns emerge.

Key Capabilities

  • Real-Time Metrics Streaming

    Bot counts, threat levels, and detection events pushed via Datadog API

  • Pre-Built Dashboards

    Import our dashboard templates for instant bot activity visibility

  • Alert Integration

    PagerDuty, Slack, and email alerts based on bot activity thresholds

  • APM Correlation

    Link bot traffic to performance degradation in your application traces

Use Case: A fintech platform used WebDecoy + Datadog to identify a correlation between bot traffic spikes and database latency, leading to a 60% improvement in API response times.

Metrics & Dashboard
// Available Datadog Metrics
webdecoy.bot.detected.count
webdecoy.bot.blocked.count
webdecoy.threat.score.avg
webdecoy.ai_scraper.detected.count
webdecoy.honeypot.triggered.count
webdecoy.attack.sqli.count
webdecoy.attack.xss.count
webdecoy.response_time.p99

// Custom Dashboard Query
{
  "title": "Bot Activity Overview",
  "widgets": [{
    "definition": {
      "type": "timeseries",
      "requests": [{
        "q": "sum:webdecoy.bot.detected.count{*}"
      }]
    }
  }]
}
aws-waf-integration.yaml
# CloudFormation Template Excerpt
Resources:
  WebDecoyBotRules:
    Type: AWS::WAFv2::RuleGroup
    Properties:
      Name: webdecoy-bot-rules
      Scope: REGIONAL
      Capacity: 100
      Rules:
        - Name: BlockDatacenterActorsByJA4
          Priority: 1
          Action:
            Block: {}
          Statement:
            OrStatement:                 # one match per confirmed actor
              Statements:
                - ByteMatchStatement:
                    FieldToMatch:
                      JA4Fingerprint:    # match the JA4 identity, not an IP
                        FallbackBehavior: NO_MATCH
                    PositionalConstraint: EXACTLY
                    SearchString: t13d1516h2_8daaf6152771_b0da82dd1658
                    TextTransformations:
                      - Priority: 0
                        Type: NONE
                # ...auto-maintained by WebDecoy as new datacenter
                #    actors are confirmed: blocks every IP they use
Cloud WAF Integration

AWS WAF Integration

Protect your entire AWS infrastructure with WebDecoy intelligence. WebDecoy attaches a managed Rule Group to your Web ACL and enforces confirmed actors as composite signatures (never a bare fingerprint) across CloudFront, API Gateway, and ALB. Challenge, rate-limit, or block: each rule auto-expires and is reversible.

Key Capabilities

  • Composite Rule Automation

    Confirmed actors become composite WAFv2 rules (fingerprint plus network plus path) with graduated Challenge/CAPTCHA/Block actions and automatic expiry. No manual rule-chasing, no bare-fingerprint blocks.

  • Custom Rule Creation

    Generate WAF rules based on bot behavior patterns and attack signatures

  • CloudFront Integration

    Protect your CDN distributions with bot intelligence at the edge

  • Lambda@Edge Support

    Run WebDecoy analysis at AWS edge locations for lowest latency

Use Case: A healthcare API provider used WebDecoy + AWS WAF to block 2M+ bot requests monthly, ensuring HIPAA compliance and protecting patient data from enumeration attacks.

Enterprise CDN Integration

Akamai Integration

Leverage Akamai's massive global network with WebDecoy intelligence. Integrate with Bot Manager, Property Manager, and Edge DNS for comprehensive enterprise-grade bot defense.

Key Capabilities

  • Edge DNS Protection

    Block bots at the DNS level before they reach your origin

  • Bot Manager Integration

    Enhance Akamai Bot Manager with WebDecoy's AI detection signals

  • Property Manager Rules

    Auto-generate PM rules based on detected threats

  • Real-Time Threat Sharing

    Bidirectional intelligence sharing with Akamai's threat network

Use Case: A Fortune 500 retailer combined WebDecoy with Akamai to protect their holiday traffic surge, blocking 50M+ bot requests during Black Friday alone.

akamai-property-rules.json
{
  "name": "WebDecoy Bot Protection",
  "children": [],
  "behaviors": [{
    "name": "webApplicationFirewall",
    "options": {
      "firewallConfiguration": {
        "ruleActions": [{
          "action": "deny",
          "conditions": [{
            "type": "clientIpMatch",
            "matchOperator": "IS_ONE_OF",
            "ipAddresses": "${WEBDECOY_BLOCKED_IPS}"
          }]
        }]
      }
    }
  }],
  "criteria": [{
    "name": "requestHeader",
    "options": {
      "headerName": "X-WebDecoy-Score",
      "matchOperator": "IS_GREATER_THAN",
      "values": ["80"]
    }
  }]
}
webdecoy.vcl
sub vcl_recv {
  # Check WebDecoy edge dictionary for blocked IPs
  if (table.lookup(webdecoy_blocked_ips, client.ip)) {
    error 403 "Forbidden";
  }

  # Check bot score header from WebDecoy
  if (req.http.X-WebDecoy-Score) {
    if (std.atoi(req.http.X-WebDecoy-Score) > 80) {
      error 403 "Bot Detected";
    }
  }
}

sub vcl_log {
  # Stream detection events to WebDecoy
  if (req.http.X-Bot-Detected == "true") {
    log "syslog " req.service_id
        " webdecoy :: "
        client.ip " "
        req.url " "
        req.http.User-Agent;
  }
}
Edge Computing Integration

Fastly Integration

Deploy WebDecoy intelligence at Fastly's edge with VCL snippets and Compute@Edge. Real-time log streaming, edge dictionaries, and Signal Sciences integration included.

Key Capabilities

  • VCL Snippet Injection

    Auto-generate VCL rules for bot blocking and logging

  • Edge Dictionary Updates

    Real-time blocklist syncing to Fastly edge dictionaries

  • Real-Time Log Streaming

    Stream edge logs to WebDecoy for enhanced analysis

  • Compute@Edge Support

    Run WebDecoy analysis in Fastly's serverless edge compute

Use Case: A media streaming company used WebDecoy + Fastly to protect their video API from credential sharing bots, reducing unauthorized access by 94%.

Custom Integration

Custom Webhooks

Build your own integrations with WebDecoy's webhook system. HMAC-signed payloads, configurable retry logic, and real-time event filtering give you complete control over your security automation.

Key Capabilities

  • HMAC-Signed Payloads

    SHA-256 signatures verify webhook authenticity and prevent tampering

  • Configurable Retry Logic

    Exponential backoff with up to 5 retries ensures delivery

  • Multiple Endpoint Support

    Send events to multiple destinations simultaneously

  • Event Filtering

    Subscribe only to events you care about: bots, attacks, or honeypot triggers

Use Case: A security team built a custom integration to automatically create Jira tickets for high-severity bot attacks, reducing response time from hours to minutes.

Webhook Payload
// Webhook Header
X-WebDecoy-Signature: sha256=abc123...
X-WebDecoy-Event: bot.detected
X-WebDecoy-Timestamp: 1700000000

// Payload
{
  "event": "bot.detected",
  "timestamp": "2024-11-15T10:30:00Z",
  "data": {
    "ip": "185.x.x.x",
    "user_agent": "GPTBot/1.0",
    "bot_type": "ai_scraper",
    "threat_score": 95,
    "detection_method": "honeypot_trigger",
    "honeypot_path": "/hidden/trap-link",
    "geo": {
      "country": "US",
      "city": "San Francisco"
    },
    "action_taken": "blocked"
  }
}
Security Operations

SIEM & SOC Integrations

Stream enriched bot detection events directly to your SIEM. Every detection includes MITRE ATT&CK tactic and technique mappings for seamless correlation with your existing security data.

MITRE ATT&CK Framework Integration

Every WebDecoy detection automatically maps to standardized ATT&CK tactics and techniques. Your SOC team speaks the same threat language across all tools.

TA0043

Reconnaissance

TA0006

Credential Access

TA0002

Execution

TA0007

Discovery

View Full ATT&CK Mapping Guide
// SIEM Event with ATT&CK Enrichment
{
  "event_type": "bot_detection",
  "mitre_attack": {
    "tactics": ["TA0006"],
    "techniques": ["T1110.004"],
    "technique_name": "Credential Stuffing"
  },
  "threat_score": 94,
  "action": "blocked"
}

Splunk

Native HTTP Event Collector (HEC) integration. Pre-built dashboards, saved searches, and SOAR playbooks for automated response.

  • Real-time HEC streaming
  • Pre-built dashboards
  • Splunk SOAR integration
  • Custom alert actions

Elastic Security (ELK)

Native Elasticsearch ingestion with Kibana dashboards. SIEM detection rules and ML job templates included.

  • Elasticsearch native
  • Kibana dashboards
  • Detection rules included
  • ML anomaly detection

CrowdStrike LogScale

Real-time streaming to Falcon LogScale (Humio). Correlate bot attacks with endpoint telemetry.

  • Sub-second search
  • Endpoint correlation
  • Falcon Fusion workflows
  • Threat graph integration

Syslog (RFC 5424)

Universal compatibility with any SIEM. TCP/TLS encrypted or UDP for high-volume scenarios.

<134>1 2024-11-27T10:30:00Z webdecoy bot_detection - - [webdecoy@12345 threat_score="95" bot_type="credential_stuffer" attack="T1110.001"] Bot detected from 185.x.x.x

CEF (Common Event Format)

ArcSight-compatible format. Works with any CEF-compatible SIEM for standardized event ingestion.

CEF:0|WebDecoy|BotScanner|1.0|bot_detected|Bot Detected|9|src=185.x.x.x cs1=credential_stuffer cs2=T1110.001 cn1=95

Enriched Event Data in Every Log

Threat Score

0-100 confidence rating

Attack Classification

SQLi, XSS, Credential Stuffing

Geo-IP Data

Country, City, ASN, ISP

TLS Fingerprint

JA3/JA4 signatures

Bot Classification

AI scraper, Scanner, Stuffer

Session Correlation

Track across requests

MITRE ATT&CK

T1190, T1110, T1595

<100ms Delivery

Real-time streaming

Integration Comparison

Choose the integrations that match your infrastructure. All integrations are available on Business and Enterprise plans.

IntegrationTypeAuto BlockEdge DeployReal-TimeSetup Time
Cloudflare WAFCDN/WAF2 minutes
VercelDrain / FirewallSeparate Firewall setupSDK optionDrain deliverySee setup guide
DatadogObservability3 minutes
AWS WAFCloud WAF10 minutes
AkamaiEnterprise CDN15 minutes
FastlyEdge CDN10 minutes
Custom WebhooksCustom1 minute
SplunkSIEM5 minutes
Elastic Security (ELK)SIEM5 minutes
CrowdStrike LogScaleSIEM5 minutes
Syslog (RFC 5424)Universal2 minutes
CEF (Common Event Format)Universal2 minutes

Why WebDecoy as Your Security Hub?

Stop managing bot protection in silos. WebDecoy becomes the intelligence layer that unifies your entire security stack.

Single Source of Truth

All bot intelligence flows through WebDecoy. One dashboard, one API, one place to manage your entire bot defense strategy.

Zero-Code Automation

Integrations activate with API keys, not code changes. Your DevOps team will thank you.

Defense in Depth

Layer multiple integrations for redundant protection. Edge blocking + observability + WAF = complete coverage.

5-Minute Setup

Most integrations take less than 5 minutes to configure. Enterprise-grade protection without enterprise-grade complexity.

Proven at Scale

Our integrations process millions of requests daily for companies ranging from startups to Fortune 500.

Integration Support

Dedicated support for integration setup. We help you get connected and stay connected.

Connect Your Security Stack Today

Start with our free plan and add integrations as you grow. No credit card required. Full API access from day one.

Enterprise plans include dedicated integration support and custom connector development.