HTTP Strict Transport Security

HTTP Strict Transport Security (HSTS) is a simple and widely supported standard to protect visitors by ensuring that their browsers always connect to a website over HTTPS. HSTS exists to remove the need for the common, insecure practice of redirecting users from http:// to https:// URLs.

When a browser knows that a domain has enabled HSTS, it does two things:

A domain instructs browsers that it has enabled HSTS by returning an HTTP header over an HTTPS connection.

In its simplest form, the policy tells a browser to enable HSTS for that exact domain or subdomain, and to remember it for a given number of seconds:

Strict-Transport-Security: max-age=31536000;

In its strongest and recommended form, the HSTS policy includes all subdomains, and indicates a willingness to be “preloaded” into browsers:

Strict-Transport-Security: max-age=31536000; includeSubDomains; preload

When using this form, bear in mind:

See below for examples of how to set an HSTS policy in common web servers.

Background

Strict Transport Security was proposed in 2009, motivated by Moxie Marlinspike’s demonstration of how a hostile network could downgrade visitor connections and exploit insecure redirects. It was quickly adopted by several major web browsers, and finalized as RFC 6797 in 2012.

The basic problem that HSTS solves is that even after a website turns on HTTPS, visitors may still end up trying to connect over plain HTTP. For example:

Websites that prefer HTTPS will generally still listen for connections over HTTP in order to redirect the user to the HTTPS URL. For example:

$ curl --head http://github.com

HTTP/1.1 301 Moved Permanently
Location: https://github.com/

This redirect is insecure and is an opportunity for an attacker to capture information about the visitor (such as cookies from a previous secure session), or to maliciously redirect the user to a phishing site.

This can be addressed by returning a Strict-Transport-Security header whenever the user connects securely. For example:

$ curl --head https://github.com

HTTP/1.1 200 OK
Strict-Transport-Security: max-age=31536000; includeSubdomains; preload

This enables HSTS for github.com. While HSTS is in effect, clicking any links to http://github.com will cause the browser to issue a request directly for https://github.com.

In the above example, the browser will remember the HSTS policy for 1 year. The policy is refreshed every time browser sees the header again, so if a user visits https://github.com at least once every year, they’ll be indefinitely protected by HSTS.

HSTS Preloading

For a user to take advantage of HSTS, their browser does have to see the HSTS header at least once. This means that users are not protected until after their first successful secure connection to a given domain.

In addition, in many cases, there may never be a first visit to https://domain.gov. For example:

In either case, https://domain.gov is never visited, meaning connecting clients will never see an HSTS policy with an includeSubDomains directive that applies to the whole zone.

To solve this problem, the Chrome security team created an “HSTS preload list”: a list of domains baked into Chrome that get Strict Transport Security enabled automatically, even for the first visit.

Firefox, Safari, Opera, and Edge also incorporate Chrome’s HSTS preload list, making this feature shared across major browsers.

How to preload a domain

The Chrome security team allows anyone to submit their domain to the list, provided it meets the following requirements:

An example of a valid HSTS header for preloading:

Strict-Transport-Security: max-age=31536000; includeSubDomains; preload

In the long term, as the web transitions fully to HTTPS and browsers can start phasing out plain HTTP and defaulting to HTTPS, the HSTS preload list (and HSTS itself) may eventually become unnecessary.

Until that time, the HSTS preload list is a simple, effective mechanism for locking down HTTPS for an entire domain.

HSTS as a forcing function

Strict Transport Security provides meaningful security benefits to visitors, especially visitors on hostile networks.

However, it’s also highly valuable as an organizational forcing function and compliance mechanism.

When a domain owner follows the recommendations in this article and sets an HSTS policy on its base domain with includeSubDomains and preload, the domain owner is saying “Every part of our web infrastructure is HTTPS, and always will be.” — and is giving browsers permission to vigorously enforce that from then onwards.

It’s a clear and auditable commitment, and gives anyone overseeing an organization’s transition to HTTPS a way of marking domains as “done”.

Zooming out even further: it’s technically possible to preload HSTS for an entire top-level domain (e.g. “.gov”), as Google first did with .google. As a relatively small, centrally managed top-level domain, perhaps someday .gov can get there.

Configuration for common web servers

On nginx, you would apply an add_header command to the appropriate virtual host configuration. This website, https.cio.gov, is hosted on nginx, and uses this batch of HTTPS rules to set this header:

add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains; preload;' always;

On Apache, you would apply a Header directive to always set the HSTS header, like so:

Header always set Strict-Transport-Security "max-age=31536000; includeSubDomains; preload"

On Microsoft systems running IIS (Internet Information Services), there are no “.htaccess” files to implement custom headers. IIS applications use a central web.config file for configuration.

For IIS 7.0 and up, the example web.config file configuration below will handle secure HTTP to HTTPS redirection with HSTS enabled for HTTPS:

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <rewrite>
            <rules>
                <rule name="HTTP to HTTPS redirect" stopProcessing="true">
                    <match url="(.*)" />
                    <conditions>
                        <add input="{HTTPS}" pattern="off" ignoreCase="true" />
                    </conditions>
                    <action type="Redirect" url="https://{HTTP_HOST}/{R:1}"
                        redirectType="Permanent" />
                </rule>
            </rules>
            <outboundRules>
                <rule name="Add Strict-Transport-Security when HTTPS" enabled="true">
                    <match serverVariable="RESPONSE_Strict_Transport_Security"
                        pattern=".*" />
                    <conditions>
                        <add input="{HTTPS}" pattern="on" ignoreCase="true" />
                    </conditions>
                    <action type="Rewrite" value="max-age=31536000; includeSubDomains; preload" />
                </rule>
            </outboundRules>
        </rewrite>
    </system.webServer>
</configuration>

Generally, you want to set a custom HTTP header for Strict-Transport-Security with the value max-age=31536000; includeSubDomains; preload (or some variant).

Here are some links to do that with other web servers:

Resources