Mandanten-Konfiguration verwalten

Was ist Tenant Config?

Tenant Config ist ein sicherer Key-Value-Speicher für Einstellungen und Zugangsdaten, die deine Plattform zur Laufzeit braucht.

Typ	Beschreibung	In der UI sichtbar
Config	Nicht sensible Einstellungen, URLs, Feature-Flags	Ja
Secret	API-Keys, Passwörter, Tokens	Nein — nach dem Speichern verborgen

Tenant Config verwalten

1. Gehe zu Menu → Developer → Config
2. Klicke + Add Entry
3. Wähle Config oder Secret
4. Gib den Key (z. B. SMTP_HOST, OPENAI_API_KEY) und den Value ein
5. Klicke Save

Config-Werte lesen

Die Tenant-Konfiguration liest du über die GraphQL-Query getConfig — z. B. aus einem Workflow-Script-Node:

local res = ctx.graphql.query([[
  query { getConfig { entries { name type value } } }
]])
-- res.data.getConfig.entries: je Eintrag name, type (Config oder Secret) und value

Für einen einzelnen Eintrag gibt es in Scripts und Custom Apps eine Abkürzung — ctx.config.get liefert nur den Wert dieses Keys zurück (oder nil, wenn er fehlt oder redacted ist):

local smtpHost = ctx.config.get("SMTP_HOST")

(ctx.config.get steht in Integrationen nicht zur Verfügung — sie lesen ihre Install-Config über ctx.integration.getConfig.)

Secret-Werte werden von der API redacted — sie lassen sich über getConfig oder ein Script nicht zurücklesen. Nur nicht-geheime Config-Einträge liefern ihren Wert. Secrets werden dort von der Plattform genutzt, wo sie referenziert sind; an Client- oder Script-Code werden sie nie zurückgegeben.

Best Practices

• Großschreibung und sprechende Keys: SENDGRID_API_KEY statt key1
• Für Zugangsdaten immer den Typ Secret — ihre Werte sind nach dem Speichern nicht zurücklesbar
• Ein gemeinsames Team-Dokument pflegen, das beschreibt, wofür jeder Key verwendet wird