Generic SIEM engine detector
Project description
Made in :brazil:
Clickdetect
Clickdetect is a generic alerting and detection engine that supports any data source and integrates with any webhook. It is vendor-agnostic, with no lock-in, and enables powerful, flexible detection workflows.
Follow the doc: https://clickdetect.souzo.me
Supported sources
Datasources
- Clickhouse
- Loki
- VictoriaLogs
- PostgreSQL
- Elastic/Opensearch
Webhooks
- Generic
- DFIR Iris
- Forgejo
- Microsoft Teams
- Slack
- Telegram
- Discord
Starting guide
First of all, create your runner.yml file. (Follow doc for the creation) You will put detectors, webhooks and datasources in the configuration file.
uv
Follow uv installation in https://docs.astral.sh/uv
uv sync --no-dev
uv run clickdetect --api
Docker/Podman
Local
podman build -t clickdetect .
podman run -v ./runner.yml:/app/runner.yml -p 8080 clickdetect --api -p 8080
Github Packages
podman run -v ./runner.yml:/app/runner.yml -p 8080 ghcr.io/clicksiem/clickdetect:latest --api -p 8080
Options
| Flag | Default | Description |
|---|---|---|
--api |
off | Start the REST API server |
-p, --port |
8080 |
Port for the API server |
-r, --runner |
runner.yml |
Path to the runner configuration file |
--stdin |
off | Read the runner configuration from stdin |
--verbose |
off | Verbose mode |
--reload |
off | Hot reload rules |
--no-start |
off | Do not start detectors on start |
--list-webhooks |
off | List webhooks |
--list-datasources |
off | List datasources |
Roadmap
Webhooks
- Complete DFIR-IRIS webhook integration
- Add Slack webhook
- Add Discord webhook
- Add PagerDuty webhook
- Add Telegram webhook
- Add Opsgenie webhook
Alert Management
- Implement timeframe-based alert grouping (avoid duplicate alerts within a window)
- Implement alert silencing (suppress alerts by rule/group/tenant for a duration)
- Add API endpoints to manage silences (
POST /silence,DELETE /silence/{id})
Rule Management
- Hot reload rules without restarting (
--reloadflag or file watcher) ✅ - API endpoints to add/update/remove rules dynamically (depends on hot reload)
- Sigma rule conversion support (
sigma: truein rule definition)
Datasources
- Add support for Splunk
- Add support for OpenSearch/Elasticsearch
- Add support for VictoriaLogs
API & Observability
- Implement an endpoint to create, edit and delete rules
- Alert history endpoint to query past triggered rules
Contact-me
- E-mail: me@souzo.me
- Matrix: @souzo:matrix.org
- Linkedin: https://www.linkedin.com/in/vinicius-m-a76ba51b5/
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file clickdetect-1.7.0.tar.gz.
File metadata
- Download URL: clickdetect-1.7.0.tar.gz
- Upload date:
- Size: 18.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
dfa2b5c72ab49491852d882818e9e3688528b75bfb211c0fdcf3307a4b93f67b
|
|
| MD5 |
cdfdcd093a2ee363b95c949612fa86d5
|
|
| BLAKE2b-256 |
f5c96b32f2e927514ba69b9feb2fede5dc6fe1353d73763a99ba94aede90e164
|
File details
Details for the file clickdetect-1.7.0-py3-none-any.whl.
File metadata
- Download URL: clickdetect-1.7.0-py3-none-any.whl
- Upload date:
- Size: 34.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
895c9ebab50a11746282bd2ce7424e5ab8942c5f1588483fc2afd396b6729b51
|
|
| MD5 |
aa4aad0cdc75fb78c9bc8616ea7ec686
|
|
| BLAKE2b-256 |
9ebd7f24311ebb9c04249c0bb7223640cc37297aee84066c1292e282cbd89103
|
