Amazon CodeCatalyst ist nicht mehr offen für Neukunden. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter [Wie migriert man von CodeCatalyst](migration.md).

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.

# Daten mithilfe von Geheimnissen maskieren
<a name="workflows-secrets"></a>

Es kann vorkommen, dass Sie vertrauliche Daten, wie z. B. Anmeldeinformationen, in Ihren Workflows verwenden müssen. Es sollte vermieden werden, diese Werte irgendwo in Ihrem Repository im Klartext zu speichern, da jeder, der Zugriff auf das Repository hat, das das Geheimnis enthält, sie sehen kann. Ebenso sollten diese Werte nicht direkt in Workflow-Definitionen verwendet werden, da sie dann als Dateien in Ihrem Repository sichtbar sind. Mit können Sie diese Werte schützen CodeCatalyst, indem Sie Ihrem Projekt ein Geheimnis hinzufügen und dann in Ihrer Workflow-Definitionsdatei auf das Geheimnis verweisen. Beachten Sie, dass Sie pro Aktion maximal fünf Geheimnisse haben können.

**Anmerkung**  
Secrets können nur verwendet werden, um Passwörter und vertrauliche Informationen in der Workflow-Definitionsdatei zu ersetzen.

**Topics**
+ [Ein Geheimnis erstellen](workflows-secrets.creating.md)
+ [Ein Geheimnis bearbeiten](workflows-secrets.editing.md)
+ [Verwenden eines Secrets](workflows-secrets.using.md)
+ [Ein Geheimnis löschen](workflows-secrets.deleting.md)

# Ein Geheimnis erstellen
<a name="workflows-secrets.creating"></a>

Gehen Sie wie folgt vor, um ein Geheimnis zu erstellen. Das Geheimnis enthält die vertraulichen Informationen, die Sie vor dem Zugriff verbergen möchten.

**Anmerkung**  
Geheimnisse sind für Aktionen sichtbar und werden nicht maskiert, wenn sie in eine Datei geschrieben werden.

**So erstellen Sie ein Secret**

