CI
omni-auth
Управляет аутентификацией API-ключей и сессионными токенами. Позволяет авторизовывать запросы через Bearer token, получать сессионные cookies и настраивать требования входа для OmniRoute API.
Что делает навык
Навык управляет аутентификацией в OmniRoute API, обеспечивая доступ через Bearer-токены для запросов к шлюзу и сессионные cookies для входа в панель управления. Он позволяет авторизовывать запросы, получать сессионные токены, настраивать требования входа и управлять жизненным циклом сессий (вход/выход, OIDC).
Когда применять
- Авторизация запросов к локальному или удалённому AI-шлюзу OmniRoute с использованием API-ключа.
- Вход в панель управления (Dashboard) через POST /api/auth/login с использованием пароля администратора.
- Настройка и завершение процесса входа через OIDC (OpenID Connect) для административного доступа.
- Получение CSRF-токена для выполнения безопасных POST-запросов, таких как выход из системы.
- Проверка статуса текущей аутентификации пользователя.
Как работает
- Установите переменные окружения OMNIROUTE_URL и OMNIROUTE_KEY для работы с API-шлюзом.
- Для входа в панель управления отправьте POST-запрос на /api/auth/login с паролем и сохраните cookie в файл (например, cookie.jar).
- Для входа через OIDC перейдите по GET /api/auth/oidc/login, а затем обработайте callback на /api/auth/oidc/callback для получения JWT-сессии.
- Для выполнения защищённых действий (например, выхода) получите CSRF-токен через GET /api/auth/csrf и включите его в заголовок x-omniroute-csrf.
- Используйте заголовок Authorization: Bearer ${OMNIROUTE_KEY} для всех запросов к конечным точкам API (например, /v1/models).
- Проверяйте статус сессии через GET /api/auth/status или выходите через POST /api/auth/logout.
Примеры запросов агенту
Войди в панель управления OmniRoute, используя пароль 'secret', и сохрани сессионные cookies.
Проверь, авторизован ли я в системе, и получи текущий статус аутентификации.
Получи CSRF-токен и выполни выход из системы, используя сохранённые cookies.
Что понадобится
- Переменные окружения OMNIROUTE_URL и OMNIROUTE_KEY
- Утилита curl для выполнения HTTP-запросов
- Утилита jq для парсинга JSON-ответов
Описание составлено по SKILL.md навыка, сверено 22.10.2026.
Как подключить
1Скачать навык
# возьмите папку навыка «cheaper-inference-omni-auth» из репозитория:
# https://github.com/cheaper-inference/omniroute
2Положить папку с
SKILL.md к навыкам ассистента# положите папку навыка туда, где ассистент ищет skills:
cp -r cheaper-inference-omni-auth/ ~/.claude/skills/cheaper-inference-omni-auth/
Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.