This site is the archived OWASP Foundation Wiki and is no longer accepting Account Requests.
To view the new OWASP Foundation website, please visit https://owasp.org
Clickjacking Defense Cheat Sheet
Clickjacking Defense Introduction
This cheat sheet is focused on providing developer guidance on Clickjack/UI Redress attack prevention. For more information on the risk of Clickjacking, please visit this page.
The most popular way to defend against clickjacking is to include some sort of "frame-breaking" functionality which prevents other web pages from framing the site you wish to defend. This cheat sheet will discuss two methods of implementing frame-braking; via X-FRAME-OPTIONS headers (if the browser or browsers in question support it) and via javascript "frame-breaking" code.
Defending with X-FRAME-OPTIONS response headers
The X-FRAME-OPTIONS header is used to mark responses that should not be framed.
X-FRAME-OPTION Header Types
There are three types of X-FRAME-OPTIONS headers.
- The first is X-FRAME-OPTIONS DENY, which prevents any domain from framing the content.
- The second option is X-FRAME-OPTIONS SAMEORIGIN, which only allows the current site to frame the content.
- The third, is the X-FRAME-OPTIONS ALLOW-FROM 'sitename' header, which permits the specified 'sitename' to frame this page. (e.g., ALLOW-FROM http://www.foo.com) The ALLOW-FROM option is a relatively recent addition (circa 2012) and may not be supported by all browsers yet.
X-FRAME-OPTIONS DENY and SAMEORGIN has seen good adoption by major browsers.
Browser Support
- The following browsers support X-FRAME-OPTIONS headers. from http://blogs.msdn.com/b/ieinternals/archive/2010/03/30/combating-clickjacking-with-x-frame-options.aspx)
- IE8+
- Opera 10.50+
- Safari 4+
- Chrome 4.1.249.1042+
- Firefox 3.6.9 (or earlier with NoScript)
Implementation
To implement this protection, you need to add the header to any page that you want to protect from being clickjacked. One way to do this is to add the header manually to every page. A possibly simpler way is to implement a filter that automatically adds the header to every page.
Defending legacy browsers
The following methodology will prevent a webpage from being framed even in legacy browsers.
In the document HEAD element, add the following:
First apply an ID to the style element itself:
<style id="antiClickjack">body{display:none !important;}</style>
And then delete that style by its ID immediately after in the script:
<script type="text/javascript"> if (self === top) { var antiClickjack = document.getElementById("antiClickjack"); antiClickjack.parentNode.removeChild(antiClickjack); } else { top.location = self.location; } </script>
This way, everything can be in the document HEAD and you only need one method/taglib in your API.
References
- Main OWASP https://www.owasp.org/index.php/Clickjacking page.
- OWASP has an article and some code that provides all the details for implementing this in the Java EE environment.
- The SDL blog has posted an article covering how to implement this in a .NET environment.
- In 2009, Microsoft implemented a header based defense in IE8 that allows developers to specify that pages should not be framed.
- Legacy browser Clickjacking defense from August Detlefsen and Jason Li: https://www.codemagi.com/blog/post/194.
OWASP Cheat Sheets Project Homepage