prx auth

Управление профилями OAuth-аутентификации. PRX использует потоки OAuth2 для провайдеров и сервисов, которые их поддерживают (GitHub Copilot, Google Gemini и т.д.). Профили аутентификации хранят токены в защищённом хранилище секретов PRX.

Использование

prx auth <SUBCOMMAND> [OPTIONS]

Подкоманды

prx auth login

Аутентификация с провайдером или сервисом.

prx auth login [OPTIONS]

Флаг	Сокр.	По умолчанию	Описание
--provider	-P		Провайдер для аутентификации (например, github-copilot, google-gemini)
--profile		default	Именованный профиль для нескольких учётных записей
--browser		true	Открыть браузер для потока OAuth
--device-code		false	Использовать поток device code (для headless-окружений)

# Вход в GitHub Copilot
prx auth login --provider github-copilot

# Поток device code (без браузера)
prx auth login --provider github-copilot --device-code

# Вход с именованным профилем
prx auth login --provider google-gemini --profile work

Процесс входа:

1. PRX открывает браузер (или отображает device code) со страницей согласия OAuth провайдера
2. Вы авторизуете PRX в браузере
3. PRX получает и безопасно сохраняет токены доступа и обновления
4. Токен автоматически используется для последующих API-вызовов

prx auth refresh

Ручное обновление истёкшего токена доступа.

prx auth refresh [OPTIONS]

Флаг	Сокр.	По умолчанию	Описание
--provider	-P	все	Провайдер для обновления (обновляет все, если не указано)
--profile		default	Именованный профиль для обновления

# Обновить токены всех провайдеров
prx auth refresh

# Обновить конкретного провайдера
prx auth refresh --provider github-copilot

TIP

Обновление токенов происходит автоматически при обычной работе. Используйте эту команду только при устранении проблем с аутентификацией.

prx auth logout

Удаление сохранённых учётных данных для провайдера.

prx auth logout [OPTIONS]

Флаг	Сокр.	По умолчанию	Описание
--provider	-P		Провайдер для выхода (обязательный)
--profile		default	Именованный профиль для выхода
--all		false	Выйти из всех провайдеров и профилей

# Выход из GitHub Copilot
prx auth logout --provider github-copilot

# Выход из всех учётных записей
prx auth logout --all

Профили аутентификации

Профили позволяют использовать несколько учётных записей для одного провайдера. Это полезно, когда у вас есть отдельные рабочий и личный аккаунты.

# Вход с двумя разными аккаунтами Google
prx auth login --provider google-gemini --profile personal
prx auth login --provider google-gemini --profile work

# Использование конкретного профиля в чате
prx chat --provider google-gemini  # использует профиль "default"

Установка активного профиля для провайдера в файле конфигурации:

[providers.google-gemini]
auth_profile = "work"

Хранение токенов

Токены шифруются с использованием алгоритма ChaCha20-Poly1305 и хранятся в хранилище секретов PRX по пути ~/.local/share/prx/secrets/. Ключ шифрования выводится из идентификатора машины.

См. также

• Обзор аутентификации — архитектура аутентификации
• Поток OAuth2 — подробная документация потока OAuth2
• Профили аутентификации — управление профилями
• Хранилище секретов — как токены хранятся безопасно