Wat is Azure API Management?

  • Artikel

VAN TOEPASSING OP: Alle API Management-lagen

Dit artikel bevat een overzicht van veelvoorkomende scenario's en belangrijke onderdelen van Azure API Management. Azure API Management is een hybride, multicloudbeheerplatform voor API's in alle omgevingen. Als platform-as-a-service ondersteunt API Management de volledige API-levenscyclus.

Tip

Als u al bekend bent met API Management en klaar bent om te beginnen, raadpleegt u deze resources:

Scenario's

API's maken digitale ervaringen mogelijk, vereenvoudigen de integratie van toepassingen, ondersteunen nieuwe digitale producten en maken gegevens en services herbruikbaar en universeel toegankelijk. Met de verspreiding en toenemende afhankelijkheid van API's moeten organisaties ze gedurende hun levenscyclus beheren als eersteklas assets.

Diagram met de rol van API's in verbonden ervaringen.

Met Azure API Management kunnen klanten aan deze uitdagingen voldoen:

  • Diversiteit en complexiteit van back-endarchitectuur van API-consumenten abstract
  • Veilig services beschikbaar maken die worden gehost op en buiten Azure als API's
  • API's beveiligen, versnellen en observeren
  • API-detectie en -verbruik inschakelen door interne en externe gebruikers

Veelvoorkomende scenario's:

  • Verouderde assets ontgrendelen: API's worden gebruikt om verouderde back-ends te abstraheren en te moderniseren en toegankelijk te maken vanuit nieuwe cloudservices en moderne toepassingen. API's maken innovatie mogelijk zonder het risico, de kosten en vertragingen van de migratie.
  • API-gerichte app-integratie : API's zijn eenvoudig te gebruiken, op standaarden gebaseerde en zelfbeschrijfbare mechanismen voor het blootstellen en openen van gegevens, toepassingen en processen. Ze vereenvoudigen en verlagen de kosten van app-integratie.
  • Gebruikerservaringen met meerdere kanalen: API's worden vaak gebruikt om gebruikerservaringen zoals web-, mobiele, draagbare of Internet of Things-toepassingen mogelijk te maken. API's hergebruiken om de ontwikkeling en roi te versnellen.
  • B2B-integratie : API's die worden blootgesteld aan partners en klanten verlagen de barrière voor het integreren van bedrijfsprocessen en het uitwisselen van gegevens tussen bedrijfsentiteiten. API's elimineren de overhead die inherent is aan punt-naar-punt-integratie. Met name met selfservicedetectie en onboarding ingeschakeld, zijn API's de primaire hulpprogramma's voor het schalen van B2B-integratie.

API Management-onderdelen

Azure API Management bestaat uit een API-gateway, een beheervlak en een ontwikkelaarsportal. Deze onderdelen worden standaard door Azure gehost en volledig beheerd. API Management is beschikbaar in verschillende lagen die verschillen in capaciteit en functies.

Diagram met de belangrijkste onderdelen van Azure API Management.

API-gateway

Alle aanvragen van clienttoepassingen bereiken eerst de API-gateway, die deze vervolgens doorstuurt naar de respectieve back-endservices. De API-gateway fungeert als een façade voor de back-endservices, zodat API-providers API-implementaties kunnen abstraheren en de back-endarchitectuur kunnen ontwikkelen zonder dat dit van invloed is op API-consumenten. De gateway maakt een consistente configuratie mogelijk van routering, beveiliging, beperking, caching en waarneembaarheid.

Met name de gateway:

  • Fungeert als een façade naar back-endservices door API-aanroepen te accepteren en door te sturen naar de juiste back-ends
  • Controleert API-sleutels en andere referenties, zoals JWT-tokens en certificaten die worden weergegeven met aanvragen
  • Hiermee worden gebruiksquota en frequentielimieten afgedwongen
  • Optioneel aanvragen en antwoorden transformeren zoals opgegeven in beleidsinstructies
  • Indien geconfigureerd, slaat u reacties in de cache op om de reactielatentie te verbeteren en de belasting van back-endservices te minimaliseren
  • Verzendt logboeken, metrische gegevens en traceringen voor bewaking, rapportage en probleemoplossing

Zelf-hostende gateway

Met de zelf-hostende gateway kunnen klanten de API-gateway implementeren in dezelfde omgevingen waar ze hun API's hosten, om API-verkeer te optimaliseren en naleving van lokale regelgeving en richtlijnen te garanderen. Met de zelf-hostende gateway kunnen klanten met een hybride IT-infrastructuur API's beheren die on-premises en in clouds worden gehost vanuit één API Management-service in Azure.

