Geheimnisspeicher · DeutschlandGPT

Geheimnisspeicher enthalten Schlüssel-Wert-Paare wie API-Keys, Tokens oder Basis-URLs. Workflows lesen sie zur Laufzeit, sodass die Werte nie in der Konfiguration eines Knotens stehen. Sie finden sie unter Geheimnisspeicher in der Gruppe Daten & Integrationen der Seitenleiste von Workflows.

Einen Speicher anlegen

Ein Speicher fasst zusammengehörige Werte zusammen, etwa einen Speicher pro externem Dienst oder pro Umgebung.

Öffnen Sie Geheimnisspeicher und klicken Sie auf Neuer Speicher.
Ein Speicher namens „Neuer Geheimnisspeicher“ wird angelegt und geöffnet.
Tragen Sie im Reiter Einstellungen den Namen und optional eine Beschreibung ein und klicken Sie auf Speichern.

Variablen verwalten

Der Reiter Variablen listet die Einträge des Speichers. Für einen neuen Eintrag klicken Sie auf Variable hinzufügen, geben Schlüssel und Wert ein, entscheiden über Secret (verschlüsselt) und klicken auf Hinzufügen. Die Secret-Option ist standardmäßig eingeschaltet.

Einfache Variablen werden als Text gespeichert und angezeigt.
Secrets werden auf dem Server verschlüsselt. Die Liste zeigt statt des Werts einen Platzhalter mit dem Vermerk „verschlüsselt“. Anzeigen entschlüsselt ihn für Sie, Verbergen blendet ihn wieder aus.

Um einen Wert zu ändern, fügen Sie den Schlüssel mit dem neuen Wert noch einmal hinzu; er ersetzt den alten. Das Papierkorbsymbol löscht eine Variable.

Aus einer .env-Datei importieren

Klicken Sie auf Aus .env importieren und fügen Sie den Inhalt einer .env-Datei ein. Jede Zeile SCHLUESSEL=WERT wird zu einer Variable; leere Zeilen und Zeilen, die mit # beginnen, werden übersprungen. Der Dialog zeigt, wie viele Variablen er gefunden hat. Mit Alle als Secret markieren (verschlüsselt) wird jeder importierte Wert verschlüsselt.

Werte in Workflows nutzen

Öffnen Sie in der Knotenauswahl Integrationen → Geheimnisspeicher:

Alle Geheimnisse abrufen liefert alle Einträge eines Speichers als Objekt variables
Einzelnes Geheimnis abrufen liefert einen Eintrag anhand des Variable Key als value

Spätere Knoten verweisen auf diese Ausgaben, etwa {{getAllSecrets.outputs.variables.API_KEY}}. Secrets werden als Verweis weitergegeben und erst aufgelöst, wenn der nächste Knoten läuft. Ausgaben und Ausführungsverlauf zeigen deshalb den Verweis, nicht den Wert. Einzelheiten unter Aktionsknoten.

Ein Speicher gehört der Person, die ihn angelegt hat. Teilen Sie einen Workflow, behalten seine Ausführungen den Zugriff auf die Speicher, die er nutzt.

Einen Speicher archivieren

Um einen Speicher zu entfernen, archivieren Sie ihn in der Übersicht. Archivierte Speicher stehen Workflows nicht mehr zur Verfügung, und Knoten, die daraus lesen, schlagen fehl.