Аутентификация CLI — Altifigence Documentation

Войдите с помощью нативного PKCE Cloud и отличайте его сеанс от прежних учётных данных API и сервиса DDS.

Overview

Выберите путь учётных данных для используемой команды. Нативный вход Cloud, прежние учётные данные клиентских действий и настроенный оператором HTTP-сервис DDS имеют отдельные контракты. Локальному XLS и нативным операциям рабочей области не нужны учётные данные Cloud.

Учётные данные настольного приложения и CLI раздельны

Интерфейс	Путь учётных данных	Полномочия
Digital Design Studio 2.0.2 Windows	Вход через браузер для защищённых локальных функций; редактирование и сохранение работают и без входа	Лицензия устройства My PC не нужна. Вход с Free поддерживает описанные локальные функции; Cloud и ИИ проверяют отдельные разрешения.
`alti` `ide` `cloud`	PKCE через браузер и частный сеанс CLI	Личность учётной записи и разрешения организации/проекта проверяет сервер
Клиент действий/заданий заказчика	`ALTI_TOKEN` и `ALTI_ORG_ID`	Учётные данные и область доступа, предоставленные выбранному API
`alti` `ide` `service`	Настроенный адрес сервиса и `ALTI_STUDIO_SERVICE_SECRET`	Существующий контракт авторизации устаревшего сервиса

Ни один сеанс CLI не предоставляет настольную лицензию. Не импортируйте файлы настольного сеанса, cookie браузера или внутренние заголовки сервиса в нативный запрос Cloud.

Нативный вход Cloud

alti ide cloud login
alti ide cloud whoami
alti ide cloud refresh
alti ide cloud logout

Вход выводит URL авторизации для процесса PKCE в браузере. По умолчанию используются https://api.altifigence.com и частный каталог сеанса ~/.local/state/altifigence/cloud-cli. Используйте --session-dir последовательно для выбора другого сеанса. Вход также принимает --org и ограниченный --wait-seconds; последующие команды используют собственные сроки запросов.

Используйте whoami для определения личности сервером вместо вывода из сохранённого токена. Обновление и выход работают с этим нативным сеансом. Идентификаторы организации/проекта в командах поиска и терминала Cloud ограничивают запрос, но не предоставляют доступ. Типизированные операции ide cloud run сохраняют серверные проверки разрешений и требуют --allow-source-upload, когда их контракт передаёт загружаемые исходники.

CLI подключается через явные нативные маршруты API. Процесс входа не обещает, что каждая операция Cloud включена для каждой организации.

Переменные среды, читаемые CLI

Прежние клиенты клиентских действий и заданий Cloud сохраняют следующие настройки:

Переменная	Действие
`ALTI_TOKEN`	Обязательные учётные данные bearer; отсутствие или пустое значение отклоняются
`ALTI_ORG_ID`	Обязательная область организации
`ALTI_API_BASE`	Базовый адрес API, по умолчанию `https://api.altifigence.com`
`ALTI_BYO`	`1`, `true` или `yes` выбирает тип собственного субъекта доступа
`ALTI_ALLOW_SOURCE_UPLOAD`	Согласие на клиентские действия MCP с исходниками; отсутствие означает отказ

Настраивайте переопределение конечных точек только на сервис под вашим контролем или адрес, явно предоставленный вашей учётной записи. Изменение адреса может отправить соответствующие учётные данные другому хосту.

Прежние HTTP-команды DDS вместо этого используют --endpoint или ALTI_STUDIO_ENDPOINT и существующую настройку секрета сервиса в среде. Они не используют повторно нативный вход Cloud и не создают новый процесс аутентификации этого сервиса.

Статус конфигурации не является аутентификацией

alti auth status проверяет только конфигурацию прежней среды. Его serverVerification остаётся not_performed; это не эквивалент alti ide cloud whoami.

Прежние верхнеуровневые alti login и alti whoami всё ещё завершаются с кодом 4 и AUTH_FLOW_UNAVAILABLE и IDENTITY_NOT_VERIFIED. Верхнеуровневый alti logout не может очистить значения, унаследованные от родительского процесса. Очистите или смените эти значения у источника; используйте ide cloud logout для нативного сеанса.

Работа с секретами

Храните учётные данные CI в хранилище секретов CI и передавайте только шагу, которому они нужны.
Каталоги сеансов должны быть частными для владельца; не добавляйте их в контроль версий, общие межпользовательские кеши или опубликованные артефакты.
Не записывайте в журнал токены, секреты сервисов, cookie браузера или полную среду.
Отключайте трассировку оболочки вокруг команд с учётными данными и меняйте любое значение, которое могло попасть в журнал.

Доступ к удалённому API

Используйте типизированные Команды заданий и Cloud для выбранного бэкенда. Проверка клиента и успешный вход не заменяют серверные разрешения и не доказывают завершение запрошенного задания.

Проверка и восстановление нативного сеанса

alti ide cloud login
alti ide cloud whoami

Выполняйте их от того же обычного пользователя Linux, который будет использовать CLI. Завершите процесс в браузере и требуйте успешный ответ whoami до операций рабочей области. Если используете другой --session-dir, применяйте его для входа и последующих вызовов; другой каталог означает другой сохранённый сеанс.

Если сеанс истёк, используйте нативный процесс обновления/входа. Если личность подтверждена, но проект недоступен, проверьте членство в организации и разрешения проекта. Не копируйте учётные данные настольного приложения и не меняйте адреса API для обхода отказа. Восстановление учётной записи см. в Безопасности учётной записи.