Zum Hauptinhalt springen
Erstelle einen Management-Schlüssel, um die Verwaltungs-APIs von Phaseo von deinen eigenen Servern aus aufzurufen: Guthaben, Aktivität, Workspaces, Schlüssel, Voreinstellungen, Einstellungen und Guardrails. Management-Schlüssel können keine Inferenzanfragen senden. Erstelle einen im Dashboard unter Einstellungen → Verwaltungsschlüssel. Das Geheimnis wird nur einmal angezeigt, also speichere es in deinem Geheimnismanager. Sende es nur aus serverseitigem Code, an dieselbe Basis-URL wie das Gateway (https://api.phaseo.app/v1):

Management-Schlüssel, API-Schlüssel und OAuth-Tokens

Management-Routen akzeptieren nur Management-Schlüssel (oder OAuth-Tokens); ein Gateway-API-Schlüssel kann sie nicht aufrufen. Guardrails sind eine eigene Kontrolle: Sie gelten für Gateway-API-Schlüssel und steuern den Inferenz-Traffic, etwa Routing-Beschränkungen, Budgets, den Umgang mit Prompt-Injection und Regeln für vertrauliche Informationen. Die Funktionen eines Management-Schlüssels legen fest, welche Verwaltungs-APIs er aufrufen darf.

Zugriffsstufe auswählen

Jede Vorlage wird beim Erstellen des Schlüssels in eine explizite Liste von Funktionen aufgelöst. Phaseo speichert nie einen Platzhalter wie all, daher erhält ein Schlüssel nie eine später hinzugefügte Berechtigung. Keine Vorlage enthält billing:write, womit Guthabenaufladungen gestartet werden; fordere es ausdrücklich mit --scopes an. Verwende All nur für vertrauenswürdige Verwaltungsautomatisierung. Für eine kleinere Berechtigung übergibst du die benötigten Funktionen mit --scopes scope_a,scope_b:

Funktionen setzen Workspace-Rollen nicht außer Kraft

Phaseo prüft bei jedem Aufruf zwei Dinge: dass der Schlüssel die Funktion hat und dass der Schlüssel oder OAuth-Nutzer zum Workspace gehört und die Rolle besitzt, die die Aktion erfordert. keys:write erlaubt zum Beispiel die Schlüsselverwaltung, aber die Rollenprüfung entscheidet weiterhin, ob der Aufrufer in diesem Workspace Schlüssel verwalten darf. Ein Schlüssel kann eine Funktion nicht nutzen, um einen anderen Workspace zu erreichen oder Eigentümer- und Administratorprüfungen zu umgehen.

Schlüssel sicher aufbewahren

  • Halte Management-Schlüssel aus Browsern, Desktop-Protokollen, der Versionsverwaltung und Chats heraus.
  • Verwende einen Schlüssel pro Integration, mit der engsten Vorlage, die funktioniert.
  • Lege ein Ablaufdatum fest, wenn die Integration keinen unbegrenzten Zugriff braucht.
  • Pausiere oder lösche ungenutzte Schlüssel sofort.
  • Rotiere einen offengelegten Schlüssel, bevor du weiter untersuchst.
Zuletzt geändert am 7. November 2026