De zelf-hostende gateway wordt verpakt als een Docker-container op basis van Linux en wordt vaak geïmplementeerd in Kubernetes, met inbegrip van Azure Kubernetes Service en Kubernetes met Azure Arc.

Meer informatie:

Beheerlaag

API-providers communiceren met de service via het beheervlak, dat volledige toegang biedt tot de API Management-servicemogelijkheden.

Klanten communiceren met het beheervlak via Azure-hulpprogramma's, waaronder Azure Portal, Azure PowerShell, Azure CLI, een Visual Studio Code-extensie, een REST API of client-SDK's in verschillende populaire programmeertalen.

Gebruik het beheervlak om het volgende te doen:

  • Api Management-service-instellingen inrichten en configureren
  • API-schema's definiëren of importeren uit een breed scala aan bronnen, waaronder OpenAPI-, WSDL- en OData-definities, Azure-rekenservices en WebSocket-, GraphQL- en gRPC-back-ends
  • API's verpakken in producten
  • Beleid instellen, zoals quota of transformaties in de API's
  • Inzichten verkrijgen uit analyses
  • Gebruikers beheren

ontwikkelaarsportal

De opensource-ontwikkelaarsportal is een automatisch gegenereerde, volledig aanpasbare website met de documentatie van uw API's.

Schermopname van de API Management-ontwikkelaarsportal - beheerdersmodus.

API-providers kunnen het uiterlijk van de ontwikkelaarsportal aanpassen door aangepaste inhoud toe te voegen, stijlen aan te passen en hun huisstijl toe te voegen. Breid de ontwikkelaarsportal verder uit door zelf te hosten.

App-ontwikkelaars gebruiken de opensource-ontwikkelaarsportal om de API's te detecteren, onboarden om ze te gebruiken en te leren hoe ze in toepassingen kunnen worden gebruikt. (API's kunnen ook worden geëxporteerd naar de Power Platform voor detectie en gebruik door burgerontwikkelaars.)

Met behulp van de ontwikkelaarsportal kunnen ontwikkelaars het volgende doen:

  • API-documentatie lezen
  • Een API aanroepen via de interactieve console
  • Een account maken en abonneren om API-sleutels op te halen
  • Toegang tot analyses voor hun eigen gebruik
  • API-definities downloaden
  • API-sleutels beheren

API Management-lagen

API Management wordt aangeboden in verschillende prijscategorieën om te voldoen aan de behoeften van verschillende klanten. Elke laag biedt een unieke combinatie van functies, prestaties, capaciteitslimieten, schaalbaarheid, SLA en prijzen voor verschillende scenario's. De lagen worden als volgt gegroepeerd:

  • Klassiek : de oorspronkelijke API Management-aanbieding, waaronder de lagen Developer, Basic, Standard en Premium. De Premium-laag is ontworpen voor ondernemingen die toegang nodig hebben tot privé-back-ends, verbeterde beveiligingsfuncties, implementaties in meerdere regio's, beschikbaarheidszones en hoge schaalbaarheid. De developer-laag is een voordelige optie voor niet-productiegebruik, terwijl de basic-, Standard- en Premium-lagen productieklare lagen zijn.
  • V2 : een nieuwe set lagen die snelle inrichting en schaalaanpassing bieden, waaronder Basic v2 voor ontwikkeling en testen en Standard v2 voor productieworkloads. Standard v2 ondersteunt vereenvoudigde verbinding met netwerk-geïsoleerde back-ends.
  • Verbruik : de verbruikslaag is een serverloze gateway voor het beheren van API's die worden geschaald op basis van de vraag en gefactureerd per uitvoering. Het is ontworpen voor toepassingen met serverloze compute- en microservicesgebaseerde architecturen en toepassingen met variabele verkeerspatronen.

Meer informatie:

Integratie met Azure-services

API Management kan worden geïntegreerd met veel aanvullende Azure-services om bedrijfsoplossingen te maken, waaronder:

Meer informatie:

Belangrijke concepten

API's

API's vormen de basis van een service-exemplaar van API Management. Elke API vertegenwoordigt een set bewerkingen die beschikbaar zijn voor app-ontwikkelaars. Elke API bevat een verwijzing naar de back-endservice die de API implementeert en de bijbehorende bewerkingen worden toegewezen aan back-endbewerkingen.

Bewerkingen in API Management zijn zeer goed te configureren, met controle over URL-toewijzing, query- en padparameters, aanvraag- en antwoordinhoud en het in de cache opslaan van bewerkingsantwoorden.

