Skip to content

Commit 246f18a

Browse files
Merge pull request #211440 from JimacoMS4/update-dps-tls-doc-for-always-1.2
Fix TLS topic to note that DPS only supports TLS 1.2 and enforces both…
2 parents b280a18 + ca8d316 commit 246f18a

File tree

1 file changed

+11
-8
lines changed

1 file changed

+11
-8
lines changed

articles/iot-dps/tls-support.md

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -5,21 +5,25 @@
55
author: kgremban
66
ms.service: iot-dps
77
ms.topic: conceptual
8-
ms.date: 09/14/2020
8+
ms.date: 09/15/2022
99
ms.author: kgremban
1010
---
1111

1212
# TLS support in Azure IoT Hub Device Provisioning Service (DPS)
1313

14-
DPS uses [Transport Layer Security (TLS)](http://wikipedia.org/wiki/Transport_Layer_Security) to secure connections from IoT devices.
14+
DPS uses [Transport Layer Security (TLS)](http://wikipedia.org/wiki/Transport_Layer_Security) to secure connections from IoT devices.
1515

1616
Current TLS protocol versions supported by DPS are:
1717

1818
* TLS 1.2
1919

20-
## Restrict connections to TLS 1.2
20+
## Restrict connections to a minimum TLS version
2121

22-
For added security, it is advised to configure your DPS instances to *only* allow device client connections that use TLS version 1.2 and to enforce the use of [recommended ciphers](#recommended-ciphers).
22+
You can configure your DPS instances to *only* allow device client connections that use a minimum TLS version or greater.
23+
24+
> [!IMPORTANT]
25+
>
26+
> Currently, DPS only supports TLS 1.2, so there is no need to specify the minimum TLS version when you create a DPS instance. This feature is provided for future expansion.
2327
2428
To do this, provision a new DPS resource setting the `minTlsVersion` property to `1.2` in your Azure Resource Manager template's DPS resource specification. The following example template JSON specifies the `minTlsVersion` property for a new DPS instance.
2529

@@ -45,15 +49,15 @@ To do this, provision a new DPS resource setting the `minTlsVersion` property to
4549
}
4650
```
4751

48-
You can deploy the template with the following Azure CLI command.
52+
You can deploy the template with the following Azure CLI command.
4953

5054
```azurecli
5155
az deployment group create -g <your resource group name> --template-file template.json
5256
```
5357

5458
For more information on creating DPS resources with Resource Manager templates, see, [Set up DPS with an Azure Resource Manager template](quick-setup-auto-provision-rm.md).
5559

56-
The DPS resource created using this configuration will refuse devices that attempt to connect using TLS versions 1.0 and 1.1. Similarly, the TLS handshake will be refused if the device client's HELLO message does not list any of the [recommended ciphers](#recommended-ciphers).
60+
The DPS resource created using this configuration will refuse devices that attempt to connect using TLS versions 1.0 and 1.1.
5761

5862
> [!NOTE]
5963
> The `minTlsVersion` property is read-only and cannot be changed once your DPS resource is created. It is therefore essential that you properly test and validate that *all* your IoT devices are compatible with TLS 1.2 and the [recommended ciphers](#recommended-ciphers) in advance.
@@ -63,8 +67,7 @@ The DPS resource created using this configuration will refuse devices that attem
6367
6468
## Recommended ciphers
6569

66-
DPS instances that are configured to accept only TLS 1.2 will also enforce the use of the following cipher suites:
67-
70+
DPS instances enforce the use of the following recommended and legacy cipher suites:
6871

6972
| Recommended TLS 1.2 cipher suites |
7073
| :--- |

0 commit comments

Comments
 (0)