📚 Documentation 💠 Hub 💬 Discourse
Bouncer for cloud firewalls to use with Crowdsec.
⚠️ This is not an official Crowdsec bouncer.
The Cloud Firewall Bouncer will periodically fetch new and expired/removed decisions from the CrowdSec Local API and update cloud firewall rules accordingly.
Supported cloud providers:
A complete step-by-step example of using the bouncer docker image with the GCP provider is available here.
You can run this bouncer using the docker image.
You will need to create the configuration file and mount it on the docker container. By default, the bouncer will look for the config at /etc/crowdsec/config.d/config.yaml but this can be overridden with the CONFIG_PATH environment variable.
First, download the latest cs-cloud-firewall-bouncer release.
1$ tar xzvf cs-cloud-firewall-bouncer.tgz2$ sudo ./install.sh
Run the following commands:
1git clone https://github.com/fallard84/cs-cloud-firewall-bouncer.git2cd cs-cloud-firewall-bouncer/3make release4tar xzvf cs-cloud-firewall-bouncer.tgz5cd cs-cloud-firewall-bouncer-v*/6sudo ./install.sh
If your bouncer run on the same machine as your crowdsec local API, you can start the service directly since the install.sh took care of the configuration.
1sudo systemctl start cs-cloud-firewall-bouncer
If you already have cs-cloud-firewall-bouncer installed as a service, please download the latest release and run the following commands to upgrade it:
1tar xzvf cs-cloud-firewall-bouncer.tgz2cd cs-cloud-firewall-bouncer-v*/3sudo ./upgrade.sh
Before starting the cs-cloud-firewall-bouncer service, please edit the configuration to add your cloud provider configuration, as well as the crowdsec local API url and key.
The default configuration file is located under : /etc/crowdsec/cs-cloud-firewall-bouncer/
1$ vim /etc/crowdsec/cs-cloud-firewall-bouncer/cs-cloud-firewall-bouncer.yaml
1cloud_providers: # 1 or more provider needs to be specified2 gcp:3 project_id: gcp-project-id # optional if using application default credentials, will override project id of the application default credentials4 network: default # mandatory. This is the VPC network where the firewall rules will be created5 priority: 0 # optional, defaults to 0 (highest priority). Additional rules will be incremented by 1.6 max_rules: 10 # optional, defaults to 10. This is the maximum number of rules to create. One GCP network firewall rule can contain at most 256 source ranges. Using the default of 10 means 2560 source ranges at most can be created. A GCP project has a default quota of 100 rules across all VPC networks. See https://cloud.google.com/vpc/docs/quota for more info.7 aws:8 region: us-east-1 # mandatory9 firewall_policy: policy-name # mandatory, this is the firewall policy which will contain the rule group. The firewall policy must exist.10 capacity: 1000 # optional, defaults to 1000. This is the capacity of the stateless rule group that the bouncer will create. A capacity of 1000 signify that the rule will contain at most 1000 source ranges. AWS has a default quota of 10,000 stateless capacity per account per region. See https://docs.aws.amazon.com/network-firewall/latest/developerguide/quotas.html for more info. This capacity is only used when the rule is being created and will not be updated afterwards.11 priority: 1 # optional, defaults to 1 (highest priority). This is the priority of the rule group in the firewall policy.12 cloudarmor:13 project_id: gcp-project-id # optional if using application default credentials, will override project id of the application14 policy: test-policy # mandatory, this is the cloud armor policy which will contain the rules. The cloud armor policy must exist.15 priority: 0 # optional, defaults to 0 (highest priority). Additional rules will be incremented by 1.16 max_rules: 100 # optional, defaults to 100. This is the maximum number of rules to create. One cloud armor rule can contain at most 10 source ranges. A GCP project has a default quota of 200 rules across all security policies. Using the default of 100 means 1000 source ranges at most can be created. See https://cloud.google.com/armor/quotas for more info.17rule_name_prefix: crowdsec # mandatory, this is the prefix for the firewall rule name(s) to create/update18update_frequency: 10s19daemonize: true20log_mode: stdout21log_dir: log/22log_level: info23api_url: <API_URL> # when install, default is "localhost:8080"24api_key: <API_KEY> # Add your API key generated with `cscli bouncers add --name <bouncer_name>`
The rule name prefix be 1-44 characters long and match the regular expression ^(?:[a-z](?:[-a-z0-9]{0,43})?)\$. The first character
must be a lowercase letter, and all following characters must be a dash, lowercase letter, or
digit. The name cannot contain two consecutive dash ('-') characters.
Authentication to GCP is done through Application Default Credentials. If using a service account, the GCP project ID will be automatically determined (using the project ID of the service account) and does not have to be specified in the configuration. If the service account resides in a different project than the VPC network/Cloud Armor policy, the GCP project ID must be overridden in the configuration.
The service account will need the following permissions:
The service account will need the following permissions:
The managed role roles/compute.securityAdmin already provides these permissions.
Authentication to AWS is done through the default credential provider chain.
The user account will need the following permissions:
The managed role NetworkFirewallManager already provides these permissions.
