Authentifizierung & API-Schlüssel

Subaya unterstützt zwei Authentifizierungsmodi gegen dieselbe API.

API-Schlüssel — SUBAYA_API_KEY (Agenten & CI)

Der einfachste Weg, und der für KI-Agenten und CI-Pipelines zu verwendende. Setzen Sie die Umgebungsvariable, und jeder suya-Befehl (und die Plattform-API) greift sie auf:

export SUBAYA_API_KEY="sk_..."
suya auth whoami      # confirm the identity the key resolves to

Kein Browser, kein interaktiver Schritt — ideal für Headless-Umgebungen. Schlüssel geben Sie aus und verwalten Sie über die Konsole.

OAuth-Browser-Login (Menschen)

Für die interaktive Nutzung an einer Workstation:

suya auth login                 # opens a browser (loopback redirect)
suya auth login --no-browser    # manual-code fallback for remote/headless shells

Die CLI speichert das resultierende Token lokal (unter ~/.config/suya/). Prüfen oder löschen Sie es:

suya auth status    # local status, without calling the server
suya auth logout    # log out and revoke the local token

Rangfolge

Wenn mehr als ein Credential vorhanden ist, löst suya in dieser Reihenfolge auf:

1. Das globale Flag --token
2. SUBAYA_API_KEY
3. Das lokal gespeicherte OAuth-Token (~/.config/suya/auth.json)

Auf einen anderen Host zeigen

Alle Befehle akzeptieren --host (Standard https://subaya-dev.com), falls Sie einen abweichenden API-Endpunkt ansteuern müssen.

Nächste Schritte

• Quickstart — führen Sie Ihre erste Simulation aus.
• CLI: auth — die vollständige suya auth-Referenz.