Le guide de API référence AWS SDK for JavaScript V3 décrit en détail toutes les API opérations de la AWS SDK for JavaScript version 3 (V3).
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Appliquer une TLS version minimale
Pour renforcer la sécurité lors de la communication avec les AWS services, configurez le AWS SDK for JavaScript pour utiliser la version TLS 1.2 ou une version ultérieure.
Important
La AWS SDK for JavaScript v3 négocie automatiquement la TLS version de plus haut niveau prise en charge par un point de terminaison de AWS service donné. Vous pouvez éventuellement appliquer une TLS version minimale requise par votre application, telle que TLS 1.2 ou 1.3, mais veuillez noter que TLS la version 1.3 n'est pas prise en charge par certains points de terminaison du AWS Service. Certains appels peuvent donc échouer si vous appliquez la version TLS 1.3.
Transport Layer Security (TLS) est un protocole utilisé par les navigateurs Web et autres applications pour garantir la confidentialité et l'intégrité des données échangées sur un réseau.
Vérifier et appliquer TLS dans Node.js
Lorsque vous utilisez le AWS SDK for JavaScript with Node.js, la couche de sécurité Node.js sous-jacente est utilisée pour définir la TLS version.
Node.js 12.0.0 et versions ultérieures utilisent une version minimale d'Open SSL 1.1.1b, compatible avec TLS la version 1.3. La AWS SDK for JavaScript version 3 utilise par défaut la version TLS 1.3 lorsqu'elle est disponible, mais utilise par défaut une version inférieure si nécessaire.
Vérifiez la version d'Open SSL and TLS
Pour obtenir la version d'Open SSL utilisée par Node.js sur votre ordinateur, exécutez la commande suivante.
node -p process.versions
La version d'Open SSL dans la liste est la version utilisée par Node.js, comme indiqué dans l'exemple suivant.
openssl: '1.1.1b'
Pour obtenir la version TLS utilisée par Node.js sur votre ordinateur, démarrez le shell Node et exécutez les commandes suivantes, dans l'ordre.
>
var tls = require("tls");>
var tlsSocket = new tls.TLSSocket();>
tlsSocket.getProtocol();
La dernière commande affiche la TLS version, comme indiqué dans l'exemple suivant.
'TLSv1.3'
Node.js utilise par défaut cette version de TLS et essaie de négocier une autre version de TLS si un appel échoue.
Appliquer une version minimale de TLS
Node.js négocie une version de TLS lorsqu'un appel échoue. Vous pouvez appliquer la TLS version minimale autorisée au cours de cette négociation, soit lors de l'exécution d'un script depuis la ligne de commande, soit par requête dans votre JavaScript code.
Pour spécifier la TLS version minimale à partir de la ligne de commande, vous devez utiliser Node.js version 11.0.0 ou ultérieure. Pour installer une version spécifique de Node.js, installez d'abord le gestionnaire de version de Node (nvm) en suivant les étapes décrites dans la section Installation et mise à jour du gestionnaire de versions de Node
nvm install 11 nvm use 11
Vérifier et appliquer TLS dans un script de navigateur
Lorsque vous utilisez le SDK formulaire JavaScript dans un script de navigateur, les paramètres du navigateur TLS contrôlent la version utilisée. La version TLS utilisée par le navigateur ne peut pas être découverte ou définie par script et doit être configurée par l'utilisateur. Pour vérifier et appliquer la version TLS utilisée dans un script de navigateur, reportez-vous aux instructions propres à votre navigateur.