Поделиться через

Что такое служба управления Azure API?

  • Статья

ОБЛАСТЬ ПРИМЕНЕНИЯ: все уровни Управление API

В этой статье представлен обзор распространенных сценариев и ключевых компонентов службы управления Azure API Management. Служба управления API Azure является гибридной мультиоблачной платформой управления для интерфейсов API во всех средах. В качестве платформы как услуги API Management поддерживает полный жизненный цикл API.

Совет

Если вы уже знакомы со службой API Management и готовы начать, ознакомьтесь со следующими ресурсами:

Сценарии

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

Схема, демонстрирующая роль API в подключенных интерфейсах.

Azure Управление API помогает организациям выполнять следующие задачи:

  • Предоставление комплексной платформы API для различных заинтересованных лиц и команд для создания API и управления ими
  • Отделение разнообразия и сложности архитектуры серверной части от пользователей API
  • Безопасное предоставление служб, размещенных в Azure и за ее пределами, в качестве API
  • Защита, ускорение работы и наблюдение за API
  • Включение возможности обнаружения и использования API внутренними и внешними пользователями

Распространенные сценарии включают в себя:

  • Разблокировка устаревших ресурсов — API используются для отделения и модернизации устаревших серверных частей и предоставления доступа к ним из новых облачных служб и современных приложений. API позволяют внедрять инновации без риска, лишних затрат и задержек, связанных с миграцией.
  • Интеграция приложений, ориентированных на API — API представляют собой простые в использовании, основанные на стандартах и самостоятельно описываемые механизмы для предоставления и доступа к данным, приложениям и процессам. Они упрощают и сокращают затраты на интеграцию приложений.
  • Многоканальные взаимодействия с пользователями — API часто используются для предоставления пользователям таких возможностей, как веб-приложения, мобильные приложения, переносимые приложения или Интернет вещей. Повторное использование API для ускорения разработки и рентабельности инвестиций.
  • Интеграция B2B — API, предоставляемые партнерам и клиентам, снижают барьер для интеграции бизнес-процессов и обмена данными между бизнес-сущностями. API позволяют устранить издержки, присущие интеграции "точка — точка". Особенно с поддержкой самостоятельного обнаружения и подключения API являются основными инструментами для масштабирования интеграции B2B.

Совет

Посетите aka.ms/apimlove библиотеку полезных ресурсов, в том числе видео, блоги и истории клиентов об использовании Azure Управление API.

Компоненты службы управления API

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

Схема, демонстрирующая основные компоненты Azure API Management.

Шлюз API

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

В частности, шлюз:

Независимый шлюз

С помощью локального шлюза поставщик API может развернуть шлюз API в тех же средах, где они размещают СВОИ API, для оптимизации трафика API и обеспечения соответствия локальным правилам и рекомендациям. Локальный шлюз позволяет организациям с гибридной ИТ-инфраструктурой управлять API, размещенными в локальной среде и в облаках из одной службы Управление API в Azure.

Локальный шлюз упаковывается в виде контейнера Docker на базе Linux и обычно развертывается в Kubernetes, включая Службу Azure Kubernetes и Kubernetes с поддержкой Azure Arc.

Подробнее:

Плоскость управления

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

Клиенты взаимодействуют с плоскости управления с помощью средств Azure, включая портал Azure, Azure PowerShell, Azure CLI, расширение Visual Studio Code, REST API или клиентские пакеты SDK на нескольких популярных языках программирования.

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

  • Подготовка и настройка параметров службы управления API
  • Определение или импорт схем API из широкого спектра источников, включая определения OpenAPI, WSDL и OData, службы вычислений Azure и WebSocket, GraphQL и серверные серверные части gRPC
  • Упаковка API в продукты
  • Настройка политик, например, квот или преобразований, в интерфейсах API
  • Получение дополнительных сведений на основе аналитики
  • Управление пользователями, такими как разработчики приложений

Портал разработчика

Портал разработчика с открытым кодом — это автоматически создаваемый и полностью настраиваемый веб-сайт с документацией по API.

Снимок экрана: портал разработчика Управления API — режим администратора.

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

