Ключи управления больше не обязательно должны предоставлять полный административный доступ ко всей вашей организации. Теперь вы можете сделать ключ доступным только для чтения, ограничить его одной рабочей областью или применить оба ограничения, чтобы каждый ключ выполнял только ту задачу, для которой он был создан. Ключи с доступом только для чтения могут просматривать ключи API, активность и использование, а ключи с доступом на чтение/запись могут также создавать, обновлять и удалять ключи API. Если ключ будет скомпрометирован или использован не по назначению, ущерб останется локализованным.
Доступно уже сегодня для каждой организации на любом тарифном плане. Создайте ключ на странице «Ключи» вашей рабочей области или в разделе «Ключи API управления» (Management API Keys), и ознакомьтесь с руководством по ключам API управления, чтобы узнать, какие маршруты может вызывать каждый тип ключа.
Команды управляют своими рабочими областями, и теперь их автоматизация может делать то же самое
По мере роста организаций в OpenRouter они разделяют свою работу на рабочие области, часто по одной на команду. Каждая команда управляет своей собственной рабочей областью, а администраторы организации следят за тем, что является общим для всех: кредиты, бюджеты и настройки организации.
До настоящего момента ключ управления всегда имел полный доступ на чтение и запись ко всей организации. Команде, которая хотела автоматизировать свою собственную рабочую область, приходилось использовать ключ, который мог получить доступ и ко всем остальным рабочим областям.
Теперь у каждого ключа есть две настройки. Область действия (Scope) определяет, где работает ключ: в одной рабочей области или во всей организации. Уровень доступа (Access level) определяет, что он может там делать: только чтение или чтение и запись. Администраторы рабочих областей могут создавать ключи для своей собственной рабочей области, чтобы конвейер развертывания мог обновлять ключи API команды, агент мог настраивать защитные барьеры (guardrails), или скрипт мог добавлять участников в рабочую область, при этом ни один из них не получит доступа к рабочей области другой команды.
Область действия ограничивает ключ одной рабочей областью
Ключ, ограниченный рабочей областью, работает только в ней. Если запрос указывает на другую рабочую область или ресурс, принадлежащий ей, OpenRouter отказывает в доступе. Неисправный агент или скомпрометированный ключ не смогут получить доступ к остальной части вашей организации.
Внутри своей рабочей области ключ может управлять ключами API, участниками, защитными барьерами и политиками защитных барьеров, вашими собственными ключами провайдеров, пунктами назначения для наблюдаемости и пресетами. Он может считывать бюджеты, активность и аналитику рабочей области.
Лимиты бюджета, кредиты и настройки организации остаются под контролем администраторов организации. Команда может автоматизировать всё внутри своей рабочей области, но по-прежнему не сможет увеличить бюджет своей рабочей области. Установка бюджета рабочей области, создание или удаление рабочих областей, управление участниками организации и частными конечными точками по-прежнему требуют ключа организации, который работает так же, как и всегда.
Доступ только для чтения позволяет инструментам просматривать данные без внесения изменений
Уровень доступа — это вторая настройка, и она применяется как к ключам рабочих областей, так и к ключам организации. Ключ с доступом только для чтения может вызывать маршруты чтения, разрешенные его областью действия, включая аналитические запросы. Любой запрос, который пытается создать, изменить или удалить что-либо, вернет ошибку.
Это подходит для инструментов, которым нужно только просматривать данные. Панель мониторинга затрат может получать данные об использовании, агент мониторинга может следить за активностью, а скрипт аудита может перечислять ключи, защитные барьеры и ключи провайдеров. Вы можете подключить новый инструмент отчетности или аудита, не предоставляя ему доступ на запись к вашей учетной записи.
Предоставляйте каждой задаче ключ только с необходимым уровнем доступа
Область действия и уровень доступа объединяются в четыре типа ключей:
- Агент, который создает и обновляет ключи API для одной команды, получает ключ на чтение/запись для рабочей области этой команды.
- Панель мониторинга использования для одной команды получает ключ только для чтения для рабочей области этой команды.
- Инструмент аудита или контроля затрат в масштабах всей организации получает ключ организации только для чтения.
- Любой инструмент, который создает рабочие области или устанавливает лимиты бюджета, сохраняет ключ организации на чтение/запись.
Обе настройки фиксируются при создании ключа, поэтому ключ не может получить расширенные права позже. Чтобы изменить любую из них, создайте новый ключ и удалите старый.
Создание ключа на панели управления
- Откройте рабочую область, перейдите в раздел «Ключи» и выберите вкладку «Ключи управления». Администраторы рабочих областей могут создавать ключи для своей собственной рабочей области, а администраторы организации могут создавать их для любой рабочей области.
- Нажмите «Новый ключ управления». В диалоговом окне будет показано, к какой рабочей области привязан ключ.
- Введите имя, выберите срок действия и выберите «Только чтение» или «Чтение и запись» в разделе «Уровень доступа».
- Скопируйте ключ, когда он появится. Вы больше не увидите его.
Для ключа, который охватывает всю организацию, администраторы организации используют страницу «Ключи API управления».
Ваши агенты и инструменты используют ключ так же, как они используют ключ управления сегодня, в качестве токена Bearer в API управления:
Чтобы просмотреть ключи управления, которые у вас уже есть, откройте настройки безопасности, перейдите в раздел «Безопасность ключей», откройте «Фильтр ключей» и выберите «Показать ключи управления». Каждый активный ключ отображается с указанием владельца, последнего использования и срока действия. В руководстве по ключам API управления перечислены все маршруты, которые может вызывать каждый тип ключа.












