Dev48
ЯЗЫК
  • О нас
  • Услуги
  • Индустрии
  • Технологии
  • Статьи
  • Контакты
Забронировать звонок
    Главная/Статьи/Predostavlenie razrabotchikam i agentam dostupa k api s pomoschyu postman passpo
Dev48
info@dev48.org+375 29 320-40-96WhatsApp@isky_by

© 2026 · Все права защищены.

Предоставление разработчикам и агентам доступа к API с помощью Postman Passport

Фото: Ibrahim Rifath (Unsplash) — https://unsplash.com/photos/yellow-mailbox-on-brown-wall-bricks-Ir0VrE74xKg?utm_source=dev48&utm_medium=referral

Источник: Postman Blog•19 ноября 2026 г. в 17:01

Предоставление разработчикам и агентам доступа к API с помощью Postman Passport

Узнайте, как Postman Passport предоставляет разработчикам и агентам ограниченный доступ к API с помощью ссылок на секреты, чтобы никому не приходилось передавать базовый ключ API. Статья «Предоставление разработчикам и агентам доступа к API с помощью Postman Passport» впервые появилась в блоге…

19 ноября 2026 г.

Разработчик просит своего агента по кодированию расследовать неудачный заказ. Агенту необходимо прочитать детали заказа. Создание возврата потребовало бы отдельного одобрения.

Если вы управляете доступом к API для команды, вам нужен способ выразить это различие. Какие запросы должен иметь возможность делать агент? Чьим доступом он будет пользоваться? Как вы прекратите этот доступ, когда работа будет завершена?

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

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

Это доступ без владения: разрешение на использование API без получения его ключа. Passport также помогает вам проверять трафик разработчиков и помечать учетные данные, которые уже отправляются инструментами и агентами.

Почему агенты по кодированию делают это решение более актуальным

Агент может превратить одну задачу в последовательность вызовов инструментов, скриптов и сетевых запросов. Учетные данные, доступные этим процессам, могут появиться в выходных данных отладки, созданных файлах или контексте модели. Вредоносная инструкция — одна из возможных причин; обычный шаг по устранению неполадок также может раскрыть значение.

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

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

Проверяйте трафик разработчиков и помечайте обнаруженные секреты

Локальный инспектор трафика Passport, доступный в CLI Community Edition, проверяет HTTP- и HTTPS-запросы от инструментов разработчика, скриптов и агентов по кодированию, проходящих через него. Когда он обнаруживает секрет, он помечает запрос в браузере или на панели управления терминала. Результаты показывают пункт назначения, клиента, время и тип секрета, при этом значения секретов маскируются. Заголовки и URL-адреса сканируются, с опциональным сканированием тела запроса.

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

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

Одобряйте операции API, необходимые агенту

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

GET orders.sandbox.example.com/v1/orders/{id}

Вы не одобряете конечную точку возврата. Когда запросы, использующие эту ссылку, проходят через Passport, прокси-сервер проверяет метод, хост и путь перед разрешением учетных данных.

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

Выбирайте область действия тщательно. Одобренная конечная точка чтения все еще может возвращать конфиденциальные данные, и скомпрометированный агент может злоупотребить доступом, который он сохраняет. Ограничения конечных точек и изоляция учетных данных помогают ограничить доступ; собственная авторизация и бизнес-правила API по-прежнему важны. Руководство OWASP по чрезмерным полномочиям объясняет, почему разрешения должны соответствовать работе, которую агент должен выполнять.

Предоставьте внешней команде доступ к тому же рабочему процессу API

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

С помощью Passport вы можете сделать необходимые конечные точки доступными для запросов на доступ. Импортируйте их из коллекции Postman, спецификации API, curl-запроса или экспорта активности прокси, а затем сопоставьте требуемые им учетные данные со ссылками на секреты.

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

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

Прекращайте доступ, не нарушая работу других потребителей

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

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

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

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

Сохраняйте свое хранилище секретов и добавляйте контроль во время запроса

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

Для запроса, направленного через этот прокси-сервер:

  • Потребитель включает ссылку на секрет там, где API ожидает свои учетные данные.
  • Прокси-сервер проверяет аутентифицированную личность соединения и проверяет, разрешает ли его область действия эту ссылку на запрошенной конечной точке.
  • Если авторизовано, прокси-сервер разрешает секрет и внедряет его в запрос, отправленный в целевой API.
  • Ответ возвращается потребителю, и прокси-сервер записывает запрос для аутентифицированной личности.

Разрешение секрета происходит в вашей инфраструктуре. Разрешенные учетные данные поступают в целевой API, не будучи доставленными потребителю или в облако Passport.

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

Оцените Passport с помощью одного API и одного потребителя

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

Затем проверьте границы доступа:

  • Отправьте утвержденный запрос через Passport и убедитесь, что он выполнен успешно.
  • Используйте ту же ссылку для конечной точки за пределами утвержденной области видимости и убедитесь, что прокси отклоняет ее.
  • Просмотрите запись запроса и подтвердите, какую аутентифицированную личность она несет. Для агента установите, использует ли соединение его собственную личность или сеанс его оператора.
  • Отмените право доступа, повторите запрос и оцените, когда прокси прекратит его авторизацию.

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

Откройте Postman Passport, чтобы создать пространство имен и добавить свой первый API.

← Все статьи

О чём эта статья

Ещё в разделе «Разработка ПО»

Все →
Обобщенные компоненты в Vue 3
Telerik

Обобщенные компоненты в Vue 3

Анонс плагина Medusa ChatGPT
Medusajs

Анонс плагина Medusa ChatGPT

Как Naviance расширяет возможности планирования будущего за пределами колледжа
Powerschool

Как Naviance расширяет возможности планирования будущего за пределами колледжа

ИИ повышает продуктивность, но становятся ли результаты команд лучше?
Duetto

ИИ повышает продуктивность, но становятся ли результаты команд лучше?

ИИ может устанавливать тариф. Но ответственность за решение остается за вами
Duetto

ИИ может устанавливать тариф. Но ответственность за решение остается за вами

Экосистема Anthropic
HCLTech

Экосистема Anthropic

Ещё от Postman

Отчет о состоянии API за 2026 год: агенты уже в продакшене, а большинство API к этому не готовы
Postman

Отчет о состоянии API за 2026 год: агенты уже в продакшене, а большинство API к этому не готовы

Как писать масштабируемые скрипты для нагрузочного тестирования в Postman
Postman

Как писать масштабируемые скрипты для нагрузочного тестирования в Postman

Создание портала разработчика с помощью Postman и Fern за один день
Postman

Создание портала разработчика с помощью Postman и Fern за один день

Fern теперь является платформой Postman для порталов разработчиков API
Postman

Fern теперь является платформой Postman для порталов разработчиков API

Что нового в Postman: Kafka, тесты MCP, RAML
Postman

Что нового в Postman: Kafka, тесты MCP, RAML

Обмен симуляциями API между сессиями агентов кодинга
Postman

Обмен симуляциями API между сессиями агентов кодинга