Udostępnij za pośrednictwem

Co to jest Azure API Management?

DOTYCZY: Wszystkich poziomów zarządzania API

Ten artykuł przedstawia przegląd typowych scenariuszy oraz kluczowych elementów zarządzania interfejsami API platformy Azure. Azure API Management to hybrydowa, wielochmurowa platforma zarządzania API dla wszystkich środowisk. Jako platforma jako usługa, zarządzanie API wspiera pełny cykl życia API.

Wskazówka

Jeśli znasz już zarządzanie API i jesteś gotowy, aby zacząć, skorzystaj z tych zasobów:

Scenariusze

Interfejsy API umożliwiają tworzenie cyfrowych doświadczeń, upraszczają integrację aplikacji, stanowią podstawę nowych produktów cyfrowych oraz sprawiają, że dane i usługi są wielokrotnego użytku i powszechnie dostępne. Dzięki rozprzestrzenianiu się i zwiększaniu zależności od interfejsów API organizacje muszą zarządzać nimi jako zasoby pierwszej klasy w całym cyklu życia.

Diagram przedstawiający rolę interfejsów API w połączonych doświadczeniach.

Azure API Management pomaga organizacjom sprostać tym wyzwaniom.

  • Zapewnij kompleksową platformę API dla różnych interesariuszy i zespołów do tworzenia i zarządzania interfejsami API.
  • Abstrahować różnorodność i złożoność architektury zaplecza od użytkowników API
  • Bezpieczne udostępnianie usług hostowanych w Azure i poza tym środowiskiem jako interfejsy API
  • Chroń, przyspieszaj i monitoruj interfejsy API
  • Umożliwienie odkrywania i wykorzystywania API przez użytkowników wewnętrznych i zewnętrznych.

Typowe scenariusze obejmują:

  • Odblokowywanie zasobów dziedzictwa - Interfejsy API są używane do abstrakcji i modernizacji starych backendów, aby uczynić je dostępnymi z nowych usług chmurowych i nowoczesnych aplikacji. API umożliwiają wprowadzanie innowacji bez ryzyka, kosztów i opóźnień związanych z migracją.
  • Integracja aplikacji skoncentrowana na API - API to łatwo przyswajalne, oparte na standardach i samoopisujące mechanizmy do udostępniania i dostępu do danych, aplikacji i procesów. Ułatwiają i obniżają koszty integracji aplikacji.
  • Wielokanałowe doświadczenia użytkownika - API są często używane do wdrażania doświadczeń użytkownika, takich jak aplikacje webowe, mobilne, do noszenia lub Internet Rzeczy. Ponowne użycie interfejsów API, aby przyspieszyć rozwój i zwrot z inwestycji.
  • Integracja B2B - interfejsy API udostępniane partnerom i klientom obniżają barierę integracji procesów biznesowych oraz wymiany danych pomiędzy podmiotami gospodarczymi. API eliminują nadmiar związany z integracją punkt-punkt. Zwłaszcza przy włączonym samodzielnym odkrywaniu i wdrażaniu, API są podstawowymi narzędziami do skalowania integracji B2B.

Wskazówka

Odwiedź aka.ms/apimlove, aby znaleźć bibliotekę przydatnych zasobów, w tym filmy wideo, blogi i historie klientów dotyczące wykorzystania Azure API Management.

Komponenty zarządzania API

Azure API Management składa się z bramki API, płaszczyzny zarządzania i portalu dla programistów, z funkcjami zaprojektowanymi dla różnych odbiorców w ekosystemie API. Te komponenty są uruchamiane w Azure i zarządzane w pełni domyślnie. Zarządzanie API jest dostępne w różnych poziomach, różniących się pojemnością i funkcjami.

Diagram przedstawiający kluczowe komponenty usługi Azure API Management.

Brama interfejsu API

Wszystkie zapytania od aplikacji klienckich najpierw trafiają do bramy API (zwanej również płaszczyzną danych lub czasem wykonywania), która następnie przekazuje je do odpowiednich usług backendowych. Brama API działa jako zasłona dla usług zaplecza, umożliwiając dostawcom API abstrahowanie implementacji API i rozwijanie architektury zaplecza bez wpływu na odbiorców API. Brama umożliwia spójną konfigurację trasowania, zabezpieczeń, ograniczania przepustowości, buforowania i obserwowalności.

Konkretne wejście:

Samodzielnie hostowany gateway

Korzystając z self-hosted gateway, dostawca API może wdrożyć bramkę API w tych samych środowiskach, w których hostują swoje API, aby zoptymalizować ruch API i zapewnić zgodność z lokalnymi przepisami i wytycznymi. Brama hostowana samodzielnie umożliwia organizacjom z hybrydową infrastrukturą IT zarządzanie interfejsami API hostowanymi lokalnie i w chmurze z jednego usługi zarządzania API w Azure.

Brama z własnym hostingiem jest pakowana jako kontener Docker oparty na Linuxie i jest często wdrażana do Kubernetes, w tym do usługi Azure Kubernetes Service i Kubernetes obsługiwanego przez Azure Arc.

Więcej informacji:

Warstwa zarządzania

