Перейти к содержанию
Публикация AiManual

Skyflow и Amazon Bedrock AgentCore Gateway: как защитить данные в вызовах инструментов AI-агентов

Skyflow подключается к Amazon Bedrock AgentCore Gateway как перехватчик: заменяет чувствительные данные токенами на пути к инструменту и восстанавливает их для

Коротко

Что будет в материале

  1. 01

    Где утекают данные, когда агент вызывает инструменты

  2. 02

    Как перехватчик Skyflow встраивается в AgentCore Gateway

  3. 03

    Три режима защиты: Shield the tool, Shield the model и Shield the document

  4. 04

    Ограничения, которые нужно учесть до пилота

Где утекают данные, когда агент вызывает инструменты

Skyflow подключается к Amazon Bedrock AgentCore Gateway как перехватчик запросов и ответов. Он де-идентифицирует чувствительные данные до того, как они дойдут до инструмента, модели или логов, и восстанавливает исходные значения для авторизованных получателей. Код агентов и инструментов менять не нужно: контроль ставится один раз на шлюзе и действует для всех агентов и всех инструментов за ним. Разбор интеграции в блоге AWS описывает эту схему на уровне перехватчика.

Проблема, которую закрывает такая конструкция, узкая и вполне конкретная. Агенты научились действовать через инструменты: MCP-серверы, SaaS API, хранилища документов, веб-поиск. Корпоративные контроли при этом обычно смотрят на то, что уходит в модель и что из неё возвращается. Обмен агента с инструментами остаётся в стороне, а персональные данные проходят именно там.

Первый канал - аргументы вызова. Модель пишет их из всего, что лежит в контексте, включая детали, которые инструменту не нужны. Аналитик просит агента разобрать спорную транзакцию, и имя клиента, номер счёта или email уходят в запрос к стороннему серверу. Инструменту для проверки статуса операции эти поля не требуются.

Второй канал - результаты инструмента. Выдержки из веб-страниц, записи CRM и заметки по обращениям попадают в контекст модели, её память, трассировки и логи. Дальше они живут там столько, сколько живут логи, и удалить их оттуда точечно почти невозможно.

Третий канал - документы. Amazon S3, Box и Google Drive возвращают подписанный URL, а не текст. Фильтр, который проверяет строки, видит ссылку и пропускает её, после чего агент открывает исходный файл. Содержимое документа проходит мимо контроля целиком.

Почему фильтры на уровне промптов не решают задачу

Строковый фильтр умеет одно: найти шаблон и заблокировать вызов. Для части сценариев этого достаточно. Для агентных вызовов блокировка ломает задачу, не защищая данные: агент не получит ответ и не сможет продолжить работу. Второе ограничение в том, что фильтр не возвращает исходное значение авторизованному получателю. Третье - он не видит содержимое файла за подписанным URL.

Перехватчик работает иначе. Он запускается на каждом вызове, проходящем через шлюз, и может проверить payload, переписать его или заблокировать. Замена на токен сохраняет работоспособность сценария: инструмент получает обезличенный идентификатор, агент получает исходное значение после восстановления. Атаки на входе модели, промпт-инъекции и обфускация устроены по другой логике, они разобраны в материале про трёхфазную защиту AI-агентов.

Как перехватчик Skyflow встраивается в AgentCore Gateway

AgentCore Gateway стоит перед каждым инструментом агента, независимо от фреймворка и модели, на которой этот агент работает. Через перехватчики шлюз позволяет запускать собственный код в виде AWS Lambda-функции на каждом вызове. Перехватчик запросов видит вызов до того, как он достигнет инструмента. Перехватчик ответов видит результат до того, как его прочитает агент. Оба могут проверить payload, переписать его или заблокировать вызов. Skyflow Detect подключается в это место как готовый перехватчик.

Документация AWS различает два типа перехватчиков: REQUEST и RESPONSE. REQUEST-перехватчик вызывается до того, как шлюз обратится к целевому ресурсу, и подходит для собственных проверок и авторизации. RESPONSE-перехватчик вызывается до ответа вызывающей стороне и может изменять ответ, например выполнять редактирование или дополнение. Оба типа реализуются как AWS Lambda-функции, которые получают и возвращают структурированный payload. Если REQUEST-перехватчик возвращает в выходном payload готовый ответ, шлюз отвечает этим содержимым немедленно, не обращаясь к цели. Для HTTP-целей перехватчики поддерживаются только в буферизованном режиме: шлюз буферизует полный ответ, прежде чем вызвать RESPONSE-перехватчик. Типы перехватчиков AgentCore Gateway описаны в документации AWS.

Путь одного вызова выглядит так:

  1. Агент формирует вызов инструмента и отправляет его на шлюз.
  2. Перехватчик запроса находит чувствительные поля и заменяет их токенами.
  3. Инструмент получает очищенный payload и работает с обезличенными значениями.
  4. Перехватчик ответа восстанавливает исходные значения для авторизованного получателя.
  5. Агент читает результат в привычном виде, код агента не менялся.

