Authentification
La CLI se connecte via ton navigateur, un code d'appareil ou une clé API, et dans les scripts et la CI elle lit l'identifiant depuis un drapeau ou une variable d'environnement. Lance polylane auth login pour choisir une méthode de façon interactive, ou passe un drapeau pour sauter le sélecteur.
Méthodes de connexion
| Méthode | Commande | Description |
|---|---|---|
| Navigateur | polylane auth login | Pour l'usage interactif. La CLI ouvre ton navigateur, reçoit les tokens sur un callback localhost et les rafraîchit à leur expiration. |
| Code d'appareil | polylane auth login --no-browser | Pour SSH et les machines sans interface graphique. La CLI affiche une URL et un code ; ouvre l'URL sur n'importe quel appareil, saisis le code, et la CLI interroge le serveur jusqu'à ce que tu approuves. |
| Clé API | polylane auth login --api-key sk_xxxxx | Pour les scripts, la CI et les agents. La CLI valide la clé et la stocke avec un espace de travail par défaut. |
Après la connexion, la CLI montre qui tu es et, si tu appartiens à plus d'un espace de travail, te demande d'en choisir un par défaut, enregistré comme workspace_id dans ~/.polylane/config.json. Force un rafraîchissement du token avec polylane auth refresh.
Clés API
Crée une clé sous Settings > API Keys avec Create an API key : nomme-la, choisis ses scopes et copie-la, car elle n'est affichée qu'une fois. Les clés commencent par sk_. En CI, définis POLYLANE_API_KEY dans l'environnement au lieu de lancer l'étape de connexion, ou passe le drapeau global --api-key <key> sur un seul appel.
Priorité des identifiants
Quand plusieurs identifiants sont présents, la CLI les résout dans cet ordre :
- Le drapeau
--api-keysur la commande courante - La variable d'environnement
POLYLANE_API_KEY - Les identifiants OAuth dans
~/.polylane/credentials.json api_keydans~/.polylane/config.json
Une variable POLYLANE_API_KEY exportée l'emporte toujours sur un ~/.polylane/credentials.json périmé, donc un runner CI avec la variable définie ne récupère pas des tokens OAuth oubliés. polylane auth status indique quelle source est utilisée.
Vérifier et changer
polylane auth status
polylane auth whoami
polylane auth logout
auth status montre la méthode utilisée, un token masqué, l'utilisateur et l'espace de travail ; auth whoami montre l'utilisateur courant. auth logout révoque les tokens OAuth et efface les identifiants stockés après une confirmation, que --yes saute ; pour changer de compte, déconnecte-toi et reconnecte-toi avec l'autre identifiant.
Variables d'environnement
| Variable | Description |
|---|---|
POLYLANE_API_KEY | Clé API pour l'authentification non interactive |
POLYLANE_WORKSPACE_ID | Espace de travail par défaut (identifiant ws_) |
POLYLANE_API_DOMAIN | Remplacement du nom d'hôte de l'API |
Utilise-les dans les jobs de CI et les conteneurs où tu ne veux pas écrire dans ~/.polylane/. Configuration liste l'ensemble complet.
Voir aussi
- Configuration : l'ordre de priorité complet, chaque variable d'environnement et les fichiers sur disque.
- Scripting : la sortie JSON, les codes de sortie et les drapeaux pour la CI et les agents.
- Clés API et OAuth : scopes, gestion des clés et clients OAuth.