agorum_ai_agents_library_basic_metadb_write_encrypted

Anzeigename: MetaDB write encrypted

Was macht das Tool?

Dieses Tool schreibt einen verschlüsselten Wert in die agorum core MetaDB. Es dient zum sicheren Speichern sensibler Daten wie Passwörter, API-Schlüssel, Tokens oder anderer geheimer Konfigurationswerte. Der Wert wird vor dem Speichern verschlüsselt und kann nicht im Klartext zurückgelesen werden.

Die MetaDB ist eine zentrale Konfigurationsdatenbank in agorum core (vergleichbar mit der Windows-Registry). Sie besteht aus drei Elementtypen:

Property-Group: Dient zur visuellen Strukturierung
Property-Bundle: Wie Ordner, zur Organisation von Einträgen
Property-Entry: Enthält die eigentlichen Werte

Empfohlener Einsatzzweck

Das Tool ist ideal geeignet für:

Speichern von API-Schlüsseln für externe Dienste
Speichern von Datenbankpasswörtern
Speichern von Authentifizierungs-Tokens (OAuth, JWT etc.)
Speichern aller sensiblen Konfigurationswerte, die nicht im Klartext lesbar sein sollen

Funktionsbeschreibung

Parameter Beschreibung

Parameter	Beschreibung
path (Pflicht)	Der vollständige MetaDB-Pfad inklusive des Eintragsnamens, unter dem der verschlüsselte Wert gespeichert wird. Pfadstruktur: `MAIN_AREA/path/to/bundle/entryName` Der Pfad muss mit einem der folgenden Hauptbereiche beginnen: MAIN_ACL_MANAGEMENT: Erweiterte ACL-Einstellungen MAIN_COMMON_MANAGEMENT: Kundenspezifische Einstellungen MAIN_GROUP_MANAGEMENT: Erweiterte Gruppeneinstellungen MAIN_MACHINE_MANAGEMENT: Erweiterte Client-Einstellungen MAIN_MODULE_MANAGEMENT: Alle Modulkonfigurationen (am häufigsten verwendet) MAIN_SERVER_MANAGEMENT: Serverkonfigurationen MAIN_USER_MANAGEMENT: Erweiterte Benutzereinstellungen Beispiel: `MAIN_MODULE_MANAGEMENT/customers/myproject/secrets/apiKey`
value (Pflicht)	Der sensible Wert, der verschlüsselt gespeichert werden soll (z. B. Passwort, API-Schlüssel, Token). Der Wert wird vor der Speicherung verschlüsselt und kann nicht im Klartext zurückgelesen werden.

path
(Pflicht)

Der vollständige MetaDB-Pfad inklusive des Eintragsnamens, unter dem der verschlüsselte Wert gespeichert wird.

Pfadstruktur: MAIN_AREA/path/to/bundle/entryName

Der Pfad muss mit einem der folgenden Hauptbereiche beginnen:

MAIN_ACL_MANAGEMENT: Erweiterte ACL-Einstellungen
MAIN_COMMON_MANAGEMENT: Kundenspezifische Einstellungen
MAIN_GROUP_MANAGEMENT: Erweiterte Gruppeneinstellungen
MAIN_MACHINE_MANAGEMENT: Erweiterte Client-Einstellungen
MAIN_MODULE_MANAGEMENT: Alle Modulkonfigurationen (am häufigsten verwendet)
MAIN_SERVER_MANAGEMENT: Serverkonfigurationen
MAIN_USER_MANAGEMENT: Erweiterte Benutzereinstellungen

Beispiel: MAIN_MODULE_MANAGEMENT/customers/myproject/secrets/apiKey

value
(Pflicht) Der sensible Wert, der verschlüsselt gespeichert werden soll (z. B. Passwort, API-Schlüssel, Token).

Der Wert wird vor der Speicherung verschlüsselt und kann nicht im Klartext zurückgelesen werden.

Beispiel-Prompt

Speichere den API-Schlüssel "sk-abc123xyz789" verschlüsselt in der MetaDB unter dem Pfad MAIN_MODULE_MANAGEMENT/customers/meinprojekt/secrets/apiKey

Tipps und Tricks

Tipp: Die Verschlüsselung ist nur für das Schreiben gedacht. Der gespeicherte Wert kann nicht über dieses Tool im Klartext ausgelesen werden. Um verschlüsselte Werte in JavaScript-Code zu lesen, verwenden Sie: metadb.decrypt(metadb.read(path)[0])

Hinweis: Im Gegensatz zum regulären MetaDB-Write-Tool kann dieses Tool nur einen einzelnen String-Wert speichern. Der Pfad muss direkt auf den Eintrag zeigen, nicht auf das übergeordnete Bundle.