Das [AWS SDK für JavaScript V3-API-Referenzhandbuch](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/) beschreibt detailliert alle API-Operationen für die AWS SDK für JavaScript Version 3 (V3).
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.
# Konfigurieren Sie das SDK für JavaScript
Bevor Sie das SDK JavaScript zum Aufrufen von Webdiensten mithilfe der API verwenden, müssen Sie das SDK konfigurieren. Sie müssen mindestens Folgendes konfigurieren:
+ Die AWS Region, in der Sie Dienste anfordern werden
+ Wie authentifiziert sich Ihr Code mit AWS
Zusätzlich zu diesen Einstellungen müssen Sie möglicherweise auch Berechtigungen für Ihre AWS Ressourcen konfigurieren. Sie können beispielsweise den Zugriff auf einen Amazon S3 S3-Bucket oder den Lesezugriff auf eine Amazon DynamoDB-Tabelle einschränken.
Das [AWS SDKs Referenzhandbuch zu Tools](https://docs.aws.amazon.com/sdkref/latest/guide/) enthält auch Einstellungen, Funktionen und andere grundlegende Konzepte, die vielen von ihnen gemeinsam sind. AWS SDKs
In den Themen dieses Abschnitts wird beschrieben, wie Sie das SDK JavaScript für Node.js konfigurieren und in einem Webbrowser JavaScript ausführen können.
**Topics**
+ [Konfiguration pro Dienst](global-config-object.md)
+ [Legen Sie die Region fest AWS](setting-region.md)
+ [Legen Sie die Anmeldeinformationen fest](setting-credentials.md)
+ [Überlegungen zu Node.js](node-js-considerations.md)
+ [Überlegungen zum Browser-Skript](browser-js-considerations.md)
# Konfiguration pro Dienst
Sie können das SDK konfigurieren, indem Sie Konfigurationsinformationen an ein Serviceobjekt übergeben.
Die Konfiguration auf Dienstebene bietet umfassende Kontrolle über einzelne Dienste und ermöglicht es Ihnen, die Konfiguration einzelner Dienstobjekte zu aktualisieren, wenn Ihre Anforderungen von der Standardkonfiguration abweichen.
**Anmerkung**
In Version 2.x konnte die AWS SDK für JavaScript Dienstkonfiguration an einzelne Client-Konstruktoren übergeben werden. Diese Konfigurationen würden jedoch zunächst automatisch zu einer Kopie der globalen SDK-Konfiguration zusammengeführt. `AWS.config`
Außerdem wird `AWS.config.update({/* params *})` nur die aktualisierte Konfiguration für Service-Clients aufgerufen, die nach dem Aktualisierungsaufruf instanziiert wurden, nicht für bestehende Clients.
Dieses Verhalten sorgte häufig für Verwirrung und erschwerte es, dem globalen Objekt eine Konfiguration hinzuzufügen, die sich auf vorwärtskompatible Weise nur auf eine Teilmenge von Service-Clients auswirkt. In Version 3 gibt es keine globale Konfiguration mehr, die vom SDK verwaltet wird. Die Konfiguration muss an jeden Service-Client übergeben werden, der instanziiert wird. Es ist immer noch möglich, dieselbe Konfiguration für mehrere Clients gemeinsam zu verwenden, aber diese Konfiguration wird nicht automatisch mit einem globalen Status zusammengeführt.
## Legen Sie die Konfiguration pro Dienst fest
Auf jeden Dienst, den Sie im SDK verwenden, JavaScript wird über ein Dienstobjekt zugegriffen, das Teil der API für diesen Dienst ist. Um beispielsweise auf den Amazon S3 S3-Service zuzugreifen, erstellen Sie das Amazon S3 S3-Serviceobjekt. Sie können für einen bestimmten Service Konfigurationseinstellungen als Teil des Konstruktors für dieses Serviceobjekt definieren.
Wenn Sie beispielsweise auf Amazon EC2-Objekte in mehreren AWS Regionen zugreifen müssen, erstellen Sie ein Amazon EC2-Serviceobjekt für jede Region und legen Sie dann die Regionskonfiguration für jedes Serviceobjekt entsprechend fest.
```
var ec2_regionA = new EC2({region: 'ap-southeast-2', maxAttempts: 15});
var ec2_regionB = new EC2({region: 'us-west-2', maxAttempts: 15});
```
# Legen Sie die Region fest AWS
Eine AWS Region ist eine benannte Gruppe von AWS Ressourcen in demselben geografischen Gebiet. Ein Beispiel für eine Region ist `us-east-1` die Region USA Ost (Nord-Virginia). Sie geben eine Region an, wenn Sie einen Service-Client im SDK für erstellen, JavaScript sodass das SDK auf den Service in dieser Region zugreift. Einige -Services werden nur in bestimmten Regionen angeboten.
Das SDK für wählt standardmäßig JavaScript keine Region aus. Sie können die AWS Region jedoch mithilfe einer Umgebungsvariablen oder einer gemeinsam genutzten `config` Konfigurationsdatei festlegen.
## In einem Client-Klassenkonstruktor
Wenn Sie ein Serviceobjekt instanziieren, können Sie die AWS Region für diese Ressource als Teil des Client-Klassenkonstruktors angeben, wie hier gezeigt.
```
const s3Client = new S3.S3Client({region: 'us-west-2'});
```
## Verwenden Sie eine Umgebungsvariable
Sie können die Region mithilfe der Umgebungsvariablen `AWS_REGION` festlegen. Wenn Sie diese Variable definieren, JavaScript liest das SDK für sie und verwendet sie.
## Verwenden Sie eine gemeinsam genutzte Konfigurationsdatei
So wie Sie mit der Datei mit gemeinsam genutzten Anmeldeinformationen Anmeldeinformationen für das SDK speichern können, können Sie Ihre AWS Region und andere Konfigurationseinstellungen in einer gemeinsam genutzten Datei speichern, die `config` nach dem zu verwendenden SDK benannt ist. Wenn die `AWS_SDK_LOAD_CONFIG` Umgebungsvariable auf einen wahrheitsgemäßen Wert gesetzt ist, sucht das SDK für beim Laden JavaScript automatisch nach einer `config` Datei. Wo Sie die `config`-Datei speichern, hängt von Ihrem Betriebssystem ab:
+ Linux-, MacOS- oder Unix-Benutzer - `~/.aws/config`
+ Windows-Benutzer - `C:\Users\USER_NAME\.aws\config`
Wenn Sie noch keine freigegebene `config`-Datei haben, können Sie diese in dem angegebenen Verzeichnis erstellen. Im folgenden Beispiel werden sowohl die Region als auch das Ausgabeformat über die `config`-Datei definiert.
```
[default]
region=us-west-2
output=json
```
Weitere Informationen zur Verwendung von `credentials` Dateien `config` und gemeinsam genutzten Dateien finden Sie unter Dateien [mit gemeinsam genutzten Konfigurationen und Anmeldeinformationen](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) im *AWS SDKs Referenzhandbuch für Tools*.
## Reihenfolge der Festlegung der Region
Im Folgenden finden Sie die Rangfolge für die Einstellung der Region:
1. Wenn eine Region an einen Client-Klassenkonstruktor übergeben wird, wird diese Region verwendet.
1. Wenn in der Umgebungsvariablen eine Region festgelegt ist, wird diese Region verwendet.
1. Andernfalls wird die in der gemeinsam genutzten Konfigurationsdatei definierte Region verwendet.
# Legen Sie die Anmeldeinformationen fest
AWS verwendet Anmeldeinformationen, um festzustellen, wer Dienste anruft und ob der Zugriff auf die angeforderten Ressourcen zulässig ist.
Unabhängig davon, ob Ihr JavaScript Code in einem Webbrowser oder auf einem Node.js -Server ausgeführt wird, muss er gültige Anmeldeinformationen erhalten, bevor er über die API auf Dienste zugreifen kann. Anmeldeinformationen können pro Dienst festgelegt werden, indem Anmeldeinformationen direkt an ein Dienstobjekt übergeben werden.
Es gibt mehrere Möglichkeiten, Anmeldeinformationen festzulegen, die sich in Node.js und JavaScript in Webbrowsern unterscheiden. Die Themen in diesem Abschnitt beschreiben, wie Sie die Anmeldeinformationen in Node.js oder Web-Browsern definieren. In jedem Fall werden die Optionen in der empfohlenen Reihenfolge dargestellt.
## Bewährte Methoden für Anmeldeinformationen
Durch das ordnungsgemäße Festlegen von Anmeldeinformationen wird sichergestellt, dass Ihre Anwendung oder Ihr Browser-Skript auf die benötigten Services und Ressourcen zugreifen kann. Gleichzeitig werden Sicherheitsrisiken minimiert, die geschäftskritische Anwendungen beeinträchtigen oder vertrauliche Daten kompromittieren könnten.
Ein wichtiger Grundsatz beim Einrichten von Anmeldeinformationen lautet, immer nur die geringstmöglichen Berechtigungen zu erteilen, die für eine Aufgabe erforderlich sind. Es ist sicherer, minimale Berechtigungen für Ihre Ressourcen bereitzustellen und bei Bedarf weitere Berechtigungen hinzuzufügen, anstatt Berechtigungen bereitzustellen, die die geringsten Rechte überschreiten, und aufgrund dessen zu einem späteren Zeitpunkt möglicherweise Sicherheitsprobleme beheben zu müssen. Wenn Sie beispielsweise nicht einzelne Ressourcen lesen und schreiben müssen, z. B. Objekte in einem Amazon S3 S3-Bucket oder einer DynamoDB-Tabelle, legen Sie für diese Berechtigungen nur Lesen fest.
Weitere Informationen zur Gewährung der geringsten Rechte finden Sie im Abschnitt [Geringste Rechte gewähren](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#grant-least-privilege) des Themas Best Practices im *IAM-Benutzerhandbuch*.
**Topics**
+ [Bewährte Methoden für Anmeldeinformationen](#credentials-best-practices)
+ [Legen Sie die Anmeldeinformationen in Node.js fest](setting-credentials-node.md)
+ [Anmeldeinformationen in einem Webbrowser einrichten](setting-credentials-browser.md)
# Legen Sie die Anmeldeinformationen in Node.js fest
Wir empfehlen neuen Benutzern, die sich lokal weiterentwickeln und von ihrem Arbeitgeber keine Authentifizierungsmethode erhalten, zur Einrichtung AWS IAM Identity Center. Weitere Informationen finden Sie unter [SDK-Authentifizierung mit AWS](getting-your-credentials.md).
Es gibt mehrere Möglichkeiten in Node.js, um dem SDK die Anmeldeinformationen bereitzustellen. Einige davon sind sicherer und andere bieten eine höhere Benutzerfreundlichkeit bei der Anwendungsentwicklung. Achten Sie beim Abrufen von Anmeldeinformationen in Node.js darauf, dass Sie sich nicht auf mehr als eine Quelle verlassen, z. B. auf eine Umgebungsvariable und eine JSON-Datei, die Sie laden. Sie können die Berechtigungen, unter denen Ihr Code ausgeführt wird, ändern, ohne sich dieser Änderung bewusst zu sein.
AWS SDK für JavaScript V3 stellt in Node.js eine standardmäßige Anbieterkette für Anmeldeinformationen bereit, sodass Sie nicht explizit einen Anmeldeinformationsanbieter angeben müssen. Die standardmäßige [Anbieterkette für Anmeldeinformationen](https://docs.aws.amazon.com/sdkref/latest/guide/standardized-credentials.html#credentialProviderChain) versucht, die Anmeldeinformationen aus einer Vielzahl verschiedener Quellen in einer bestimmten Rangfolge aufzulösen, bis Anmeldeinformationen aus einer der Quellen zurückgegeben werden. [Die Anmeldeinformationsanbieterkette für SDK für V3 finden Sie hier. JavaScript ](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-credential-providers/#fromnodeproviderchain)
## Kette der Anbieter von Anmeldeinformationen
Alle SDKs haben eine Reihe von Stellen (oder Quellen), die sie überprüfen, um gültige Anmeldeinformationen zu erhalten, mit denen eine Anfrage an AWS-Service einen gestellt werden kann. Nachdem gültige Anmeldeinformationen gefunden wurden, wird die Suche beendet. Diese systematische Suche wird als Standardanbieterkette für Anmeldeinformationen bezeichnet.
Für jeden Schritt in der Kette gibt es unterschiedliche Möglichkeiten, die Werte festzulegen. Das Setzen von Werten direkt im Code hat immer Vorrang, gefolgt von der Einstellung als Umgebungsvariablen und dann in der gemeinsam genutzten AWS `config` Datei. Weitere Informationen finden Sie unter [Priorität der Einstellungen](https://docs.aws.amazon.com/sdkref/latest/guide/settings-reference.html#precedenceOfSettings) im Referenzhandbuch *AWS SDKs und im Tools-Referenzhandbuch.*
Das *Referenzhandbuch AWS SDKs und die Tools* enthalten Informationen zu den SDK-Konfigurationseinstellungen, die von allen verwendet werden, AWS SDKs und zu den AWS CLI. Weitere Informationen zur Konfiguration des SDK mithilfe der gemeinsam genutzten AWS `config` Datei finden Sie unter Gemeinsam genutzte Konfigurations [- und Anmeldeinformationsdateien](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html). Weitere Informationen zur Konfiguration des SDK durch das Setzen von Umgebungsvariablen finden Sie unter [Unterstützung von Umgebungsvariablen](https://docs.aws.amazon.com/sdkref/latest/guide/environment-variables.html).
Für die Authentifizierung werden AWS die Anbieter der Anmeldeinformationen in der in der folgenden Tabelle angegebenen Reihenfolge AWS SDK für JavaScript überprüft.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/sdk-for-javascript/v3/developer-guide/setting-credentials-node.html)
Wenn Sie für den Einstieg den empfohlenen Ansatz für neue Benutzer befolgt haben, richten Sie die AWS IAM Identity Center Authentifizierung während [SDK-Authentifizierung mit AWS](getting-your-credentials.md) des Themas Erste Schritte ein. Andere Authentifizierungsmethoden sind in verschiedenen Situationen nützlich. Um Sicherheitsrisiken zu vermeiden, empfehlen wir, immer kurzfristige Anmeldeinformationen zu verwenden. Informationen zu anderen Authentifizierungsmethoden finden Sie unter [Authentifizierung und Zugriff](https://docs.aws.amazon.com/sdkref/latest/guide/access.html) im *AWS SDKs Referenzhandbuch zu Tools*.
Die Themen in diesem Abschnitt beschreiben, wie Sie die Anmeldeinformationen in Node.js laden.
**Topics**
+ [Kette der Anbieter von Anmeldeinformationen](#credchain)
+ [Anmeldeinformationen in Node.js aus IAM-Rollen für Amazon EC2 laden](loading-node-credentials-iam.md)
+ [Anmeldeinformationen für eine Lambda-Funktion von Node.js laden](loading-node-credentials-lambda.md)
# Anmeldeinformationen in Node.js aus IAM-Rollen für Amazon EC2 laden
Wenn Sie Ihre Anwendung Node.js auf einer Amazon EC2-Instance ausführen, können Sie IAM-Rollen für Amazon EC2 nutzen, um automatisch Anmeldeinformationen für die Instance bereitzustellen. Wenn Sie Ihre Instance für die Verwendung von IAM-Rollen konfigurieren, wählt das SDK automatisch die IAM-Anmeldeinformationen für Ihre Anwendung aus, sodass Sie keine Anmeldeinformationen manuell angeben müssen.
Weitere Informationen zum Hinzufügen von IAM-Rollen zu einer Amazon EC2-Instance finden Sie unter [IAM-Rollen für](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html) Amazon EC2.
# Anmeldeinformationen für eine Lambda-Funktion von Node.js laden
Wenn Sie eine AWS Lambda Funktion erstellen, müssen Sie eine spezielle IAM-Rolle erstellen, die über die Berechtigung zum Ausführen der Funktion verfügt. Diese Rolle wird *Ausführungsrolle* genannt. Wenn Sie eine Lambda-Funktion einrichten, müssen Sie die von Ihnen erstellte IAM-Rolle als entsprechende Ausführungsrolle angeben.
Die Ausführungsrolle stellt der Lambda-Funktion die Anmeldeinformationen zur Verfügung, die sie zum Ausführen und Aufrufen anderer Webdienste benötigt. Daher müssen Sie keine Anmeldeinformationen für den Code Node.js angeben, den Sie in einer Lambda-Funktion schreiben.
Weitere Informationen zum Erstellen einer Lambda-Ausführungsrolle finden Sie unter [Berechtigungen verwalten: Verwenden einer IAM-Rolle (Ausführungsrolle)](https://docs.aws.amazon.com/lambda/latest/dg/intro-permission-model.html#lambda-intro-execution-role) im *AWS Lambda Entwicklerhandbuch*.
# Anmeldeinformationen in einem Webbrowser einrichten
Es gibt mehrere Möglichkeiten, um dem SDK die Anmeldeinformationen aus Browser-Skripts bereitzustellen. Einige davon sind sicherer und andere bieten eine höhere Benutzerfreundlichkeit bei der Entwicklung eines Skripts.
So können Sie Ihre Anmeldeinformationen in der Reihenfolge ihrer Empfehlungen angeben:
1. Verwenden von Amazon Cognito Identity zur Benutzerauthentifizierung und Bereitstellung von Anmeldeinformationen
1. Verwenden von Web-Verbundidentitäten
**Warnung**
Wir empfehlen nicht, Ihre AWS Anmeldeinformationen in Ihren Skripten fest zu codieren. Die Hartcodierung der Anmeldeinformationen setzt die Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel dem Risiko einer Offenlegung aus.
**Topics**
+ [Verwenden Sie Amazon Cognito Identity, um Benutzer zu authentifizieren](loading-browser-credentials-cognito.md)
# Verwenden Sie Amazon Cognito Identity, um Benutzer zu authentifizieren
Die empfohlene Methode zum Abrufen von AWS Anmeldeinformationen für Ihre Browserskripte ist die Verwendung des Amazon Cognito Identity-Anmeldeinformationsclients`CognitoIdentityClient`. Amazon Cognito ermöglicht die Authentifizierung von Benutzern über externe Identitätsanbieter.
Um Amazon Cognito Identity verwenden zu können, müssen Sie zunächst einen Identitätspool in der Amazon Cognito Cognito-Konsole erstellen. Ein Identitäten-Pool stellt die Gruppe von Identitäten dar, die Ihre Anwendung für Ihre Benutzer bereitstellt. Die den Benutzern zugewiesenen Identitäten identifizieren jedes Benutzerkonto eindeutig. Amazon-Cognito-Identitäten sind keine Anmeldeinformationen. Sie werden mithilfe der Unterstützung von Web Identity Federation in AWS -Security-Token-Service (AWS STS) gegen Anmeldeinformationen ausgetauscht.
Amazon Cognito unterstützt Sie bei der Verwaltung der Abstraktion von Identitäten über mehrere Identitätsanbieter hinweg. Die geladene Identität wird dann gegen Anmeldeinformationen in AWS STS ausgetauscht.
## Konfigurieren Sie das Amazon Cognito Identity-Anmeldeinformationsobjekt
Wenn Sie noch keinen erstellt haben, erstellen Sie einen Identitätspool, den Sie mit Ihren Browserskripten in der [Amazon Cognito Cognito-Konsole](https://console.aws.amazon.com/cognito) verwenden können, bevor Sie Ihren Amazon Cognito Cognito-Client konfigurieren. Erstellen Sie sowohl authentifizierte als auch nicht authentifizierte IAM-Rollen für Ihren Identitätspool und ordnen Sie sie zu. Weitere Informationen finden Sie unter [Tutorial: Einen Identitätspool erstellen](https://docs.aws.amazon.com/cognito/latest/developerguide/tutorial-create-identity-pool.html) im *Amazon Cognito Developer Guide*.
Bei nicht authentifizierten Benutzern wird die Identität nicht verifiziert, sodass diese Rolle für Gastbenutzer Ihrer App oder für Fälle geeignet ist, in denen es egal ist, ob die Identität der Benutzer verifiziert wurde. Authentifizierte Benutzer melden sich bei Ihrer Anwendung über einen Drittanbieter an, der ihre Identität überprüft. Vergewissern Sie sich, dass Sie die Berechtigungen der Ressourcen entsprechend anpassen, damit Sie keinen Zugriff von nicht authentifizierten Benutzern darauf gewähren.
Nachdem Sie einen Identitätspool konfiguriert haben, verwenden Sie die `fromCognitoIdentityPool` Methode von, `@aws-sdk/credential-providers` um die Anmeldeinformationen aus dem Identitätspool abzurufen. Ersetzen Sie im folgenden Beispiel für die Erstellung eines Amazon S3 S3-Clients *AWS\$1REGION* durch die Region und *IDENTITY\$1POOL\$1ID* die Identitätspool-ID.
```
// Import required AWS SDK clients and command for Node.js
import {S3Client} from "@aws-sdk/client-s3";
import {fromCognitoIdentityPool} from "@aws-sdk/credential-providers";
const REGION = AWS_REGION;
const s3Client = new S3Client({
region: REGION,
credentials: fromCognitoIdentityPool({
clientConfig: { region: REGION }, // Configure the underlying CognitoIdentityClient.
identityPoolId: 'IDENTITY_POOL_ID',
logins: {
// Optional tokens, used for authenticated login.
},
})
});
```
Die optionale `logins`-Eigenschaft ist eine Abbildung der Namen des Identitätsanbieters auf die Identitäts-Token für diese Anbieter. Wie Sie den Token von Ihrem Identitätsanbieter erhalten, hängt davon ab, welchen Anbieter Sie verwenden. Wenn Sie beispielsweise einen Amazon Cognito Cognito-Benutzerpool als Authentifizierungsanbieter verwenden, könnten Sie eine Methode verwenden, die der folgenden ähnelt.
```
// Get the Amazon Cognito ID token for the user. 'getToken()' below.
let idToken = getToken();
let COGNITO_ID = "COGNITO_ID"; // 'COGNITO_ID' has the format 'cognito-idp.REGION.amazonaws.com/COGNITO_USER_POOL_ID'
let loginData = {
[COGNITO_ID]: idToken,
};
const s3Client = new S3Client({
region: REGION,
credentials: fromCognitoIdentityPool({
clientConfig: { region: REGION }, // Configure the underlying CognitoIdentityClient.
identityPoolId: 'IDENTITY_POOL_ID',
logins: loginData
})
});
// Strips the token ID from the URL after authentication.
window.getToken = function () {
var idtoken = window.location.href;
var idtoken1 = idtoken.split("=")[1];
var idtoken2 = idtoken1.split("&")[0];
var idtoken3 = idtoken2.split("&")[0];
return idtoken3;
};
```
## Wechseln Sie zwischen nicht authentifizierten Benutzern und authentifizierten Benutzern
Amazon Cognito unterstützt sowohl authentifizierte als auch nicht authentifizierte Benutzer. Nicht authentifizierte Benutzer erhalten Zugriff auf Ihre Ressourcen, auch wenn sie nicht über Ihre Identitätsanbieter angemeldet sind. Dieser Grad des Zugriffs ist nützlich, um Inhalte für Benutzer anzuzeigen, bevor diese sich anmelden. Jeder nicht authentifizierte Benutzer hat eine eindeutige Identität in Amazon Cognito, obwohl er nicht einzeln angemeldet und authentifiziert wurde.
### Anfänglich nicht authentifizierter Benutzer
Benutzer beginnen in der Regel mit der nicht authentifizierten Rolle, für die Sie die Eigenschaft für die Anmeldeinformationen Ihres Konfigurationsobjekts ohne eine `logins`-Eigenschaft festlegen. In diesem Fall könnten Ihre Standardanmeldedaten wie folgt aussehen:
```
// Import the required AWS SDK für JavaScript v3 modules.
import {fromCognitoIdentityPool} from "@aws-sdk/credential-providers";
// Set the default credentials.
const creds = fromCognitoIdentityPool({
identityPoolId: 'IDENTITY_POOL_ID',
clientConfig: { region: REGION } // Configure the underlying CognitoIdentityClient.
});
```
### Wechseln Sie zum authentifizierten Benutzer
Wenn sich ein nicht authentifizierter Benutzer bei einem Identitätsanbieter anmeldet und Sie über ein Token verfügen, können Sie den Benutzer von nicht authentifiziert auf authentifiziert umstellen, indem Sie eine benutzerdefinierte Funktion aufrufen, die das Anmeldeinformationsobjekt aktualisiert und das Token hinzufügt. `logins`
```
// Called when an identity provider has a token for a logged in user
function userLoggedIn(providerName, token) {
creds.params.Logins = creds.params.logins || {};
creds.params.Logins[providerName] = token;
// Expire credentials to refresh them on the next request
creds.expired = true;
}
```
# Überlegungen zu Node.js
Der Code Node.js ist es zwar JavaScript, aber die Verwendung von AWS SDK für JavaScript in Node.js kann sich von der Verwendung des SDK in Browserskripts unterscheiden. Einige API-Methoden funktionieren in Node.js, jedoch nicht in Browser-Skripts und umgekehrt. Und die erfolgreiche Verwendung einiger Module APIs hängt davon ab, ob Sie mit den gängigen Node.js -Codierungsmustern vertraut sind, z. B. mit dem Import und der Verwendung anderer Node.js -Module wie dem `File System (fs)` Modul.
**Anmerkung**
AWS empfiehlt die Verwendung der Active LTS-Version von Node.js für die Entwicklung.
## Verwenden Sie die integrierten Node.js -Module
Node.js bietet eine Reihe von integrierten Modulen, die Sie verwenden können ohne sie installieren zu müssen. Um diese Module verwenden zu können, müssen Sie ein Objekt mit der `require`-Methode erstellen und den Modulnamen angeben. Wenn beispielsweise das integrierte HTTP-Modul enthalten sein soll, geben Sie Folgendes ein.
```
import http from 'http';
```
Rufen Sie Methoden des Moduls ab, als würde es sich um Methoden dieses Objekts handeln. Das folgende Beispiel zeigt Code, der eine HTML-Datei liest.
```
// include File System module
import fs from "fs";
// Invoke readFile method
fs.readFile('index.html', function(err, data) {
if (err) {
throw err;
} else {
// Successful file read
}
});
```
Eine vollständige Liste aller integrierten Module, die Node.js bereitstellt, finden Sie in der [Node.js -Dokumentation](https://nodejs.org/api/modules.html) auf der Website Node.js.
## Verwenden Sie npm-Pakete
Zusätzlich zu den integrierten Modulen können Sie auch Code von Drittanbietern aus dem `npm` Paketmanager Node.js einbinden und integrieren. Hierbei handelt es sich um ein Repository mit Open-Source-Node.js-Paketen sowie um eine Befehlszeilen-Schnittstelle für die Installation dieser Pakete. Weitere Informationen zu `npm` und eine Liste der derzeit verfügbaren Pakete finden Sie unter [ https://www.npmjs.com](https://www.npmjs.com). Weitere Informationen zu den zusätzlichen Paketen von Node.js, die Sie verwenden können, finden Sie [hier auf GitHub](https://github.com/sindresorhus/awesome-nodejs).
# MaxSockets in Node.js konfigurieren
In Node.js können Sie die maximale Anzahl der Verbindungen pro Ursprungsserver festlegen. Wenn ` maxSockets` festgelegt wurde, setzt der Low-Level-HTTP-Client die Anforderungen auf eine Warteliste und ordnet sie Sockets zu, sobald diese verfügbar werden.
Mit dieser Option können Sie eine Obergrenze für die Anzahl der gleichzeitigen Anforderungen an einen bestimmten Ursprungsserver angeben. Indem Sie diesen Wert senken, kann die Anzahl der maximalen Ablehnungen oder Timeout-Fehler reduziert werden. Es kann jedoch auch die Speichernutzung erhöhen, da Anforderungen so lange in eine Warteschlange gesetzt werden, bis ein Socket verfügbar wird.
Das folgende Beispiel zeigt, wie die Einstellungen `maxSockets` für einen DynamoDB-Client vorgenommen werden.
```
import { DynamoDBClient } from "@aws-sdk/client-dynamodb";
import { NodeHttpHandler } from "@smithy/node-http-handler";
import https from "https";
let agent = new https.Agent({
maxSockets: 25
});
let dynamodbClient = new DynamoDBClient({
requestHandler: new NodeHttpHandler({
requestTimeout: 3_000,
httpsAgent: agent
});
});
```
Das SDK für JavaScript verwendet den `maxSockets` Wert 50, wenn Sie keinen Wert oder kein Objekt `Agent` angeben. Wenn Sie ein `Agent` Objekt angeben, wird sein `maxSockets` Wert verwendet. Weitere Informationen zur Einstellung `maxSockets` in Node.js finden Sie in der [Dokumentation zu Node.js](https://nodejs.org/dist/latest/docs/api/http.html#http_agent_maxsockets).
Ab Version 3.521.0 von können Sie AWS SDK für JavaScript die folgende [Kurzsyntax](https://github.com/aws/aws-sdk-js-v3/blob/main/supplemental-docs/CLIENTS.md#new-in-v35210) zur Konfiguration verwenden. `requestHandler`
```
import { DynamoDBClient } from "@aws-sdk/client-dynamodb";
const client = new DynamoDBClient({
requestHandler: {
requestTimeout: 3_000,
httpsAgent: { maxSockets: 25 },
},
});
```
# Verbindungen mit Keep-Alive in Node.js wiederverwenden
Der HTTP/HTTPS Standardagent Node.js erstellt für jede neue Anfrage eine neue TCP-Verbindung. Um die Kosten für den Aufbau einer neuen Verbindung zu vermeiden, werden TCP-Verbindungen *standardmäßig AWS SDK für JavaScript * wiederverwendet.
Bei kurzlebigen Vorgängen, wie Amazon DynamoDB DynamoDB-Abfragen, kann der Latenzaufwand beim Einrichten einer TCP-Verbindung größer sein als der Vorgang selbst. Da die [DynamoDB-Verschlüsselung im Ruhezustand](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/encryption.howitworks.html) integriert ist [AWS KMS](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/encryption.howitworks.html), kann es außerdem zu Latenzen kommen, weil die Datenbank für jeden Vorgang neue AWS KMS Cacheeinträge einrichten muss.
Wenn Sie TCP-Verbindungen nicht wiederverwenden möchten, können Sie die Wiederverwendung dieser Verbindungen `keepAlive` live with für jeden einzelnen Service deaktivieren, wie im folgenden Beispiel für einen DynamoDB-Client gezeigt.
```
import { DynamoDBClient } from "@aws-sdk/client-dynamodb";
import { NodeHttpHandler } from "@smithy/node-http-handler";
import { Agent } from "https";
const dynamodbClient = new DynamoDBClient({
requestHandler: new NodeHttpHandler({
httpsAgent: new Agent({ keepAlive: false })
})
});
```
Wenn `keepAlive` aktiviert, können Sie auch die Anfangsverzögerung für TCP-Keep-Alive-Pakete mit festlegen`keepAliveMsecs`, die standardmäßig 1000 ms beträgt. Weitere Informationen finden Sie in der [Node.js-Dokumentation](https://nodejs.org/api/http.html#new-agentoptions) .
# Konfigurieren Sie Proxys für Node.js
Wenn Sie keine direkte Verbindung zum Internet herstellen können, JavaScript unterstützt das SDK für die Verwendung von HTTP- oder HTTPS-Proxys über einen HTTP-Agenten eines Drittanbieters.
[Um einen HTTP-Agenten eines Drittanbieters zu finden, suchen Sie bei npm nach „HTTP-Proxy“.](https://www.npmjs.com/)
Um einen HTTP-Agent-Proxy eines Drittanbieters zu installieren, geben Sie in der Befehlszeile Folgendes ein, wobei der Name des `npm` Pakets angegeben *PROXY* ist.
```
npm install PROXY --save
```
Um einen Proxy in Ihrer Anwendung zu verwenden, verwenden Sie die ` httpsAgent` Eigenschaft `httpAgent` and, wie im folgenden Beispiel für einen DynamoDB-Client gezeigt.
```
import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
import { NodeHttpHandler } from "@smithy/node-http-handler";
import { HttpsProxyAgent } from "hpagent";
const agent = new HttpsProxyAgent({ proxy: "http://internal.proxy.com" });
const dynamodbClient = new DynamoDBClient({
requestHandler: new NodeHttpHandler({
httpAgent: agent,
httpsAgent: agent
}),
});
```
**Anmerkung**
`httpAgent`ist nicht dasselbe wie`httpsAgent`, und da die meisten Aufrufe vom Client an erfolgen`https`, sollten beide gesetzt werden.
# Registrieren Sie Zertifikatspakete in Node.js
Die Standard-Vertrauensspeicher für Node.js enthalten die Zertifikate, die für den Zugriff auf AWS Dienste erforderlich sind. In einigen Fällen könnte es vorteilhaft sein, nur eine bestimmte Gruppe von Zertifikaten einzuschließen.
In diesem Beispiel wird ein bestimmtes Zertifikat auf der Festplatte verwendet, mit dem ein ` https.Agent` erstellt wird, der alle Verbindungen ablehnt, die nicht über das vorgesehene Zertifikat verfügen. Das neu erstellte Objekt `https.Agent` wird dann vom DynamoDB-Client verwendet.
```
import { DynamoDBClient } from "@aws-sdk/client-dynamodb";
import { NodeHttpHandler } from "@smithy/node-http-handler";
import { Agent } from "https";
import { readFileSync } from "fs";
const certs = [readFileSync("/path/to/cert.pem")];
const agent = new Agent({
rejectUnauthorized: true,
ca: certs
});
const dynamodbClient = new DynamoDBClient({
requestHandler: new NodeHttpHandler({
httpAgent: agent,
httpsAgent: agent
})
});
```
# Überlegungen zum Browser-Skript
In den folgenden Themen werden besondere Überlegungen zur Verwendung von AWS SDK für JavaScript In-Browser-Skripts beschrieben.
**Topics**
+ [Erstellen Sie das SDK für Browser](building-sdk-for-browsers.md)
+ [Cross-Origin Resource Sharing (CORS)](cors.md)
+ [Bündeln Sie Anwendungen mit Webpack](webpack.md)
# Erstellen Sie das SDK für Browser
Im Gegensatz zum SDK für JavaScript Version 2 (V2) wird V3 nicht als JavaScript Datei mit Unterstützung für eine Reihe von Standarddiensten bereitgestellt. Stattdessen können Sie mit V3 nur das SDK für die benötigten JavaScript Dateien bündeln und in den Browser aufnehmen, wodurch der Overhead reduziert wird. Wir empfehlen, Webpack zu verwenden, um das erforderliche SDK für JavaScript Dateien und alle zusätzlichen Pakete von Drittanbietern, die Sie benötigen, in einer einzigen `Javascript` Datei zu bündeln und diese mithilfe eines `