Block a request


Varnish Cache allows you to create synthetic HTTP responses with the use of vcl_synth. This can be used to deliver a 403 forbidden status code. These config changes are typically made under Advanced Config -> varnish -> default.vcl for the respective branch.

If you want to block all HTTP requests and only permit HTTPS requests see also Non-HTTPS response codes .

VCL syntax

Below is an example of how to deliver a synthetic 403 response using VCL syntax 4.0. This example will deliver a 403 response if the request matches the URI path “/admin”:

sub vcl_recv {
    if (req.url ~ "/admin") {
        return (synth(803, "Forbidden"));

sub vcl_synth {
    if (resp.status == 803) {
        set resp.status = 403;
        return (deliver);

This is just an example of how to block a request using Varnish Cache. You can utilize many different patterns to block a request. E.g. check for user agents, country codes (example below), IP addresses, etc.

Blocking traffic based on GEO Region

The platform performs GEO region lookup at the Edge and sets a custom header section-io-geo-country that contains the ISO 3166-1 alpha-2 country code such as US for the United States, or AU for Australia. There are also a number of other header that are set which can be useful. See:

You can then use the section-io-geo-country header to block traffic in Varnish.

sub vcl_recv {
	if(req.http.section-io-geo-country == "XX") {
		return (synth(403, "Forbidden"));

Replace XX with the country code to block.You can block multiple countries by using | e.g.req.http.section-io-geo-country == “XX|YY|ZZ”