API-Gateway in Azure API Management

GILT FÜR: Alle API Management-Ebenen

In diesem Artikel werden die Rollen und Features der API-Verwaltungsgatewaykomponente beschrieben. Außerdem werden die Gateways verglichen, die Sie bereitstellen können.

Verwandte Informationen:

• Eine Übersicht über API Management-Szenarien, -Komponenten und -Konzepte finden Sie unter Informationen zu API Management.

• Weitere Informationen zu den API Management-Dienstebenen und -features finden Sie unter:

  • API Management-Ebenen
  • Featurebasierter Vergleich der Azure API Management-Ebenen.

Rolle des Gateways

Das Gateway von API Management (auch Datenebene oder Runtime genannt) ist die Dienstkomponente, die als Proxy für API-Anforderungen fungiert sowie Richtlinien anwendet und Telemetriedaten sammelt.

Das Gateway übernimmt insbesondere folgende Aufgaben:

• Es fungiert als Fassade für Back-End-Dienste, indem es API-Aufrufe akzeptiert und an geeignete Back-Ends weiterleitet.
• Überprüft API-Schlüssel und andere Anmeldeinformationen wie JWTs und Zertifikate, die bei Anfragen mitgesendet werden.
• Es erzwingt Nutzungskontingente und Ratenbegrenzungen.
• Es transformiert optional Anforderungen und Antworten gemäß der Angabe in Richtlinienanweisungen.
• Bei entsprechender Konfiguration speichert es Antworten zwischen, um die Antwortlatenz zu verbessern und Back-End-Dienste zu entlasten.
• Es gibt Protokolle, Metriken und Ablaufverfolgungen für die Überwachung, Berichterstellung und Problembehandlung aus.

Verwaltete und selbst gehostete Gateways

API Management bietet sowohl verwaltete als auch selbstgehostete Gateways:

• Verwaltet – Das verwaltete Gateway ist die Standardgatewaykomponente, die Azure für jede API-Verwaltungsinstanz auf jeder Dienstebene bereitstellt. Sie können auch ein eigenständiges verwaltetes Gateway einem Arbeitsbereich in einer API-Verwaltungsinstanz in ausgewählten Dienstebenen zuordnen. Durch die Verwendung des verwalteten Gateways fließt der gesamte API-Datenverkehr über Azure, unabhängig davon, wo Back-Ends zur Implementierung der APIs gehostet werden.

  Note

  Aufgrund von Unterschieden in der zugrunde liegenden Dienstarchitektur weisen die in den verschiedenen API Management-Dienstebenen bereitgestellten Gateways einige Unterschiede bei den Funktionen auf. Ausführliche Informationen finden Sie im Abschnitt Featurevergleich: Verwaltete und selbstgehostete Gateways.

• Selbst gehostet – Das selbst gehostete Gateway ist eine optionale containerisierte Version des standardverwalteten Gateways, das in ausgewählten Dienstebenen verfügbar ist. Es ist hilfreich für Hybrid- und Multicloudszenarien, in denen die Gateways unabhängig von Azure in den gleichen Umgebungen ausgeführt werden müssen, in denen API-Back-Ends gehostet werden. Das selbstgehostete Gateway ermöglicht es Kunden mit hybrider IT-Infrastruktur, lokal und in Clouds gehostete APIs über einen einzelnen API Management-Dienst in Azure zu verwalten.

  • Das selbstgehostete Gateway ist als Linux-basierter Docker-Container gepackt und wird üblicherweise in Kubernetes (sowohl Azure Kubernetes Service als auch Kubernetes mit Azure Arc-Unterstützung) bereitgestellt.

  • Jedes selbstgehostete Gateway ist einer Gatewayressource in einer cloudbasierten API Management-Instanz zugeordnet, über die sie Konfigurationsupdates erhält und den Status kommuniziert.

Featurevergleich: Verwaltete und selbstgehostete Gateways

In den folgenden Tabellen werden die Features verglichen, die in den folgenden API Management-Gateways verfügbar sind:

• Klassisch: Das verwaltete Gateway, das in den Dienstebenen „Developer“, „Basic“, „Standard“ und „Premium“ verfügbar ist (früher als dedizierte Ebenen gruppiert)
• V2: Das verwaltete Gateway, das in den Tarifen Basic v2, Standard v2 und Premium v2 verfügbar ist
• Verbrauch: Das verwaltete Gateway, das auf der Stufe „Verbrauch“ verfügbar ist
• Selbst gehostet: Das optionale selbst gehostete Gateway, das für ausgewählte Dienstebenen verfügbar ist
• Arbeitsbereich: Das verwaltete Gateway, das in einem Arbeitsbereich in ausgewählten Dienstebenen verfügbar ist

Infrastructure

¹ Hängt davon ab, wie das Gateway bereitgestellt wird, liegt jedoch in der Verantwortung des Kunden.
² Konnektivität mit dem selbst gehosteten Gateway v2 Konfigurationsendpunkt erfordert die DNS-Auflösung des Endpunkthosts.
³ Zertifizierungsstellen-Stammzertifikate für selbst gehostetes Gateway werden separat pro Gateway verwaltet.
⁴ Das Clientprotokoll muss aktiviert sein.
⁵ Konfigurieren Sie mithilfe der forward-request-Richtlinie.
⁶ Konfigurieren Sie CA-Zertifikatsdetails für die Backend-Zertifikatauthentifizierung in Backend-Einstellungen.

