Ensure 'Minimum Inbound TLS Version' is set to '1.2' or higher
Description
The TLS (Transport Layer Security) protocol secures the transmission of data over the internet using standard encryption technology. App Service deployment slots use TLS 1.2 for the Minimum Inbound TLS Version by default and allow for the use of TLS versions 1.0, 1.1, and 1.3. NIST strongly suggests the use of TLS 1.2 and recommends the adoption of TLS 1.3.
Rationale
TLS 1.0 and 1.1 are outdated and vulnerable to security risks. Since TLS 1.2 and TLS 1.3 provide enhanced security and improved performance, it is highly recommended to use TLS 1.2 or higher whenever possible.
Impact
Using the latest TLS version may affect compatibility with clients and backend services.
Audit Procedure
Using Azure Portal
- Go to
App Services. - Click the name of an app.
- Under
Deployment, clickDeployment slots. - Click the name of a deployment slot.
- Under
Settings, clickConfiguration. - In the
General settingspane, underPlatform settings, ensure thatMinimum Inbound TLS Versionis set to1.2or higher. - Repeat steps 1-6 for each app and deployment slot.
Using Azure CLI
Run the following command to list apps:
az webapp list
For each app, run the following command to list deployment slots:
az webapp deployment slot list --resource-group <resource-group-name> --name <app-name>
For each deployment slot, run the following command to get the TLS version setting:
az resource show --name web --resource-group <resource-group-name> --namespace Microsoft.Web --resource-type config --parent sites/<app-name>/slots/<deployment-slot-name> --query properties.minTlsVersion
Ensure that "1.2" or higher is returned.
Expected Result
The minTlsVersion property should return "1.2" or "1.3".
Remediation
Using Azure Portal
- Go to
App Services. - Click the name of an app.
- Under
Deployment, clickDeployment slots. - Click the name of a deployment slot.
- Under
Settings, clickConfiguration. - In the
General settingspane, underPlatform settings, click the drop-down next toMinimum Inbound TLS Versionand select1.2or higher. - Click
Save. - Click
Continue. - Repeat steps 1-8 for each app and deployment slot requiring remediation.
Using Azure CLI
For each deployment slot requiring remediation, run the following command to update the TLS version:
az resource update --name web --resource-group <resource-group-name> --namespace Microsoft.Web --resource-type config --parent sites/<app-name>/slots/<deployment-slot-name> --set properties.minTlsVersion=<1.2|1.3>
Default Value
By default, TLS version is set to 1.2.
References
- https://learn.microsoft.com/en-us/azure/app-service/configure-ssl-bindings#how-can-i-change-the-minimum-tls-versions-for-the-app
- https://learn.microsoft.com/en-us/security/benchmark/azure/mcsb-data-protection#dp-3-encrypt-sensitive-data-in-transit
- https://learn.microsoft.com/en-us/security/benchmark/azure/mcsb-network-security#ns-8-detect-and-disable-insecure-services-and-protocols
- https://learn.microsoft.com/en-us/cli/azure/webapp
- https://learn.microsoft.com/en-us/cli/azure/resource
- https://csrc.nist.gov/news/2019/nist-publishes-sp-800-52-revision-2
Profile
Level 1 | Automated