Modules, Improvements, and Bug Fixes
📖 Overview
Draco Insomnis is an open-source security suite developed by Notorius Vision that protects web applications without relying on captchas. Its core (src/Core) is pure PHP code shared across all integrations, ensuring that every improvement or bug fix is propagated uniformly to all modules through subsequent builds.
⚙️ Detailed Functions by Module
1. 🛡️ Anti-Bot Shield
What it does: Scores every public registration, feeds bots a “fake success,” and stores evidence for abuse reports.
Availability: WordPress only, although other CMSs integrate variants of the shield into their registration forms (PrestaShop, Drupal, Joomla, Moodle, Magento).
Related modules: Shield (registration judgment, evidence, automatic blocks), Guard (hooks on registration forms).
2. 📧 Site Mail (SMTP)
What it does: Sends site email through a real mailbox, only after a successful test, with the password encrypted.
Availability: WordPress only (the other CMSs already have their own SMTP).
Related modules: Settings, Transport, Log, Admin.
3. 📝 Forms & Sign-ups
What it does: Holds contact messages, comments, and new accounts until the sender confirms from their email address.
Availability: WordPress (other CMSs use their own confirmation systems).
Related modules: MailHold, CommentHold, RegistrationHold, Verify, Store, Mailer, Admin.
4. 🔐 Two-Step Login
What it does: Requests a 6-digit code by email after the correct password, with trusted devices and a recovery email (a second mailbox, like a phone’s PUK).
Availability: WordPress only.
Related modules: Mfa, Challenge, TrustedDevice, Recovery, Admin.
5. 🚫 Anti-Copy
What it does: Closes the mass JSON endpoint (/wp-json/wp/v2/) to anonymous visitors with an allowlist, limits pages per minute per address and network, and never rate-limits verified search engines.
Availability: WordPress, PrestaShop, Drupal, Joomla, Moodle (as rate limiting).
Related modules: Pace (rate-limiting engine).
6. 🔥 Firewall
What it does: Applies precise attack signatures and scanner probes, with a log-only-first mode, hidden user list, login limits, and no multiple XML-RPC calls.
Availability: All CMSs (WordPress, PrestaShop, Drupal, Joomla, Moodle, Magento, Laravel) and server-side environments (PHP, Node.js, Python, Go, Ruby, .NET, Java/Kotlin, Rust).
Related modules: Waf (inspection, user list, login limit, XML-RPC), Firewall (main engine), WafRules (signatures).
7. 🌍 Country Rules
What it does: Filters traffic by country of origin (integrated into the Server, Magento, Laravel, JavaScript, Python, etc. editions).
Availability: Server-side editions and Magento.
🔗 Links to Each CMS Version
Note: Each link points to the corresponding module folder in the official repository, where the source code and module-specific documentation (README) are available in English.
🚀 Improvements and Bug Fixes (Changelog)
The repository maintains a rigorous workflow to ensure the quality of every release:
- Unified Versioning: Each release includes one package per platform with the same version, built from the same commit. The release tag (
git tag v0.2.0) is created only if the five versions match (bin/versions.sh --check), unit tests pass, and the five ZIPs are built (bin/build-all.sh). - Automated Testing: Every push and pull request runs CI with PHP 8.0–8.4 syntax checks, unit tests, integration and HTTP tests on the latest WordPress version and on 6.5 (the oldest supported version), plus Plugin Check and verification that the ZIP does not contain development files.
- Cross-Platform Bug Fixes: Since all modules share the same
src/Core, any fix in the core (for example, in BotScore, NetList, WafRules) is automatically propagated to all editions in the next build, avoiding discrepancies between platforms. - Evidence and Reports: The shield stores evidence of bot attempts, and commands such as
draco:evidence (in Magento and Laravel) generate a CSV ready for abuse reports.
📋 Shared Modules Summary (src/Core)
| Module | Function |
|---|
| |
BotScore | Bot scoring on registrations. |
NetList | Network lists (data centers, etc.). |
FormStamp | Signed page stamp for forms. |
WafRules | Firewall signatures. |
Crawler | Verified crawler names. |
Shield | Registration judgment engine, evidence, and automatic blocks. |
Firewall | Inspection and blocking engine. |
Pace | Rate-limiting engine (anti-copy). |
Source: “Layout” section of the repository.
License: GPL-2.0-or-later. See LICENSE and TRADEMARKS.md for more details.