anteumbra 1.0.26

Anteumbra — Web Perimeter Threat Intelligence. Passive detection, semi-active response, attacker profiling.

Anteumbra

Lightweight Web Perimeter Security
Passive detection, semi-active response, file-level forensics, and attacker profiling.

中文 | User Manual | Architecture | Release Guide | PyPI | Issues

---

Anteumbra is a web perimeter threat-intelligence and WebShell detection platform for Windows and Linux. It watches website directories, detects suspicious PHP/ASP/JSP/ASPX files with YARA rules, correlates access logs, profiles attacker behavior, and provides a web dashboard for triage, quarantine, restoration, audit, and reporting.

Anteumbra is installed as one product. PyPI users and source-install developers both create runtime instances with the same anteumbra install and anteumbra config workflow.

Documentation

Need	English	Chinese
Install, configure, operate	User Manual	用户手册
Internal architecture and extension points	Architecture	架构文档
Release and PyPI publishing	Release Guide	-

Quick Start

pip install anteumbra
anteumbra install ./anteumbra-instance
cd ./anteumbra-instance
anteumbra config wizard
anteumbra config validate
anteumbra run

Open http://127.0.0.1:8080/admin. The default username is admin; the initial password is printed by anteumbra install. You can set a new password in anteumbra config wizard.

YARA scanning is included in the base install. Optional similarity engines are available through the full extra:

pip install anteumbra           # includes yara-python
pip install "anteumbra[full]"  # adds ssdeep and py-tlsh

anteumbra[yara] remains accepted as a compatibility alias but adds no dependencies beyond the base package.

Common Configuration

Use the wizard for first-run setup:

anteumbra config wizard
anteumbra config validate

Use preset commands for access-log analysis. This avoids hand-writing platform-specific paths and Tomcat wildcards:

anteumbra config access-log nginx
anteumbra config access-log apache
anteumbra config access-log tomcat --base /opt/tomcat
anteumbra config access-log custom --path /path/to/access.log
anteumbra config access-log none

Low-level scripted edits are still available:

anteumbra config set website.path /var/www/html
anteumbra config set web_admin.port 8080
anteumbra config env set ANTEUMBRA_WECHAT_API_KEY your-send-key
anteumbra config reload

For the full command reference, see CLI Commands.

Core Capabilities

• Multi-site file monitoring on Windows and Linux
• Manual scans with scan history and printable reports
• YARA-based WebShell detection for PHP, ASP, JSP, ASPX, Godzilla, Behinder, and related families
• Access-log behavior analysis for Nginx, Apache, and Tomcat
• Attacker profiling, IP reputation, attack chain timelines, and cross-page batch actions
• Quarantine, restore, false-positive marking, and audit trail workflows
• JSON and SQLite storage backends with WAL support
• SIEM export in CEF, JSON Lines, and Syslog formats
• Web dashboard with merged historical/live SSE logs, runtime capability status, and configuration management
• Plugin manager and WAF/event-source integration points

Source Install

Use a source install for development, testing, or local code changes. Runtime setup remains the same as the PyPI flow.

git clone https://github.com/SxyLao1/Anteumbra.git
cd Anteumbra
pip install -e ".[dev]"
anteumbra install ./dev-instance --force
cd ./dev-instance
anteumbra config wizard
anteumbra run

Run tests from the repository root:

python -m pytest

Docker

docker build -t anteumbra .
docker run -d --name anteumbra \
  -p 18080:8080 \
  -v $(pwd)/anteumbra-data:/app/data \
  -v $(pwd)/anteumbra-logs:/app/logs \
  anteumbra
docker logs anteumbra

The container starts the same full runtime as anteumbra run, creates a Docker-friendly default config on first start, and prints the initial admin password in docker logs. Open http://127.0.0.1:18080/admin.

Architecture

Anteumbra follows a layered structure:

src/anteumbra/
  domain/          # Entities and ports
  application/     # Use cases and orchestration
  infrastructure/  # Persistence, detection, monitoring, config, utilities
  interfaces/      # CLI, Flask blueprints, templates, static assets

See Architecture for module boundaries, extension guidance, and integration contracts.

Migration From Trident

Anteumbra is the successor to Trident. Existing config.toml and data/ directories are intended to remain compatible; install Anteumbra, create a runtime instance, then copy your existing configuration and data into that instance. See the User Manual before production migration.

License

MIT License. Third-party tools bundled under tools/ retain their original licenses.

---

_{Anteumbra v1.0.26 · MIT License}