Безопасность Drive, аудит и правила безопасного удаления

Автоматизация Drive обладает широкими возможностями: она может перемещать, публиковать и удалять файлы. Такие возможности требуют четких правил безопасности. API Drive в TrekMail объединяет токены с узкой областью действия, восстановление файлов из Корзины, отдельные разрешения на безвозвратное удаление, защитные ограничения MCP и ведение журнала аудита. Благодаря этому агенты могут работать, не превращаясь в невидимых администраторов файлов.

Используйте токены с узкой областью действия

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

Не предоставляйте все области доступа Drive одному постоянно активному агенту. Если что-то пойдет не так, узкая область действия токена ограничит масштаб последствий и упростит проверку журнала аудита.

Сначала в Корзину, затем безвозвратное удаление

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

Используйте следующее правило по умолчанию:

Агенты могут перемещать файлы в корзину в рамках утвержденного рабочего процесса. Безвозвратно удалять файлы можно только по явному запросу пользователя или во время выполнения проверенного задания технического обслуживания.

Администратор локально размещенного сервера MCP может потребовать TREKMAIL_ALLOW_DESTRUCTIVE=true для инструментов безвозвратного удаления. Соответствующая область доступа для такого удаления необходима всегда.

Проверяйте публичные ссылки

Публичные ссылки предназначены для передачи файлов внешним получателям. Любой человек с URL может скачать файл, пока срок действия ссылки не истечет, не будет достигнут лимит скачиваний или ссылка не будет отозвана.

Более безопасные настройки по умолчанию:

• Укажите дату окончания срока действия.
• Установите лимит скачиваний.
• Отзывайте ссылки после завершения проекта.
• Не создавайте публичные ссылки на файлы, доступ к которым должен предоставляться только указанным получателям, если это не разрешено вашей политикой.

Регистрируйте каждый рабочий процесс, изменяющий данные

Изменяющие данные действия API Drive и MCP записываются с указанием токена. Используйте раздел ИИ-агенты и API → Журнал аудита, чтобы выяснить:

• Какой токен создал эту папку?
• Какой агент загрузил файл?
• Когда была создана или отозвана публичная ссылка?
• Выполнялось ли безвозвратное удаление?

Если впоследствии токен будет отозван, исторические записи аудита останутся полезными для проверки.

Ограничения по почтовому ящику

Если агенту нужен только Drive одного почтового ящика, ограничьте токен этим ящиком. API не покажет ресурсы за пределами такого ограничения. Это особенно важно для помощников, встроенных в рабочий процесс отдельного почтового ящика.

Безопасность оплаты

Изменение оплаты дополнения Drive недоступно через инструменты записи API или MCP. Агенты могут читать состояние и цены дополнения, но покупка, изменение объема и отмена выполняются только в панели управления. Поэтому токен автоматизации файлов не может превратиться в токен автоматизации оплаты.

Контрольный список при инциденте

Если агент совершил неожиданное действие:

1. Отзовите токен.
2. Просмотрите журнал аудита, отфильтрованный по этому токену.
3. По возможности восстановите файлы из Корзины.
4. Отзовите непредусмотренные ссылки для общего доступа.
5. Создайте новый токен с более узкой областью действия только после исправления рабочего процесса.

Связанные статьи

• Области доступа и разрешения API Drive
• Руководство по ссылкам общего доступа через API и MCP
• Массовые операции с файлами Drive через API/MCP