{"id":171,"date":"2024-01-02T13:53:15","date_gmt":"2024-01-02T13:53:15","guid":{"rendered":"https:\/\/protocolguard.com\/resources\/?p=171"},"modified":"2024-11-20T13:46:22","modified_gmt":"2024-11-20T13:46:22","slug":"what-is-expect-ct","status":"publish","type":"post","link":"https:\/\/protocolguard.com\/resources\/what-is-expect-ct\/","title":{"rendered":"What is Expect-CT HTTP header?"},"content":{"rendered":"
<\/div>\n

Bad guys are always looking for ways to exploit websites and steal some personal data, and even more, but luckily out there exists a pretty handy tool known as Expect-CT. This is an HTTP header used to boost the security of the website you’re browsing, helping you to have a safer online experience. The name “Expect-CT” comes from “Expect Certificate Transparency”.<\/p>\n\n\n\n

So, what does Expect-CT do exactly? When your browser connects to a site, this security header ensures that the certificates, which are like the website’s digital identification tags, are not counterfeit. Basically, Expect-C will double-check every virtual handshake between your browser and the site you’re browsing, confirming that you’re interacting with the real one.<\/p>\n\n\n\n

In this article we will take a deep look into the Expect-CT header and we will make clear how it actively contributes to creating a more secure online experience for users.<\/p>\n\n\n\n\n\n\n

What is the Expect-CT HTTP header?<\/h2>\n\n\n\n

Expect-CT is a web security protocol designed to enhance the integrity of digital certificates used by websites. This is extremely important in Internet security, because certificates act as identification cards for websites, which helps your browser to trust them.<\/p>\n\n\n\n

The main function of Expect-CT is to enforce transparency in the deployment of these certificates. When your browser connects to a website, the header dictates that the presented certificates are not only valid but also have been publicly logged in recognized certificate transparency logs. These logs serve as a public record, verifying that the certificates have gone through the proper validation processes.<\/p>\n\n\n\n

Thanks to this level of transparency, Expect-CT helps to mitigate the risk of potential security threats, becoming a great security measure against malicious third parties that attempt to use counterfeit certificates to impersonate legitimate websites.<\/p>\n\n\n\n

Regarding it, Mozilla<\/a> says that “The Expect-CT header lets sites opt in to reporting and\/or enforcement of Certificate Transparency requirements.”<\/p>\n\n\n\n

The function of Expect-CT<\/h3>\n\n\n\n

Expect-CT works by requiring websites to declare their certificate transparency expectations through an HTTP header. This helps ensure that certificates are properly logged in public CT logs, minimizing the risk of unauthorized or malicious certificate issuance.<\/p>\n\n\n\n

Expect-CT has a few specific standards, let’s take a look at them.<\/p>\n\n\n\n

Enforcement through HTTP header:<\/strong><\/p>\n\n\n\n

As we have already explained, Expect-CT is implemented through an HTTP header that web servers send in their responses. This header includes information about the expected transparency behavior regarding certificates for the given domain.<\/p>\n\n\n\n

Directive and reporting:<\/strong><\/p>\n\n\n\n

The header contains a directive specifying the Certificate Transparency (CT) policy that is expected. This policy tells if the website requires that all issued certificates are logged in public CT logs.<\/p>\n\n\n\n

Websites can also include a “report-uri” parameter in the header, where it’s possible to specify a URI if the browser requires to send reports, in case it encounters certificate-related issues. This is very helpful for the monitoring and analysis of potential fake certificate incidents.<\/p>\n\n\n\n

Preloading:<\/strong><\/p>\n\n\n\n

Websites can choose to enhance their security by being “preloaded” into web browsers. This means they are included in a list of websites that require CT enforcement by default, regardless of the presence of the Expect-CT header. This is known as the HTTP Strict Transport Security (HSTS<\/a>) preload list.<\/p>\n\n\n\n

Certificate Transparency logs:<\/strong><\/p>\n\n\n\n

Certificate Transparency logs are public logs that record certificate information. When a certificate is issued, it is expected to be added to these logs by the CA. Browsers, when encountering this header, verify that the presented certificate is indeed logged in the CT logs.<\/p>\n\n\n\n

Handling violations:<\/strong><\/p>\n\n\n\n

If a browser encounters a certificate that violates the CT policy, it can take corrective actions. This may include preventing the connection or issuing a report to a specified URI.<\/p>\n\n\n\n

Expect-CT deprecation<\/h3>\n\n\n\n

Is it deprecated? Well, it is, but at the same time, it isn’t. The main concern with Expect-CT is its initial design for Chromium-based browsers. While these browsers still provide support, a significant shift occurred with Chromium version 107: Certificate Transparency (CT) is now automatically enforced, which renders the mentioned header useless. Due to this, many consider it deprecated.<\/p>\n\n\n\n

If you choose to implement it on your website, you can do so. As previously mentioned, some major browsers continue to support it. It’s important to note that deploying it alongside browsers that enforce CT by default will simply result in redundancy.<\/p>\n\n\n\n

Webtechsurvey reports that 0,22%<\/a> of websites still use it.<\/p>\n\n\n\n

Expect-CT browser support<\/h3>\n\n\n\n

As we have already mentioned, Expect-CT is a header that only works under Chromium-based browsers, so major browsers like Safari and Firefox do not support it. Others like Chrome, Edge and Opera still support it<\/a>, though.<\/p>\n\n\n\n

Google Chrome added support for it starting with version 64 in early September 2017, and was the first major browser to include it. A couple of weeks later Opera started to support it too. Finally, Microsoft Edge included support for the header in 2020, a lot later than the other two. The rest of major browsers like Apple Safari and Mozilla Firefox are not compatible with this feature.<\/p>\n\n\n\n

Expect-CT directives<\/h2>\n\n\n\n

The Expect-CT header includes a few directives that provide instructions on how the browser should handle certificate-related issues. Here are the key directives:<\/p>\n\n\n\n

“enforce” directive:<\/strong><\/p>\n\n\n\n

The enforce directive makes the browser enforce the Certificate Transparency policy for the specified host. This means that the browser will only connect to the website if the presented SSL\/TLS certificate has been properly logged in public Certificate Transparency logs.<\/p>\n\n\n\n

enforce<\/pre>\n\n\n\n
“max-age” directive:<\/strong><\/p>\n\n\n\n
The max-age directive defines the time (in seconds) for which the browser should remember the Certificate Transparency policy. During this period, the browser will continue to enforce the policy without checking the header again.<\/p>\n\n\n\n
max-age=31536000<\/pre>\n\n\n\n
“report-uri” directive:<\/strong><\/p>\n\n\n\n
The report-uri directive lets us specify a URI where the browser should send reports if it encounters certificate-related issues, such as a certificate that violates the Certificate Transparency policy.<\/p>\n\n\n\n
report-uri=\"https:\/\/domain.com\/report\"<\/pre>\n\n\n\n
“report-to” directive:<\/strong><\/p>\n\n\n\n
Similar to report-uri, the report-to directive (based on Reporting API) defines a reporting group that specifies where the browser should send the reports.<\/p>\n\n\n\n
report-to=\"group-name\"<\/pre>\n\n\n\n
Expect-CT examples<\/h2>\n\n\n\n
Now let’s see a few examples of how this header can be configured with different directives:<\/p>\n\n\n\n
Enforcing CT with a specific max-age:<\/strong> this example enforces Certificate Transparency and sets a max-age of 30 days (in seconds). Browsers will enforce the CT policy for this domain for the specified duration.<\/p>\n\n\n\n
Expect-CT: enforce, max-age=2592000<\/pre>\n\n\n\n
Enforcing CT with reporting:<\/strong> this one enforces Certificate Transparency and includes a report-uri where browsers should send reports if they encounter certificate-related issues.<\/p>\n\n\n\n
Expect-CT: enforce, report-uri=\"https:\/\/example.com\/report\"<\/pre>\n\n\n\n
Enforcing CT with the reporting API:<\/strong> in this example, Certificate Transparency is enforced and it uses the report-to directive, specifying a reporting group for more advanced reporting using the Reporting API.<\/p>\n\n\n\n
Expect-CT: enforce, report-to=\"group name\"<\/pre>\n\n\n\n
Non-enforcing directive:<\/strong> this example doesn’t enforce Certificate Transparency but includes a report-uri for monitoring purposes. Browsers will not reject connections based on CT compliance.<\/p>\n\n\n\n
Expect-CT: report-uri=\"https:\/\/domain.com\/report\"<\/pre>\n\n\n\n
Enforcing CT with a short max-age for testing:<\/strong> during testing, a short max-age can be useful. This example enforces CT and sets a max-age of 10 minutes.<\/p>\n\n\n\n
Expect-CT: enforce, max-age=600<\/pre>\n\n\n\n
How to configure Expect-CT<\/h2>\n\n\n\n
Enabling this feature in your server is pretty easy. Let’s see how to do this in popular web servers like Apache and Nginx.<\/p>\n\n\n\n
Enabling Expect-CT in Apache<\/h3>\n\n\n\n
Open your Apache configuration file (for example httpd.conf or your site’s virtual host file), you can use a text editor like nano or vim.<\/p>\n\n\n\n
Add the following line to your VirtualHost block to enable it:<\/p>\n\n\n\n
Header always set Expect-CT \"enforce, max-age=31536000, report-uri=https:\/\/example.com\/report\"<\/pre>\n\n\n\n
Remember to customize the parameters based on your specific requirements, the parameters above are just an example.<\/p>\n\n\n\n
Save the configuration file and restart Apache to apply the changes.<\/p>\n\n\n\n
systemctl restart apache2<\/pre>\n\n\n\n
Setting up Expect-CT in Nginx<\/h3>\n\n\n\n
Open your Nginx configuration file (for example nginx.conf or your domain’s .conf file).
Add the following line in your server block to enable it:<\/p>\n\n\n\n
add_header Expect-CT \"enforce, max-age=31536000, report-uri=https:\/\/example.com\/report\";<\/pre>\n\n\n\n
Don’t forget to customize the parameters based on your specific requirements, the parameters we have used are just an example.<\/p>\n\n\n\n
\"Expect-CT<\/figure>\n\n\n\n
<\/p>\n\n\n\n
Save the configuration file, test your Nginx config and restart it:<\/p>\n\n\n\n
nginx -t\nsystemctl restart nginx<\/pre>\n\n\n\n
How to configure Expect-CT on IIS<\/h3>\n\n\n\n
Let’s see how to add the Expect-CT header on the IIS webserver.<\/p>\n\n\n\n
    \n
  1. Open the IIS Manager and select the website where you want to enable the Expect-CT header.<\/li>\n\n\n\n
  2. Now access HTTP Response Headers and add a new header with the following:\n