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.
# Verwenden von Umgebungsvariablen in einer Amplify-Anwendung
Umgebungsvariablen sind Schlüssel-Wert-Paare, die Sie zu den Einstellungen Ihrer Anwendung hinzufügen können, um sie für Amplify Hosting verfügbar zu machen. Als bewährte Methode können Sie Umgebungsvariablen verwenden, um Anwendungskonfigurationsdaten verfügbar zu machen. Alle Umgebungsvariablen, die Sie hinzufügen, sind verschlüsselt, um unbefugten Zugriff zu verhindern.
Amplify erzwingt die folgenden Einschränkungen für die von Ihnen erstellten Umgebungsvariablen.
+ Amplify erlaubt Ihnen nicht, Umgebungsvariablennamen mit einem `AWS` Präfix zu erstellen. Dieses Präfix ist nur für den internen Gebrauch von Amplify reserviert.
+ Der Wert einer Umgebungsvariablen darf 5500 Zeichen nicht überschreiten.
**Wichtig**
Verwenden Sie keine Umgebungsvariablen zum Speichern von Geheimnissen. Verwenden Sie für eine Gen 2-App die **Secret-Verwaltungsfunktion** in der Amplify-Konsole. Weitere Informationen finden Sie unter [Secrets and environment vars](https://docs.amplify.aws/react/deploy-and-host/fullstack-branching/secrets-and-vars/) in der *Amplify-Dokumentation*. Speichern Sie für eine Gen-1-App Geheimnisse in einem Umgebungsgeheimnis, das mit dem AWS Systems Manager Parameter Store erstellt wurde. Weitere Informationen finden Sie unter [Verwaltung von Umgebungsgeheimnissen](environment-secrets.md).
## Umgebungsvariablenreferenz Amplify
Auf die folgenden Umgebungsvariablen kann standardmäßig in der Amplify-Konsole zugegriffen werden.
****
| Variablenname | Description | Beispielwert |
| --- | --- | --- |
| \$1BUILD\$1TIMEOUT | Die Dauer des Build-Timeouts in Minuten. Der Mindestwert ist 5. Der Höchstwert ist 120. | `30` |
| \$1LIVE\$1UPDATES | Das Tool wird auf die neueste Version aktualisiert. | `[{"name":"Amplify CLI","pkg":"@aws-amplify/cli","type":"npm","version":"latest"}]` |
| USER\$1DISABLE\$1TESTS | Der Testschritt wird während eines Builds übersprungen. Sie können Tests für alle Zweige oder bestimmte Zweige in einer App deaktivieren. Diese Umgebungsvariable wird für Apps verwendet, die während der Buildphase Tests durchführen. Weitere Informationen zum Setzen dieser Variablen finden Sie unter[Tests für eine Amplify-Anwendung oder einen Amplify-Zweig ausschalten](running-tests.md#disabling-tests). | `true` |
| AWS\$1APP\$1ID | Die App-ID des aktuellen Builds | `abcd1234` |
| AWS\$1BRANCH | Der Verzweigungsname des aktuellen Builds | `main`, `develop`, `beta`, `v2.0` |
| AWS\$1BRANCH\$1ARN | Der Branch-Amazon-Ressourcenname (ARN) des aktuellen Builds | `aws:arn:amplify:us-west-2:123456789012:appname/branch/... ` |
| AWS\$1CLONE\$1URL | Die Klon-URL zum Abrufen der Git-Repository-Inhalte | `git@github.com:/.git` |
| AWS\$1COMMIT\$1ID | Die Commit-ID des aktuellen Builds „HEAD“ für Rebuilds | `abcd1234` |
| AWS\$1JOB\$1ID | Die Auftrags-ID des aktuellen Builds. Dies beinhaltet eine gewisse Polsterung von '0', sodass es immer dieselbe Länge hat. | `0000000001` |
| AWS\$1PULL\$1REQUEST\$1ID | Die Pull-Request-ID des Pull-Request-Webvorschau-Builds. Diese Umgebungsvariable ist nicht verfügbar, wenn Sie sie AWS CodeCommit als Repository-Anbieter verwenden. | `1` |
| AWS\$1PULL\$1REQUEST\$1SOURCE\$1BRANCH | Der Name des Feature-Branches für eine Pull-Request-Vorschau, der an einen Anwendungszweig in der Amplify-Konsole gesendet wird. | `featureA` |
| AWS\$1PULL\$1REQUEST\$1DESTINATION\$1BRANCH | Der Name des Anwendungszweigs in der Amplify-Konsole, an den eine Feature-Branch-Pull-Anfrage gesendet wird. | `main` |
| AMPLIFY\$1AMAZON\$1CLIENT\$1ID | Die Amazon-Kunden-ID | `123456` |
| AMPLIFY\$1AMAZON\$1CLIENT\$1SECRET | Das Geheimnis des Amazon-Kunden | `example123456` |
| AMPLIFY\$1FACEBOOK\$1CLIENT\$1ID | Die Facebook-Kunden-ID | `123456` |
| AMPLIFY\$1FACEBOOK\$1CLIENT\$1SECRET | Das geheime Facebook-Kundengeheimnis | `example123456` |
| AMPLIFY\$1GOOGLE\$1CLIENT\$1ID | Die Google-Kunden-ID | `123456` |
| AMPLIFY\$1GOOGLE\$1CLIENT\$1SECRET | Das Geheimnis des Google-Clients | `example123456` |
| AMPLIFY\$1DIFF\$1DEPLOY | Aktivieren oder deaktivieren Sie die diff-basierte Frontend-Bereitstellung. Weitere Informationen finden Sie unter [Konfiguration von diff-basiertem Frontend, Build und Deployment](edit-build-settings.md#enable-diff-deploy). | `true` |
| AMPLIFY\$1DIFF\$1DEPLOY\$1ROOT | Der Pfad, der für Vergleichsvergleiche von Frontend-Deployments verwendet werden soll, relativ zum Stammverzeichnis Ihres Repositorys. | `dist` |
| AMPLIFY\$1DIFF\$1BACKEND | Aktiviert oder deaktiviert diff-basierte Backend-Builds. Dies gilt nur für Apps der 1. Generation. Weitere Informationen finden Sie unter [Konfiguration von diff-basierten Backend-Builds für eine Gen-1-App](edit-build-settings.md#enable-diff-backend). | `true` |
| AMPLIFY\$1BACKEND\$1PULL\$1ONLY | Amplify verwaltet diese Umgebungsvariable. Dies gilt nur für Apps der 1. Generation. Weitere Informationen finden Sie unter [Bearbeiten Sie ein vorhandenes Frontend so, dass es auf ein anderes Backend verweist](reuse-backends.md#reuse-backends-edit-existing). | `true` |
| AMPLIFY\$1BACKEND\$1APP\$1ID | Amplify verwaltet diese Umgebungsvariable. Dies gilt nur für Apps der 1. Generation. Weitere Informationen finden Sie unter [Bearbeiten Sie ein vorhandenes Frontend so, dass es auf ein anderes Backend verweist](reuse-backends.md#reuse-backends-edit-existing). | `abcd1234` |
| AMPLIFY\$1SKIP\$1BACKEND\$1BUILD | Wenn Ihre Build-Spezifikation keinen Backend-Abschnitt enthält und Sie Backend-Builds deaktivieren möchten, setzen Sie diese Umgebungsvariable auf. `true` Dies gilt nur für Apps der 1. Generation. | `true` |
| AMPLIFY\$1ENABLE\$1DEBUG\$1OUTPUT | Setzen Sie diese Variable auf, `true` um einen Stack-Trace in den Protokollen zu drucken. Dies ist hilfreich beim Debuggen von Backend-Build-Fehlern. | `true` |
| AMPLIFY\$1MONOREPO\$1APP\$1ROOT | Der Pfad, der verwendet werden soll, um das App-Stammverzeichnis einer Monorepo-App relativ zum Stammverzeichnis Ihres Repositorys anzugeben. | `apps/react-app` |
| AMPLIFY\$1USERPOOL\$1ID | Die ID für den Amazon Cognito Cognito-Benutzerpool, der für die Authentifizierung importiert wurde | `us-west-2_example` |
| AMPLIFY\$1WEBCLIENT\$1ID | Die ID für den App-Client, der von Webanwendungen verwendet werden soll Der App-Client muss mit Zugriff auf den Amazon Cognito Cognito-Benutzerpool konfiguriert sein, der in der Umgebungsvariablen AMPLIFY\$1USERPOOL\$1ID angegeben ist. | `123456` |
| AMPLIFY\$1NATIVECLIENT\$1ID | Die ID für den App-Client, der von nativen Anwendungen verwendet werden soll Der App-Client muss mit Zugriff auf den Amazon Cognito Cognito-Benutzerpool konfiguriert sein, der in der Umgebungsvariablen AMPLIFY\$1USERPOOL\$1ID angegeben ist. | `123456` |
| AMPLIFY\$1IDENTITYPOOL\$1ID | Die ID für den Amazon Cognito Cognito-Identitätspool | `example-identitypool-id` |
| AMPLIFY\$1PERMISSIONS\$1BOUNDARY\$1ARN | Der ARN für die IAM-Richtlinie, der als Berechtigungsgrenze verwendet werden soll und für alle von Amplify erstellten IAM-Rollen gilt. | `arn:aws:iam::123456789012:policy/example-policy` |
| AMPLIFY\$1DESTRUCTIVE\$1UPDATES | Setzen Sie diese Umgebungsvariable auf true, damit eine GraphQL-API mit Schemaoperationen aktualisiert werden kann, die möglicherweise zu Datenverlust führen können. | `true` |
**Anmerkung**
Die Umgebungsvariablen `AMPLIFY_AMAZON_CLIENT_ID` und die `AMPLIFY_AMAZON_CLIENT_SECRET` Umgebungsvariablen sind OAuth Token, kein AWS Zugriffsschlüssel und kein geheimer Schlüssel.
## Umgebungsvariablen des Frontend-Frameworks
Wenn Sie Ihre App mit einem Frontend-Framework entwickeln, das seine eigenen Umgebungsvariablen unterstützt, ist es wichtig zu verstehen, dass diese nicht mit den Umgebungsvariablen identisch sind, die Sie in der Amplify-Konsole konfigurieren. Mit React (mit dem Präfix REACT\$1APP) und Gatsby (mit dem Präfix GATSBY) können Sie beispielsweise Laufzeitumgebungsvariablen erstellen, die diese Frameworks automatisch in Ihren Frontend-Produktions-Build bündeln. Informationen zu den Auswirkungen der Verwendung dieser Umgebungsvariablen zum Speichern von Werten finden Sie in der Dokumentation für das von Ihnen verwendete Frontend-Framework.
Das Speichern sensibler Werte, wie API-Schlüssel, in diesen Umgebungsvariablen des Frontend-Frameworks mit Präfix ist keine bewährte Methode und es wird dringend davon abgeraten.
# Umgebungsvariablen setzen
Verwenden Sie die folgenden Anweisungen, um Umgebungsvariablen für eine Anwendung in der Amplify-Konsole festzulegen.
**Anmerkung**
**Umgebungsvariablen** sind nur dann im **App-Einstellungsmenü** der Amplify-Konsole sichtbar, wenn eine App für die kontinuierliche Bereitstellung eingerichtet und mit einem Git-Repository verbunden ist. Anweisungen zu dieser Art der Bereitstellung finden Sie unter [Erste Schritte mit vorhandenem Code.](getting-started.md)
**So legen Sie Umgebungsvariablen fest**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amplify-Konsole](https://console.aws.amazon.com/amplify/).
1. Wählen Sie in der Amplify-Konsole **Hosting** und dann **Umgebungsvariablen** aus.
1. Wählen Sie auf der Seite **Umgebungsvariablen** die Option **Variablen verwalten** aus.
1. Geben Sie unter **Variable** Ihren Schlüssel ein. Geben Sie unter **Wert** Ihren Wert ein. Standardmäßig wendet Amplify die Umgebungsvariablen auf alle Zweige an, sodass Sie Variablen nicht erneut eingeben müssen, wenn Sie einen neuen Zweig verbinden.
1. (Optional) Um eine Umgebungsvariable speziell für einen Zweig anzupassen, fügen Sie wie folgt eine Branch-Override hinzu:
1. Wählen Sie „**Aktionen**“ und anschließend „**Variablenüberschreibung hinzufügen**“.
1. Sie verfügen jetzt über einen spezifischen Satz von Umgebungsvariablen für Ihre Verzweigung.
1. Wählen Sie **Speichern**.
## Erstellen Sie eine neue Backend-Umgebung mit Authentifizierungsparametern für die Anmeldung über soziale Netzwerke
**Um eine Filiale mit einer App zu verbinden**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amplify-Konsole](https://console.aws.amazon.com/amplify/).
1. Das Verfahren zum Verbinden einer Filiale mit einer App hängt davon ab, ob Sie eine Filiale mit einer neuen App oder einer vorhandenen App verbinden.
+ **Eine Filiale mit einer neuen App verbinden**
1. Suchen Sie auf der Seite mit den **Build-Einstellungen** den Abschnitt **Wählen Sie eine Backend-Umgebung aus, die mit diesem Zweig verwendet** werden soll. Wählen Sie für **Umgebung** die Option **Neue Umgebung erstellen** aus und geben Sie den Namen Ihrer Backend-Umgebung ein. Der folgende Screenshot zeigt den Abschnitt **Wählen Sie eine Backend-Umgebung aus, die mit diesem Zweig verwendet werden soll auf** der Seite mit den **Build-Einstellungen**, in dem für die Backend-Umgebung ein Name **backend** eingegeben wurde.
![\[Auf der Seite mit den Build-Einstellungen finden Sie den Abschnitt Wählen Sie eine Backend-Umgebung aus, die mit diesem Zweig verwendet werden soll.\]](http://docs.aws.amazon.com/de_de/amplify/latest/userguide/images/amplify-newenvironment-1.png)
1. Erweitern Sie auf der Seite mit den **Build-Einstellungen den Abschnitt **Erweiterte** Einstellungen** und fügen Sie Umgebungsvariablen für Social-Anmeldeschlüssel hinzu. **AMPLIFY\$1FACEBOOK\$1CLIENT\$1SECRET**Ist beispielsweise eine gültige Umgebungsvariable. Eine Liste der standardmäßig verfügbaren Amplify-Systemumgebungsvariablen finden Sie in [Umgebungsvariablenreferenz Amplify](environment-variables.md#amplify-console-environment-variables) der Tabelle unter.
+ **Einen Zweig mit einer vorhandenen App verbinden**
1. Wenn Sie eine neue Filiale mit einer vorhandenen App verbinden, legen Sie die Umgebungsvariablen für die Anmeldung über soziale Netzwerke fest, bevor Sie die Filiale verbinden. Wählen Sie im Navigationsbereich **App-Einstellungen**, **Umgebungsvariablen** aus.
1. Wählen Sie im Abschnitt **Umgebungsvariablen** die Option **Variablen verwalten** aus.
1. Wählen **Sie im Abschnitt Variablen verwalten** die Option **Variable hinzufügen** aus.
1. Geben Sie unter **Variable** (Schlüssel) Ihre Client-ID ein. Geben Sie unter **Value** Ihr Client-Geheimnis ein.
1. Wählen Sie „**Speichern**“.
# Verwaltung von Umgebungsgeheimnissen
Mit der Veröffentlichung von Amplify Gen 2 wurde der Workflow für Umgebungsgeheimnisse optimiert, um die Verwaltung von Geheimnissen und Umgebungsvariablen in der Amplify-Konsole zu zentralisieren. Anweisungen zum Einrichten und Zugreifen auf Geheimnisse für eine Amplify Gen 2-App finden Sie unter [Secrets and environment vars](https://docs.amplify.aws/react/deploy-and-host/fullstack-branching/secrets-and-vars/) in der *Amplify-Dokumentation*.
Umgebungsgeheimnisse für eine Gen-1-App ähneln Umgebungsvariablen, es handelt sich jedoch um Schlüsselwertpaare für den AWS Systems Manager Parameterspeicher, die verschlüsselt werden können. Einige Werte müssen verschlüsselt werden, z. B. die Anmeldung mit dem privaten Apple-Schlüssel für Amplify.
## Wird verwendet AWS Systems Manager , um Umgebungsgeheimnisse für eine Amplify Gen 1-Anwendung festzulegen
Verwenden Sie die folgenden Anweisungen, um mithilfe der AWS Systems Manager Konsole ein Umgebungsgeheimnis für eine Amplify-App der Generation 1 festzulegen.
**Um ein Umgebungsgeheimnis festzulegen**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [AWS Systems Manager Konsole](https://console.aws.amazon.com/systems-manager/).
1. Wählen Sie im Navigationsbereich **Application Management** und dann **Parameter Store** aus.
1. Wählen Sie auf der Seite **AWS Systems Manager Parameter Store** die Option **Create parameter** aus.
1. Gehen Sie auf der Seite **Parameter erstellen** im Abschnitt **Parameterdetails** wie folgt vor:
1. Geben Sie für **Name** einen Parameter im Format ein**/amplify/\$1your\$1app\$1id\$1/\$1your\$1backend\$1environment\$1name\$1/\$1your\$1parameter\$1name\$1**.
1. Wählen Sie für **Type (Typ)** die Option **SecureString** aus.
1. Wählen Sie unter **KMS-Schlüsselquelle** die Option **Mein aktuelles Konto** aus, um den Standardschlüssel für Ihr Konto zu verwenden.
1. Geben Sie **unter Wert** Ihren geheimen Wert für die Verschlüsselung ein.
1. Wählen Sie „**Parameter erstellen“**.
**Anmerkung**
Amplify hat nur Zugriff auf die Schlüssel unter dem Build `/amplify/{your_app_id}/{your_backend_environment_name}` für die spezifische Umgebung. Sie müssen die Standardeinstellung angeben AWS KMS key , damit Amplify den Wert entschlüsseln kann.
## Zugreifen auf Umgebungsgeheimnisse für eine Gen 1-Anwendung
Umgebungsgeheimnisse für eine Gen-1-Anwendung werden `process.env.secrets` als JSON-Zeichenfolge gespeichert.
## Referenz zu Umgebungsgeheimnissen verstärken
Geben Sie einen Systems Manager Manager-Parameter im Format an`/amplify/{your_app_id}/{your_backend_environment_name}/AMPLIFY_SIWA_CLIENT_ID`.
Sie können die folgenden Umgebungsgeheimnisse verwenden, auf die standardmäßig in der Amplify-Konsole zugegriffen werden kann.
****
| Variablenname | Description | Beispielwert |
| --- | --- | --- |
| AMPLIFY\$1SIWA\$1CLIENT\$1ID | Die Anmeldung mit der Apple-Client-ID | `com.yourapp.auth` |
| AMPLIFY\$1SIWA\$1TEAM\$1ID | Das Melden Sie sich mit der Apple-Team-ID an | `ABCD123` |
| AMPLIFY\$1SIWA\$1KEY\$1ID | Die Anmeldung mit der Apple-Schlüssel-ID | `ABCD123` |
| AMPLIFY\$1SIWA\$1PRIVATE\$1KEY | Die Anmeldung mit dem privaten Apple-Schlüssel | -----BEGINNE MIT DEM PRIVATEN SCHLÜSSEL----- \$1\$1\$1\$1...... -----ENDE DES PRIVATEN SCHLÜSSELS----- |