crowdsec/mkdocs.yml
2020-12-17 09:55:55 +01:00

363 lines
15 KiB
YAML

site_name: Crowdsec
nav:
- Home: index.md
- Crowdsec v0: "!include ./docs/v0.3.X/mkdocs.yml"
- Crowdsec v1 : "!include ./docs/v1.X/mkdocs.yml"
- Developers : https://crowdsecurity.github.io/api_doc/index.html?urls.primaryName=LAPI" target="_blank
- Hub : https://hub.crowdsec.net/" target="_blank
- Releases : https://github.com/crowdsecurity/crowdsec/releases" target="_blank
- Contributing:
- Guide: contributing.md
- FAQ:
- Questions: faq.md
markdown_extensions:
- codehilite:
guess_lang: false
- toc:
permalink: true
- admonition
theme:
name: material
logo: assets/images/crowdsec2.png
favicon: assets/images/crowdsec2.png
features:
- navigation.tabs
- navigation.expand
- navigation.instant
- navigation.section
palette:
primary: "#3d85c6"
language: en
font:
text: Montserrat
highlightjs: true
hljs_languages:
- yaml
repo_url: https://github.com/crowdsecurity/crowdsec
repo_name: GitHub
plugins:
- search
- macros
- monorepo
extra:
swagger_url: "https://raw.githubusercontent.com/crowdsecurity/crowdsec/master/pkg/models/localapi_swagger.yaml"
v0X:
doc:
new_issue: "[new documentation issue](https://github.com/crowdsecurity/crowdsec/issues/new)"
discourse: "[CrowdSecurity discourse](http://discourse.crowdsec.net)"
gitter: "[Crowdsec gitter](http://discourse.crowdsec.net)"
hub:
name: Crowdsec Hub
htmlname: "[Crowdsec Hub](https://hub.crowdsec.net/)"
url: "https://hub.crowdsec.net/"
plugins_url: "https://hub.crowdsec.net/browse/#bouncers"
scenarios_url: "https://hub.crowdsec.net/browse/#configurations"
parsers_url: "https://hub.crowdsec.net/browse/#configurations"
collections_url: "https://hub.crowdsec.net/browse/#collections"
crowdsec:
name: Crowdsec
Name: Crowdsec
bin: crowdsec-agent
path: /usr/bin/crowdsec-agent
url: https://github.com/crowdsecurity/crowdsec
bugreport: "https://github.com/crowdsecurity/crowdsec/issues"
main_log: "/var/log/crowdsec.log"
download_url: https://github.com/crowdsecurity/crowdsec/releases
cli:
name: cscli
Name: cscli
main_doc: /Crowdsec/v0/cscli/cscli/
url: "https://github.com/crowdsecurity/crowdsec"
bugreport: "https://github.com/crowdsecurity/crowdsec/issues"
# alerts_doc: /Crowdsec/v1/cscli/cscli_alerts/
# decisions_doc: /Crowdsec/v1/cscli/cscli_decisions/
# collections_doc: /Crowdsec/v1/cscli/cscli_collections/
# parsers_doc: /Crowdsec/v1/cscli/cscli_parsers/
# scenarios_doc: /Crowdsec/v1/cscli/cscli_scenarios/
# api_doc: /Crowdsec/v0/cscli/cscli_api/
# ban_doc: /Crowdsec/v0/cscli/cscli_ban/
# metrics_doc: /Crowdsec/v0/cscli/cscli_metrics/
# remove_doc: /Crowdsec/v0/cscli/cscli_remove/
# install_doc: /Crowdsec/v0/cscli/cscli_install/
# list_doc: /Crowdsec/v0/cscli/cscli_list/
# update_doc: /Crowdsec/v0/cscli/cscli_update/
# upgrade_doc: /Crowdsec/v0/cscli/cscli_upgrade/
# backup_doc: /Crowdsec/v0/cscli/cscli_backup/
# simulation_doc: /Crowdsec/v0/cscli/cscli_simulation/
config:
cli_dir: /etc/crowdsec/cscli/
crowdsec_dir: "/etc/crowdsec/config/"
acquis_path: "/etc/crowdsec/config/acquis.yaml"
bouncers:
name: bouncers
Name: bouncers
url: "https://hub.crowdsec.net/browse/#bouncers"
htmlname: "[bouncers](/Crowdsec/v0/bouncers/)"
Htmlname: "[Bouncers](/Crowdsec/v0/bouncers/)"
plugins:
name: backend plugins
configpath: "/etc/crowdsec/plugins/backend/"
binpath: "/usr/local/lib/crowdsec/plugins/"
metabase:
name: metabase
url: https://github.com/crowdsecurity/crowdsec
wizard:
name: wizard
url: "https://github.com/crowdsecurity/crowdsec"
bin: "./wizard.sh"
bugreport: "https://github.com/crowdsecurity/crowdsec/issues"
ref:
parser: "[parser](/Crowdsec/v0/references/parsers/)"
Parser: "[Parser](/Crowdsec/v0/references/parsers/)"
scenario: "[scenarios](/Crowdsec/v0/references/scenarios/)"
Scenario: "[Scenarios](/Crowdsec/v0/references/scenarios/)"
acquis: "[acquisition](/Crowdsec/v0/guide/crowdsec/acquisition/)"
Acquis: "[Acquisition](/Crowdsec/v0/guide/crowdsec/acquisition/)"
output: "[output](/Crowdsec/v0/references/output/)"
Output: "[Output](/Crowdsec/v0/references/output/)"
# All the technical terms
event:
name: event
Name: Event
htmlname: "[event](/Crowdsec/v0/getting_started/concepts/#event)"
Htmlname: "[Event](/Crowdsec/v0/getting_started/concepts/#event)"
expr:
name: expr
Name: Expr
htmlname: "[expr](/Crowdsec/v0/write_configurations/expressions/)"
Htmlname: "[Expr](/Crowdsec/v0/write_configurations/expressions/)"
filter:
name: filter
Name: Filter
htmlname: "[filter](/Crowdsec/v0/references/parsers/#filter)"
Htmlname: "[Filter](/Crowdsec/v0/references/parsers/#filter)"
onsuccess:
name: onsuccess
Name: Onsuccess
htmlname: "[onsuccess](/Crowdsec/v0/references/parsers/#onsuccess)"
Htmlname: "[Onsuccess](/Crowdsec/v0/references/parsers/#onsuccess)"
statics:
name: statics
Name: Statics
htmlname: "[statics](/Crowdsec/v0/references/parsers/#statics)"
Htmlname: "[Statics](/Crowdsec/v0/references/parsers/#statics)"
parsers:
name: parsers
Name: Parsers
htmlname: "[parsers](/Crowdsec/v0/getting_started/concepts/#parsers)"
Htmlname: "[Parsers](/Crowdsec/v0/getting_started/concepts/#parsers)"
scenarios:
name: scenarios
Name: Scenarios
htmlname: "[scenarios](/Crowdsec/v0/getting_started/concepts/#scenarios)"
Htmlname: "[Scenarios](/Crowdsec/v0/getting_started/concepts/#scenarios)"
collections:
name: collections
Name: Collections
htmlname: "[collections](/Crowdsec/v0/getting_started/concepts/#collections)"
Htmlname: "[Collections](/Crowdsec/v0/getting_started/concepts/#collections)"
timeMachine:
name: timeMachine
Name: TimeMachine
htmlname: "[timeMachine](/Crowdsec/v0/getting_started/concepts/#timemachine)"
Htmlname: "[TimeMachine](/Crowdsec/v0/getting_started/concepts/#timemachine)"
overflow:
name: overflow
Name: Overflow
htmlname: "[overflow](/Crowdsec/v0/getting_started/concepts/#overflow-or-signaloccurence)"
Htmlname: "[Overflow](/Crowdsec/v0/getting_started/concepts/#overflow-or-signaloccurence)"
whitelists:
name: whitelists
Name: Whitelists
htmlname: "[whitelists](/Crowdsec/v0/write_configurations/whitelist/)"
Htmlname: "[Whitelists](/Crowdsec/v0/write_configurations/whitelist/)"
signal:
name: signal
Name: Signal
htmlname: "[signal](/Crowdsec/v0/getting_started/concepts/#overflow-or-signaloccurence)"
Htmlname: "[Signal](/Crowdsec/v0/getting_started/concepts/#overflow-or-signaloccurence)"
#scenario stuff
stage:
name: stage
Name: Stage
htmlname: "[stage](/Crowdsec/v0/getting_started/concepts/#stages)"
Htmlname: "[Stage](/Crowdsec/v0/getting_started/concepts/#stages)"
leakspeed:
name: leakspeed
Name: Leakspeed
htmlname: "[leakspeed](/Crowdsec/v0/references/scenarios/#leakspeed)"
Htmlname: "[Leakspeed](/Crowdsec/v0/references/scenarios/#leakspeed)"
capacity:
name: capacity
Name: Capacity
htmlname: "[capacity](/Crowdsec/v0/references/scenarios/#capacity)"
Htmlname: "[Capacity](/Crowdsec/v0/references/scenarios/#capacity)"
duration:
name: duration
Name: Duration
htmlname: "[duration](/Crowdsec/v0/references/scenarios/#duration)"
Htmlname: "[Duration](/Crowdsec/v0/references/scenarios/#duration)"
prometheus:
name: prometheus
htmlname: "[prometheus](https://github.com/prometheus/client_golang)"
api:
name: API
htmlname: "[API](TBD)"
topX:
name: topX
htmlname: "[topX](TBD)"
###############################################################
### Bellow are defines for V1 and later of the documentation ##
###############################################################
v1X:
doc:
new_issue: "[new documentation issue](https://github.com/crowdsecurity/crowdsec/issues/new)"
discourse: "[CrowdSecurity discourse](http://discourse.crowdsec.net)"
community: "[community](http://discourse.crowdsec.net)"
hub:
name: Crowdsec Hub
htmlname: "[Crowdsec Hub](https://hub.crowdsec.net/)"
url: "https://hub.crowdsec.net/"
bouncers_url: "https://hub.crowdsec.net/browse/#bouncers"
scenarios_url: "https://hub.crowdsec.net/browse/#configurations"
parsers_url: "https://hub.crowdsec.net/browse/#configurations"
collections_url: "https://hub.crowdsec.net/browse/#collections"
crowdsec:
name: crowdsec-agent
Name: Crowdsec-agent
url: https://github.com/crowdsecurity/crowdsec
bugreport: "https://github.com/crowdsecurity/crowdsec/issues"
download_url: https://github.com/crowdsecurity/crowdsec/releases
lapi:
name: local API (LAPI)
Name: Local API (LAPI)
Htmlname: "[Local API](/Crowdsec/v1/localAPI/)"
htmlname: "[local API](/Crowdsec/v1/localAPI/)"
url: /Crowdsec/v1/localAPI/
swagger: https://crowdsecurity.github.io/api_doc/index.html?urls.primaryName=LAPI
cli:
name: cscli
Name: Cscli
bin: cscli
user_guide: "[cscli](/Crowdsec/v1/user_guide/cscli/)"
config:
crowdsec_dir: "/etc/crowdsec/"
acquis_path: "/etc/crowdsec/acquis.yaml"
crowdsec_config_file: "/etc/crowdsec/config.yaml"
bouncers:
name: bouncers
Name: Bouncers
url: "https://hub.crowdsec.net/browse/#bouncers"
htmlname: "[bouncers](/Crowdsec/v1/bouncers/)"
Htmlname: "[bouncers](/Crowdsec/v1/bouncers/)"
metabase:
name: metabase
htmlName: "[dashboard](/Crowdsec/v1/observability/dashboard)"
wizard:
name: wizard
bin: "./wizard.sh"
bugreport: "https://github.com/crowdsecurity/crowdsec/issues"
ref:
acquis: "[acquisition](/Crowdsec/v1/user_guide/configurations_management/acquisition/)"
parsers: "[parsers](/Crowdsec/v1/references/parsers/)"
scenarios: "[scenarios](/Crowdsec/v1/references/scenarios/)"
# All the technical terms
event:
name: event
Name: Event
htmlname: "[event](/Crowdsec/v1/getting_started/concepts/#events)"
Htmlname: "[Event](/Crowdsec/v1/getting_started/concepts/#events)"
expr:
name: expr
Name: Expr
htmlname: "[expr](/Crowdsec/v1/references/expressions/)"
Htmlname: "[Expr](/Crowdsec/v1/references/expressions/)"
filter:
name: filter
Name: Filter
htmlname: "[filter](/Crowdsec/v1/references/parsers/#filter)"
Htmlname: "[Filter](/Crowdsec/v1/references/parsers/#filter)"
onsuccess:
name: onsuccess
Name: Onsuccess
htmlname: "[onsuccess](/Crowdsec/v1/references/parsers/#onsuccess)"
Htmlname: "[Onsuccess](/Crowdsec/v1/references/parsers/#onsuccess)"
profiles:
htmlname: "[profiles](/Crowdsec/v1/references/profiles/)"
simulation:
htmlname: "[profiles](/Crowdsec/v1/references/simulation/)"
statics:
name: statics
Name: Statics
htmlname: "[statics](/Crowdsec/v1/references/parsers/#statics)"
Htmlname: "[Statics](/Crowdsec/v1/references/parsers/#statics)"
parsers:
name: parsers
Name: Parsers
htmlname: "[parsers](/Crowdsec/v1/getting_started/concepts/#parsers)"
Htmlname: "[Parsers](/Crowdsec/v1/getting_started/concepts/#parsers)"
scenarios:
name: scenarios
Name: Scenarios
htmlname: "[scenarios](/Crowdsec/v1/getting_started/concepts/#scenarios)"
Htmlname: "[Scenarios](/Crowdsec/v1/getting_started/concepts/#scenarios)"
collections:
name: collections
Name: Collections
htmlname: "[collections](/Crowdsec/v1/getting_started/concepts/#collections)"
Htmlname: "[Collections](/Crowdsec/v1/getting_started/concepts/#collections)"
timeMachine:
name: timeMachine
Name: TimeMachine
htmlname: "[timeMachine](/Crowdsec/v1/getting_started/concepts/#timemachine)"
Htmlname: "[TimeMachine](/Crowdsec/v1/getting_started/concepts/#timemachine)"
alert:
name: alert
Name: Alert
htmlname: "[alert](/Crowdsec/v1/getting_started/concepts/#alerts)"
Htmlname: "[Alert](/Crowdsec/v1/getting_started/concepts/#alerts)"
decision:
name: decision
Name: Decision
htmlname: "[decision](/Crowdsec/v1/getting_started/concepts/#decisions)"
Htmlname: "[Decision](/Crowdsec/v1/getting_started/concepts/#decisions)"
whitelists:
name: whitelists
Name: Whitelists
htmlname: "[whitelists](/Crowdsec/v1/write_configurations/whitelist/)"
Htmlname: "[Whitelists](/Crowdsec/v1/write_configurations/whitelist/)"
#scenario stuff
stage:
name: stage
Name: Stage
htmlname: "[stage](/Crowdsec/v1/getting_started/concepts/#stages)"
Htmlname: "[Stage](/Crowdsec/v1/getting_started/concepts/#stages)"
leakspeed:
name: leakspeed
Name: Leakspeed
htmlname: "[leakspeed](/Crowdsec/v1/references/scenarios/#leakspeed)"
Htmlname: "[Leakspeed](/Crowdsec/v1/references/scenarios/#leakspeed)"
capacity:
name: capacity
Name: Capacity
htmlname: "[capacity](/Crowdsec/v1/references/scenarios/#capacity)"
Htmlname: "[Capacity](/Crowdsec/v1/references/scenarios/#capacity)"
duration:
name: duration
Name: Duration
htmlname: "[duration](/Crowdsec/v1/references/scenarios/#duration)"
Htmlname: "[Duration](/Crowdsec/v1/references/scenarios/#duration)"
prometheus:
name: prometheus
htmlname: "[prometheus](https://github.com/prometheus/client_golang)"
api:
name: API
htmlname: "[API](TBD)"
topX:
name: topX
htmlname: "[topX](TBD)"