Meer informatie:

Producten

Producten zijn de manier waarop de API's worden opgehaald voor ontwikkelaars. Producten in API Management hebben een of meer API's en kunnen worden geopend of beveiligd. Voor beveiligde producten is een abonnementssleutel vereist terwijl open producten vrij kunnen worden gebruikt.

Wanneer een product gereed is voor gebruik door ontwikkelaars, kan het worden gepubliceerd. Zodra het is gepubliceerd, kan het worden bekeken of geabonneerd door ontwikkelaars via de ontwikkelaarsportal. De goedkeuring van abonnementen wordt geconfigureerd op productniveau en er kan beheerdersgoedkeuring voor vereist zijn of abonnementen kunnen automatisch worden goedgekeurd.

Meer informatie:

Groepen

Groepen worden gebruikt voor het beheren van de zichtbaarheid van producten voor ontwikkelaars. API Management heeft de volgende ingebouwde groepen:

  • Beheer istrators: API Management-service-exemplaren beheren en de API's, bewerkingen en producten maken die door ontwikkelaars worden gebruikt.

    Beheerders van Azure-abonnementen zijn lid van deze groep.

  • Ontwikkelaars : geverifieerde gebruikers van de ontwikkelaarsportal die toepassingen bouwen met behulp van uw API's. Ontwikkelaars krijgen toegang tot de ontwikkelaarsportal en bouwen toepassingen waarmee de bewerkingen van een API worden aangeroepen.

  • Gasten : niet-geverifieerde gebruikers van de ontwikkelaarsportal, zoals potentiële klanten die de ontwikkelaarsportal bezoeken. Ze kunnen bepaalde alleen-lezentoegang krijgen, zoals de mogelijkheid om API's te bekijken maar niet om ze aan te roepen.

Beheer istrators kunnen ook aangepaste groepen maken of externe groepen gebruiken in een bijbehorende Microsoft Entra-tenant om ontwikkelaars zichtbaarheid en toegang te geven tot API-producten. Maak bijvoorbeeld een aangepaste groep voor ontwikkelaars in een partnerorganisatie voor toegang tot een specifieke subset api's in een product. Een gebruiker kan tot meer dan één groep behoren.

Meer informatie:

Ontwikkelaars

Ontwikkelaars vertegenwoordigen de gebruikersaccounts in een service-exemplaar van API Management. Ontwikkelaars kunnen worden gemaakt of uitgenodigd om deel te nemen door beheerders of ze kunnen zich registreren via de ontwikkelaarsportal. Elke ontwikkelaar is lid van een of meer groepen en mag zich abonneren op de producten die zichtbaarheid aan deze groepen verlenen.

Wanneer ontwikkelaars zich abonneren op een product, krijgen ze de primaire en secundaire sleutel voor het product voor gebruik bij het aanroepen van de API's van het product.

Meer informatie:

Workspaces

Met werkruimten kunnen gedecentraliseerde API-ontwikkelteams hun eigen API's beheren en productiseren, terwijl een centraal API-platformteam de API Management-infrastructuur onderhoudt. Elke werkruimte bevat API's, producten, abonnementen en gerelateerde entiteiten die alleen toegankelijk zijn voor de deelnemers aan de werkruimte. Toegang wordt beheerd via op rollen gebaseerd toegangsbeheer van Azure (RBAC).

Meer informatie:

Beleidsregels

Met beleidsregels kan een API-uitgever het gedrag van een API wijzigen via configuratie. Beleidsregels zijn een verzameling instructies die sequentieel worden uitgevoerd op de aanvraag of het antwoord van een API. Populaire instructies omvatten indelingsconversie van XML naar JSON en aanroepfrequentiebeperking om het aantal binnenkomende aanroepen van een ontwikkelaar te beperken. Zie API Management-beleid voor een volledige lijst.

Beleidsexpressies kunnen worden gebruikt als kenmerkwaarden of tekstwaarden in API Management-beleidsregels, tenzij het beleid iets anders aangeeft. Sommige beleidsregels, zoals de beleidsregels Stroom controleren en Variabele instellen, zijn gebaseerd op beleidsexpressies.

Beleidsregels kunnen op verschillende bereiken worden toegepast, afhankelijk van uw behoeften: globaal (alle API's), een werkruimte, een product, een specifieke API of een API-bewerking.

Meer informatie:

Volgende stappen

Voltooi de volgende Quick Start en ga aan de slag met Azure API Management:

Een Azure API Management-exemplaar maken met behulp van Azure Portal