Domains & URLs

SSL and domain security in HubSpot

Last updated: October 20, 2020

Applies to:

Marketing Hub  Starter, Professional, Enterprise
CMS Hub  Professional, Enterprise
Legacy Marketing Hub Basic

When you connect a domain to your account, HubSpot automatically provisions a standard SAN SSL certificate through DigiCert. This usually takes a few minutes, but can take up to four hours. If you've purchased the custom SSL add-on, you can upload custom SSL certificates to HubSpot.

For each connected domain, you can also configure security settings, such as TLS version and security headers.

Please note: if you encounter any errors during the SSL provisioning process, please see HubSpot's troubleshooting guide for SSL certificate errors.

SSL

Standard SAN SSL provided through HubSpot is free and will automatically renew the certificate 30 days before the expiration date. To renew the certificate, both of the conditions must be true:

  • You are still a HubSpot customer.
  • You still have your domain CNAME pointed to the secure server which was set up in the initial process.
However, if you'd prefer to use a different provisioner or type of certificate, you can add custom SSL certificates to your account by purchasing the custom SSL add-on. You cannot use a pre-existing SSL certificate, because it would compromise the security of the certificate.

Please note: DigiCert is the certificate authority that provisions a certificate for your domain. If your domain has a Certification Authority Authorization (CAA) record, ensure digicert.com is listed so SSL can be provisioned or renewed.

Pre-provision your SSL certificate

If you're moving your existing site to HubSpot, you may want to pre-provision an SSL certificate so there's no SSL downtime. You can pre-provision an SSL certificate while connecting a domain to HubSpot.

To pre-provision an SSL certificate:

  • On the DNS Setup page of the domain connection process, a banner will appear if your site has an existing SSL certificate. Click Click here to begin the provisioning process. 

    pre-provision-ssl-certificate
  • Follow the instructions in the dialog box:
    • Log in to your DNS provider account, such as GoDaddy or Namecheap.
    • In your DNS provider, navigate to the DNS settings screen where you manage your DNS records.
    • Create new DNS records according to the dialog box using the Host (name) and Value values provided in the dialog box.

Please note: if you're using Network Solutions, Namecheap, or GoDaddy, you only need to copy everything up to and including the subdomain. Your provider will add your brand domain and top-level domain to the end of the DNS record automatically.

  • Click Verify. It can take up to four hours for your changes to process. If you get an error when clicking Verify, wait a few minutes then click Verify to check again.

Once your certificate has been pre-provisioned, a confirmation banner will appear in the domain connection screen. You can then continue connecting your domain.

ssl-pre-provision-success

Domain security settings

You can customize the security settings for each subdomain connected to HubSpot. Security settings include your website protocol (HTTP vs. HTTPS), TLS version, and your website security headers.

To update a domain's security settings:

  • In your HubSpot account, click the settings icon settings in the main navigation bar.
  • In the left sidebar menu, navigate to CMS > Domains & URLs.
  • Click Edit next to the domain, then select Update domain security settings.
update-domain-security-settings

HTTPS protocol

By default, HubSpot enables HTTPS protocol once SSL has been provisioned. This will automatically send your site visitors to the secure https version of your site, rather than the insecure http.

Once this is enabled, content loaded over HTTP, such as images and stylesheets, will not load on your site. Content loaded over HTTP on an HTTPS site is referred to as mixed content. Learn how to resolve mixed content errors on your page.

To disable HTTPS protocol, clear the Require HTTPS checkbox.


require-https


TLS version

By default, HubSpot servers will accept a connection using TLS 1.0 and above.

To change which TLS versions are supported, click the TLS version dropdown menu and select the lowest TLS version that you want to support. Connections attempting to use a TLS version lower than the minimum set will fail.

TLS-version

Security headers

Configure your domain security by enabling security header settings per domain.

HTTP Strict Transport Security (HSTS)

