API-Gateways

Spezielle Agenten, die API- und HTTP-Trigger-Endpunkte verfügbar machen, z. B. über DMZ.

Ossi Galkin avatarGeschrieben vonOssi Galkin Vor über einer Woche aktualisiert

API-Gateways sind eingeschränkte Agenten, die nur als einfache Lastausgleichs-Proxys vor den eigentlichen Ausführungsagenten fungieren. Sie stellen nur API- und HTTP-Trigger-Endpunkte bereit und leiten gültige Anfragen an die Ausführungsagenten weiter. Die API-Gateway-Agenten authentifizieren und validieren die Anfragen, bevor sie sie weiterleiten. Die Gateways drosseln außerdem übermäßige Anfragen. Die Idee ist, dass Sie API-Gateway-Agenten auf öffentlich zugänglichen Servern installieren können, ohne Ihre eigentlichen Ausführungsagenten mit Verbindungen zu internen Systemen dem öffentlichen Netzwerkverkehr auszusetzen.

Bitte beachten Sie, dass Sie kein API-Gateway benötigen, um API-Prozesse nutzen zu können. Die Ausführungsagenten stellen außerdem alle API-Prozessendpunkte direkt zur Verfügung und führen Authentifizierung, Drosselung usw. durch. Wenn Sie also bereits einen Proxyserver mit Lastausgleich für Ihre Agenten eingerichtet haben, müssen Sie kein API-Gateway bereitstellen.

API-Gateways werden immer als Teil einer Agentengruppe konfiguriert und stellen standardmäßig dieselben API- und HTTP-Trigger bereit wie die Ausführungsagenten. Sie können einen API- oder HTTP-Trigger als privat festlegen, was bedeutet, dass die Gateways sie nicht bereitstellen. Sie sind nur von den internen Ausführungsagenten aus zugänglich. Dies können Sie tun, indem Sie der API-Spezifikation das Tag „privat“ hinzufügen oder das private Flag für den HTTP-Trigger aktivieren.

Wenn die Agentengruppe über mehr als einen ausführenden Agenten verfügt, führt das API-Gateway einen einfachen Lastausgleich zwischen ihnen im Round-Robin-Verfahren durch. Das Gateway fragt jeden Agenten jede Sekunde ab und entfernt oder fügt die Agenten entsprechend dem Routing-Pool hinzu. Eine weitergeleitete Anfrage, die aufgrund eines unerwarteten Fehlers wie einer Netzwerktrennung oder eines Timeouts fehlschlägt, führt ebenfalls dazu, dass der Agent aus dem Routing-Pool entfernt wird. Der Agent wird an den Pool zurückgegeben, sobald das Gateway ihn erfolgreich abfragen kann. Der Datenverkehr zu Upstream-Agenten wird an ihre konfigurierten externen URLs weitergeleitet.

API-Gateways werden mit demselben Installationsprogramm wie jeder andere Agent installiert. Die Konfiguration weist den Agent an, im Proxy-Gateway-Modus zu arbeiten. Da API-Gateways nicht mit anderen Agenten synchronisiert werden müssen, können sie ohne externe Abhängigkeiten (abgesehen von der Service Bus-Verbindung) unter Verwendung einzelner LocalDB-Instanzen installiert werden.


Verwandte Artikel4.5 VersionshinweiseAgentenstatus-EndpunktEinführung in Frends AgentBeispiel für die Einrichtung eines API-Gateway-AgentenEinführung in HTTP-Proxy und Platzhalter in Frends