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

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

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

## Модель материализации[​](#materialization-model "Прямая ссылка на Модель материализации")

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

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

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

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

## Выбор стратегии ротации[​](#choose-a-rotation-strategy "Прямая ссылка на Выбор стратегии ротации")

### Замена на месте[​](#replace-in-place "Прямая ссылка на Замена на месте")

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

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

### Миграция на новое имя[​](#migrate-to-a-new-name "Прямая ссылка на Миграция на новое имя")

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

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

## Безопасная последовательность ротации[​](#safe-rotation-sequence "Прямая ссылка на Безопасная последовательность ротации")

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`[​](#what-lastusedat-means "Прямая ссылка на what-lastusedat-means")

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

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

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

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

## События аудита аккаунта[​](#account-audit-events "Прямая ссылка на События аудита аккаунта")

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

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

| Событие         | Значение                                       |
| --------------- | ---------------------------------------------- |
| `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.

## Граница аудита[​](#audit-boundary "Прямая ссылка на Граница аудита")

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

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

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

## Связанные материалы[​](#related "Прямая ссылка на Связанные материалы")

* [Создание и управление секретами](/secrets/create-and-manage.md)
* [Использование секретов с песочницами](/secrets/use-with-sandboxes.md)
* [Использование секретов с MCP-хостингом](/secrets/use-with-mcp-hosting.md)
* [Область действия и доступ](/secrets/scope-and-access.md)
* [Жизненный цикл и засыпание при простое](/hosted-mcp/lifecycle-and-scale-to-zero)
