Die AWS SDK für JavaScript Version 2 hat das Ende des Supports erreicht. Wir empfehlen Ihnen, auf Version 3 zu AWS SDK für JavaScript migrieren. Weitere Einzelheiten und Informationen zur Migration finden Sie in dieser Ankündigung.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Erzwingen einer Mindestversion von TLS

Um die Sicherheit bei der Kommunikation mit AWS Diensten zu erhöhen, konfigurieren Sie das so, AWS SDK für JavaScript dass TLS 1.2 oder höher verwendet wird.

Transport Layer Security (TLS) ist ein Protokoll, das von Webbrowsern und anderen Anwendungen verwendet wird, um die Privatsphäre und Integrität der über ein Netzwerk ausgetauschten Daten zu gewährleisten.

Um Post-Quanten-Kryptografie verwenden zu können, müssen Sie zuerst TLS 1.3 aktivieren. Weitere Informationen finden Sie unter Hybrid-Post-Quantum-TLS aktivieren.

Überprüfen und erzwingen Sie TLS in Node.js

Wenn Sie with verwenden Node.js, wird die zugrunde liegende Node.js Sicherheitsebene verwendet, um die TLS-Version festzulegen. AWS SDK für JavaScript

Node.js 12.0.0 und höher verwenden eine Mindestversion von OpenSSL 1.1.1b, die TLS 1.3 unterstützt. Die AWS SDK für JavaScript Version 2 verwendet standardmäßig TLS 1.3, sofern verfügbar, verwendet jedoch standardmäßig eine niedrigere Version, falls erforderlich.

Überprüfen der Version von OpenSSL und TLS

Führen Sie den folgenden Befehl aus, um die von Node.js auf Ihrem Computer verwendete Version von OpenSSL abzurufen.

node -p process.versions

Die Version von OpenSSL in der Liste ist die von verwendete Version Node.js, wie im folgenden Beispiel gezeigt.

openssl: '1.1.1b'

Um die von Node.js auf Ihrem Computer verwendete Version von TLS abzurufen, starten Sie die Node-Shell und führen Sie die folgenden Befehle der Reihe nach aus.

> var tls = require("tls");
> var tlsSocket = new tls.TLSSocket();
> tlsSocket.getProtocol();

Der letzte Befehl gibt die TLS-Version aus, wie im folgenden Beispiel gezeigt.

'TLSv1.3'

Node.js verwendet standardmäßig diese Version von TLS und versucht, eine andere Version von TLS auszuhandeln, wenn ein Aufruf nicht erfolgreich ist.

Es werden die minimal und maximal unterstützten TLS-Versionen überprüft

Entwickler können die minimal und maximal unterstützten TLS-Versionen Node.js mithilfe des folgenden Skripts überprüfen:

var tls = require("tls");
console.log("Supported TLS versions:", tls.DEFAULT_MIN_VERSION + " to " + tls.DEFAULT_MAX_VERSION);

Der letzte Befehl gibt die standardmäßige Mindest- und Höchstversion für TLS aus, wie im folgenden Beispiel gezeigt.

Supported TLS versions: TLSv1.2 to TLSv1.3

Erzwingen einer Mindestversion von TLS

Node.js handelt eine Version von TLS aus, wenn ein Anruf fehlschlägt. Sie können während dieser Aushandlung die zulässige Mindestversion von TLS durchsetzen, entweder wenn Sie ein Skript über die Befehlszeile ausführen oder pro Anforderung in Ihrem JavaScript Code.

Um die Mindestversion von TLS über die Befehlszeile anzugeben, müssen Sie Node.js Version 11.4.0 oder höher verwenden. Um eine bestimmte Node.js Version zu installieren, installieren Sie zuerst Node Version Manager (nvm). Gehen Sie dabei wie unter Installation und Aktualisierung von Node Version Manager beschrieben vor. Führen Sie dann die folgenden Befehle aus, um eine bestimmte Version von Node.js zu installieren und zu verwenden.

nvm install 11
nvm use 11

Enforcing TLS 1.2

Um zu erzwingen, dass TLS 1.2 die minimal zulässige Version ist, geben Sie beim Ausführen des Skripts das Argument --tls-min-v1.2 an, wie im folgenden Beispiel gezeigt.

node --tls-min-v1.2 yourScript.js

Um die minimal zulässige TLS-Version für eine bestimmte Anforderung in Ihrem JavaScript Code anzugeben, verwenden Sie den httpOptions Parameter, um das Protokoll anzugeben, wie im folgenden Beispiel gezeigt.

