How to configure Edge Services Web Application Firewall
An Edge Services Web Application Firewall (WAF) evaluates requests to your pipeline to determine whether they are potentially malicious. You can choose the paranoia level to be used when evaluating requests, and set exclusions to define traffic that should not be filtered by WAF. Requests identified as malicious are blocked or logged depending on your settings.
This page walks you through the process of enabling and configuring WAF to protect your Edge Services pipeline.
To read more about how WAF works, refer to our Understanding WAF page.
Before you start
To complete the actions presented below, you must have:
- A Scaleway account logged into the console
- Owner status or IAM permissions allowing you to perform actions in the intended Organization
- An Edge Services pipeline
How to enable and configure WAF
-
Click Edge Services in the Network section of the Scaleway console side menu. A listing of your pipelines displays.
-
Click the name of the pipeline you want to configure WAF for, then open the Settings tab.
-
In the Web Application Firewall (WAF) panel, click Enable WAF. A configuration pop-up displays.
-
Choose the paranoia level, from 1 to 4, that best suits your use case. The higher the paranoia level, the more sensitive WAF is to potential threats, and the more likely it is to classify a request as malicious. For help with choosing a paranoia level, see our dedicated documentation.
-
Select a WAF mode. Requests judged to be malicious can either be blocked and prevented from passing to the backend, or logged but allowed to pass.
-
Click Save.
WAF is enabled and you are returned to your Edge Services pipeline overview. You can disable or edit WAF settings at any time.
How to set exclusions
Once you have enabled WAF, you can choose to set exclusions. Exclusions are a set of filters: requests that match the filters are not evaluated by WAF, and pass directly to your backend.
-
Click Edge Services in the Network section of the Scaleway console side menu. A listing of your pipelines displays.
-
Click the name of the desired pipeline, then open the Settings tab.
-
In the Web Application Firewall (WAF) panel, click + Add exclusions. A configuration pop-up displays.
-
Set up to two filters for this exclusion. You can add either:
- One Path regex filter, to match paths of requests to exclude. For example,
/api/v1/.* - One HTTP method filter, to match the HTTP methods of requests to exclude. For example, enter one or more of
GET,PATCH,PUT,DELETEetc. Requests that match any of these methods will be considered to match the HTTP method filter. - One of each of the above (use the Add filter button to add the second filter)
If you include both a path regex and an HTTP method filter in the same exclusion, requests must match both of the filters in order to be excluded.
Currently, the only action possible to set for matching requests is Bypass WAF (matching requests will not be evaluated by WAF and will proceed directly to the backend.) In the future, more actions will be added.
- One Path regex filter, to match paths of requests to exclude. For example,
-
Click Add to add the exclusion.
-
Optionally, repeat steps 3 to 5 to add more exclusions (up to 100).
-
Click Save changes to save all the exclusions you added.
How to edit exclusions
-
Click Edge Services in the Network section of the Scaleway console side menu. A listing of your pipelines displays.
-
Click the name of the desired pipeline, then open the Settings tab.
-
In the WAF panel, click edit icon next to the exclusion you want to edit.
-
Make edits to the filters as required. You cannot add more than one filter of each type (maximum of one path regex and one HTTP method filter per exclusion).
-
Click Confirm when you have finished editing.
-
Continue to edit or delete other exclusions as necessary.
-
Click Save changes to exit Edit mode and save all your changes.
How to delete exclusions
-
Click Edge Services in the Network section of the Scaleway console side menu. A listing of your pipelines displays.
-
Click the name of the desired pipeline, then open the Settings tab.
-
In the WAF panel, click Edit exclusions to enter Edit mode.
-
Click the delete icon icon next to the exclusion you want to delete.
A pop-up displays, asking you to confirm the deletion.
-
Click Delete.
-
Continue to edit or delete other exclusions as necessary.
-
Click Save changes to exit Edit mode and save all your changes and deletions.
How to edit WAF configuration
You can edit WAF's paranoia level and mode (log or block) at any time.
-
Click Edge Services in the Network section of the Scaleway console side menu. A listing of your pipelines displays.
-
Click the name of the desired pipeline, then open the Settings tab.
-
In the WAF panel, click edit icon.
-
Edit the paranoia level and mode as required.
-
Click Save.
Your edits are saved, and you are returned to the Edge Services pipeline settings.
How to disable WAF
You can disable WAF at any time.
-
Click Edge Services in the Network section of the Scaleway console side menu. A listing of your pipelines displays.
-
Click the name of the desired pipeline, then open the Settings tab.
-
In the WAF panel, click Disable WAF. A confirmation pop-up displays.
-
Click Disable to confirm.
WAF is disabled for your Edge Services pipeline.