Потребители API, такие как разработчики приложений, получают доступ к порталу разработчика с открытым исходным кодом, чтобы обнаружить API, подключить их к ним и узнать, как использовать их в приложениях. (API также можно экспортировать в Power Platform для обнаружения и использования разработчиками-любителями.)

С помощью портала разработчика потребители API могут:

  • читать документацию по API;
  • вызывать API через интерактивную консоль;
  • создавать учетную запись и оформлять подписку для получения ключей API;
  • получать доступ к аналитике по использованию;
  • скачивать определения API;
  • Управление ключами API

Управление федеративными API с рабочими областями

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

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

Дополнительные сведения:

уровни Управление API

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

  • Классический — исходное предложение Управление API, включая уровни "Разработчик", "Базовый", "Стандартный" и "Премиум". Уровень "Премиум" предназначен для предприятий, требующих доступа к частным серверным службам, расширенным функциям безопасности, развертываниям в нескольких регионах, зонам доступности и высокой масштабируемости. Уровень разработчика — это экономичный вариант для использования, а уровни "Базовый", "Стандартный" и "Премиум" — это готовые к производству уровни.
  • Версия 2 . Новый набор уровней, которые предлагают быструю подготовку и масштабирование, включая Базовую версию 2 для разработки и тестирования, а также стандартную версию 2 и Премиум версии 2 для рабочих нагрузок. Стандартная версия 2 и Premium версии 2 поддерживает интеграцию виртуальной сети для упрощенного подключения к изолированным от сети серверным службам. Премиум версии 2 также поддерживает внедрение виртуальной сети для полной изоляции сетевого трафика к шлюзу и из нее.
  • Потребление — бессерверный шлюз для управления API, масштабируемых на основе запросов и счетов за выполнение. Он предназначен для приложений с бессерверными вычислениями, архитектурами на основе микрослужб и шаблонами трафика переменных.

Дополнительные сведения:

Интеграция со службами Azure

Служба API Management интегрируется со многими дополнительными службами Azure, в том числе со следующими:

  • Центр API Azure для создания полной инвентаризации API в организации независимо от их типа, этапа жизненного цикла или расположения развертывания для обнаружения, повторного использования и управления API
  • Copilot в Azure для создания политик Управление API или объяснения уже настроенных политик
  • Azure Key Vault для безопасного хранения и управления сертификатами клиента и секретами
  • Azure Monitor для ведения журнала, создания отчетов и оповещений об операциях управления, событиях систем и запросах API
  • Application Insights для получения динамических метрик, сквозной трассировки и устранения неполадок
  • Виртуальные сети, частные конечные точки, Шлюз приложений и Azure Front Door для защиты на уровне сети
  • Azure Defender для API и защиты от атак DDoS Azure для защиты среды выполнения от вредоносных атак
  • Идентификатор Microsoft Entra для проверки подлинности разработчика и авторизации запроса
  • Центры событий для потоковой передачи событий
  • Azure Redis для кэширования ответов с помощью Кэш Azure для Redis или Управляемого Redis в Azure
  • Несколько предложений вычислений Azure, часто используемых для создания и размещения API в Azure, включая Функции, Logic Apps, веб-приложения, Service Fabric и другие, включая службу Azure OpenAI.

Дополнительные сведения:

Основные понятия

Программные интерфейсы

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

Операции в API Management широко настраиваемые, с управлением через сопоставление URL-адресов, параметров запроса и пути, содержимого запроса и ответа и кэширование ответа операций.

Дополнительные сведения:

Продукты

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

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

Дополнительные сведения:

Пользователи и группы

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

API Management включает следующие встроенные группы:

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

  • Гости — пользователи портала разработчиков, не прошедшие проверку подлинности, например, возможные клиенты, посетившие портал разработчиков. Им может быть предоставлен доступ только для чтения, позволяющий просматривать API, но не вызывать их.

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

Дополнительные сведения:

Рабочие области

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

Дополнительные сведения:

Политики

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

Выражения политики можно использовать в качестве значений атрибутов или текстовых значений во многих политиках Управление API. Некоторые политики (в том числе Поток управления и Задание переменной) основаны на выражениях политики.

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

Дополнительные сведения:

Следующие шаги

Изучите следующее краткое руководство и приступите к использованию службы управления API Azure:

Создание экземпляра службы API Management Azure с помощью портала Azure