Dostawcy API wchodzą w interakcję z usługą poprzez płaszczyznę zarządzania (nazywaną także płaszczyzną kontrolną), która zapewnia pełny dostęp do funkcji usługi zarządzania API.

Klienci wchodzą w interakcje z plane zarządzania za pomocą narzędzi Azure, w tym portalu Azure, Azure PowerShell, Azure CLI, rozszerzenia Visual Studio Code, interfejsu REST API lub pakietów SDK klienta w kilku popularnych językach programowania.

Użyj płaszczyzny zarządzania, aby:

  • Udostępnianie i konfigurowanie ustawień serwisu zarządzania API
  • Definiuj lub importuj schematy API z szerokiego zakresu źródeł, w tym definicje OpenAPI, WSDL i OData, usługi obliczeniowe Azure oraz zaplecza WebSocket, GraphQL i gRPC.
  • Pakietuj interfejsy API w produkty
  • Skonfiguruj polityki, takie jak limity lub transformacje na interfejsach API
  • Uzyskaj wgląd dzięki analizom
  • Zarządzaj użytkownikami, takimi jak deweloperzy aplikacji

Portal dla deweloperów

Otwarty portal dla developerów to automatycznie generowana, w pełni dostosowywalna strona internetowa zawierająca dokumentację Twoich interfejsów API.

Zrzut ekranu portalu programisty zarządzania interfejsem API - tryb administratora.

Dostawcy API mogą dostosowywać wygląd i działanie portalu dla deweloperów, dodając własną zawartość, dostosowując style oraz umieszczając swoje elementy brandingu. Rozszerz portal dewelopera o możliwość samodzielnego hostingu.

Użytkownicy interfejsów API, tacy jak deweloperzy aplikacji, uzyskują dostęp do portalu dla deweloperów open-source, aby odnajdywać API, integrować je do swoich projektów i uczyć się, jak korzystać z nich w aplikacjach. (Interfejsy API mogą być również eksportowane do Power Platform w celu odkrywania i używania przez deweloperów obywatelskich.)

Korzystając z portalu dla deweloperów, konsumenci API mogą:

  • Przeczytaj dokumentację API
  • Wywołaj API za pomocą interaktywnej konsoli
  • Utwórz konto i zasubskrybuj, aby otrzymać klucze API.
  • Uzyskaj dostęp do analityki dotyczącej własnego użytkowania
  • Pobierz definicje API
  • Zarządzaj kluczami API

Federowane zarządzanie interfejsami API z użyciem przestrzeni roboczych

Dla organizacji, które chcą umożliwić zdecentralizowanym zespołom rozwijanie i zarządzanie własnymi interfejsami API z zaletami scentralizowanego zarządzania i odkrywania API, Zarządzanie API oferuje najwyższej jakości wsparcie dla modelu federacyjnego zarządzania API z workspaces.

W Zarządzaniu API, przestrzenie robocze wprowadzają nowy poziom autonomii dla zespołów API organizacji, umożliwiając im szybsze, bardziej niezawodne, bezpieczne i wydajne tworzenie, zarządzanie oraz publikowanie API w ramach usługi Zarządzania API. Poprzez zapewnienie izolowanego dostępu administracyjnego i środowiska uruchomieniowego API, przestrzenie robocze wzmacniają zespoły API, jednocześnie pozwalając zespołowi platformy API na utrzymanie nadzoru. Obejmuje to centralne monitorowanie, egzekwowanie polityk i zgodności API oraz publikowanie API w celu odkrycia ich przez zintegrowany portal dla deweloperów.

Więcej informacji:

Poziomy zarządzania API

Zarządzanie API jest oferowane w różnych poziomach cenowych, aby spełnić potrzeby różnych klientów. Każdy poziom oferuje unikalną kombinację funkcji, wydajności, limitów pojemności, skalowalności, umowy SLA oraz cen dla różnych scenariuszy. Poziomy są pogrupowane w następujący sposób:

  • Klasyczny - Oryginalna oferta zarządzania API, w tym poziomy Developer, Basic, Standard i Premium. Poziom Premium jest zaprojektowany dla przedsiębiorstw wymagających dostępu do prywatnych backendów, zaawansowanych funkcji bezpieczeństwa, wdrożeń w wielu regionach, stref dostępności i wysokiej skalowalności. Poziom dewelopera jest ekonomiczną opcją do użytku nieprodukcyjnego, podczas gdy poziomy podstawowy, standardowy i premium są gotowe do produkcji.
  • V2 - Nowy zestaw poziomów oferujących szybkie przygotowanie i skalowanie, w tym Basic v2 do rozwoju i testowania oraz Standard v2 i Premium v2 dla obciążeń produkcyjnych. Standard v2 i Premium v2 wspierają integrację z wirtualną siecią dla uproszczonego połączenia z backendami izolowanymi sieciowo. Premium v2 obsługuje także wstrzykiwanie wirtualnej sieci dla pełnej izolacji ruchu sieciowego do i z bramy.
  • Consumption - Bezserwerowa brama do zarządzania interfejsami API, która dostosowuje się do zapotrzebowania i rozlicza opłaty na podstawie liczby wykonanych operacji. ** Jest zaprojektowany dla aplikacji z przetwarzaniem bezserwerowym, architektur opartych na mikrousługach oraz dla tych z zmiennymi wzorcami ruchu.

