Переход с PolicyBox
Интеграция PolicyBox удалена в v1.4.0; в v1.3.0 она ещё присутствовала.
Удалены клиент PolicyBox, вкладка настроек, runtime playground, загрузка внешнего аудита, миграции PolicyBox при запуске и команды admin policybox. MCPBox больше не обращается к PolicyBox. Сохраняются RagBox, локальные пользователи, роли, сессии, bearer/OAuth проектов, изоляция MCP-сессий, разрешения серверов/инструментов и проверка паузы проекта.
Перед обновлением
- Остановите MCPBox и сохраните резервную копию каталога установки, SQLite, файлов баз знаний и настроенной operational PostgreSQL. Сохраните прежний бинарник для отката.
- Найдите проекты с
identity_verification_enabled: trueв авторизованном ответеGET /api/projects. Само наличие конфигурации или binding PolicyBox не включало runtime-проверку: её включал флаг проекта. Не публикуйте ответ: в нём есть credentials. - Проверьте правила identity, roles, scopes и tenant/resource в прежнем PolicyBox. Bearer MCPBox разрешает доступ к проекту, но не воспроизводит пользовательские правила PolicyBox. Нужные бизнес-ограничения должны выполняться в upstream MCP-сервере/целевой системе либо через отдельные проекты и ограниченные инструменты до открытия доступа.
Переход каждого старого проекта
После обновления проект со старым флагом отвечает 403 на MCP-подключения и AgentBox direct bootstrap даже с действующим bearer/OAuth проекта или произвольным user ID. Обычное редактирование и снятие с паузы не убирают блокировку. Другие проекты сохраняют прежние настройки авторизации.
- Войдите администратором MCPBox и выберите проект. Вместо прежней проверки идентификации появится уведомление о переходе.
- Нажмите Перейти на bearer и поставить на паузу и подтвердите действие. Операция атомарно снимает старый флаг, включает bearer authentication, создаёт новый bearer и ставит проект на паузу. URL/token проекта, серверы, промпты и связи с базами знаний сохраняются.
- Проверьте разрешения серверов/инструментов и все именованные OAuth-подключения; отключите ненужные. Прежние OAuth credentials сохраняются. Настройте клиентов на новый bearer либо одобренные OAuth credentials проекта. Admin-сессии/API tokens и старые runtime tokens PolicyBox не заменяют их.
- Снимайте проект с паузы после проверки доступа. Проверьте разрешённые и запрещённые вызовы реальными клиентами и события в журнале.
Для автоматизации: POST /api/projects/{id}/migrate-policybox на Admin listener с admin credential и scope pro:admin. Успех возвращает статус проекта; повторный запрос отвечает 409, не меняя уже перенесённый проект. Событие аудита: project_policybox_migrated. Ответы с bearer-токенами содержат секреты.
Маршруты и конфигурация
/connect/runtime,/api/agentbox/bootstrapи/api/pro/policybox/*отвечают410 Gone; ticket/exchange/validate и опубликованные manifests недоступны.- Прямые MCP-вызовы используют
/mcp/{project-token}или/connect/{project-token}. - AgentBox direct bootstrap сохранён:
POST /api/agentbox/direct-bootstrap, JSONmcp_urlи необязательныеpage_url/page_title. Он использует те же проверки bearer/OAuth, паузы и миграции проекта, что MCP. Он не создаёт runtime identities, roles, scopes, подписанные context headers или manifests PolicyBox. Переведите встраиваемый клиент в direct mode и отдельно проверьте совместимость. MCPBOX_RUNTIME_CONTEXT_HMAC_SECRETбольше не используется. Сохранённые URL, токены, bindings и manifests PolicyBox неактивны.
Данные и откат
Таблицы PolicyBox, сохранённые credentials, флаги проектов и данные внешнего сервиса автоматически не удаляются. Старый флаг остаётся в схеме только для блокировки до миграции. Если использовалась PostgreSQL, сохраняйте копии и bootstrap SQLite, и operational storage. Старые локальные события остаются в общем журнале; внешний аудит PolicyBox больше не загружается.
Для отката остановите MCPBox и восстановите прежний бинарник вместе с данными до обновления. Замена одного бинарника не отменяет явную миграцию. Настройте и проверьте прежний PolicyBox перед открытием endpoints. Это изменение не останавливает и не удаляет отдельный сервис PolicyBox: выводите его из эксплуатации отдельно после проверки других потребителей.
