Аутентификация
CLI выполняет вход через браузер, код устройства или API-ключ, а в скриптах и CI читает учётные данные из флага или переменной окружения. Запустите polylane auth login, чтобы выбрать метод интерактивно, или передайте флаг, чтобы пропустить выбор.
Методы входа
| Метод | Команда | Описание |
|---|---|---|
| Браузер | polylane auth login | Для интерактивной работы. CLI открывает браузер, получает токены на 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-клиенты.