Точка подключения одна. Контроль, прикреплённый к шлюзу, охватывает всех агентов и все инструменты за ним, поэтому не нужно обходить десятки сервисов и договариваться с каждой командой отдельно. Skyflow доступен в AWS Marketplace, а сам перехватчик открыт на GitHub, так что логику можно изучить до пилота и не покупать вслепую. Описание решения и ссылки на репозиторий есть в публикации AWS.

Что видит и что может сделать перехватчик на каждом шаге

Границы конкретные: инспекция payload, переписывание, блокировка. Смысл запроса за пределами заданных политик перехватчик не анализирует, поэтому качество защиты определяется тем, какие поля и шаблоны вы описали и какие инструменты охватили.

Пример с email и номером счёта. Агент вызывает внешний API проверки контрагента и отправляет в аргументах {"email": "client@example.com", "account": "40817810099910004312"}. Перехватчик запроса заменяет оба значения токенами, инструмент получает обезличенный запрос. В ответе приходит токен вместо номера, перехватчик ответа восстанавливает исходное значение, и агент показывает аналитику тот же номер счёта, что был в системе.

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

Из чего состоит решение на стороне AWS

В опубликованном разборе AWS описаны шлюз, перехватчик и его поведение на каждом вызове, а состав вспомогательных сервисов именно решения Skyflow там не детализирован. Раскладка ниже - рамка для проектирования, её стоит согласовать с командой и поставщиком до пилота. Названия сервисов даны как кандидаты под задачу, а не как подтверждённый перечень из статьи.

Что нужноКандидатЧто решить до пилота
Политики: какие поля де-идентифицировать и в каких инструментахAWS Systems Manager Parameter StoreКто владеет политикой, как проходит ревью изменений, как быстро откатить правку
Ключи и секретыAWS Secrets ManagerРотация, разделение по средам, кто имеет доступ на чтение
Хранение токеновAmazon DynamoDBСрок жизни записи, удаление, поведение при сбое функции
Логи и метрикиAmazon CloudWatchЧто именно попадает в логи: payload целиком или только факт срабатывания
Среда выполнения перехватчикаAWS LambdaТаймауты, конкурентность, деградация при недоступности хранилища токенов

Разделение по сервисам нужно не для красоты. Политики меняются чаще ключей, ключи ротируются по расписанию, токены живут минуты или часы. Когда всё это лежит в одном месте, любая правка требует релиза, а компрометация одного компонента раскрывает остальные. Отдельный вопрос к команде: что окажется в CloudWatch при ошибке перехватчика. Логи с исходным payload обнуляют всю схему, потому что чувствительные данные возвращаются в систему через журнал.

Ориентир по составу сервисов дают открытые примеры AWS для AgentCore Gateway. В примере с учётом расходов на LLM два Lambda-перехватчика привязывают каждый вызов к пользователю и применяют жёсткие дневные и месячные бюджеты до обращения к модели: превышение обрабатывается в REQUEST-перехватчике и возвращает HTTP 403. Метрики расходов по пользователям, командам и моделям идут в CloudWatch, журнал учёта - в DynamoDB, а весь стек, включая Cognito, KMS и конвейер ротации, собран в одном шаблоне CloudFormation. В примере с идентичностью REQUEST-перехватчик передаёт идентичность пользователя и внедряет персональные учётные данные, при этом агент не хранит учётные данные целевой системы. Эти примеры показывают, как перехватчики раскладываются по сервисам, но не описывают внутреннее устройство перехватчика Skyflow.

Три режима защиты: Shield the tool, Shield the model и Shield the document

В опубликованном разборе AWS перехватчик описан через три задачи: де-идентифицировать данные до того, как они достигнут инструмента, восстановить их до того, как агент прочитает результат, и заменить документ очищенной копией до того, как агент его откроет. Эти три задачи удобно называть режимами защиты, но официальных названий «Shield the tool», «Shield the model» и «Shield the document» и их формального описания в доступных материалах нет. Ниже - рабочая трактовка по трём точкам, где срабатывает замена; точные названия режимов, их настройки и поведение нужно сверить с документацией Skyflow до пилота.

Точка защитыЧто скрываетсяТипичный сценарийЧто получает агент
Аргументы вызоваЧувствительные поля в аргументах вызоваВеб-поиск, внешний SaaS APIРезультат по обезличенному запросу, исходные значения возвращаются на ответе
Результаты инструментаДанные в результатах инструмента до попадания в контекстДиалоги с клиентами, записи CRM, заметки по обращениямОбезличенные данные и восстановление для авторизованного получателя
ДокументыСодержимое файла за подписанным URLДокументы в Amazon S3, Box, Google DriveОчищенная копия документа вместо оригинала

Защита аргументов вызова

Сценарий: агент ищет информацию в веб-поиске или обращается к внешнему API, а в аргументах оказываются имя клиента, номер счёта или email. Перехватчик запроса заменяет их токенами до отправки. Поисковой системе достаточно обезличенного запроса, лишние детали ей не нужны. Граница режима простая: если инструменту нужен точный идентификатор, политика обязана это учитывать, иначе вызов перестанет работать.

Защита контекста и логов

