Cache Deception Armor
Before learning about Cache Deception Armor, you should first understand how Web Cache Deception attacks work.
Web Cache Deceptions attacks occur when an attacker tricks a user into opening a link in the format of http://www.example.com/newsfeed/foo.jpg
, when http://www.example.com/newsfeed
is the location of a dynamic script that returns different content for different users.
This scenario becomes problematic when your website is configured to be flexible about what kinds of paths it can handle. To be more specific, when requests to a path that do not exist, such as /x/y/z
are treated as equivalent to requests to a parent path that does exist /x
.
For example, an attacker could send a user a link to http://www.example.com/newsfeed/foo.jpg
so that the user could be taken to their newsfeed. When the request passes through Cloudflare, the request would be cached because the path ends in .jpg
. The attacker can then visit the same URL themselves, and their request will be served from Cloudflare’s cache, exposing your user’s sensitive content.
You can protect users from Web Cache Deception attacks by creating a cache rule. With this rule, you can continue to cache static assets, but the rule will verify a URL’s extension matches the returned Content-Type
.
In the newsfeed example above, if http://www.example.com/newsfeed
is a script that outputs a webpage, the Content-Type
is text/html
. On the other hand, http://www.example.com/newsfeed/foo.jpg
is expected to have image/jpeg
as Content-Type
. When a mismatch that could result in a Web Cache Deception attack is found, Cloudflare does not cache the response.
- If the returned
Content-Type
isapplication/octet-stream
, the extension does not matter because that is typically a signal to instruct the browser to save the asset instead of to display it. - Cloudflare allows
.jpg
to be served asimage/webp
or.gif
asvideo/webm
and other cases that we think are unlikely to be attacks. - Keep in mind that Cache Deception Armor depends upon Origin Cache Control. A
Cache-Control
header from the origin, Edge Cache TTL Cache Rule or Browser Cache TTL zone setting may override the protection.
To enable Cache Deception Armor, you need to start by creating a cache rule. Follow the steps below for guidance:
- Log in to your Cloudflare dashboard ↗, and select your account and domain.
- Go to Caching > Cache Rules.
- Select Create rule.
- Under When incoming requests match, define the rule expression.
- Under Then, in the Cache eligibility section, select Eligible for cache.
- Add the Cache Key setting to the rule and turn on Cache deception armor.
- To save and deploy your rule, select Deploy. If you are not ready to deploy your rule, select Save as Draft.