Open source · AGPL-3.0 · Wazuh 4.x

Find the signal
in the dark.

Occultera is an on-call companion for Wazuh. It watches your alerts around the clock and tells you within minutes when something is truly urgent. Once or twice a day an AI reviews everything, explains it and suggests what to tune. You decide — nothing changes in Wazuh without your approval.

  • Urgent alerts without an AI call
  • Personal data masked before the model
  • One container, no extra database
occultera · watch board
Occultera watch board: alert counts, alert volume chart, severity breakdown and MITRE ATT&CK tactics

How it works

Two loops. One quiet night.

Urgent things should not wait for a report, and a report should not be written in a panic. Occultera keeps the two apart.

The watch

every few minutes

Local rules decide — no model is called. A critical alert, a successful login after failed attempts, Active Response, a sudden spike or agents that stop reporting reach a person within minutes. Quiet hours hold everything except critical events.

  • Teams
  • Telegram
  • Slack
  • E-mail
  • Quiet hours

The AI round

once or twice a day

The model you choose reviews everything the watch saw, using read-only tools, and writes one report: findings with evidence, open questions, a verdict on every watch event, rule drafts and tuning suggestions.

  • Any LLM provider
  • Read-only tools
  • Rule drafts
  • Your approval

Features

Everything the morning check needs

The morning check, in one report

Is data flowing, are agents connected, what is at a high level and which of it is the usual noise. One report instead of an hour of dashboard queries.

Noise reduction you can trust

Rule drafts are replayed against two weeks of real alerts, checked with logtest, deployed with automatic rollback and then verified against live events.

Dashboard and MITRE ATT&CK

Trend charts, severity bands, top rules, agents and sources, a tactic strip and technique matrix, and tactics with no alerts — all without AI.

A knowledge base that learns

Known noise, decisions and open items are given to the model on every round, and the knowledge base learns from what you approve or reject.

Your data stays with you

It writes only to its own indices in your Wazuh Indexer. No other database to run. Encrypted backups to download or to S3.

Ready for a team

A read-only viewer role, SSO behind Keycloak or Authentik via proxy groups, and a monthly audit report for the review meeting.

KVKK · GDPR

Personal data never reaches the AI

E-mail addresses, phone numbers, national ID numbers, IBANs, card numbers, passwords, tokens and keys are replaced by pseudonyms before anything is sent to the model. It is on by default, and secrets cannot be unmasked at all. Your reports keep the real values — inside your own installation.

Occultera also finds personal data stored in clear text in your logs and turns it into a recommendation.

How masking works →
In your logsuser=ayse.kaya@example.com id=10000000146 failed login from 203.0.113.7
What the model seesuser=<email:3f9a…> id=<national_id_tr:b71c…> failed login from 203.0.113.7
What happened on webserver last night?
search_alerts(agent="webserver", since="-12h")correlate_around(…)ip_profile("203.0.113.7")
Between 02:10 and 02:40 there were 412 failed SSH logins from 203.0.113.7, then none. No successful login followed, and the IP is not seen on other agents. Known noise? No — I'd suggest a frequency rule; a draft is ready for your review.

Model Context Protocol

Ask your Wazuh in plain language

The built-in MCP server gives any agent that speaks the Model Context Protocol the same read-only tools the AI uses: alert search, timelines, IP profiles, agents, rule info, logtest, reports and the knowledge base — with the same query limits, the same masking and a per-client rate limit.

  • Claude Desktop
  • Claude Code
  • Cursor
  • VS Code
  • any MCP client
Connect an agent →

What it is — and what it is not

It is

  • A daily review and on-call aid that reads what Wazuh produced
  • Read-only towards Wazuh by default
  • An assistant that proposes; a person decides
  • One container that keeps its data in your own Wazuh Indexer
  • Supporting evidence for monitoring reviews

It is not

  • A replacement for Wazuh or its dashboard
  • A SOAR: it does not block, isolate or run commands on agents
  • An autonomous responder
  • A hosted service, or another database to run
  • A certificate of ISO 27001 or any other conformity

Get started

Running in five minutes

The demo needs no Wazuh and no model: synthetic data, a mock model, a finished report and waiting suggestions.

git clone https://github.com/occultera/occultera.git && cd occultera
cp .env.demo .env
docker compose up -d --build
# open http://127.0.0.1:8080  —  password: demo-password-change-me

Why “Occultera”?

In astronomy, an occultation is the moment one body passes in front of another and hides it. Astronomers turn those moments into measurements: the rings of Uranus were discovered by watching a star blink out behind them. Occultera works the same way with your logs — it watches what happens in the dark and finds the signal worth waking up for.