Więcej informacji:

Integracja z usługami Azure

Zarządzanie interfejsem API integruje się z wieloma uzupełniającymi usługami Azure w celu tworzenia rozwiązań dla przedsiębiorstw, w tym:

Więcej informacji:

Kluczowe pojęcia

API-e

Interfejsy API są fundamentem instancji usługi Zarządzania API. Każde API reprezentuje zestaw operacji dostępnych dla deweloperów aplikacji. Każde API zawiera odniesienie do usługi backendowej, która implementuje API, a jej operacje odpowiadają operacjom backendowym.

Operacje w zarządzaniu API są wysoce konfigurowalne, z możliwością kontrolowania mapowania adresów URL, parametrów zapytań i ścieżek, treści żądań i odpowiedzi oraz buforowania odpowiedzi operacji.

Więcej informacji:

Produkty

Produkty to sposób, w jaki interfejsy API są udostępniane użytkownikom API, takim jak deweloperzy aplikacji. Produkty w usłudze API Management mają co najmniej jeden interfejs API i mogą być otwarte lub chronione. Produkty chronione wymagają klucza subskrypcyjnego, podczas gdy produkty otwarte mogą być konsumowane bezpłatnie.

Gdy produkt jest gotowy do użytku przez konsumentów, można go wprowadzić na rynek. Po opublikowaniu użytkownicy mogą przeglądać lub subskrybować ją za pośrednictwem portalu dewelopera. Konfiguracja zatwierdzania subskrypcji odbywa się na poziomie produktu i może wymagać zatwierdzenia przez administratora lub być automatyczna.

Więcej informacji:

Użytkownicy i grupy

Użytkownicy (konsumenci API) mogą zostać utworzeni lub zaproszeni do dołączenia przez administratorów usług, albo mogą zarejestrować się z portalu deweloperskiego. Każdy użytkownik jest członkiem jednej lub więcej grup i może subskrybować produkty, które umożliwiają widoczność tych grup.

Zarządzanie interfejsami API ma następujące wbudowane grupy:

  • Developers - Użytkownicy uwierzytelnieni na portalu dla deweloperów, którzy tworzą aplikacje korzystając z Twoich interfejsów API. Programiści mają dostęp do portalu dla programistów i budują aplikacje, które wywołują operacje API.

  • Goście - Niezalogowani użytkownicy portalu dla deweloperów, na przykład potencjalni klienci odwiedzający portal dla deweloperów. Mogą mieć przyznany pewien dostęp tylko do odczytu, na przykład możliwość przeglądania interfejsów API, ale bez możliwości ich wywoływania.

Właściciele usługi zarządzania API mogą również tworzyć niestandardowe grupy lub używać grup zewnętrznych w powiązanym dzierżawcy Microsoft Entra, aby zapewnić użytkownikom widoczność i dostęp do produktów API. Na przykład, utwórz niestandardową grupę dla developerów w organizacji partnerskiej, aby uzyskać dostęp do określonego podzbioru interfejsów API w produkcie. Użytkownik może należeć do więcej niż jednej grupy.

Więcej informacji:

Przestrzenie robocze

Workspaces wspierają federacyjny model zarządzania API, umożliwiając zdecentralizowanym zespołom deweloperskim API zarządzanie i komercjalizację własnych API, podczas gdy centralny zespół platformy API utrzymuje infrastrukturę zarządzania API. Każda przestrzeń robocza zawiera interfejsy API, produkty, subskrypcje i powiązane podmioty, które są dostępne tylko dla współpracowników tej przestrzeni roboczej. Dostęp jest kontrolowany za pomocą opartego na rolach systemu kontroli dostępu Azure (RBAC). Każde miejsce pracy jest powiązane z jedną lub więcej bramkami roboczymi, które kierują ruch API do jego usług zaplecza.

Więcej informacji:

Zasady

Dzięki policies dostawca API może zmienić zachowanie API poprzez konfigurację. Polityki to zbiór instrukcji, które są wykonywane sekwencyjnie na żądanie lub odpowiedź API. Popularne oświadczenia obejmują konwersję formatu z XML na JSON oraz ograniczenie liczby połączeń przychodzących od dewelopera. Aby uzyskać pełną listę, zobacz polityki zarządzania API.

Wyrażenia polityki mogą być używane jako wartości atrybutów lub wartości tekstowe w wielu politykach zarządzania interfejsem API. Niektóre zasady, takie jak zasady przepływu kontroli i ustawiania zmiennej, opierają się na wyrażeniach zasad.

Zasady można stosować na różnych poziomach, w zależności od potrzeb: globalnym (wszystkie interfejsy API), w przestrzeni roboczej, w produkcie, w konkretnym interfejsie API lub podczas operacji API.

Więcej informacji:

Kolejne kroki

Ukończ poniższy szybki start i zacznij korzystać z zarządzania interfejsem API Azure.

Utwórz instancję Azure API Management za pomocą portalu Azure