Автентифікація
CLI виконує вхід через ваш браузер, код пристрою або ключ API, а в скриптах і CI читає облікові дані з прапорця або змінної середовища. Виконайте polylane auth login, щоб вибрати метод інтерактивно, або передайте прапорець, щоб пропустити вибір.
Методи входу
| Метод | Команда | Опис |
|---|---|---|
| Браузер | polylane auth login | Для інтерактивного використання. CLI відкриває ваш браузер, отримує токени через callback на localhost і оновлює їх у міру закінчення терміну дії. |
| Код пристрою | polylane auth login --no-browser | Для SSH і машин без графічного середовища. CLI друкує URL і код; відкрийте URL на будь-якому пристрої, введіть код, і CLI опитуватиме сервер, доки ви не схвалите. |
| Ключ API | polylane auth login --api-key sk_xxxxx | Для скриптів, CI та агентів. CLI перевіряє ключ і зберігає його разом із робочим простором за замовчуванням. |
Після входу CLI показує, хто ви, і, якщо ви належите до більш ніж одного робочого простору, просить вибрати робочий простір за замовчуванням, який зберігається як workspace_id у ~/.polylane/config.json. Примусово оновіть токен через polylane auth refresh.
Ключі API
Створіть ключ у розділі Settings > API Keys через Create an API key: назвіть його, виберіть області дії та скопіюйте його, бо він показується один раз. Ключі починаються з sk_. У CI задайте POLYLANE_API_KEY у середовищі замість виконання кроку входу або передайте глобальний прапорець --api-key <key> для окремого виклику.
Пріоритет облікових даних
Коли присутні кілька облікових даних, CLI розв'язує їх у такому порядку:
- Прапорець
--api-keyпоточної команди - Змінна середовища
POLYLANE_API_KEY - Облікові дані OAuth у
~/.polylane/credentials.json api_keyу~/.polylane/config.json
Експортована POLYLANE_API_KEY завжди перемагає застарілий ~/.polylane/credentials.json, тому раннер CI із заданою змінною не підхоплює залишкові токени OAuth. polylane auth status показує, яке джерело використовується.
Перевірка та перемикання
polylane auth status
polylane auth whoami
polylane auth logout
auth status показує використовуваний метод, замаскований токен, користувача та робочий простір; auth whoami показує поточного користувача. auth logout відкликає токени OAuth і очищає збережені облікові дані після підтвердження, яке пропускає --yes; щоб змінити обліковий запис, вийдіть і увійдіть з іншими обліковими даними.
Змінні середовища
| Змінна | Опис |
|---|---|
POLYLANE_API_KEY | Ключ API для неінтерактивної автентифікації |
POLYLANE_WORKSPACE_ID | Робочий простір за замовчуванням (ідентифікатор ws_) |
POLYLANE_API_DOMAIN | Перевизначення імені хоста API |
Використовуйте їх у завданнях CI та контейнерах, де ви не хочете писати в ~/.polylane/. Конфігурація перелічує повний набір.
Пов'язане
- Конфігурація: повний порядок пріоритету, кожна змінна середовища та файли на диску.
- Скриптинг: вивід JSON, коди виходу та прапорці для CI і агентів.
- Ключі API та OAuth: області дії, керування ключами та OAuth-клієнти.