1. Öffnen Sie die CodeCatalyst Konsole unter [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. **Wählen Sie im Navigationsbereich **CI/CD** und dann Secrets aus.**

1. Wählen Sie **Create secret (Secret erstellen)** aus.

1. Geben Sie die folgenden Informationen ein:  
**Name**  
Geben Sie einen Namen für Ihr Geheimnis ein.  
**Wert**  
Geben Sie den Wert für das Geheimnis ein. Dies sind die vertraulichen Informationen, die Sie vor dem Zugriff verbergen möchten. Standardmäßig wird der Wert nicht angezeigt. Um den Wert anzuzeigen, wählen Sie **Wert anzeigen**.  
**Beschreibung**  
(Optional) Geben Sie eine Beschreibung für Ihr Geheimnis ein.

1. Wählen Sie **Erstellen** aus.

# Ein Geheimnis bearbeiten
<a name="workflows-secrets.editing"></a>

Gehen Sie wie folgt vor, um ein Geheimnis zu bearbeiten.

**Um ein Geheimnis zu bearbeiten**

1. Öffnen Sie die CodeCatalyst Konsole unter [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. **Wählen Sie im Navigationsbereich **CI/CD** und dann Secrets aus.**

1. Wählen Sie in der Geheimnisliste das Geheimnis aus, das Sie bearbeiten möchten.

1. Wählen Sie **Bearbeiten** aus.

1. Bearbeiten Sie die folgenden Eigenschaften:  
**Wert**  
Geben Sie den Wert für das Geheimnis ein. Dies ist der Wert, den Sie aus der Ansicht ausblenden möchten. Standardmäßig wird der Wert nicht angezeigt.  
**Beschreibung**  
(Optional) Geben Sie eine Beschreibung für Ihr Geheimnis ein.

1. Wählen Sie **Speichern**.

# Verwenden eines Secrets
<a name="workflows-secrets.using"></a>

Um ein Geheimnis in einer Workflow-Aktion zu verwenden, müssen Sie die Referenz-ID des Geheimnisses abrufen und diese ID in der Workflow-Aktion verwenden.

**Topics**
+ [Den Bezeichner eines Geheimnisses abrufen](#workflows-using-secrets.get-identifier)
+ [Verweisen auf ein Geheimnis in einem Workflow](#workflows-using-secrets.using-identifier)

## Den Bezeichner eines Geheimnisses abrufen
<a name="workflows-using-secrets.get-identifier"></a>

Gehen Sie wie folgt vor, um die Referenz-ID des Geheimnisses zu ermitteln. Sie fügen diese Kennung Ihrem Workflow hinzu.

**Um die Referenz-ID des Geheimnisses zu erhalten**

1. Öffnen Sie die CodeCatalyst Konsole unter [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. **Wählen Sie im Navigationsbereich **CI/CD** und dann Secrets aus.**

1. Suchen Sie in der Liste der Geheimnisse nach dem Geheimnis, das Sie verwenden möchten.

1. Kopieren Sie in der Spalte **Referenz-ID** die Kennung des Geheimnisses. Im Folgenden ist die Syntax für die **Referenz-ID**:

   ```
   ${Secrets.<name>}
   ```

## Verweisen auf ein Geheimnis in einem Workflow
<a name="workflows-using-secrets.using-identifier"></a>

Gehen Sie wie folgt vor, um in einem Workflow auf ein Geheimnis zu verweisen.

**Um auf ein Geheimnis zu verweisen**

1. **Wählen Sie im Navigationsbereich **CI/CD** und dann Workflows aus.**

1. Wählen Sie den Namen Ihres Workflows. Sie können nach dem Quell-Repository oder dem Branch-Namen filtern, in dem der Workflow definiert ist, oder nach Workflow-Namen oder -Status filtern.

1. Wählen Sie **Bearbeiten** aus.

1. Wählen Sie **YAML.**

1. Ändern Sie das YAML so, dass es den Bezeichner des Geheimnisses verwendet. Um beispielsweise einen Benutzernamen und ein Passwort zu verwenden, die zusammen mit dem `curl` Befehl als Geheimnisse gespeichert sind, würden Sie einen `Run` Befehl verwenden, der dem folgenden ähnelt:

   ```
   - Run: curl -u <username-secret-identifier>:<password-secret-identifier> https://example.com
   ```

1. (Optional) Wählen Sie „**Validieren**“, um den YAML-Code des Workflows vor dem Commit zu überprüfen.

1. Wählen Sie **Commit**, geben Sie eine Commit-Nachricht ein und wählen Sie erneut **Commit**.

# Ein Geheimnis löschen
<a name="workflows-secrets.deleting"></a>

Gehen Sie wie folgt vor, um ein Geheimnis und die geheime Referenz-ID zu löschen.

**Anmerkung**  
Bevor Sie ein Geheimnis löschen, empfehlen wir, die Referenz-ID des Geheimnisses aus allen Workflow-Aktionen zu entfernen. Wenn Sie das Geheimnis löschen, ohne die Referenz-ID zu löschen, schlägt die Aktion bei der nächsten Ausführung fehl. 

**Um die Referenz-ID eines geheimen Schlüssels aus einem Workflow zu löschen**

1. Öffnen Sie die CodeCatalyst Konsole unter [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. **Wählen Sie im Navigationsbereich **CI/CD** und dann Workflows aus.**

1. Wählen Sie den Namen Ihres Workflows. Sie können nach dem Quell-Repository oder dem Branch-Namen filtern, in dem der Workflow definiert ist, oder nach Workflow-Namen oder -Status filtern.

1. Wählen Sie **Bearbeiten** aus.

1. Wählen Sie **YAML.**

1. Suchen Sie im Workflow nach der folgenden Zeichenfolge:

   ```
   ${Secrets.
   ```

   Dadurch werden alle Referenzkennungen aller Geheimnisse gefunden.

1. Löscht den Referenzbezeichner des ausgewählten Geheimnisses oder ersetzt ihn durch einen Klartextwert.

1. (Optional) Wählen Sie „**Validieren**“, um den YAML-Code des Workflows vor dem Commit zu überprüfen.

1. Wählen Sie **Commit**, geben Sie eine Commit-Nachricht ein und wählen Sie erneut **Commit**.

**So löschen Sie ein Geheimnis**

1. Öffnen Sie die CodeCatalyst Konsole unter [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. **Wählen Sie im Navigationsbereich **CI/CD** und dann Secrets aus.**

1. Wählen Sie in der Geheimnisliste das Geheimnis aus, das Sie löschen möchten.

1. Wählen Sie **Löschen** aus.

1. Geben Sie ein**delete**, um das Löschen zu bestätigen.

1. Wählen Sie **Löschen** aus.