Аутентификация в CLI
Войдите локально, передайте учётные данные для CI и проверьте, от чьего имени выполнится команда.
CLI использует первые доступные учётные данные: сначала глобальный параметр --api-key текущего вызова, затем LINGO_API_KEY, затем сохранённый ключ или сессию браузера в ~/.lingo/credentials.json. Это важно при смене учётной записи: даже если вы заново войдёте и сохраните данные входа, приоритет останется у ключа, который уже передаёт командная оболочка.
Вход #
lingo login
lingo whoamiПри входе без ключа CLI открывает браузер для авторизации через OAuth и сохраняет сессию. CLI обновляет сессии незадолго до истечения срока их действия. Если обновить сессию не удалось, войдите заново.
Успешный вход не завершает настройку организации и не означает, что требования SSO всех организаций выполнены. Если привязка возвращает вас в веб-приложение, завершите настройку этой организации или войдите через SSO, прежде чем повторить попытку.
lingo login --api-key <value> проверяет и сохраняет ключ. В отличие от него, глобальный параметр --api-key в другой команде действует только для текущего вызова. Поддерживаются и раздельная запись, и запись в формате --api-key=value. Лучше передавать секреты через механизм их подстановки, а не в командной строке: иначе они могут попасть в историю оболочки, сведения о процессах или диагностические данные.
CLI создаёт каталог учётных данных с правами 0700, а файл учётных данных — с правами 0600.
Текущая учётная запись #
lingo whoami --jsonРезультат показывает тип аутентификации и доступный контекст организации и движка локализации. Команда whoami проверяет учётные данные онлайн. При сбое подключения она может вернуть лишь часть сохранённых сведений. Если аутентификация отклонена, учётная запись не считается подтверждённой.
Проверьте, от чьего имени выполняются команды, перед привязкой checkout. Сохранённый ИД ресурса определяет, какой ресурс использовать, но не даёт учётным данным права доступа к нему.
Выход #
lingo logoutПри выходе CLI удаляет сохранённые учётные данные. Но ключ из переменной окружения или флаг вызова по-прежнему может использоваться для аутентификации следующих команд. Уберите этот параметр из оболочки, если больше не хотите его использовать. Выход не отзывает ключ, не удаляет ресурсы и не отменяет привязку проекта.
CI #
Передавайте LINGO_API_KEY через механизм секретов среды выполнения и сохраняйте в репозитории только настройки проекта без секретов. Запускайте CLI из корневого каталога нужного проекта. Не копируйте сессию из домашнего каталога разработчика в CI.
Встроенная интеграция с GitHub использует собственные полномочия и механизм одобрения запусков — независимо от среды выполнения CLI, которой вы управляете самостоятельно.