* if log_media is set to file, don't try to log to stdout * use the log media no matter what |
||
---|---|---|
.github | ||
cmd | ||
config | ||
docker | ||
docs | ||
pkg | ||
scripts | ||
.gitignore | ||
Dockerfile | ||
go.mod | ||
go.sum | ||
LICENSE | ||
Makefile | ||
mkdocs.yml | ||
README.md | ||
RELEASE.json | ||
wizard.sh |
📚 Documentation 💠 Hub 💬 Discourse Forum 💬 Gitter Chat
Crowdsec shouldn't, and didn't crash any production so far we know, but some features might be missing or undergo evolutions. IP Blocklists are limited to very-safe-to-ban IPs only (~5% of the global database so far, will grow soon)
If you want to be notified of software updates, click here
<TL;DR>
A modern behavior detection system, written in Go. It stacks on Fail2ban's philosophy, but uses Grok patterns & YAML grammar to analyse logs, a modern decoupled approach (detect here, remedy there) for Cloud/Containers/VM based infrastructures. Once detected you can remedy threats with various bouncers (block, 403, Captchas, etc.) and blocked IPs are shared among all users to further improve their security.
ℹ️ About the CrowdSec project
Crowdsec is an open-source, lightweight software, detecting peers with aggressive behaviors to prevent them from accessing your systems. Its user friendly design and assistance offers a low technical barrier of entry and nevertheless a high security gain.
Processing is done in 5 steps:
- Read Data sources (log files, streams, trails, messages ...), normalize and enrich signals
- Matching those signals to behavior patterns, aka scenarios (*)
- If an unwanted behavior is detected, deal with it through a bouncer : a software component integrated into your applicative stack that supports various remediations such as block, return 403, and soon captcha, 2FA, etc.
- (ONLY) The aggressive IP, the scenario name triggered and a timestamp is then sent to our curation platform (to avoid poisoning & false positives)
- If verified, this IP is then integrated to the block list continuously distributed to all CrowdSec clients (which is used as an enrichment source in step1)
By detecting, blocking & sharing the threat they faced, all clients are reinforcing each-others (hence the name Crowd-Security). Crowdsec is designed for modern infrastructures, with its "Detect Here, Remedy There" approach, letting you analyse logs coming from several sources in one place and block threats at various levels (applicative, system, infrastructural) of your stack.
(*) CrowdSec ships by default with scenario (brute force, port scan, web scan, etc.) adapted for most context, but you can easily extend it by picking more of them from the hub. It is also very easy to adapt an existing one or create one yourself.
👉 What it is not
CrowdSec is not a SIEM, storing your logs (neither locally nor remotely).
Your data stay in your premises and are only analyzed and forgotten.
Signals sent to the curation platform are extremely limited (IP, Scenario, Timestamp), and are only there to allow the system to rule out false positives or poisoning attemps.
⬇️ Install it !
In order to install it on an amd64
platform, you can use the available prebuilt release package.
Just follow the steps below. However, if you want crowdsec for a different architecture
(e.g. ARM) then you must build it yourself from source. You can find the build instructions
here in
our documentation.
Find the latest release
Ensure you have dependencies :
for Debian based distributions
apt-get install bash gettext whiptail wget
for RedHat based distributions
yum install bash gettext newt wget
Then :
wget https://github.com/crowdsecurity/crowdsec/releases/latest/download/crowdsec-release.tgz
tar xvzf crowdsec-release.tgz
cd crowdsec-v*
sudo ./wizard.sh -i
🐋 Docker
You can use docker to run crowdsec, by using official docker image.
You can also build the docker image following this
⚙️ Build it !
If you want to build crowdsec yourself follow these steps:
git clone https://github.com/crowdsecurity/crowdsec
cd crowdsec
make build
For more details read the chapter Installation from source in our documentation.
🎉 Key points
Fast assisted installation, no technical barrier
User is assisted during setup, providing functional out-of-the-box setup
![](/beenull/crowdsec/media/commit/6d28599efa09606467a34fa337745f1aa7400433/docs/assets/images/crowdsec_install.gif)
Out of the box detection
Baseline detection is effective out-of-the-box, no fine-tuning required (click to expand)
![](/beenull/crowdsec/media/commit/6d28599efa09606467a34fa337745f1aa7400433/docs/assets/images/out-of-the-box-protection.gif)
Easy bouncer deployment
It's trivial to add bouncers to enforce decisions of crowdsec (click to expand)
![](/beenull/crowdsec/media/commit/6d28599efa09606467a34fa337745f1aa7400433/docs/assets/images/blocker-installation.gif)
Easy dashboard access
It's easy to deploy a metabase interface to view your data simply with cscli (click to expand)
![](/beenull/crowdsec/media/commit/6d28599efa09606467a34fa337745f1aa7400433/docs/assets/images/cscli-metabase.gif)
📦 About this repository
This repository contains the code for the two main components of crowdsec :
crowdsec
: the daemon a-la-fail2ban that can read, parse, enrich and apply heuristis to logs. This is the component in charge of "detecting" the attackscscli
: the cli tool mainly used to interact with crowdsec : ban/unban/view current bans, enable/disable parsers and scenarios.