Skip to content

Commit bea0393

Browse files
committed
add more integrations
1 parent 01bad34 commit bea0393

File tree

6 files changed

+97
-6
lines changed

6 files changed

+97
-6
lines changed

crowdsec-docs/sidebarsUnversioned.js

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -400,6 +400,7 @@ module.exports = {
400400
"integrations/genericfirewall",
401401
"integrations/juniper",
402402
"integrations/mikrotik",
403+
"integrations/opnsense",
403404
"integrations/paloalto",
404405
"integrations/pfsense",
405406
"integrations/remediationcomponent",
1.7 MB
Loading

crowdsec-docs/unversioned/integrations/juniper.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -43,8 +43,8 @@ Once the integration is generated you will be presented with a credentials scree
4343
<ThemedImage
4444
alt="Juniper Integration Credentials Screen"
4545
sources={{
46-
light: useBaseUrl("/img/console_integrations_checkpoint_credentials_light.png"),
47-
dark: useBaseUrl("/img/console_integrations_checkpoint_credentials_dark.png"),
46+
light: useBaseUrl("/img/console_integrations_generic_credentials_light.png"),
47+
dark: useBaseUrl("/img/console_integrations_generic_credentials_dark.png"),
4848
}}
4949
/>
5050

crowdsec-docs/unversioned/integrations/mikrotik.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -43,8 +43,8 @@ Once the integration is generated you will be presented with a credentials scree
4343
<ThemedImage
4444
alt="Mikrotik Integration Credentials Screen"
4545
sources={{
46-
light: useBaseUrl("/img/console_integrations_checkpoint_credentials_light.png"),
47-
dark: useBaseUrl("/img/console_integrations_checkpoint_credentials_dark.png"),
46+
light: useBaseUrl("/img/console_integrations_generic_credentials_light.png"),
47+
dark: useBaseUrl("/img/console_integrations_generic_credentials_dark.png"),
4848
}}
4949
/>
5050

Lines changed: 88 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,88 @@
1+
---
2+
id: opnsense
3+
title: OPNsense
4+
---
5+
6+
import ThemedImage from "@theme/ThemedImage";
7+
import useBaseUrl from "@docusaurus/useBaseUrl";
8+
9+
The CrowdSec OPNsense integration allows you to block malicious IPs in your OPNsense firewall. This guide will walk you through the steps to integrate CrowdSec blocklists with your OPNsense firewall.
10+
11+
### Prerequisites
12+
13+
Before you begin, please ensure your OPNsense software version supports ingesting blocklists (URL aliases). If you are unsure, please refer to the OPNsense documentation or contact OPNsense support.
14+
15+
### Steps
16+
17+
We will presume you followed the [Getting Started](integrations/intro.mdx) guide and have created an account on the CrowdSec Console.
18+
19+
Once you are authenticated, you can proceed to the Blocklist tab located on the top menu bar, from there you can select the Integrations sub menu.
20+
21+
Once the page has loaded, you can click the "Connect" button under the OPNsense logo.
22+
23+
<ThemedImage
24+
alt="OPNsense Integration Card"
25+
sources={{
26+
light: useBaseUrl("/img/console_integrations_opnsense_card_light.png"),
27+
dark: useBaseUrl("/img/console_integrations_opnsense_card_dark.png"),
28+
}}
29+
/>
30+
31+
Doing so will prompt you to name this integration, you can name it anything you like, for example "My Integration ". Note the name should be unique per integration that is tied to your account.
32+
33+
<ThemedImage
34+
alt="OPNsense Integration Creation Screen"
35+
sources={{
36+
light: useBaseUrl("/img/console_integrations_creation_light.png"),
37+
dark: useBaseUrl("/img/console_integrations_creation_dark.png"),
38+
}}
39+
/>
40+
41+
Once the integration is generated you will be presented with a credentials screen that will provide you with the necessary information to configure your OPNsense Firewall. This information will **ONLY** be displayed once, so please ensure you copy it down.
42+
43+
<ThemedImage
44+
alt="OPNsense Integration Credentials Screen"
45+
sources={{
46+
light: useBaseUrl("/img/console_integrations_generic_credentials_light.png"),
47+
dark: useBaseUrl("/img/console_integrations_generic_credentials_dark.png"),
48+
}}
49+
/>
50+
51+
## OPNsense Configuration
52+
53+
To configure the OPNsense firewall, we will :
54+
55+
1. Create a URL alias and choose the update frequency.
56+
:::info
57+
You need to put the username and password provided by the console in the "URL" so it can use basic authentication:
58+
59+
```
60+
https://<username>:<password>@admin.api.crowdsec.net/v1/integrations/<integration_id>/content
61+
```
62+
:::
63+
64+
2. Create a firewall rule to block the malicious IPs from the CrowdSec feed alias.
65+
3. Check the alias is containing your subscribed blocklists.
66+
67+
Here is a tutorial on how to configure the OPNsense firewall with the CrowdSec Integration:
68+
69+
![](/img/opnsense.gif)
70+
71+
72+
## Format example
73+
74+
The CrowdSec blocklist will be in plain text format, with one IP address per line. Here is an example of how the blocklist will look:
75+
76+
```
77+
192.168.38.187
78+
192.168.38.186
79+
```
80+
81+
## Contribute to this documentation
82+
83+
Since CrowdSec is a community-driven project, we welcome contributions to this documentation. If you have any instructions or tips that you would like to share with the community, please feel free to open a pull request on our [GitHub repository](https://github.com/crowdsecurity/crowdsec-docs)
84+
85+
## Next Steps
86+
87+
Now that you have integrated CrowdSec integration with your OPNsense firewall, you can proceed to the [Blocklist Catalog](console/blocklists/catalog.md) to find what blocklists you can subscribe too.
88+

crowdsec-docs/unversioned/integrations/pfsense.mdx

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -43,8 +43,8 @@ Once the integration is generated you will be presented with a credentials scree
4343
<ThemedImage
4444
alt="pfSense Integration Credentials Screen"
4545
sources={{
46-
light: useBaseUrl("/img/console_integrations_checkpoint_credentials_light.png"),
47-
dark: useBaseUrl("/img/console_integrations_checkpoint_credentials_dark.png"),
46+
light: useBaseUrl("/img/console_integrations_generic_credentials_light.png"),
47+
dark: useBaseUrl("/img/console_integrations_generic_credentials_dark.png"),
4848
}}
4949
/>
5050

@@ -64,6 +64,8 @@ https://<username>:<password>@admin.api.crowdsec.net/v1/integrations/<integratio
6464
2. Check the URL alias is working.
6565
3. Create a firewall rule to block the malicious IPs.
6666

67+
Here is a tutorial on how to configure the pfSense firewall with the CrowdSec Integration:
68+
6769
![](/img/pfsense.gif)
6870

6971

0 commit comments

Comments
 (0)