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 wieall, 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.