You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: pages/edge-services/concepts.mdx
+16-9Lines changed: 16 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -29,14 +29,21 @@ The CNAME record pointing your subdomain to the Edge Services endpoint, if you h
29
29
30
30
## Edge Services
31
31
32
-
Edge Services is an additional feature for Scaleway Load Balancers and Object Storage buckets. It provides a [caching service](/edge-services/how-to/configure-cache/) to improve performance by reducing load on your [origin](#origin), and a customizable and secure [endpoint](#endpoint) for accessing content via Edge Services, which can be set to a subdomain of your choice.
32
+
Edge Services is an additional feature for Scaleway Load Balancers and Object Storage buckets. It provides:
33
+
- A [caching service](/edge-services/how-to/configure-cache/) to improve performance by reducing load on your [origin](#origin)
34
+
- A [Web Application Firewall](/edge-services/how-to/configure-waf/) to protect your origin from threats and malicious activity
35
+
- A customizable and secure [endpoint](#endpoint) for accessing content via Edge Services, which can be set to a subdomain of your choice.
33
36
34
37
## Endpoint
35
38
36
39
The endpoint from which a given Edge Services pipeline can be accessed, e.g. `https://pipeline-id.svc.edge.scw.cloud`. When a client requests content from the Edge Services endpoint, it is served by Edge Services and its cache, rather than from the origin (Object Storage bucket or Load Balancer backend servers) directly. Edge Services automatically manages redirection from HTTP to HTTPS.
37
40
38
41
The endpoint can be customized with a user-defined subdomain, allowing you to replace the standardized endpoint with the subdomain of a domain you already own, e.g. `http://my-own-domain.com`. An associated [certificate](#certificate), and [CNAME record](#cname-record) will be required, in this case.
39
42
43
+
## Exclusions
44
+
45
+
In the context of an Edge Services [Web Application Firewall](#web-application-firewall), exclusions let you define filters for requests that should not be evaluated by the WAF, but rather pass straight to the Load Balancer origin. Learn more about [creating exclusions](TODO)
46
+
40
47
## Origin
41
48
42
49
The primary source from which a Scaleway Edge Services pipeline retrieves and caches data. An origin can consist of either:
@@ -54,22 +61,22 @@ The origin host must be associated with the origin Load Balancer / its backend s
54
61
55
62
The Load Balancer defined by the user as origin for a given Edge Services pipeline. The pipeline connects to this Load Balancer, on the specified frontend port to request content.
56
63
64
+
## Paranoia level
65
+
66
+
In the context of an Edge Services [Web Application Firewall](#web-application-firewall), the paranoia level determines how sensitive the request-evaluation mechanism is to potential threats. Four paranoia levels are available, with level 1 being the least sensitive, and level 4 being the most sensitive. The higher the paranoia level, the more likely it is that a given request will be judged to be malicious. For full details on paranoia levels, see [TODO](todo).
67
+
57
68
## Pipeline
58
69
59
-
<Lightboxsrc="scaleway-edge-services-pipeline.webp"alt="A diagram shows the elements and workflow of an Edge Services pipeline. The user connects to the customizable Edge Services endpoint (with its SSL/TLS certificate), which fetches content from the Edge Services cache, which itself fetches content to cache from an origin which is either an Object Storage bucket or Load Balancer" />
70
+
<Lightboxsrc="scaleway-edge-services-pipeline.webp"alt="A diagram shows the elements and workflow of an Edge Services pipeline. The user connects to the customizable Edge Services endpoint (with its SSL/TLS certificate), which fetches content from the Edge Services cache, which itself fetches content to cache from an origin which is either an Object Storage bucket or Load Balancer. A Web Application Firewall sits between the cache and origin, protecting the origin from threats." />
60
71
61
-
An Edge Services pipeline consists of an [origin](#origin) for which Edge Services requests and [caches](#cache) content, and an [endpoint](#endpoint) from which this content is served via Edge Services. The pipeline's endpoint can be customized with a user-defined [subdomain](/domains-and-dns/concepts/#subdomain) and associated [certificate](#certificate) so that Edge Services can serve content over HTTPS.
72
+
An Edge Services pipeline consists of an [origin](#origin), which Edge Services can protect from threats with a [Web Application Firefall](#web-application-firewall), and for which it also requests and [caches](#cache) content. Each pipeline also has an [endpoint](#endpoint) from which content is accessed served via Edge Services. The pipeline's endpoint can be customized with a user-defined [subdomain](/domains-and-dns/concepts/#subdomain) and associated [certificate](#certificate) so that Edge Services can serve content over HTTPS. Edge Services can also protect
62
73
63
-
You can create an Edge Services pipeline for each of your Object Storage buckets or Load Balancer origins. Note that the cache can be enabled and disabled at will, so it is an optional part of the pipeline, as is the customization of the endpoint.
74
+
You can create an Edge Services pipeline for each of your Object Storage buckets or Load Balancer origins. Note that caching and WAF can be enabled and disabled at will, so are optional parts of the pipeline, as is the customization of the endpoint. WAF is only available for Load Balancer origins, not Object Storage buckets.
64
75
65
76
## Protocol
66
77
67
78
The protocol (HTTP or HTTPS) that the Edge Services pipeline should use when sending requests to an origin Load Balancer. HTTPS is recommended, but you should choose the protocol that corresponds with your Load Balancer setup.
68
79
69
80
## WAF
70
81
71
-
<Messagetype="note">
72
-
Edge Services WAF is currently in [Public Beta](https://www.scaleway.com/en/betas/) and available only via the [Edge Services API](https://www.scaleway.com/en/developers/api/edge-services/). It will be coming to the Scaleway console soon.
73
-
</Message>
74
-
75
-
An Edge Services **W**eb **A**pplication **F**irewall (WAF) evaluates requests to your Load Balancer origin to determine whether they are potentially malicious. You can set the paranoia level to be used when evaluating requests. Requests that are judged to be malicious are then blocked or logged, depending on the settings you choose. Find out more in our dedicated [reference documentation](/edge-services/reference-content/understanding-waf/).
82
+
An Edge Services **W**eb **A**pplication **F**irewall (WAF) evaluates requests to your origin to determine whether they are potentially malicious. You can set the [paranoia level](#paranoia-level) to be used when evaluating requests. Requests that are judged to be malicious are then blocked or logged, depending on the settings you choose. Find out more about [configuring a WAF](/edge-services/how-to/configure-waf/).
title: How to configure Edge Services Web Application Firewall
4
+
description: Learn how to configure a Web Application Firewall (WAF) for Edge Services. Protect your Load Balancer origin from threats and malicious requests, and fine tune your settings to pick the right paranoia level and exclusions for your use case.
5
+
content:
6
+
h1: How to configure Edge Services Web Application Firewall
7
+
paragraph: Learn how to configure a Web Application Firewall (WAF) for Edge Services. Protect your Load Balancer origin from threats and malicious requests, and fine tune your settings to pick the right paranoia level and exclusions for your use case.
An Edge Services **W**eb **A**pplication **F**irewall (WAF) evaluates requests to your Load Balancer origin to determine whether they are potentially malicious. You can choose the [paranoia level](/edge-services/concepts/#paranoia-level) to be used when evaluating requests, and set [exclusions](/edge-services/concepts/#exclusions) to define traffic that shouldn't be filtered by the WAF. Requests that are judged to be malicious are blocked or logged, depending on the settings you choose.
17
+
18
+
This page walks you through the processing of enabling and configuring WAF to protect your Load Balancer origin.
19
+
20
+
<Messagetype="note">
21
+
WAF is not available for Object Storage bucket origins.
22
+
</Message>
23
+
24
+
<Macroid="requirements" />
25
+
26
+
- A Scaleway account logged into the [console](https://console.scaleway.com)
27
+
-[Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
28
+
- An Edge Services pipeline for a [Load Balancer](/edge-services/how-to/create-pipeline-lb/) origin
29
+
30
+
## How to enable and configure WAF
31
+
32
+
1. In the Scaleway console, navigate to the Edge Services dashboard for the Load Balancer pipeline on which you want to enable WAF:
33
+
TODO UPDATE
34
+
<Lightboxsrc="scaleway-edge-services-dashboard.webp"alt="A screenshot of the Edge Services dashboard in the Scaleway console. This is a dashboard for Edge Services on an Object Storage bucket, showing links to the documentation, Scaleway Cockpit, the endpoint, cache settings and a button to disable the pipeline." />
35
+
36
+
2. In the **Web Application Firewall (WAF)** panel, use the <Iconname="toggle" /> icon to enable WAF.
37
+
38
+
A pop-up displays:
39
+
40
+
TODO SCREENSHOT
41
+
42
+
3. Choose the **paranoia level**, from 1 - 4, that is best adapted to your use case. The higher the paranoia level, the more sensitive WAF is to potential threats, and the more likely it is to class a request as malicious. For help with choosing a paranoia level, see our [dedicated documentation](TODO).
43
+
44
+
<Messagetype="tip">
45
+
After enabling WAF, you will be able to [set exclusions](TODO) that filter out requests matching certain criteria from being evaluated by WAF.
46
+
</Message>
47
+
48
+
4. Select a WAF **mode**. Requests judged to be malicious can either be **blocked** and prevented from passing to the Load Balancer origin, or **logged** but allowed to pass.
Copy file name to clipboardExpand all lines: pages/edge-services/index.mdx
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,15 +6,15 @@ meta:
6
6
7
7
<Alert
8
8
sentiment="info"
9
-
title="Edge Services WAF is now available via the Edge Services API!"
9
+
title="Edge Services WAF is now available!"
10
10
>
11
-
Web Application Firewall (WAF) for Edge Services is now in Public Beta and available via the [Edge Services API](https://www.scaleway.com/en/developers/api/edge-services/). Enable WAF to protect your Load Balancer origin from threats and malicious requests. Find out more in our [dedicated documentation](/edge-services/reference-content/understanding-waf/).
11
+
Edge Services now offers a Web Application Firewall (WAF) service, to protect your origin from threats and malicious requests. Find out more in our [dedicated documentation](/edge-services/how-to/configure-waf/).
12
12
</Alert>
13
13
14
14
<ProductHeader
15
15
productName="Edge Services"
16
16
productLogo="edgeServices"
17
-
description="Edge Services is a feature for Scaleway Load Balancers and Object Storage buckets. It provides a caching service to improve performance by reducing load on your origin, and a customizable, secure endpoint for accessing content via Edge Services."
17
+
description="Edge Services is a feature for Scaleway Load Balancers and Object Storage buckets. It provides a caching service to improve performance by reducing load on your origin, WAF to protect against malicious requests, and a customizable, secure endpoint for accessing content via Edge Services."
0 commit comments