const https = require("https");
const {NodeHttpHandler} = require("@aws-sdk/node-http-handler");
const {DynamoDBClient} = require("@aws-sdk/client-dynamodb");

const client = new DynamoDBClient({
    region: "us-west-2",
    requestHandler: new NodeHttpHandler({
        httpsAgent: new https.Agent(
            {
                secureProtocol: 'TLSv1_2_method'
            }
        )
    })
});

Enforcing TLS 1.3

Um zu erzwingen, dass TLS 1.3 die zulässige Mindestversion ist, geben Sie das --tls-min-v1.3 Argument an, wenn Sie Ihr Skript ausführen, wie im folgenden Beispiel gezeigt.

node --tls-min-v1.3 yourScript.js

Um die zulässige Mindestversion von TLS für eine bestimmte Anforderung in Ihrem JavaScript Code anzugeben, verwenden Sie den httpOptions Parameter, um das Protokoll anzugeben, wie im folgenden Beispiel gezeigt.

const https = require("https");
const {NodeHttpHandler} = require("@aws-sdk/node-http-handler");
const {DynamoDBClient} = require("@aws-sdk/client-dynamodb");

const client = new DynamoDBClient({
    region: "us-west-2",
    requestHandler: new NodeHttpHandler({
        httpsAgent: new https.Agent(
            {
                secureProtocol: 'TLSv1_3_method'
            }
        )
    })
});

Überprüfen und Erzwingen von TLS in einem Browserskript

Wenn Sie das SDK für JavaScript in einem Browserskript verwenden, steuern die Browsereinstellungen die verwendete TLS-Version. Die vom Browser verwendete Version von TLS kann nicht vom Skript erkannt oder festgelegt werden und muss vom Benutzer konfiguriert werden. Informationen zur Überprüfung und Erzwingung der in einem Browserskript verwendeten Version von TLS finden Sie in den Anweisungen für den jeweiligen Browser.

Microsoft Internet Explorer

1. Öffnen Sie den Internet Explorer.

2. Wählen Sie in der Menüleiste Extras — Internetoptionen — Registerkarte Erweitert.

3. Scrollen Sie nach unten zur Kategorie Sicherheit und aktivieren Sie manuell das Optionsfeld TLS 1.2 verwenden.

4. Klicken Sie auf OK.

5. Schließen Sie Ihren Browser und starten Sie Internet Explorer neu.

Microsoft Edge

1. Geben Sie in das Suchfeld des Windows-Menüs einInternet options.

2. Klicken Sie unter Beste Übereinstimmung auf Internetoptionen.

3. Scrollen Sie im Fenster Interneteigenschaften auf der Registerkarte Erweitert nach unten zum Abschnitt Sicherheit.

4. Markieren Sie das Kontrollkästchen User TLS 1.2.

5. Klicken Sie auf OK.

Google Chrome

1. Öffnen Sie Google Chrome.

2. Klicken Sie auf Alt F und wählen Sie Einstellungen.

3. Scrollen Sie nach unten und wählen Sie Erweiterte Einstellungen anzeigen... .

4. Scrollen Sie nach unten zum Abschnitt System und klicken Sie auf Proxyeinstellungen öffnen... .

5. Wählen Sie die Registerkarte „Erweitert“.

6. Scrollen Sie nach unten zur Kategorie Sicherheit und aktivieren Sie manuell das Optionsfeld für TLS 1.2 verwenden.

7. Klicken Sie auf OK.

8. Schließen Sie Ihren Browser und starten Sie Google Chrome neu.

Mozilla Firefox

1. Öffnen Sie Firefox.

2. Geben Sie in der Adressleiste about:config ein und drücken Sie die Eingabetaste.

3. Geben Sie im Suchfeld tls ein. Suchen Sie den Eintrag für security.tls.version.min und doppelklicken Sie darauf.

4. Setzen Sie den Ganzzahlwert auf 3, um das Protokoll von TLS 1.2 zum Standardprotokoll zu machen.

5. Klicken Sie auf OK.

6. Schließen Sie Ihren Browser und starten Sie Mozilla Firefox neu.

Apple Safari

Es gibt keine Optionen zum Aktivieren von SSL-Protokollen. Wenn Sie Safari Version 7 oder höher verwenden, wird TLS 1.2 automatisch aktiviert.