Difference between revisions of "HTTP Strict Transport Security Cheat Sheet"

From OWASP
Jump to: navigation, search
m
(Migration to GitHub)
Line 2: Line 2:
 
<div style="width:100%;height:160px;border:0,margin:0;overflow: hidden;">[[File:Cheatsheets-header.jpg|link=]]</div>
 
<div style="width:100%;height:160px;border:0,margin:0;overflow: hidden;">[[File:Cheatsheets-header.jpg|link=]]</div>
  
{| style="padding: 0;margin:0;margin-top:10px;text-align:left;" |-
+
The Cheat Sheet Series project has been moved to [https://github.com/OWASP/CheatSheetSeries GitHub]!
| valign="top"  style="border-right: 1px dotted gray;padding-right:25px;" |
 
Last revision (mm/dd/yy): '''{{REVISIONMONTH}}/{{REVISIONDAY}}/{{REVISIONYEAR}}'''
 
__TOC__{{TOC hidden}}
 
  
= Introduction  =
+
Please visit [https://github.com/OWASP/CheatSheetSeries/blob/master/cheatsheets/HTTP_Strict_Transport_Security_Cheat_Sheet.md HTTP Strict Transport Security Cheat Sheet] to see the latest version of the cheat sheet.
 
 
HTTP Strict Transport Security (HSTS) is an opt-in security enhancement that is specified by a web application through the use of a special response header. Once a supported browser receives this header that browser will prevent any communications from being sent over HTTP to the specified domain and will instead send all communications over HTTPS. It also prevents HTTPS click through prompts on browsers.
 
 
 
The specification has been released and published end of 2012 as RFC 6797 (HTTP Strict Transport Security (HSTS)) by the IETF. (Reference see in the links at the bottom.)
 
 
 
== Threats ==
 
 
 
HSTS addresses the following threats:
 
* User bookmarks or manually types http://example.com and is subject to a man-in-the-middle attacker
 
** HSTS automatically redirects HTTP requests to HTTPS for the target domain
 
* Web application that is intended to be purely HTTPS inadvertently contains HTTP links or serves content over HTTP
 
** HSTS automatically redirects HTTP requests to HTTPS for the target domain
 
* A man-in-the-middle attacker attempts to intercept traffic from a victim user using an invalid certificate and hopes the user will accept the bad certificate
 
** HSTS does not allow a user to override the invalid certificate message
 
 
 
== Examples  ==
 
 
 
Simple example, using a long (1 year) max-age. This example is dangerous since it lacks <i>includeSubDomains</i>.
 
 
 
  Strict-Transport-Security: max-age=31536000
 
 
 
This example is useful if all present and future subdomains will be HTTPS. This is a more secure option but will block access to certain pages that can only be served over HTTP.
 
 
 
  Strict-Transport-Security: max-age=31536000; includeSubDomains
 
 
 
This example is useful if all present and future subdomains will be HTTPS. In this example we set a very short max-age in case of mistakes during initial rollout.
 
 
 
  Strict-Transport-Security: max-age=86400; includeSubDomains
 
 
 
'''Recommended:''' If the site owner would like their domain to be included in the [https://hstspreload.appspot.com/ HSTS preload list] maintained by Chrome (and used by Firefox and Safari), then use the header below. <b>Sending the preload directive from your site can have PERMANENT CONSEQUENCES and prevent users from accessing your site and any of its subdomains if you find you need to switch back to HTTP. Please read the details at hstspreload.appspot.com/#removal before sending the header with "preload".</b>
 
 
 
  Strict-Transport-Security: max-age=31536000; includeSubDomains; preload
 
 
 
The `preload` flag indicates the site owner's consent to have their domain preloaded. The site owner still needs to then go and submit the domain to the list.
 
 
 
== Problems ==
 
 
 
Site owners can use HSTS to identify users without cookies. This can lead to a significant privacy leak[http://www.leviathansecurity.com/blog/the-double-edged-sword-of-hsts-persistence-and-privacy].
 
 
 
Cookies can be manipulated from sub-domains, so omitting the "includeSubDomains" option permits a broad range of cookie-related attacks that HSTS would otherwise prevent by requiring a valid certificate for a subdomain. Ensuring the "Secure Flag" is set on all cookies will also prevent, some, but not all, of the same attacks.
 
 
 
== Browser Support ==
 
 
 
{| width="400" cellspacing="1" cellpadding="1" border="1"
 
|-
 
| '''Browser'''<br>
 
| '''Support Introduced'''<br>
 
|-
 
| Internet Explorer <br>
 
| Internet Explorer 11 on Windows 8.1 and Windows 7[http://blogs.windows.com/msedgedev/2015/06/09/http-strict-transport-security-comes-to-internet-explorer-11-on-windows-8-1-and-windows-7/]<br>
 
|-
 
| Firefox<br>
 
| 4<br>
 
|-
 
| Opera<br>
 
| 12<br>
 
|-
 
| Safari<br>
 
| Mavericks (Mac OS X 10.9)<br>
 
|-
 
| Chrome<br>
 
| 4.0.211.0<br>
 
|}
 
 
 
<br>
 
A detailed overview of supporting browsers can be found at [http://caniuse.com/#feat=stricttransportsecurity caniuse.com]. There is also a [https://badssl.com/ TLS Browser Test Page] to check whether your current browser supports HSTS.
 
 
 
== Links ==
 
* [https://hstspreload.appspot.com/ HSTS Preload Submission]
 
* [http://dev.chromium.org/sts Chromium Projects/HSTS]
 
* [http://tools.ietf.org/html/rfc6797 HSTS Spec]
 
* [http://en.wikipedia.org/wiki/HTTP_Strict_Transport_Security Wikipedia]
 
* [https://developer.mozilla.org/en/Security/HTTP_Strict_Transport_Security Mozilla Developer Network]
 
* [https://www.owasp.org/index.php/Transport_Layer_Protection_Cheat_Sheet OWASP TLS Protection Cheat Sheet]
 
* [https://developer.mozilla.org/en/Security/HTTP_Strict_Transport_Security Firefox STS Support]
 
* [http://lists.w3.org/Archives/Public/public-webapps/2009JulSep/1148.html Google Chrome STS Support]
 
* [http://www.thoughtcrime.org/software/sslstrip/ Moxie Marlinspike's Black Hat 2009 talk on sslstrip, that demonstrates why you need HSTS]
 
* [http://www.youtube.com/watch?v=zEV3HOuM_Vw&feature=youtube_gdata AppSecTutorial Series - Episode 4]
 
* [https://nmap.org/nsedoc/scripts/http-hsts-verify.html Nmap NSE script to detect HSTS configuration]
 
 
 
= Authors and Primary Editors  =
 
 
 
Til Maas<br/>
 
Jim Manico<br/>
 
Pawel Krawczyk<br/>
 
Daniel Black<br/>
 
Michael Coates<br/>
 
and others...
 
 
 
= Other Cheatsheets =
 
 
 
{{Cheatsheet_Navigation_Body}}
 
 
 
|}
 
 
 
[[Category:Cheatsheets]]
 
[[Category:OWASP Best Practices]]
 
[[Category:Control|Control]]
 

Revision as of 06:38, 14 February 2019

Cheatsheets-header.jpg

The Cheat Sheet Series project has been moved to GitHub!

Please visit HTTP Strict Transport Security Cheat Sheet to see the latest version of the cheat sheet.