Authentification et clés API

Subaya prend en charge deux modes d’authentification contre la même API.

Clés API — SUBAYA_API_KEY (agents et CI)

Le chemin le plus simple, et celui à utiliser pour les agents IA et les pipelines CI. Définissez la variable d’environnement et chaque commande suya (ainsi que l’API de la plateforme) la récupère :

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

Pas de navigateur, pas d’étape interactive — idéal pour les environnements headless. Émettez et gérez les clés depuis la console.

Connexion OAuth navigateur (humains)

Pour une utilisation interactive sur un poste de travail :

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

La CLI stocke le jeton résultant localement (sous ~/.config/suya/). Vérifiez-le ou effacez-le :

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

Priorité

Lorsque plusieurs identifiants sont présents, suya résout dans cet ordre :

1. Le drapeau global --token
2. SUBAYA_API_KEY
3. Le jeton OAuth stocké localement (~/.config/suya/auth.json)

Pointer vers un hôte différent

Toutes les commandes acceptent --host (par défaut https://subaya-dev.com) si vous devez cibler un point de terminaison d’API non standard.

Étapes suivantes

• Démarrage rapide — lancez votre première simulation.
• CLI : auth — la référence complète de suya auth.