Local API
The Local API (LAPI) is one of the core components of the Security Engine to :
- Allow Log Processors to push alerts & decisions to a database
- Allow Remediation Components to consume said alerts & decisions from database
- Allow
cscli
to manage the database (list, delete, etc)
You can find the swagger documentation here.
This allows you to create multi-machines architectures around CrowdSec or leverage orchestration technologies.
All subcategories below are related to the Local API and its functionalities. If you are utilizing a multi server architecture, you will only need to configure the functionality that you want to use on the LAPI server.
For example if you wish to receive notifications then you will only need to configure the Notification Plugins on the LAPI server and not each log processor.
Authentication
LAPI offers multiple different authentication methods, which has their own restrictions based on the method used.
You can find more information about the authentication methods here.
Profiles
Profiles are a set of rules processed by the LAPI to determine if an alert should trigger a decision, notification or just simply log. They are processed in order of definition and can be used to make complex decisions based on the alert.
You can find more information about profiles here.
Notification Plugins
Notification plugins are used to send alerts to external services.
You can find more information about configuring the plugins here.
Databases
Databases documentation showcases which database the LAPI supports and how to configure the database to allow the LAPI to utilize it.
You can find more information about the databases here.