Сценарий: поддержка клиентов. Перехватчик ответа заменяет чувствительные значения токенами до того, как агент прочитает результат, а восстановление выполняется для авторизованного получателя. Практический эффект: в контексте, памяти, трассировках и логах CloudWatch остаются токены, а не телефоны и номера договоров. Объём персональных данных в системе падает, требования к хранению логов упрощаются.

Защита файлов в S3, Box и Google Drive

Инструмент возвращает подписанный URL, а не текст, поэтому строковый фильтр видит ссылку и пропускает её. Перехватчик подменяет документ очищенной копией до того, как агент его откроет. Статус этой функции и перечень поддерживаемых форматов файлов в доступных материалах не подтверждены: сведения о preview-статусе де-идентификации документов и о зависимости обратимых и необратимых токенов от формата файла нужно запросить у Skyflow и проверить на своих файлах. Пока это не сделано, не стоит делать очистку документов единственной линией защиты.

Ограничения, которые нужно учесть до пилота

Три вещи влияют на архитектуру сильнее, чем кажется при чтении анонса.

Обратимые и необратимые токены: что это значит на практике

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

Какой тип токена применяется к конкретному полю или формату файла, зависит от настроек Skyflow и требует проверки на своих данных. Возьмите 10-20 реальных файлов из каждого хранилища, прогоните через перехватчик и посмотрите, какие поля восстановились. Если в критичном сценарии восстановление не происходит, защита документов для этого типа файлов не подходит, и это выяснится до продакшена, а не после.

Статус функции защиты документов

Поведение функции и поддержка форматов могут меняться, поэтому для документов нужен запасной вариант: если очистка не сработала, файл блокируется или уходит на ручную проверку. Строить единственную линию защиты на функции с неясным статусом рискованно, особенно когда через агента проходят договоры и медицинские выписки. Актуальный статус и ограничения стоит уточнить у Skyflow перед пилотом.

Зависимость от региона AWS

Документация AWS прямо оговаривает, что описанные сервисы и возможности могут различаться по регионам. Перечня конкретных регионов, где доступны AgentCore Gateway, перехватчики и хранение токенов, в доступных материалах нет, поэтому доступность нужно проверить для своего региона до проектирования. Открытые примеры AWS подтверждают, что региональные ограничения реальны: в одном из них AgentCore Runtime и Gateway не имеют ресурсов CloudFormation в выбранном регионе и создаются через CLI управляющей плоскости, а развёртывание выполняется с явным указанием региона в команде aws cloudformation deploy --region.

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

Чем это отличается от DLP и защиты на уровне модели

DLP и фильтры на входе и выходе модели работают с текстом в известных им точках: промпт, ответ, иногда файлы в почте и на общих дисках. Обмен агента с инструментами и содержимое документа за подписанным URL в эти точки не попадают. Перехватчик на шлюзе закрывает ровно этот участок.

Заменять DLP он не может и не должен. Задачи разные: DLP отвечает на вопрос, какие данные у нас есть и где они лежат, перехватчик отвечает на вопрос, что уходит наружу в конкретном вызове инструмента и что возвращается обратно. Контроль на уровне модели без контроля вызовов инструментов оставляет ту самую брешь из первого раздела. Как это выглядит в корпоративной практике, разобрано в материалах про guardrails и контроль tool calls и про AI Gateway и провалы пилотов агентов.

Кому подходит и с чего начать пилот

Критерии применимости:

  • несколько агентов и инструментов уже ходят через AgentCore Gateway, или вы как раз его строите;
  • в аргументах и результатах вызовов появляются персональные или корпоративные данные;
  • агенты работают с документами в S3, Box или Google Drive;
  • инфраструктура живёт на AWS в регионе, где доступны нужные сервисы.

Если инструментов один-два и персональных данных в них нет, дешевле обойтись политиками на уровне приложения и не добавлять ещё один компонент в путь каждого вызова.

Порядок пилота:

  1. Выбрать один сценарий с понятным риском: веб-поиск или диалоги с клиентами.
  2. Описать политики: какие поля и шаблоны де-идентифицировать, какие инструменты охватывать.
  3. Вынести ключи в отдельное хранилище и определить, у кого есть доступ на чтение.
  4. Включить логирование и посмотреть, что в этих логах оказалось: payload целиком или только факт срабатывания.
  5. Проверить восстановление на реальных данных: агент должен получать исходное значение там, где оно нужно сценарию.
  6. Расширять охват на остальные инструменты, добавляя их по одному.

Точки входа: Skyflow в AWS Marketplace и открытый перехватчик на GitHub, ссылки собраны в публикации AWS. Если платформа агентов выходит за пределы одного аккаунта, полезно заранее посмотреть, как устроены шлюзы и изоляция команд в мультиаккаунтной архитектуре AgentCore, и как MCP-инструменты в Gateway работают на практике.

Отдельная граница: соответствие требованиям к персональным данным, юридические основания обработки и оценку рисков определяют специалисты по безопасности и юристы. Статья описывает механику перехвата, а не заменяет такую оценку. Первый шаг, который даёт максимум информации за минимум усилий, - прогон 10-20 реальных вызовов через перехватчик в тестовой среде с последующим чтением логов.

Подписаться на канал