How to disable TLS 1.0 on an Azure App Service

TLS 1.2 - yes

Yes it is possible to disable TLS 1.0 and even 1.1 without using App Service Environment (ASE). The solution is to use Azure Application Gateway and a custom hostname.


  • 2018-04-20: I just realised a few days ago that the TLS version of an App Service can now be configured via the Portal. This means the workaround described in this post is no longer necessary. Azure App Service - SSL Settings


I like using Platform as a Service (PaaS) because it abstracts the complexities of managing the underlying layer. Of course it does incur additional cost but this is usually not a showstopper. An example of a showstopper is when there is a special need to bring forward disabling of less secure cryptography protocols. Failure which, switching to a different hosting option has to be considered!


Before jumping to the solution, I need to state that the way I am proposing is considered not supported by Azure.

What I have gathered

I know I am not alone in facing this issue and I have been Googleing monthly in search for a viable solution. As at 4th July 2017, below are points that I have found to date:

Known viable options

If you are fine with either of these:

  • Switching to Web Role on Azure Cloud Service which then allows tweaking the underlying O/S layer to do whatever.
  • Upscaling to ASE and pay a price premium.

Where and how the solution was derived

My solution involves use of Azure Application Gateway and a custom hostname over existing Web App.

The idea came after reading a comment by user Gwallace@MSFT (moderator) who stated the following comment on 18th May 2017:

Application Gateway forwards the request to the backend with the same host header it receives from the client, this is an issue with backends that are listening on a different hostname, which can be the case with WebApps.

The key bits are “same host header”.

In theory, it should work by doing the following:

  1. Custom hostname with CNAME to the gateway hostname.
  2. The gateway backend pointing to Web App, <your website>
  3. The Web App must serve content when HTTP Host header matches the custom hostname.

I had to do a few extras so I would suggest following the steps below.



You have the following:

  1. An existing Web App on App Service Plan. Free plan is a no-go as it does not allow setting custom domain.
  2. A domain name where you have control to create/update CNAME on a subdomain.
  3. To qualify for SLA, 2 or more instances of medium or larger App Gateway are required. You understand the cost additions of adding this.

Setup App Service custom domain

  1. Setup a subdomain with CNAME to <your website> Note that DNS information may take up to 24 hours to propagate.
  2. On Azure Portal, navigate to your App Service. Then go to Custom domains.
  3. Next click on Add hostname. Enter the FQDN of your subdomain and click on Validate. Azure will perform an ownership check to ensure that you are the owner of the domain by checking your subdomain’s CNAME record. Ensure this passes before proceeding!

Setup Application Gateway

  1. Add Application Gateway.
  2. You are then informed the terms to qualify for SLA. Click on Create.
  3. Standard tier is fine. Choose WAF if you prefer.
  4. The location should ideally be the same as per your App Service so that we can leverage on SSL termination.
  5. Click OK to proceed.
  6. Create a new Virtual network (or existing if you know what you are doing). You need to give a name. Address space, subnet name, and subnet address range have been prepropulated.
  7. Frontend IP address type is set to Public.
  8. Create a new Public IP address.
  9. Set protocol to HTTPS. You will need to create another listener for HTTP later (if you want this too) but I am not demonstrating that to focus on disabling specific TLS versions. Port number will automatically be set to 443. For testing purposes, I created a self-signed PFX which I will not detail as you can find plenty of tutorials elsewhere. The PFX must be password protected.
  10. Click OK to proceed. Expect up to 20 minutes for gateway to be created.
  11. Once the gateway has been created, navigate to Overview as further configuration is required.
  12. Change the CNAME of your subdomain to point to your newly created frontend public IP address, <guid>
  13. Go to Backend pools. One has already been created named appGatewayBackendPool. Click on it then add <your website> Remember to click Save.
  14. Go to Health probes. Add a new one that points to <your website> Root (/) path is fine. Click Save.
  15. Go to HTTP settings. Check Use custom probe and point to the newly created probe.
  16. Go to Backend health. Ensure that the status is Healthy otherwise you missed a step.

Disabling TLS 1.0 and 1.1

Firstly, verify the list of TLS protocol versions supported as-is. Go to Qualys SSL Labs SSL Server Test. A warning will appear if you used a self-signed certificate. Choose to proceed. You should now be seeing TLS 1.0, 1.1 and 1.2 marked Yes.

Start PowerShell and enter the following commands. Please note in the example below both TLS 1.0 and 1.1 are to be disabled. You can omit the latter if you prefer to keep it supported:

$gw = Get-AzureRmApplicationGateway -Name <your gateway name> -ResourceGroupName <your resource group>
Set-AzureRmApplicationGatewaySslPolicy -DisabledSslProtocols TLSv1_0, TLSv1_1 -ApplicationGateway $gw
$gw | Set-AzureRmApplicationGateway

Once the last command has completed, perform a new SSL test and you should now be seeing just TLS 1.2 marked Yes.