Перейти к основному содержимому
Открыть Markdown

Ротация и аудит секретов

Ротация секрета состоит из двух отдельных действий: заменить сохраненное значение, а затем заменить каждую материализованную копию, которая все еще использует старое значение. Обновление записи секрета не доставляет изменения в работающие песочницы или сервисы Hosted MCP.

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

Модель материализации​

Получатели получают снимок на определенной границе жизненного цикла:

ПолучательКогда он читает секретКак получить ротированное значение
ПесочницаПеред созданием песочницыСоздать заменяющую песочницу
Hosted MCPВо время каждого развертыванияВыполнить повторное развертывание инстанса Hosted MCP

Удаление исходного секрета запрещает его последующее разрешение по имени. Оно не стирает переменные окружения, файлы, конфигурацию репозиториев или окружение процесса, уже материализованные у получателя.

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

Выбор стратегии ротации​

Замена на месте​

Передайте полное новое значение существующего секрета через запрос PATCH. Его имя и все настроенные ссылки сохранятся.

Подход подходит, когда провайдер допускает период одновременной валидности и всех получателей можно оперативно пересоздать или повторно развернуть. Just Run не хранит доступные пользователю версии секретов, поэтому для отката придется снова ввести старое значение, пока оно еще действительно.

Миграция на новое имя​

Создайте второй секрет, например payments-api-v2, переведите на него получателей, проверьте их и позже удалите старую запись.

Так состояние перехода видно явно, а откат проще, потому что старую запись все еще можно выбрать. При этом нужно обновить все ссылки и не допустить неоднозначных пересекающихся записей.

Безопасная последовательность ротации​

  1. Составьте список песочниц, инстансов Hosted MCP и внешних систем, где все еще могут находиться старые учетные данные.
  2. Выпустите новые учетные данные, сохранив старые действительными, если провайдер поддерживает период пересечения.
  3. Полностью замените типизированное значение на месте или создайте секрет с новым именем.
  4. Создайте заменяющие песочницы и повторно разверните все затронутые инстансы Hosted MCP.
  5. Проверьте поведение получателей, не выводя учетные данные.
  6. Отзовите старые учетные данные у провайдера.
  7. Удаляйте устаревший секрет из Just Run, только когда на него больше не ссылаются будущие получатели.
  8. Проверьте активность аккаунта и логи провайдера на неожиданное использование.

Не отзывайте старые учетные данные до переключения получателей, если незапланированный простой неприемлем. При ротации в ходе реагирования на инцидент приоритетом может быть немедленный отзыв у провайдера; считайте уже материализованные копии скомпрометированными.

Для Hosted MCP нужно явное повторное развертывание

Изменение секрета, на который есть ссылка, не меняет определение или статус ready у Hosted MCP. Вызовите POST /v1/hosted-mcp/{id}/redeploy напрямую либо измените и сохраните инстанс на странице MCP-хостинг, чтобы он перешел в состояние нужен redeploy, а затем нажмите Передеплоить в его строке.

Что означает last_used_at​

Список секретов и API предоставляют last_used_at. Поле обновляется без гарантий после успешного разрешения секрета при создании песочницы.

Считайте его полезным сигналом, а не полным реестром зависимостей:

  • поле не показывает получателя, который получил значение;
  • старая временная метка не доказывает отсутствие существующей материализованной копии;
  • развертывание Hosted MCP разрешает ссылки env отдельным путем и не обновляет last_used_at исходного секрета;
  • неуспешная или потерянная запись метаданных может оставить временную метку без изменений.

Для решения о ротации используйте явный реестр конфигураций и логи доступа внешнего провайдера.

События аудита аккаунта​

Откройте Аккаунт → Активность, чтобы увидеть недавние события активного аккаунта. Предустановленные фильтры текущего интерфейса не перечисляют все события секретов: оставьте в фильтре событий значение Все события или запросите точный тип через эндпоинт аккаунта.

Успешные операции с секретами создают события:

СобытиеЗначение
secret.createСоздана запись секрета
secret.updateИзменены ее метаданные или полное значение
secret.deleteИсходная запись удалена
secret.useСекрет успешно разрешен при создании песочницы

Ротация значения записывается как secret.update; отдельного события secret.rotate нет. События содержат учетную запись и маскированные метаданные ресурса, но не значение секрета.

Hosted MCP использует собственные события. Повторное развертывание создает hosted_mcp.redeploy, после которого следует hosted_mcp.deploy.success или hosted_mcp.deploy.failure. Событие secret.use для каждого секрета, на который есть ссылка, при этом не создается.

Запросите события в пределах аккаунта с персональным токеном:

export JUSTRUN_API="https://your-just-run-host"
export JUSTRUN_PAT="your-personal-access-token"

curl --fail-with-body --silent --show-error \
"$JUSTRUN_API/v1/account/audit-logs?resource_type=secret&limit=100" \
--header "Authorization: Bearer $JUSTRUN_PAT" |
jq '{total, logs: [.logs[] | {
created_at,
event_type,
resource_id,
resource_name,
outcome
}]}'

Эндпоинт всегда ограничивает результат активным аккаунтом. Он поддерживает точные фильтры event_type, resource_type, resource_id и outcome, включительные границы from и to в RFC 3339 и постраничный вывод со смещением. Значение limit по умолчанию равно 50 и ограничивается диапазоном 1–500.

Граница аудита​

Доставка событий аудита асинхронна и выполняется без гарантий. При сбое процесса, недоступности базы данных или переполнении канала событие может отсутствовать, даже если продуктовая операция завершилась успешно. Поэтому журнал аккаунта подходит для устранения неполадок и операционного анализа, но не является неизменяемым или полным журналом для проверки соответствия требованиям.

Для более сильной проверки сопоставляйте его с:

  • логами выпуска, доступа и отзыва у провайдера учетных данных;
  • реестром ссылок на секреты и материализованных получателей;
  • записями о заменяющих песочницах и успешных поколениях Hosted MCP;
  • принадлежащими организации расписанием ротации и процедурой реагирования на инциденты.