From e3c75b301b8314045aff163ad8e2e27395cf98e6 Mon Sep 17 00:00:00 2001 From: Jelani Brandon Date: Fri, 10 Jan 2020 22:12:38 -0800 Subject: [PATCH] doc: Updating TLS md (#672) --- tls_protocol_version_and_ciphers.md | 20 ++++++++++++++++---- 1 file changed, 16 insertions(+), 4 deletions(-) diff --git a/tls_protocol_version_and_ciphers.md b/tls_protocol_version_and_ciphers.md index 34487582d..4db8eecd0 100644 --- a/tls_protocol_version_and_ciphers.md +++ b/tls_protocol_version_and_ciphers.md @@ -1,9 +1,21 @@ -# IoT Node SDK support for TLS 1.2 +# IoT Node SDK TLS -## TLS Version +When using the Azure IoT Node SDK in your application, you may wish to control which version of TLS is used and which ciphers are used by TLS. -The Node SDK fully supports TLS 1.2 in all of its APIs. +## How to restrict TLS version + +To restrict the TLS version one will need to set the NODE_OPTIONS environment variable to use the min version of the desired tls value + +``` +NODE_OPTIONS='--tls-min-v1.2' +``` ## TLS Cipher Suites -Coming Soon +Additionally if you would like to specify a list of ciphers can be restricted by adding a NODE_OPTIONS environment variable + +``` +NODE_OPTIONS='--tls-cipher-list=[cipher1]' +``` + +for more information see [Modifying the Default TLS Cipher suite](https://nodejs.org/api/tls.html#tls_modifying_the_default_tls_cipher_suite)