Back-End-APIs

Policies

Verwaltete und selbstgehostete Gateways unterstützen alle verfügbaren Richtlinien in Richtliniendefinitionen, mit folgenden Ausnahmen: Details zu den einzelnen Richtlinien finden Sie in der Richtlinienreferenz.

¹ Konfigurierte Richtlinien, die vom selbstgehosteten Gateway nicht unterstützt werden, werden während der Richtlinienausführung übersprungen.
² Die Richtlinien für Ratengrenzwerte nach Schlüssel, Kontingent nach Schlüssel und KI-Tokengrenzwerte sind auf der Verbrauchsebene nicht verfügbar.
³ Ratengrenzwerte in einem selbstgehosteten Gateway können so konfiguriert werden, dass sie lokal (clusterknotenübergreifend zwischen Gatewayinstanzen) synchronisiert werden, z. B. per Helm Chart-Bereitstellung für Kubernetes oder mithilfe der Bereitstellungsvorlagen im Azure-Portal. Ratengrenzwerte werden jedoch nicht mit anderen in der API Management-Instanz konfigurierten Gateway-Ressourcen synchronisiert, einschließlich des verwalteten Gateways in der Cloud. Weitere Informationen

Monitoring

Ausführliche Informationen zu Überwachungsoptionen finden Sie unter Einblick in Azure API Management.

¹ Die v2-Ebenen unterstützen Azure Monitor-basierte Analysen.
² Gateway verwendet den integrierten Speicherpuffer von Azure Application Insight und bietet keine Übermittlungsgarantien.
³ Das selbstgehostete Gateway sendet derzeit keine Ressourcenprotokolle (Diagnoseprotokolle) an Azure Monitor. Sie können optional Metriken an Azure Monitor senden oder Protokolle lokal konfigurieren und speichern (an dem Ort, an dem das selbstgehostete Gateway bereitgestellt wird).

Authentifizierung und Autorisierung

Verwaltete und selbst gehostete Gateways unterstützen alle verfügbaren API-Authentifizierungs- und Autorisierungsoptionen mit den folgenden Ausnahmen.

Gatewaydurchsatz und -skalierung

Verwaltetes Gateway

Informationen zum geschätzten maximalen Gatewaydurchsatz der API Management-Dienstebenen finden Sie unter API Management – Preise.

• Klassische Ebenen

  • Skalieren Sie die Gatewaykapazität, indem Sie Skalierungseinheiten hinzufügen und entfernen, oder upgraden Sie die Dienstebene. (Die Skalierung ist in der Entwicklerebene nicht verfügbar.)
  • Auf den Dienstebenen „Basic“, „Standard“ und „Premium“ kann optional die Autoskalierung von Azure Monitor konfiguriert werden.
  • Auf der Dienstebene „Premium“ können Sie optional Gatewaykapazität hinzufügen und auf mehrere Regionen verteilen.

• v2-Ebenen

  • Skalieren Sie die Gatewaykapazität, indem Sie Skalierungseinheiten hinzufügen und entfernen, oder upgraden Sie die Dienstebene.
  • Optional konfigurieren Sie die automatische Azure Monitor-Skalierung.

• Verbrauchsstufe

  • API Management-Instanzen auf der Verbrauchsebene werden automatisch basierend auf dem Datenverkehr skaliert.

Selbstgehostetes Gateway

• Fügen Sie in Umgebungen wie Kubernetes mehrere Gatewayreplikate hinzu, um die erwartete Nutzung zu bewältigen.
• Optional können Sie die automatische Skalierung konfigurieren, um die Datenverkehrsanforderungen zu erfüllen.

Arbeitsbereichs-Gateway

Skalieren Sie die Kapazität, indem Sie Skalierungseinheiten im Arbeitsbereichs-Gateway hinzufügen und entfernen.

Endpunkt für die Gatewayintegritätsprüfung

In allen Ebenen mit Ausnahme der Nutzungsstufe stellt Azure API Management einen integrierten Endpunkt für die Gatewayintegritätsprüfung im Pfad /status-0123456789abcdefbereit. Erreichen Sie diesen Endpunkt, um sicherzustellen, dass das API-Gateway verfügbar und ordnungsgemäß funktioniert. Es testt keine Back-End-APIs, nur das Gateway selbst.

Eine Anforderung an den Endpunkt gibt eine 200 OK HTTP-Antwort zurück, wenn das Gateway fehlerfrei ist. Fehler deuten auf Netzwerk- oder Gatewayprobleme hin.

• Azure verwendet diesen Endpunkt intern für die kontinuierliche SLA-Überwachung und die Gatewayintegritätsüberprüfung.
• Kunden können Anforderungen an diesen Endpunkt in ihre eigenen Überwachungstools und Prüfpunkte integrieren.
• Der Endpunkt ist für verwaltete Gateways (einschließlich regionaler Gateways in Bereitstellungen mit mehreren Regionen), selbst gehostete Gateways und Arbeitsbereichsgateways verfügbar.

Verwandte Inhalte

Weitere Informationen zu:

• API Management in einer Hybrid- und Multicloud-Welt
• Kapazitätsmetrik für Skalierungsentscheidungen
• Einblickfunktionen in API Management
• KI-Gatewayfunktionen in der API-Verwaltung