You can add an extra layer of security to your website by enabling HTTP Strict Transport Security (HSTS). HSTS instructs browsers to convert all HTTP requests to HTTPS requests instead. Enabling HSTS adds the HSTS header to responses for requests made to the URLs on the subdomain.

  • To enable HSTS, click the Security headers tab, then select the HTTP Strict Transport Security (HSTS) checkbox.


security-HSTS-setting

  • To set how long browsers should remember to convert HTTP to HTTPS requests, click the Duration (max-age) dropdown menu and select a duration.
  • To include the preload directive in the domain's HSTS header, select the Enable preload checkbox. Learn more about HSTS preloading.
  • To include the HSTS header in all subdomains under the selected subdomain, select the Include subdomains checkbox. For example, if HSTS is enabled for www.examplewebsite.com and the Include subdomains checkbox is selected, cool.www.examplewebsite.com will also have HSTS enabled.

Learn more about the HSTS header.

Additional domain security settings (CMS Hub Enterprise only)

If you have a CMS Hub Enterprise account, you can enable the additional security settings below.

X-Frame-Options

Enable the X-Frame-Options response header to indicate whether or not a browser can render a page in <frame>, <iframe>, <embed>, or <object> HTML tags.

To enable X-Frame-Options, select the X-Frame-Options checkbox, then select a Directive from the dropdown menu:

  • To prevent pages on your domain from being loaded on any page in the above tags, select deny.
  • To allow pages on your domain to load in the above tags across your domain only, select sameorigin.

    x-frame-options-setting

Learn more about the X-Frame-Options header.

X-XSS-Protection

Enable the X-XSS-Protection header to add a layer of security for users of older web browsers by preventing pages from loading when cross-site scripting is detected.

To enable this header, select the X-XSS-Protection checkbox, then select an XSS setting from the dropdown menu:

  •  To disable XSS filtering, select 0.
  • To remove the unsafe parts of a page when a cross-site scripting attack is detected, select 1.
  • To prevent the rendering of a page if an attack is detected, select 1; mode=block.

    x-xss-protection-header

Learn more about the X-XSS-Protection header.

X-Content-Type-Options

Enable the X-Content-Type-Options header to opt pages out of MIME type sniffing. Enabling this setting tells the browser to follow the MIME types advertised in the Content-Type headers. 

x-content-type-options

Learn more about the X-Content-Type-Options header.

Content-Security-Policy

Enable the Content-Security-Policy header to control resources that the user agent can load on a page. This header helps to prevent cross-site scripting attacks.

To enable the Content-Security-Policy header, select the Content-Security-Policy checkbox, then specify your Policy directives. For a list of available directives, check out  Mozilla's Content-Security-Policy header guide.

To allow <script> elements to execute only if they contain a nonce attribute matching the randomly-generated header value, select Enable nonce. 


content-security-policy-header

Content-Security-Policy-Report-Only

Enable the Content-Security-Policy-Report-Only header to monitor policy directives. Policy directives will not be enforced, but the effects will be monitored, which can be useful when experimenting with policies.

To enable this header, select the Content-Security-Policy-Report-Only checkbox, then enter your Policy directives

To allow <script> elements to execute only if they contain a nonce attribute matching the randomly-generated header value, select Enable nonce. 

content-security-policy-report-only-header

Learn more about the Content-Security-Policy-Report-Only header.

Referrer-Policy

Enable the Referrer-Policy header to control how much referrer information should be included with requests.

To enable this header, select the Referrer-Policy checkbox, then select a Directive from the dropdown menu.

referrer-policy-headerFor a definition of the available directives, see Mozilla's Referrer-Policy guide.

Feature-Policy

Enable the Feature-Policy header to control the use of browser features on the page, including <iframe> element content.

To enable this header, select the Feature-Policy checkbox, then enter your Directives. For a list of directives, see Mozilla's Feature-Policy guide.

feature-policy-header