Version 2.4.8 · latest

WAF rule library waf-rules

The WAF rule package version the master distributes, node alignment and the protection list (paid feature rules_update; nodes use 23 built-in rules when it is off).

Pick an endpoint to see its example call on the right.

Operations and systemAuthentication: User2 endpoints

Authentication

Send the X-API-Key header (create a key on the API Keys page; the key is shown only once at creation). An Authorization: Bearer token obtained by logging in also works.

X-API-Key

Authentication failures return 401; forbidden returns 403 (code such as insufficient_scope).

Conventions

Paging uses page (from 1) and page_size; sort with sort=field or sort=-field.

Times are RFC 3339 (UTC); amounts are in cents.

Writes return 200/201/204 on success; duplicates of a unique key return 409.

GET/api/v2/waf-rules/protectionsList WAF protections

Authentication: User

Query parameters

FieldTypeDescription
qstring Search term: rule ID, title, product name or vulnerability ID (e.g. ThinkPHP, CVE-2021-44228).
classWafRuleClass Class: general, patch (vulnerability patch), emergency, custom; omit for all.
Values ["general","patch","emergency","custom"]
product_classWafProductClass Product class: cms, framework, middleware, component, other (rules without products count as other); matches when any product of the rule is in the class; omit for all. Available classes and counts are in product_classes of the response.
Values ["cms","framework","middleware","component","other"]
stackWafStack[] Tech stack; repeat for several (any matches); omit for all. Options and counts are in categories.stacks of the response.
attackWafAttack[] Attack type; repeat for several (any matches); omit for all. With stack both must match. Options and counts are in categories.attacks of the response.
sourcestring Source: builtin (built into the node), package (rule package), custom (written by the provider); omit for all sources. It scopes the whole list (items, counts, product_classes and categories share the scope).
Values ["builtin","package","custom"]
formatstring csv = export all filtered entries as a CSV attachment; omit for paged JSON.
Values ["csv"]
pageinteger Page number, starting from 1
Default 1
page_sizeinteger Items per page
Default 20

WAF rule library object

FieldTypeDescription
addedstring Version that added the rule (first package version containing it; the version is the release date); empty for built-in rules.
attackWafAttack Attack type: rce (remote code execution), sqli (SQL injection), xss, lfi (path traversal), rfi (remote file inclusion), protocol (protocol violation), scanner, other. From the attack category of the detection rule in the package; language categories (php, java, nodejs) count as rce and a missing category as other; entries without a detection rule in the package have none.
Values ["rce","sqli","xss","lfi","rfi","protocol","scanner","other"]
builtinboolean No rule package has ever been fetched; nodes use the 23 built-in rules.
classWafRuleClass Rule class: general, patch (vulnerability patch), emergency, custom.
Values ["general","patch","emergency","custom"]
cvesstring[] Vulnerability IDs (CVE, CNVD, etc.).
enabledboolean Whether the paid feature rules_update is enabled (when off or expired, updates stop and the last package keeps being distributed).
errorstring Why the latest round did not switch to the newest package (admins only).
haltstring Why updates are halted by the license (expired, disabled, or the super admin unreachable for long) (admins only; not a failure, separate from error; absent when not halted).
idinteger Rule ID (vendor 94xxxx, custom 990000–999999).
latest_versionstring Latest package version in the license (admins only; differs from version when not yet switched).
levelstring Lowest protection level the rule applies at: basic, standard, strict.
Values ["basic","standard","strict"]
nodesWafRulesNodes Node alignment (by the rule package each node reports in its heartbeat; admins only).
observe_days_leftinteger Days left in the observation period (a partial day counts as one); present only when status=observing.
product_classWafProductClass Product class: cms, framework, middleware, component, other. Derived from the product names of the rule; the first non-other class wins when a rule covers several products, and a rule without products is other.
Values ["cms","framework","middleware","component","other"]
productsstring[] Products covered.
rulesinteger Number of rules in use (23 when builtin).
sha256string SHA-256 of the current package manifest; absent when builtin.
sourcestring builtin: built into the node; package: rule package; custom: written by the provider (990000–999999).
Values ["builtin","package","custom"]
stackWafStack Tech stack: php, java, nodejs, python, dotnet. Taken from the rule package mark, otherwise from a language attack category (php, java, nodejs); rules it cannot be derived for have none.
Values ["php","java","nodejs","python","dotnet"]
statusstring Disposition: block; observing (a new rule only logs at first, and its hits carry the observe-only new-rule mark in WAF events). Always block for built-in and emergency rules or when the observe days is 0.
Values ["block","observing"]
synced_atstring Time of the latest check.
titlestring What it protects; rule name for built-in rules.
title_enstring What it protects, in English.
typestring Type (e.g. remote code execution); attack category (e.g. sqli) for built-in rules.
versionstring Current package version (e.g. 2026.10.19); empty when builtin.

Responses and errors

Success returns the resource JSON directly (HTTP 2xx); failures return application/problem+json (code, detail, plus errors on validation failures); lists carry items + total.

Success
{
  "id": 1,
  "name": "example"
}
List
{
  "items": [
    {
      "id": 1
    }
  ],
  "page": 1,
  "page_size": 20,
  "total": 1
}
Error
{
  "code": "validation_failed",
  "detail": "Invalid request parameters",
  "errors": [
    {
      "code": "required",
      "field": "/name",
      "message": "name is required"
    }
  ],
  "request_id": "0123456789abcdef",
  "status": 422,
  "title": "Unprocessable Entity",
  "type": "about:blank"
}
Get started

Try the live demo

Open the live demo, or contact us for a quote and the install command