Edge Microgateway-Versionshinweise

Sie lesen gerade die Dokumentation zu Apigee Edge.
Zur Dokumentation zu Apigee X info

Version 3.3.x

Fehlerkorrekturen und Verbesserungen – Version 3.3.x

3.3.7

Am 17. Juli 2025 haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

Fehlerkorrekturen und Verbesserungen:

edgemicro:
  plugins:
    excludeUrls: '/hello,/proxy_one/*' # global exclude urls
    sequence:
      -oauth
      -json2xml
      -quota
      -json2xml:
          excludeUrls: '/hello/xml/*'  # plugin level exclude urls

Behobene Sicherheitsprobleme

• CVE-2024-12905
• CVE-2025-46653

3.3.6

Am 16. April 2025 haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

Komponentenversionen:

In der folgenden Tabelle sind die Versionsnummern für die einzelnen Komponentenprojekte aufgeführt, die mit Edge Microgateway 3.3.6 verknüpft sind. Da jede Komponente ein separates Projekt ist, stimmen die Release-Nummern möglicherweise nicht mit der Hauptproduktversion überein:

Behobene Sicherheitsprobleme

• CVE-2025-27789
• CVE-2024-21538
• CVE-2024-12133

3.3.5

Am Freitag, dem 20. Dezember 2024, haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

Komponentenversionen:

In der folgenden Tabelle sind die Versionsnummern für die einzelnen Komponentenprojekte aufgeführt, die mit Edge Microgateway 3.3.5 verknüpft sind. Da jede Komponente ein separates Projekt ist, stimmen die Release-Nummern möglicherweise nicht mit der Hauptproduktversion überein:

Fehlerkorrekturen und Verbesserungen:

current nodejs version is  18.x.x Note, v18.x.x will be out of support soon, see https://docs.apigee.com/release/notes/edge-microgateway-release-notes-0

You are using a version of NodeJS that is not supported

Behobene Sicherheitsprobleme

• CVE-2024-21538
• CVE-2024-45590
• CVE-2019-3844
• CVE-2019-12290
• CVE-2020-1751
• CVE-2018-12886
• CVE-2023-50387
• CVE-2019-3843
• CVE-2022-4415
• CVE-2021-3997

3.3.4

Am 18. September 2024 haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

Komponentenversionen:

In der folgenden Tabelle sind die Versionsnummern für die einzelnen Komponentenprojekte aufgeführt, die mit Edge Microgateway 3.3.4 verknüpft sind. Da jede Komponente ein separates Projekt ist, stimmen die Versionsnummern möglicherweise nicht mit der Hauptproduktversion überein:

Fehlerkorrekturen und Verbesserungen:

Behobene Sicherheitsprobleme

• CVE-2021-23337
• CVE-2024-4068
• CVE-2020-28469
• CVE-2020-28503

3.3.3

Am 25. April 2024 haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

Komponentenversionen:

In der folgenden Tabelle sind die Versionsnummern für die einzelnen Komponentenprojekte aufgeführt, die mit Edge Microgateway 3.3.3 verknüpft sind. Da jede Komponente ein separates Projekt ist, stimmen die Versionsnummern möglicherweise nicht mit der Hauptproduktversion überein:

Fehlerkorrekturen und Verbesserungen:

Behobene Sicherheitsprobleme

• CVE-2023-0842
• CVE-2023-26115
• CVE-2022-25883
• CVE-2017-20162
• CVE-2022-31129
• CVE-2022-23539
• CVE-2022-23541
• CVE-2022-23540
• CVE-2024-21484
• CVE-2022-46175
• CVE-2023-45133
• CVE-2020-15366
• CVE-2023-26136
• CVE-2023-26115

3.3.2

Am 18. August 2023 haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

Komponentenversionen:

In der folgenden Tabelle sind die Versionsnummern für die einzelnen Komponentenprojekte aufgeführt, die mit Edge Microgateway 3.3.2 verknüpft sind. Da jede Komponente ein separates Projekt ist, stimmen die Versionsnummern möglicherweise nicht mit der Hauptproduktversion überein:

Fehlerkorrekturen und Verbesserungen:

Behobene Sicherheitsprobleme

Keine.

3.3.1

Am 7. Juni 2022 haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

Komponentenversionen:

In der folgenden Tabelle sind die Versionsnummern für die einzelnen Komponentenprojekte aufgeführt, die mit Edge Microgateway 3.3.1 verknüpft sind. Da jede Komponente ein separates Projekt ist, stimmen die Versionsnummern möglicherweise nicht mit der Hauptproduktversion überein:

Fehlerkorrekturen und Verbesserungen:

Behobene Sicherheitsprobleme

3.3.0

Am 4. Februar 2022 haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

Komponentenversionen:

In der folgenden Tabelle sind die Versionsnummern für die einzelnen Komponentenprojekte aufgeführt, die mit Edge Microgateway 3.3.0 verknüpft sind. Da jede Komponente ein separates Projekt ist, stimmen die Versionsnummern möglicherweise nicht mit der Hauptproduktversion überein:

Fehlerkorrekturen und Verbesserungen:

npm install apigeetool@0.15.1

Version 3.2.x

Fehlerkorrekturen und Verbesserungen – Version 3.2.x

3.2.3

Am 17. September 2021 haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

Komponentenversionen:

In der folgenden Tabelle sind die Versionsnummern für die einzelnen Komponentenprojekte aufgeführt, die mit Edge Microgateway 3.2.3 verknüpft sind. Da jede Komponente ein separates Projekt ist, stimmen die Versionsnummern möglicherweise nicht mit der Hauptproduktversion überein:

Fehlerkorrekturen und Verbesserungen:

Behobene Sicherheitsprobleme

3.2.2

Am Donnerstag, 15. Juli 2021, haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

Komponentenversionen:

In der folgenden Tabelle sind die Versionsnummern für die einzelnen Komponentenprojekte aufgeführt, die mit Edge Microgateway 3.2.2 verknüpft sind. Da jede Komponente ein separates Projekt ist, stimmen die Versionsnummern möglicherweise nicht mit der Hauptproduktversion überein:

Fehlerkorrekturen und Verbesserungen:

Behobene Sicherheitsprobleme

3.2.1

Am Freitag, den 5. März 2021, haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

Komponentenversionen:

In der folgenden Tabelle sind die Versionsnummern für die einzelnen Komponentenprojekte aufgeführt, die mit Edge Microgateway 3.2.1 verknüpft sind. Da jede Komponente ein separates Projekt ist, stimmen die Versionsnummern möglicherweise nicht mit der Hauptproduktversion überein:

Fehlerkorrekturen und Verbesserungen:

edgemicro:
 enable_GET_req_body: true

3.2.0

Am Donnerstag, 21. Januar 2021, haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

Komponentenversionen:

In der folgenden Tabelle sind die Versionsnummern für die einzelnen Komponentenprojekte aufgeführt, die mit Edge Microgateway 3.2.0 verknüpft sind. Da jede Komponente ein separates Projekt ist, stimmen die Versionsnummern möglicherweise nicht mit der Hauptproduktversion überein:

Fehlerkorrekturen und Verbesserungen:

Version 3.1.x

Fehlerkorrekturen und Verbesserungen – Version 3.1.x

3.1.8

Am Montag, dem 16. November 2020, haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

Komponentenversionen:

In der folgenden Tabelle sind die Versionsnummern für die einzelnen Komponentenprojekte aufgeführt, die mit Edge Microgateway 3.1.8 verknüpft sind. Da jede Komponente ein separates Projekt ist, stimmen die Versionsnummern möglicherweise nicht mit der Hauptproduktversion überein:

Fehlerkorrekturen und Verbesserungen:

3.1.7

Am Donnerstag, dem 24. September 2020, haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

Komponentenversionen:

In der folgenden Tabelle sind die Versionsnummern für die einzelnen Komponentenprojekte aufgeführt, die mit Edge Microgateway 3.1.7 verknüpft sind. Da jede Komponente ein separates Projekt ist, stimmen die Versionsnummern möglicherweise nicht mit der Hauptproduktversion überein:

Fehlerkorrekturen und Verbesserungen:

{"message":"write after end","code":"ERR_STREAM_WRITE_AFTER_END"}

3.1.6

Am Donnerstag, dem 20. August 2020, haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

Komponentenversionen:

In der folgenden Tabelle sind die Versionsnummern für die einzelnen Komponentenprojekte aufgeführt, die mit Edge Microgateway 3.1.6 verknüpft sind. Da jede Komponente ein separates Projekt ist, stimmen die Versionsnummern möglicherweise nicht mit der Hauptproduktversion überein:

Fehlerkorrekturen und Verbesserungen:

3.1.5

Am Freitag, dem 26. Juni 2020, haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

Komponentenversionen:

In der folgenden Tabelle sind die Versionsnummern für die einzelnen Komponentenprojekte aufgeführt, die mit Edge Microgateway 3.1.5 verknüpft sind. Da jede Komponente ein separates Projekt ist, stimmen die Versionsnummern möglicherweise nicht mit der Hauptproduktversion überein:

Fehlerkorrekturen und Verbesserungen:

3.1.4

Am Freitag, dem 23. April 2020, haben wir den folgenden Fix für Edge Microgateway veröffentlicht.

Fehlerkorrektur:

Ein Abhängigkeitsproblem in Version 3.1.3 wurde behoben. Version 3.1.3 wurde im npm-Repository als verworfen gekennzeichnet. Andernfalls gelten alle in den Versionshinweisen zu Version 3.1.3 beschriebenen Fehlerkorrekturen und Verbesserungen auch für dieses Release.

3.1.3

Am Mittwoch, dem 15. April 2020, haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

Komponentenversionen:

In der folgenden Tabelle sind die Versionsnummern für die einzelnen Komponentenprojekte aufgeführt, die mit Edge Microgateway 3.1.3 verknüpft sind. Da jede Komponente ein separates Projekt ist, stimmen die Versionsnummern möglicherweise nicht mit der Hauptproduktversion überein:

Fehlerkorrekturen und Verbesserungen:

• 153509313: Ein Problem wurde behoben, bei dem das Node.js-Debugmodul zu Speicherlecks führte. Das Problem tritt in den Versionen 3.1.0, 3.1.1 und 3.1.2 auf.
• 153509313: Ein Problem wurde behoben, bei dem in der Protokollausgabe dieselbe Nachrichten-ID für zwei verschiedene Transaktionen ausgegeben wurde.
• 151673570: Ein Problem wurde behoben, bei dem Edge Microgateway nicht aktualisiert wurde, um neue Apigee KVM-APIs zu verwenden. Edge Microgateway verwendet jetzt die neuen Befehle zum Hinzufügen und Aktualisieren der KVM-Werte.
• 152822846 – In früheren Releases wurde Edge Microgateway so aktualisiert, dass die Verarbeitung der Zuordnung von Ressourcenpfaden mit der von Apigee Edge übereinstimmt. In dieser Version wurde ein Problem behoben, bei dem das Muster /literal_string/* nicht richtig verarbeitet wurde. Beispiel: /*/2/*. Weitere Informationen finden Sie unter Verhalten eines Ressourcenpfads von '/', '/*' und '/**' konfigurieren.
• 152005003 – Es wurden Änderungen vorgenommen, um organisations- und umgebungsbezogene IDs für Kontingente zu aktivieren.
• 152005003 – Es wurden Änderungen vorgenommen, um organisations- und umgebungsbezogene IDs für Kontingente zu aktivieren. Die Kombination aus „org + env + appName + productName“ wird als Kontingent-ID verwendet.

3.1.2

Am Montag, dem 16. März 2020, haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

Komponentenversionen:

In der folgenden Tabelle sind die Versionsnummern für die einzelnen Komponentenprojekte aufgeführt, die mit Edge Microgateway 3.1.3 verknüpft sind. Da jede Komponente ein separates Projekt ist, stimmen die Versionsnummern möglicherweise nicht mit der Hauptproduktversion überein:

Fehlerkorrekturen und Verbesserungen:

• 151285018 – Es wurde eine Funktionserweiterung vorgenommen, um HTTP-Proxy-Unterstützung für Traffic zwischen Edge Microgateway und Backend-Zielen hinzuzufügen. Außerdem wurden Probleme mit der vorhandenen HTTP-Proxy-Unterstützung zwischen Edge Microgateway und Apigee Edge behoben. Weitere Informationen finden Sie unter:
  • HTTP-Proxy für die Kommunikation mit Apigee Edge verwenden
  • HTTP-Proxy für die Zielkommunikation verwenden
• 149101890: Der Protokollbenachrichtigungscode für Fälle, in denen der Zielserver oder Load Balancer die Verbindung schließt, wurde von ERROR in INFO geändert.
• 150746985: Ein Problem wurde behoben, bei dem der Befehl edgemicro verify nicht richtig funktionierte, wenn redisBasedConfigCache: true oder quotaUri: https://%s-%s.apigee.net/edgemicro-auth in der Konfigurationsdatei vorhanden waren.
• 151284716: Serververbindungen werden jetzt schneller geschlossen, wenn Worker während eines Neuladens neu gestartet werden.
• 151588764 – Node.js-Version im Docker-Image, das zum Ausführen von Edge Microgateway in einem Docker-Container verwendet wird, auf Version 12 aktualisieren, da Node.js v8 eingestellt wurde.
• 151306049: Die Dokumentation wurde aktualisiert und enthält nun eine Liste der Apigee Edge-Verwaltungs-APIs, die von Edge Microgateway-CLI-Befehlen verwendet werden. Weitere Informationen finden Sie unter Welche Verwaltungs-APIs werden von Edge Microgateway verwendet?.

3.1.1

Am Donnerstag, 20. Februar, haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

Komponentenversionen:

In der folgenden Tabelle sind die Versionsnummern für die einzelnen Komponentenprojekte aufgeführt, die mit Edge Microgateway 3.1.1 verknüpft sind. Da jede Komponente ein separates Projekt ist, stimmen die Versionsnummern möglicherweise nicht mit der Hauptproduktversion überein:

Fehlerkorrekturen und Verbesserungen:

• 146069701: Ein Problem wurde behoben, bei dem das Modul microgateway-core die Umgebungsvariablen HTTP_PROXY und HTTPS_PROXY nicht berücksichtigt hat. Durch diese Änderung werden Proxy-Einstellungen in der YAML-Konfigurationsdatei, sofern angegeben, jetzt ignoriert. Der Proxy wird nur über die Umgebungsvariablen angegeben.

  Wenn Sie die Proxykonfiguration in der Konfigurationsdatei angeben möchten, müssen Sie auch eine HTTP_PROXY-Variable angeben, die dieselbe Proxy-URL enthält wie die in der Konfigurationsdatei angegebene. Wenn Sie beispielsweise die folgende Konfiguration angeben:

  edge_config:
    proxy: http://10.128.0.20:3128
    proxy_tunnel: true

  Sie müssen auch diese Umgebungsvariable angeben:

  HTTP_PROXY=http://10.128.0.20:3128

• 146320620: Ein neuer Konfigurationsparameter, edgemicro.headers_timeout, wurde hinzugefügt. Dieses Attribut begrenzt die Zeit in Millisekunden, die der HTTP-Parser wartet, bis er die vollständigen HTTP-Header empfängt. Beispiel:

  edgemicro:
  keep_alive_timeout: 6000
  headers_timeout: 12000

  Intern wird mit dem Parameter das Node.js-Attribut Server.headersTimeout für Anfragen festgelegt. Standard: 5 Sekunden mehr als die mit edgemicro.keep_alive_timeout festgelegte Zeit. Diese Standardeinstellung verhindert, dass Load-Balancer oder Proxys die Verbindung fälschlicherweise trennen.)

• 149278885: Es wurde eine neue Funktion hinzugefügt, mit der Sie das Ziel-API-Zeitlimit auf API-Proxy-Ebene festlegen können, anstatt eine globale Zeitlimiteinstellung zu verwenden.

  Wenn Sie das TargetEndpoint-Attribut io.timeout.millis im API-Proxy festlegen, kann Edge Microgateway dieses Attribut abrufen und zielendpunktspezifische Zeitüberschreitungen anwenden. Wenn dieser Parameter nicht angewendet wird, verwendet Edge Microgateway das globale Zeitlimit, das mit edgemicro.request_timeout angegeben ist.

3.1.0

Am Dienstag, dem 21. Januar, haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

Komponentenversionen:

In der folgenden Tabelle sind die Versionsnummern für die einzelnen Komponentenprojekte aufgeführt, die mit Edge Microgateway 3.1.0 verknüpft sind. Da jede Komponente ein separates Projekt ist, stimmen die Versionsnummern möglicherweise nicht mit der Hauptproduktversion überein:

Fehlerkorrekturen und Verbesserungen:

• 144187500: Ein neues Ereignis auf WARN-Ebene wird protokolliert, wenn das Flag quotas.failOpen ausgelöst wird. Dieses Flag wird ausgelöst, wenn ein Fehler bei der Kontingentverarbeitung auftritt oder wenn die Anfrage „quota apply“ an Edge fehlschlägt, weil die Remote-Kontingentzähler nicht aktualisiert werden können. In diesem Fall wird das Kontingent nur anhand lokaler Zählungen verarbeitet, bis die nächste erfolgreiche Remote-Kontingentsynchronisierung erfolgt. Bisher wurde dieses Ereignis nur protokolliert, wenn die Protokollebene auf DEBUG festgelegt war.

  Beispiel:

  2020-01-20T02:52:53.040Z [warn][localhost:8000][5][foo-eval][test][hello/][]
  [DbpGIq9jKfzPX8jvXEivhA0LPwE][f372cc30-3b2f-11ea-845f-a627f][quota][remote quota not
  available so processing locally, setting quota-failed-open for identifier: AppQuota60.Quota60]
  [GET][][][][]

• 145023519: Ein Problem wurde behoben, bei dem laufende oder neue Transaktionen beeinträchtigt wurden, wenn Edge Microgateway eine Änderung an einem API-Proxy erkannt hat. Wenn eine Änderung an einem Proxy vorgenommen wird, aktualisiert Edge Microgateway den Cache und die Worker-Knoten werden neu gestartet. Diese Änderung hat keine Auswirkungen auf laufende Transaktionen und neue API-Aufrufe, die an das Microgateway gesendet werden.
• 146378327: Die Logebene von sourceRequest, targetRequest und targetResponse wurde in INFO geändert.
• 146019878 – Eine Diskrepanz zwischen der Latenz, die für „API-Proxy-Leistung“ in Edge Analytics und Edge Microgateway-Logereignissen für „sourceResponse“/„targetResponse“ berechnet wurde, wurde behoben. Die Latenz bei Edge-Analyse- und Microgateway-Protokollereignissen ist jetzt gleich.
• Änderungen an der Logik für den Musterabgleich:
  • 147027862 – Das OAuth-Plug-in wurde aktualisiert, um die folgenden Muster für den Ressourcenpfad zu unterstützen, wie in API-Produkten angegeben:
    • /{literal}**
    • /{literal}*
    • Beliebige Kombination der beiden oben genannten Muster

    Mit dieser Änderung folgt das Edge Microgateway-Plug-in jetzt dem gleichen Musterabgleich wie Apigee Edge, wie unter Verhalten eines Ressourcenpfads von '/', '/*' und '/**' konfigurieren beschrieben.

  • 145644205: Die Logik für den Musterabgleich des API-Schlüssel-Plug-ins wurde an das OAuth-Plug-in angepasst.
• 143488312: Ein Problem wurde behoben, bei dem führende oder nachgestellte Leerzeichen im Parameter „client_id“ dazu führten, dass die erstellte JWT-Produktliste für OAuth-Token- und API-Schlüsselanfragen leer war.
• 145640807 und 147579179: Es wurde ein neues Feature hinzugefügt, mit dem eine spezielle Edge Microgateway-Instanz namens „Synchronizer“ Konfigurationsdaten aus Apigee Edge abrufen und in eine lokale Redis-Datenbank schreiben kann. Andere Microgateway-Instanzen können dann so konfiguriert werden, dass sie ihre Konfigurationsdaten aus der Datenbank lesen. Diese Funktion erhöht die Resilienz von Edge Microgateway. Dadurch können Microgateway-Instanzen gestartet werden und funktionieren, ohne mit Apigee Edge kommunizieren zu müssen. Weitere Informationen finden Sie unter Synchronizer verwenden.

  Die Synchronisierungsfunktion wird derzeit für Redis 5.0.x unterstützt.

Version 3.0.x

Fehlerkorrekturen und Verbesserungen in Version 3.0.x

3.0.10

Am Freitag, den 8. November, haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

Komponentenversionen:

In der folgenden Tabelle sind die Versionsnummern für die einzelnen Komponentenprojekte aufgeführt, die mit Edge Microgateway 3.0.10 verknüpft sind. Da jede Komponente ein separates Projekt ist, stimmen die Versionsnummern möglicherweise nicht mit der Hauptproduktversion überein:

Fehlerkorrekturen und Verbesserungen:

• 142677575: Es wurde eine Funktionsaktualisierung vorgenommen, sodass das Musterabgleich für Ressourcenpfade, die in API-Produkten für Edge Microgateway verwendet werden, jetzt dem Musterabgleich für Ressourcenpfade entspricht, der von Apigee Edge verwendet wird, wie in Verhalten eines Ressourcenpfads von „/“, „/*“ und „/**“ konfigurieren beschrieben.

  Hinweis: Wenn Sie ein zusammengesetztes Ressourcenmuster wie /*/2/** verwenden, muss der edgemicro_auth-Proxy einem eigenständigen API-Produkt hinzugefügt werden. Anschließend müssen Sie das Produkt in die Entwickler-App des Proxys aufnehmen, wie im folgenden Screenshot dargestellt:

  

  Hinweis: Das Konfigurationsattribut features.isSingleForwardSlashBlockingEnabled, wie unter Verhalten eines Ressourcenpfads von '/', '/*' und '/**' konfigurieren beschrieben, wird für Edge Microgateway nicht unterstützt.

• 143740696 – Die Konfigurationsstruktur für quotas hat sich geändert (siehe auch die Versionshinweise für Version 3.0.9). Mit der quotas-Property wird das Kontingent-Plug-in konfiguriert. Die Struktur wurde geändert, um die Konfigurationselemente übersichtlicher zu gestalten. Verwenden Sie die folgende YAML-Konfiguration, um das Kontingent-Plug-in zu konfigurieren. Das Konfigurationsattribut heißt quotas. Weitere Informationen zu den einzelnen quotas-Konfigurationsattributen finden Sie unter Konfigurationsoptionen für Kontingente.

  edgemicro:
    home: ../gateway
    port: 8000
    max_connections: -1
    max_connections_hard: -1
    logging:
      level: info
      dir: /var/tmp
      stats_log_interval: 60
    plugins:
      dir: ../plugins
      sequence:
        - oauth
        - quota
  quotas:
    bufferSize:
      hour: 20000
      minute: 500
      default: 10000
    useDebugMpId: true
    failOpen: true
  ...

• 141750056 – Es wurde eine neue Funktion hinzugefügt, mit der Sie Redis als Quota-Backing-Store verwenden können. Wenn useRedis „true“ ist, wird das Modul volos-quota-redis verwendet. Wenn „true“, ist das Kontingent auf die Edge Microgateway-Instanzen beschränkt, die eine Verbindung zu Redis herstellen. Wenn „false“, wird das Modul volos-quota-apigee als Sicherungsspeicher verwendet und der Kontingentzähler ist global. Weitere Informationen finden Sie unter Konfigurationsoptionen für Kontingente. Beispiel:

  edgemicro:
  ...
  quotas:
    useRedis: true
    redisHost: localhost
    redisPort: 6379
    redisDb: 1

• 140574210: Die Standardablaufzeit für Tokens, die vom edgemicro-auth-Proxy generiert werden, wurde von 108.000 Millisekunden (1,8 Minuten) auf 1.800 Sekunden (30 Minuten) geändert.
• 143551282: Zur Unterstützung von SAML-fähigen Organisationen wurde der Befehl edgemicro genkeys um den Parameter ‑‑token erweitert. Mit diesem Parameter können Sie ein OAuth-Token für die Authentifizierung anstelle von Nutzername/Passwort verwenden. Weitere Informationen finden Sie unter Schlüssel generieren.

3.0.9

Am Freitag, dem 11. Oktober, haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

Komponentenversionen:

In der folgenden Tabelle sind die Versionsnummern für die einzelnen Komponentenprojekte aufgeführt, die mit Edge Microgateway 3.0.9 verknüpft sind. Da jede Komponente ein separates Projekt ist, stimmen die Versionsnummern möglicherweise nicht mit der Hauptproduktversion überein:

Fehlerkorrekturen und Verbesserungen:

• 141989374: Für das Kontingent-Plug-in wurde eine neue „Fail Open“-Funktion hinzugefügt. Wenn diese Funktion aktiviert ist und ein Fehler bei der Kontingentverarbeitung auftritt oder die Anfrage „quota apply“ an Edge fehlschlägt, sodass die Remote-Kontingentzähler nicht aktualisiert werden, wird das Kontingent nur auf Grundlage der lokalen Zähler verarbeitet, bis die nächste erfolgreiche Remote-Kontingentsynchronisierung erfolgt. In beiden Fällen wird im Anfrageobjekt das Flag quota-failed-open gesetzt.

  Wenn Sie die Funktion „Fail Open“ für das Kontingent aktivieren möchten, legen Sie die folgende Konfiguration fest:

  quotas :
   failOpen : true

  Hinweis: Außerdem wurde das Flag des fail-open-Anfrageobjekts des OAuth-Plug-ins in oauth-failed-open geändert.

• 142093764 – Es wurde eine Konfigurationsänderung am edgemicro-auth-Proxy vorgenommen, um Kontingentüberschreitungen zu verhindern. Die Änderung besteht darin, den Kontingenttyp auf calendar festzulegen. Wenn Sie diese Verbesserung nutzen möchten, müssen Sie edgemicro-auth auf Version 3.0.7 oder höher aktualisieren.
• 142520568: Eine neue Funktion wurde hinzugefügt, mit der die MP-ID (Message Processor) in Kontingentantworten protokolliert werden kann. Wenn Sie diese Funktion verwenden möchten, müssen Sie Ihren edgemicro-auth-Proxy auf Version 3.0.7 oder höher aktualisieren und die folgende Konfiguration festlegen:

  quotas:
    useDebugMpId: true

  Wenn useDebugMpId festgelegt ist, enthalten Kontingentantworten von Edge die MP-ID und werden von Edge Microgateway protokolliert. Beispiel:

  {
      "allowed": 20,
      "used": 3,
      "exceeded": 0,
      "available": 17,
      "expiryTime": 1570748640000,
      "timestamp": 1570748580323,
      "debugMpId": "6a12dd72-5c8a-4d39-b51d-2c64f953de6a"
  }

3.0.8

Am Donnerstag, dem 26. September, haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

Komponentenversionen:

In der folgenden Tabelle sind die Versionsnummern für die einzelnen Komponentenprojekte aufgeführt, die mit Edge Microgateway 3.0.8 verknüpft sind. Da jede Komponente ein separates Projekt ist, stimmen die Versionsnummern möglicherweise nicht mit der Hauptproduktversion überein:

Fehlerkorrekturen und Verbesserungen:

• 140025210 – Es wurde eine neue „Fail Open“-Funktion hinzugefügt. Mit dieser Funktion kann die API-Verarbeitung fortgesetzt werden, wenn ein abgelaufenes JWT-Token aufgrund eines Verbindungsfehlers, der einen erfolgreichen API-Schlüssel-Prüfaufruf an den edgemicro-auth-Proxy verhindert, nicht aktualisiert werden kann.

  Mit dieser Funktion können Sie einen Kulanzzeitraum festlegen, in dem das alte Token im Cache verbleibt und wiederverwendet wird, bis der Kulanzzeitraum abläuft. Mit dieser Funktion kann Edge Microgateway Anfragen auch bei einem vorübergehenden Verbindungsfehler weiterverarbeiten. Wenn die Verbindung wiederhergestellt wird und ein erfolgreicher Aufruf der API-Schlüsselüberprüfung erfolgt, wird ein neues JWT abgerufen und ersetzt das alte JWT im Cache.

  So konfigurieren Sie das neue „Fail-Open“-Feature:

  1. Legen Sie im Abschnitt oauth der Edge Microgateway-Konfigurationsdatei die folgenden Attribute fest:

     oauth:
       failOpen: true
       failopenGraceInterval: time_in_seconds
       cacheKey: true
       ...

     Beispiel:

     oauth:
       failOpen: true
       failopenGraceInterval: 5
       cacheKey: true
       ...

     In diesem Beispiel wird das alte Token 5 Sekunden lang verwendet, wenn es aufgrund eines Verbindungsproblems nicht aktualisiert werden kann. Nach 5 Sekunden wird ein Authentifizierungsfehler zurückgegeben.

• 141168968: Die correlation_id wurde in die gesamte Logausgabe des Plug-ins aufgenommen. Außerdem wurden die Logebenen für einige Logs nach Bedarf in error geändert.
• 140193349 – Der edgemicro-auth-Proxy wurde aktualisiert, sodass der Edge Microgateway-Schlüssel und das Edge Microgateway-Secret bei jeder Anfrage vom Typ „API-Schlüssel bestätigen“ überprüft werden müssen. Edge Microgateway wurde aktualisiert, sodass der Schlüssel und das Secret immer bei jeder Anfrage zum Prüfen des API-Schlüssels gesendet werden. Durch diese Änderung wird verhindert, dass Clients ein JWT nur mit einem API-Schlüssel erhalten.
• 140090250: Es wurde ein Update vorgenommen, um die Diagnoseprotokollierung für die Kontingentverarbeitung hinzuzufügen. Durch diese Änderung ist es jetzt möglich, die Ausgabe des Kontingentlogs mit den restlichen Edge Microgateway-Logs in Beziehung zu setzen.

3.0.7

Am Donnerstag, dem 12. September, haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

Komponentenversionen:

In der folgenden Tabelle sind die Versionsnummern für die einzelnen Komponentenprojekte aufgeführt, die mit Edge Microgateway 3.0.7 verknüpft sind. Da jede Komponente ein separates Projekt ist, stimmen die Versionsnummern möglicherweise nicht mit der Hauptproduktversion überein:

Fehlerkorrekturen und Verbesserungen:

• 140075602: Das OAuth-Plug‑in wurde aktualisiert, um bei Bedarf einen 5xx-Statuscode zurückzugeben. Bisher hat das Plug-in in allen Fällen, die nicht 200 waren, nur 4xx-Statuscodes zurückgegeben. Bei jeder Nachrichtenantwort, die keinen Statuscode 200 hat, wird jetzt der genaue 4xx- oder 5xx-Code zurückgegeben, je nach Fehler.

  Diese Funktion ist standardmäßig deaktiviert. Wenn Sie diese Funktion aktivieren möchten, fügen Sie Ihrer Edge Microgateway-Konfiguration das Attribut oauth.useUpstreamResponse: true hinzu. Beispiel:

  oauth:
    allowNoAuthorization: false
    allowInvalidAuthorization: false
    gracePeriod: 10
    useUpstreamResponse: true

• 140090623 – In Version 3.0.6 wurde das neue Konfigurationsattribut quota.quotaUri hinzugefügt. Legen Sie diese Konfigurationseigenschaft fest, wenn Sie Kontingente über den edgemicro-auth-Proxy verwalten möchten, der in Ihrer Organisation bereitgestellt wird. Wenn dieses Attribut nicht festgelegt ist, wird standardmäßig der interne Edge Microgateway-Endpunkt verwendet. Beispiel:

  edge_config:
    quotaUri: https://%s-%s.apigee.net/edgemicro-auth

  In Version 3.0.7 wurde edgemicro-auth aktualisiert, um diese neue Konfiguration zu akzeptieren. Wenn Sie die quotaUri-Property verwenden möchten, müssen Sie auf den neuesten edgemicro-auth-Proxy aktualisieren. Weitere Informationen finden Sie unter edgemicro-auth-Proxy aktualisieren.

• 140470888: Den Kontingentaufrufen wurde ein Autorisierungsheader hinzugefügt, um die Authentifizierung zu ermöglichen. Außerdem wurde der edgemicro-auth-Proxy so geändert, dass „organization“ aus der Kontingent-ID entfernt wird. Da sich der Kontingentendpunkt in der Organisation des Kunden befindet, ist die Kontingentkennung nicht mehr erforderlich.
• 140823165 – Der folgende Attributname:

  edgemicro:
      keepAliveTimeout

  wurde in Version 3.0.6 falsch dokumentiert. Der richtige Eigenschaftsname lautet:

  edgemicro:
      keep_alive_timeout

• 139526406 – Ein Fehler wurde behoben, bei dem eine falsche Kontingentanzahl angezeigt wurde, wenn eine Entwickler-App mehrere Produkte hatte. Das Kontingent wird jetzt für jedes Produkt in einer App mit mehreren Produkten korrekt durchgesetzt. Die Kombination aus „appName + productName“ wird als Kontingent-ID verwendet.

3.0.6

Am Donnerstag, dem 29. August, haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

• 138633700: Das neue Konfigurationsattribut keepAliveTimeout wurde hinzugefügt. Mit dieser Eigenschaft können Sie das Edge Microgateway-Zeitlimit (in Millisekunden) festlegen. (Standard: 5.000 Millisekunden)

  Beispiel:

  edgemicro:
    keep_alive_timeout: 600

• 140090623: Das neue Konfigurationsattribut quotaUri wurde hinzugefügt. Legen Sie diese Konfigurationseigenschaft fest, wenn Sie Kontingente über den edgemicro-auth-Proxy verwalten möchten, der in Ihrer Organisation bereitgestellt wird. Wenn dieses Attribut nicht festgelegt ist, wird standardmäßig der interne Edge Microgateway-Endpunkt verwendet. Beispiel:

  edge_config:
    quotaUri: https://your_org-your_env.apigee.net/edgemicro-auth
  

  Damit Sie diese Funktion verwenden können, müssen Sie zuerst die aktuelle Version des edgemicro-auth-Proxys in Ihrer Organisation bereitstellen. Weitere Informationen finden Sie unter edgemicro-auth-Proxy aktualisieren.

• 138722809: Das neue stack_trace-Konfigurationsattribut wurde hinzugefügt. Mit dieser Property können Sie festlegen, ob Stacktraces in Logdateien angezeigt werden. Beispiel:

  stack_trace: false

  Wenn stack_trace auf true gesetzt ist, wird der Stacktrace in den Logs ausgegeben. Wenn sie auf false gesetzt ist, wird der Stacktrace nicht in Logs ausgegeben.

3.0.5

Am Donnerstag, den 15. August, haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

• 139005279 – Ein Problem wurde behoben, bei dem mit dem Befehl edgemicro status nicht die richtige Anzahl von Worker-Prozessen zurückgegeben wurde.
• 138437710: Ein Problem in der ExitCounter-Klasse wurde behoben, das verhinderte, dass das richtige Log geschrieben wurde.

• 139064652: Die Logebenen trace und debug können jetzt für Ereignis- und Systemprotokolle hinzugefügt werden. Bisher wurde nur die Möglichkeit hinzugefügt, diese Protokollebenen hinzuzufügen. Derzeit sind die Logebenen info, warn und error verfügbar.
• 139064616 – Die Logausgabe wurde für alle Konsolenlog-Anweisungen standardisiert. Konsolenprotokollierungsanweisungen enthalten jetzt folgende Attribute:
• Zeitstempel
• Komponentenname
• Prozess-ID
• Konsolenprotokollmeldung

• 138413755 – Verbesserte Protokollmeldungen für JWT-Schlüssel und ‑Secrets für die folgenden CLI-Befehle: cert, verify, upgradekvm, token, genkeys, revokekeys, rotatekey und configure.

• 138413577 – Fehlerbehandlung für Zeitüberschreitungen von Back-End-Diensten hinzufügen und verbessern.
• 138413303 – Fehlerbehandlung für Antwort- und Socket-Timeouts hinzufügen und verbessern.
• 138414116: Fehlerbehandlung für Fehler vom Typ „Verbindung verweigert“ hinzugefügt und verbessert.

3.0.4

Am Donnerstag, dem 1. August, haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

• 134445926 – Verbesserungen der internen Edge Microgateway-Authentifizierung.
• 137582169: Es wurde ein Problem behoben, durch das unerwünschte Prozesse gestartet wurden. Die zusätzlichen Prozesse führten dazu, dass Plug-ins neu geladen wurden und zu viel Arbeitsspeicher verwendet wurde. Edge Microgateway hält die Anzahl der Prozesse jetzt innerhalb des erwarteten Limits.
• 137768774 – Verbesserungen an Log-Nachrichten:
  • Bereinigte Transaktions- (Anfrage-)Logs.
  • Bei Bedarf wurden weitere Log-Nachrichten hinzugefügt.
  • Nachrichten für Transaktions- (Anfrage-)Logs wurden aus der Konsolenausgabe in die entsprechende Logdatei verschoben.
  • Die Konsolenlogs wurden aktualisiert, um eine zentralisierte Logging-Funktion zu verwenden.
• 138321133, 138320563: Fundamentale interne Änderung des Kontingentpuffers, um zukünftige Kontingenterweiterungen zu ermöglichen.

3.0.3

Am Dienstag, dem 23. Juli, haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

• Verbesserungen bei der Protokollierung: Für vorhandene Laufzeitlogs wird eine neue eventLog()-Funktion verwendet, mit der Laufzeitdaten in einem einheitlichen Format erfasst und protokolliert werden. Die Protokollinformationen umfassen:
  • Zeitstempel (nach ISO 8601: JJJJ-MM-TTTHH:mm:ss.sssZ)
  • Log-Ebene (Fehler, Warnung oder Information).
  • Hostname: Der anfragende Hostname aus dem Anfrageheader.
  • Prozess-ID: Wenn Sie einen Cluster von Node.js-Prozessen ausführen, ist dies die ID des Prozesses, in dem die Protokollierung erfolgt ist.
  • Name der Apigee-Organisation.
  • Name der Umgebung in der Organisation.
  • Name des API-Proxys.
  • IP-Adresse des Clients.
  • ClientId.
  • Korrelations-ID (derzeit nicht festgelegt).
  • Name der Edge Microgateway-Komponente.
  • Benutzerdefinierte Nachricht: Bei einigen Objekten werden möglicherweise zusätzliche Informationen ausgegeben, die an diese Fehler-Property übergeben werden.
  • Anfragemethode (bei HTTP-Anfrage).
  • Antwortstatuscode (bei HTTP-Anfrage).
  • Fehlermeldung
  • Fehlercode: Wenn ein Objekt einen Fehlercode enthält, wird er in dieser Eigenschaft ausgegeben.
  • Benötigte Zeit
  • Betriebssystem Zeilenendezeichen.

  Null-Property-Werte führen zu leeren Klammern, [].

  Das folgende Beispiel zeigt das Logformat:

  Timestamp [level][hostname][ProcessId][Org][Environment][APIProxy][ClientIp][ClientId][][component][customMessage][reqMethod][respStatusCode][errMessage][errCode][timeTaken]

  (137770055)

• Leistung: API-Produkte wurden nicht nach Umgebung gefiltert. Dieses Problem wurde behoben. (135038879)
• Verschiedene Integrationen von Funktionstests und Verbesserungen der Codequalität.

3.0.2

Am Mittwoch, dem 3. Juli 2019, haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

Codequalität: Der Code wurde auf Qualität geprüft und es wurden Codeänderungen vorgenommen, um die von Nutzern geforderten Qualitätsstandards zu erfüllen. Wir haben Fehler und Warnungen zur Codequalität behoben, die von JSHint stammen. Es wurden einige tatsächliche Codefehler erkannt und behoben. Alle Apigee Edge Microgateway-Module wurden diesem Prozess unterzogen. Weitere Informationen finden Sie in den Commits vom 28. Juni und 2. Juli für microgateway-config, microgateway-core, microgateway-plugins und microgateway. Alle Module mit Änderungen an der Codequalität wurden mit internen Tools getestet, die die Ausführung von Edge Microgateway für Kundenanwendungsfälle überprüfen.

3.0.1

Am Freitag, dem 21. Juni 2019, haben wir die folgenden Fehlerkorrekturen und Verbesserungen für Edge Microgateway veröffentlicht.

• 134834551 – Unterstützte Node.js-Versionen für Edge Microgateway ändern
  (Unterstützte Node.js-Versionen: 8 und 12; Versionen 7, 9 und 11 sind experimentell)
• 134751883 – Edge Microgateway stürzt beim erneuten Laden unter Last ab
• 134518428 – Der Products-Endpunkt für Edge Microgateway gibt 5XX zurück, wenn das Filtermuster falsch ist
• 135113408 – Worker sollten neu gestartet werden, wenn sie unerwartet beendet werden
• 134945852 – „tokenCacheSize“ wird im OAuth-Plug-in nicht verwendet
• 134947757 – cacheTTL im OAuth-Plug-in festlegen
• 135445171 – Berechnung der Kulanzfrist in OAuth ist nicht korrekt
• Das mit der Edge Microgateway-Installation bereitgestellte „memored“-Modul verwenden
• 135367906 – Sicherheitsprüfung

Version 2.5.x

Neue Funktionen und Verbesserungen in Version 2.5.x

(Behoben in Version 2.5.38, 06.07.2019)

Falsch formatierte JWTs können dazu führen, dass Worker abstürzen, wenn der Tokencache verwendet wird. Behoben im Modul „Edge-Microgateway-Plug-ins“. (b/134672029)

(Hinzugefügt: 2.5.37) CLI-Option edgemicro-cert -t hinzufügen.

Mit der Option edgemicro cert -t können Sie ein OAuth-Token angeben, um Management APIs zu authentifizieren. Weitere Informationen finden Sie unter Zertifikate verwalten.

(Hinzugefügt in Version 2.5.35) Unterstützung für das Debuggen von Edge Microgateway mit edgemicroctl hinzugefügt.

Sie können das Flag mgdebug mit edgemicroctl verwenden. Siehe auch Kubernetes-Integrationsaufgaben.

(Hinzugefügt: 2.5.35) Windows-Build für edgemicroctl aktivieren:

(Hinzugefügt am 2.5.31) Neue API „edgemicro-auth/token“

Es wurde eine neue edgemicro-auth/token-API hinzugefügt, mit der Sie den Client/das Secret als Base64-codierten Basis-Autorisierungsheader und den grant_type als Formularparameter übergeben können. Weitere Informationen finden Sie unter Inhabertokens direkt abrufen.

(Behoben 2.5.31) Private Konfiguration berücksichtigt das Token-Flag nicht

Ein Problem wurde behoben, durch das die Konfiguration von Edge Microgateway für die Verwendung eines OAuth2-Zugriffstokens in Edge for Private Cloud nicht richtig funktionierte (das Token wurde nicht berücksichtigt).

Docker: Unterstützung für die Verwendung selbst signierter Zertifikate

(Hinzugefügt am 2.5.29) Wenn Sie eine Zertifizierungsstelle (Certificate Authority, CA) verwenden, die von Node.js nicht standardmäßig als vertrauenswürdig eingestuft wird, können Sie den Parameter NODE_EXTRA_CA_CERTS verwenden, wenn Sie einen Docker-Container mit Edge Microgateway ausführen. Weitere Informationen finden Sie unter Verwenden einer Zertifizierungsstelle, die von Node.js nicht als vertrauenswürdig eingestuft wird.

Docker: Support for TLS

(Hinzugefügt am 2.5.29) Edge Microgateway, das in einem Docker-Container ausgeführt wird, unterstützt jetzt TLS für eingehende Anfragen an den Edge Microgateway-Server (Northbound-Anfragen) und für ausgehende Anfragen von Edge Microgateway an eine Zielanwendung (Southbound-Anfragen).

In den folgenden Beispielen wird detailliert erläutert, wie Sie diese TLS-Konfigurationen einrichten:

• Beispiel für die TLS-Konfiguration in Richtung Norden
• Beispiel für die Southbound-TLS-Konfiguration

In diesen Beispielen sehen Sie, wie Sie den Container-Mount-Point /opt/apigee/.edgemicro verwenden, um die Zertifikate zu laden, auf die dann in der Edge Microgateway-Konfigurationsdatei verwiesen wird.

Docker: Unterstützung für das Proxying von Anfragen

(Hinzugefügt am 2.5.27) Wenn Sie Edge Microgateway in einem Docker-Container ausführen, können Sie mit diesen Optionen das Proxyverhalten steuern, wenn das Microgateway hinter einer Firewall ausgeführt wird:

• HTTP_PROXY
• HTTPS_PROXY
• NO_PROXY

Weitere Informationen finden Sie unter Edge Micro als Docker-Container ausführen.

Docker: Aktualisierte Anleitung für das Plug-in

(Hinzugefügt am 27.05.2022) Wenn Sie Edge Microgateway in einem Docker-Container ausführen, haben Sie jetzt zwei Optionen zum Bereitstellen von Plug-ins. Eine Option, die einen Docker-Mountpunkt verwendet, ist neu. Die andere Option gab es bereits und sie ist im Grunde unverändert. Das Dockerfile wurde jedoch aktualisiert. Weitere Informationen finden Sie unter den folgenden Links:

• Option A: Das Plug-in-Verzeichnis auf einem Volume bereitstellen (Neu)
• Option B: Plug-ins in den Container einbauen (Aktualisiert)

Unterstützung neuer OAuth-Tokens für KVM-Upgrade-Befehl

(Hinzugefügt am 27.05.2024) Sie können ein OAuth-Token mit dem Befehl upgradekvm verwenden. Weitere Informationen finden Sie unter KVM aktualisieren.

APIs in Edge Analytics trennen

(Hinzugefügt am 2.5.26) Mit neuen Flags für das Analyse-Plug-in können Sie einen bestimmten API-Pfad trennen, sodass er in den Edge Analytics-Dashboards als separater Proxy angezeigt wird. Sie können beispielsweise Systemdiagnose-APIs abgrenzen, um Verwechslungen mit tatsächlichen API-Aufrufen zu vermeiden. Weitere Informationen finden Sie unter Pfade aus der Analyse ausschließen.

Lokalen Proxy konfigurieren

(Hinzugefügt am 2.5.25) Bei einem lokalen Proxy müssen Sie keinen Microgateway-fähigen Proxy in Apigee Edge manuell erstellen. Stattdessen wird der Basispfad des lokalen Proxys verwendet. Weitere Informationen finden Sie unter Lokalen Proxymodus verwenden.

Eigenständigen Modus verwenden

(Hinzugefügt am 2.5.25) Sie können Edge Microgateway vollständig ohne Abhängigkeit von Apigee Edge ausführen. In diesem Szenario, dem sogenannten Standalone-Modus, können Sie Edge Microgateway ohne Internetverbindung ausführen und testen. Weitere Informationen finden Sie unter Edge Microgateway im Standalone-Modus ausführen.

Schlüssel widerrufen

(Hinzugefügt am 2.5.2019) Ein neuer CLI-Befehl wurde hinzugefügt, mit dem die Schlüssel- und Secret-Anmeldedaten für eine Edge Microgateway-Konfiguration widerrufen werden.

edgemicro revokekeys -o [organization] -e [environment] -u [username] -k [key] -s [secret]

Docker-Unterstützung

(Hinzugefügt am 2.5.19) Sie können die aktuelle Version von Edge Microgateway jetzt als Docker-Image herunterladen:

docker pull gcr.io/apigee-microgateway/edgemicro:latest

Kubernetes-Unterstützung

(Hinzugefügt am 2.5.2019) Sie können Edge Microgateway als Dienst oder als Sidecar-Gateway vor Diensten bereitstellen, die in einem Kubernetes-Cluster bereitgestellt werden. Weitere Informationen finden Sie unter Edge Microgateway in Kubernetes einbinden.

Unterstützung der TCP-Option „nodelay“

(Hinzugefügt in Version 2.5.16) Der Edge Micro-Konfiguration wurde die neue Konfigurationseinstellung nodelay hinzugefügt.

Standardmäßig verwenden TCP-Verbindungen den Nagle-Algorithmus, um Daten zu puffern, bevor sie gesendet werden. Wenn Sie nodelay auf true festlegen, wird dieses Verhalten deaktiviert. Daten werden sofort gesendet, wenn socket.write() aufgerufen wird. Weitere Informationen finden Sie auch in der Node.js-Dokumentation.

So aktivieren Sie nodelay: Bearbeiten Sie die Edge Micro-Konfigurationsdatei so:

edgemicro:
  nodelay: true
  port: 8000
  max_connections: 1000
  config_change_poll_interval: 600
  logging:
    level: error
    dir: /var/tmp
    stats_log_interval: 60
    rotate_interval: 24

Neue Befehlszeilenoptionen für die kontinuierliche Überwachung

(Hinzugefügt am 2.5.12) Dem edgemicro forever-Befehl wurden neue Parameter hinzugefügt. Mit diesen Parametern können Sie den Speicherort der Datei forever.json angeben und den Hintergrundprozess „Forever“ starten oder beenden. Siehe auch Dauerhaftes Monitoring

Beispiele:

So starten Sie Forever:

edgemicro forever -f ~/mydir/forever.json -a start

So beenden Sie Forever:

edgemicro forever -a stop

JWT-Schlüsselrotation

Es wurde eine neue Funktion hinzugefügt, mit der Sie die öffentlichen/privaten Schlüsselpaare rotieren können, die zum Generieren der JWT-Tokens verwendet werden, die für die OAuth-Sicherheit in Edge Microgateway verwendet werden. Weitere Informationen finden Sie unter JWT-Schlüssel rotieren.

Heruntergeladene API-Proxys filtern

Standardmäßig lädt Edge Microgateway alle Proxys in Ihrer Edge-Organisation herunter, die mit dem Namenspräfix „edgemicro_“ beginnen. Sie können diese Standardeinstellung ändern, um Proxys herunterzuladen, deren Namen einem Muster entsprechen. Weitere Informationen finden Sie unter Heruntergeladene Proxys filtern.

Produkte ohne API-Proxys angeben

In Apigee Edge können Sie ein API-Produkt erstellen, das keine API-Proxys enthält. Mit dieser Produktkonfiguration kann ein API-Schlüssel, der mit diesem Produkt verknüpft ist, für jeden in Ihrer Organisation bereitgestellten Proxy verwendet werden. Ab Version 2.5.4 unterstützt Edge Microgateway diese Produktkonfiguration.

Unterstützung für das Monitoring auf unbestimmte Zeit

Edge Microgateway hat eine forever.json-Datei, die Sie konfigurieren können, um festzulegen, wie oft und in welchen Intervallen Edge Microgateway neu gestartet werden soll. Diese Datei konfiguriert einen Dienst namens „forever-monitor“, der Forever programmatisch verwaltet. Weitere Informationen finden Sie unter Dauerhaftes Monitoring.

Zentrale Verwaltung der Edge Micro-Konfigurationsdatei

Wenn Sie mehrere Edge Microgateway-Instanzen ausführen, möchten Sie ihre Konfigurationen möglicherweise an einem zentralen Ort verwalten. Dazu geben Sie einen HTTP-Endpunkt an, von dem Edge Micro die Konfigurationsdatei herunterladen kann. Weitere Informationen finden Sie unter Konfigurationsdatei-Endpoint angeben.

Unterstützung für die CLI-Option „forever“

(Hinzugefügt in Version 2.5.8) Verwenden Sie den Befehl edgemicro forever [package.json], um den Speicherort der Datei forever.json anzugeben. Vor der Hinzufügung dieses Befehls musste sich die Konfigurationsdatei im Edge Microgateway-Stammverzeichnis befinden.

Beispiel:

edgemicro forever ~/mydir/forever.json

Option „configUrl“ für den Befehl „reload“ hinzugefügt

(Hinzugefügt in Version 2.5.8) Sie können jetzt die Option --configUrl oder -u mit dem Befehl edgemicro reload verwenden.

Kulanzzeitraum für Zeitabweichungen bei JWTs

(Hinzugefügt in Version 2.5.7) Das Attribut gracePeriod in der OAuth-Konfiguration kann Fehler verhindern, die durch geringfügige Abweichungen zwischen Ihrer Systemuhr und den im JWT-Autorisierungstoken angegebenen Zeiten „Not Before“ (nbf) oder „Issued At“ (iat) verursacht werden. Legen Sie für dieses Attribut die Anzahl der Sekunden fest, die für solche Abweichungen zulässig sind. Weitere Informationen finden Sie unter OAuth-Attribute.

(Hinzugefügt in Version 2.5.7) Das Attribut gracePeriod in der OAuth-Konfiguration kann Fehler verhindern, die durch geringfügige Abweichungen zwischen Ihrer Systemuhr und den im JWT-Autorisierungstoken angegebenen Zeiten „Not Before“ (nbf) oder „Issued At“ (iat) verursacht werden. Legen Sie für dieses Attribut die Anzahl der Sekunden fest, die für solche Abweichungen zulässig sind. Weitere Informationen finden Sie unter OAuth-Attribute.

Behobene Fehler in Version 2.5.x

• (Problem 236) Tippfehler beim Leeren des Cache korrigiert.
• (Problem 234) Neuladen stürzt für Edge Microgateway 2.5.35 ab.
• (Problem 135) Fehler „Ungültiger Verweis auf virtuellen Host ‚secure‘“ bei Verwendung der Option -v. Mit dieser Korrektur wird der edgemicro-auth-Proxy vor der Bereitstellung so geändert, dass die virtuellen Hosts genau mit den Angaben im Flag „-v“ übereinstimmen. Außerdem können Sie eine beliebige Anzahl von VirtualHosts mit beliebigen Namen angeben (nicht mehr auf „default“ und „secure“ beschränkt).
• (Problem 141) Der Befehl edgemicro reload unterstützt die Konfigurationsdateioption -c nicht. Dieses Problem wurde behoben.
• (Problem 142) Edge Microgateway meldet bei der Installation veraltete Kryptografie. Dieses Problem wurde behoben.
• (Problem 145) Kontingent funktioniert nicht mit Edge Microgateway. Dieses Problem wurde behoben.
• (Apigee Community-Problem: https://community.apigee.com/questions/33149/emg-jwt-token-validated-against-both-api-proxies-a.html#answer-33336) JWT-Token wird sowohl für API-Proxys als auch für den Ressourcen-URI in OAUTH validiert. Dieses Problem wurde behoben.
• (Apigee-Community-Problem: https://community.apigee.com/questions/47846/microgateway-not-working-with-oauth.html) Microgateway funktioniert nicht mit OAuth. Dieses Problem wurde behoben.
• pidPath unter Windows korrigieren.
• (Problem 157) Das Problem, das die folgende Fehlermeldung verursacht hat, wurde behoben: ReferenceError: deployProxyWithPassword ist nicht definiert.
• (Problem 169) Node.js-Abhängigkeiten aktualisieren (npm audit)
• Der edgemicro-auth-Proxy verwendet jetzt die Edge-JWT-Richtlinien. Der Proxy ist nicht mehr auf Node.js angewiesen, um JWT-Unterstützung zu bieten.

Version 2.4.x

Neue Funktionen und Verbesserungen in Version 2.4.x

1. Benutzerdefinierten Alias für den edgemicro-auth-Proxy festlegen (PR 116)

Sie können den Standard-Basispfad für den edgemicro-auth-Proxy ändern. Der Basispfad ist standardmäßig /edgemicro-auth. Verwenden Sie zum Ändern des Werts das Flag -x für den Befehl edgemicro configure.

Beispiel:

edgemicro configure -x /mypath …

2. Unterstützung von Platzhaltern für Basispfade (PR 77)

Sie können im Basispfad eines edgemicro_*-Proxys einen oder mehrere *-Platzhalter verwenden. Mit dem Basispfad /team/*/members können Clients beispielsweise https://[host]/team/blue/members und https://[host]/team/green/members aufrufen, ohne dass Sie neue API-Proxys zur Unterstützung neuer Teams erstellen müssen. Beachten Sie, dass /**/ nicht unterstützt wird.

3. Benutzerdefinierter Konfigurationspfad, der der CLI für die Private Cloud-Konfiguration hinzugefügt wurde (PR 99)

Die Microgateway-Konfigurationsdatei befindet sich standardmäßig in ./config/config.yaml. Bei den Befehlen „init“, „configure“ und „start“ können Sie jetzt einen benutzerdefinierten Konfigurationspfad in der Befehlszeile mit den Flags -c oder --configDir angeben. Ein Problem wurde behoben, bei dem ein benutzerdefiniertes Konfigurationsverzeichnis für Private Cloud-Installationen nicht erkannt wurde.

Beispiel:

edgemicro start -o docs -e test -k abc123 -s xyz456 -c /home/microgateway/config

4. *_PROXY-Variablen berücksichtigen (PR 61)

Wenn Edge Microgateway hinter einer Firewall installiert ist und nicht mit Apigee Edge in der öffentlichen Cloud kommunizieren kann, haben Sie zwei Möglichkeiten:

Option 1:

Die erste Option besteht darin, die Option „edgemicro: proxy_tunnel“ in der Microgateway-Konfigurationsdatei auf „true“ zu setzen:

edge_config:
   proxy: http://10.224.16.85:3128
   proxy_tunnel: true

Wenn proxy_tunnel auf true gesetzt ist, verwendet Edge Microgateway die HTTP-CONNECT-Methode, um HTTP-Anfragen über eine einzelne TCP-Verbindung zu tunneln. Dasselbe gilt, wenn die Umgebungsvariablen zum Konfigurieren des Proxys TLS-fähig sind.

Option 2:

Die zweite Möglichkeit besteht darin, einen Proxy anzugeben und proxy_tunnel in der Microgateway-Konfigurationsdatei auf false zu setzen. Beispiel:

edge_config:
   proxy: http://10.224.16.85:3128
   proxy_tunnel: false

In diesem Fall können Sie die folgenden Variablen festlegen, um die Hosts für jeden HTTP-Proxy zu steuern, den Sie verwenden möchten, oder um anzugeben, welche Hosts keine Edge Microgateway-Proxys verarbeiten sollen: HTTP_PROXY, HTTPS_PROXY und NO_PROXY. Sie können NO_PROXY als durch Kommas getrennte Liste von Domains festlegen, für die Edge Microgateway keinen Proxy verwenden soll. Beispiel:

export HTTP_PROXY='http://localhost:3786'
export HTTPS_PROXY='https://localhost:3786'

Weitere Informationen zu diesen Variablen finden Sie hier:

https://www.npmjs.com/package/request#controlling-proxy-behaviour-using-environment-variables

5. Benutzerdefiniertes Zeitlimit für Zielanfragen festlegen (PR 57)

Mit dieser Konfiguration können Sie ein benutzerdefiniertes Zeitlimit für Zielanfragen festlegen:

edgemicro:
    request_timeout: 10

Das Zeitlimit wird in Sekunden festgelegt. Wenn ein Zeitlimit auftritt, antwortet Edge Microgateway mit dem Statuscode 504.

6. Benutzerdefinierte HTTP-Statusmeldungen in der Zielantwort berücksichtigen (PR 53)

Edge Microgateway berücksichtigt benutzerdefinierte HTTP-Statusmeldungen, die in der Zielantwort festgelegt sind. In früheren Releases wurden Statusmeldungen, die vom Ziel gesendet wurden, mit Node.js-Standardwerten überschrieben.

7. Mit dem X-Forwarded-For-Header kann die client_ip für Analytics festgelegt werden.

Falls vorhanden, wird mit dem X-Forwarded-For-Header die Variable client_ip festgelegt, die in Edge Analytics gemeldet wird. Mit dieser Funktion können Sie die IP-Adresse des Clients ermitteln, der eine Anfrage an Edge Microgateway gesendet hat.

8. Änderungen am OAuth-Plug-in

Das OAuth-Plug-in unterstützt die Überprüfung von API-Schlüsseln und OAuth-Zugriffstokens. Vor dieser Änderung akzeptierte das Plug-in beide Sicherheitsformen. Mit dieser Änderung können Sie nur eines dieser Sicherheitsmodelle zulassen und gleichzeitig die Abwärtskompatibilität beibehalten.

Das OAuth-Plug-in fügt zwei neue Flags hinzu:

• allowOAuthOnly: Wenn auf true gesetzt, muss jede API einen Autorisierungs-Header mit einem Bearer-Zugriffstoken enthalten.

• allowAPIKeyOnly: Wenn auf true gesetzt, muss jede API einen x-api-key-Header (oder einen benutzerdefinierten Speicherort) mit einem API-Schlüssel enthalten.

Sie legen diese Flags in der Edge Microgateway-Konfigurationsdatei so fest:

oauth:
    allowNoAuthorization: false
    allowInvalidAuthorization: false
    keep-authorization-header: false
    allowOAuthOnly: false
    allowAPIKeyOnly: false

9. Der edgemicro-auth-Proxy wurde verbessert (PR 40).

Der edgemicro-auth-Proxy wurde verbessert. Vor diesen Änderungen wurden die Schlüssel im Edge Secure Store, einem verschlüsselten Tresor, gespeichert. Der Proxy speichert jetzt Schlüssel in der verschlüsselten Schlüssel/Wert-Zuordnung (KVM) von Edge.

10. Standard-Ziel-URL in einem Plugin neu schreiben (PR 74)

Sie können auch den Port des Zielendpunkts überschreiben und zwischen HTTP und HTTPS wählen. Ändern Sie diese Variablen in Ihrem Plug-in-Code: req.targetPort und req.targetSecure. Wenn Sie HTTPS auswählen möchten, legen Sie req.targetSecure auf true fest. Für HTTP legen Sie es auf false fest. Wenn Sie „req.targetSecure“ auf „true“ setzen, finden Sie in diesem Diskussionsforum weitere Informationen.

11. Erste Unterstützung für die OAuth-Token-Authentifizierung (PR 125)

Sie können Edge Microgateway so konfigurieren, dass anstelle von Nutzername/Passwort ein OAuth-Token für die Authentifizierung verwendet wird. Wenn Sie ein OAuth-Token verwenden möchten, verwenden Sie den folgenden Parameter für den Befehl edgemicro configure:

-t, --token <token>

Beispiel:

edgemicro configure -o docs -e test -t <your token>

Behobene Fehler in Version 2.4.3

• Ein Problem wurde behoben, bei dem eine kostenpflichtige Organisation erforderlich war, um den edgemicro-auth-Proxy ordnungsgemäß auszuführen. Jetzt können Sie Edge Microgateway auch mit Testorganisationen verwenden. (PR 5)
• Ein Problem wurde behoben, bei dem die Verarbeitung von Daten im Stream noch nicht abgeschlossen war, die End-Handler aber trotzdem ausgeführt wurden. Daher wurde eine Teilantwort gesendet. (PR 71)
• Ein Problem wurde behoben, bei dem ein benutzerdefiniertes Konfigurationsverzeichnis für Private Cloud-Installationen nicht erkannt wurde. (PR 110)
• Ein Problem mit der bidirektionalen SSL zwischen dem Client und Edge Microgateway wurde behoben. (PR 70)
• Ein Problem wurde behoben, bei dem ein nachgestellter Schrägstrich im Proxy-Basispfad erforderlich war, damit die API-Schlüsselüberprüfung ordnungsgemäß funktioniert. Ein nachgestellter Schrägstrich am Ende des Basispfads ist nicht mehr erforderlich. (PR 48)

Version 2.3.5

Neue Funktionen und Verbesserungen in Version 2.3.5

Proxy-Filterung

Sie können filtern, welche Microgateway-kompatiblen Proxys von einer Edge Microgateway-Instanz verarbeitet werden. Beim Start von Edge Microgateway werden alle Microgateway-kompatiblen Proxys in der zugehörigen Organisation heruntergeladen. Verwenden Sie die folgende Konfiguration, um einzuschränken, welche Proxys vom Microgateway verarbeitet werden. Diese Konfiguration beschränkt die Proxys, die das Microgateway verarbeitet, auf drei: edgemicro_proxy-1, edgemicro_proxy-2 und edgemicro_proxy-3:

proxies:
  - edgemicro_proxy-1
  - edgemicro_proxy-2
  - edgemicro_proxy-3

Analytics-Datenmaskierung

Mit einer neuen Konfiguration können Sie verhindern, dass Informationen zum Anfragepfad in Edge-Analysen angezeigt werden. Fügen Sie der Microgateway-Konfiguration Folgendes hinzu, um den Anfrage-URI und/oder den Anfragepfad zu maskieren. Der URI besteht aus dem Hostnamen und den Pfadteilen der Anfrage.

analytics:
  mask_request_uri: 'string_to_mask'
  mask_request_path: 'string_to_mask'

Version 2.3.3

Neue Funktionen und Verbesserungen in Version 2.3.3

Im Folgenden sind die neuen Funktionen und Verbesserungen in diesem Release aufgeführt.

Automatische Abfrage von Änderungen deaktivieren

Sie können das automatische Abrufen von Änderungen deaktivieren, indem Sie dieses Attribut in der Microgateway-Konfiguration festlegen:

disabled_config_poll_interval: true

Standardmäßig werden bei der regelmäßigen Abfrage alle Änderungen, die in Edge vorgenommen wurden (Änderungen an Produkten, Microgateway-kompatiblen Proxys usw.), sowie Änderungen an der lokalen Konfigurationsdatei erfasst. Das Standard-Polling-Intervall beträgt 600 Sekunden (5 Minuten).

Ziel-URLs in Plugins umschreiben

Sie können die Standardziel-URL in einem Plug-in dynamisch überschreiben, indem Sie die folgenden Variablen in Ihrem Plug-in-Code ändern: req.targetHostname und req.targetPath.

Neue Signatur der Plug-in-Funktion

Es wurde eine neue Plugin-Funktionssignatur hinzugefügt, die die Zielantwort als Argument bereitstellt. Dadurch können Plugins leichter auf die Zielantwort zugreifen.

function(sourceRequest, sourceResponse, targetResponse, data, cb)

Vereinfachte Standardausgabe für die Protokollierung

Standardmäßig wird das JSON heruntergeladener Proxys, Produkte und JWTs jetzt vom Logging-Dienst ausgelassen. Sie können die Standardeinstellung ändern, sodass diese Objekte ausgegeben werden, indem Sie DEBUG=* festlegen, wenn Sie Edge Microgateway starten. Beispiel:

DEBUG=* edgemicro start -o docs -e test -k abc123 -s xyz456

Benutzerdefinierter Konfigurationspfad zur Befehlszeile hinzugefügt

Standardmäßig befindet sich die Microgateway-Konfigurationsdatei unter ./config/config.yaml. Bei den Befehlen „init“, „configure“ und „start“ können Sie jetzt einen benutzerdefinierten Konfigurationspfad in der Befehlszeile angeben. Beispiel:

edgemicro start -o docs -e test -k abc123 -s xyz456 -c /home/microgateway/config

Behobene Fehler in Version 2.3.3

• Ein Speicherleck wurde behoben, das bei großen Anfragen/Antworten auftrat.
• Die Reihenfolge der Plug‑in-Ausführung wurde korrigiert. Sie verhält sich jetzt so, wie in der Dokumentation beschrieben.
• Das Plugin „accumulate-request“ bleibt bei GET-Anfragen nicht mehr hängen.
• Ein Problem im Plugin „accumulate-response“ wurde behoben, bei dem das Fehlen eines Antworttexts Fehler verursacht hat.

Version 2.3.1

Installationshinweis

In einigen früheren Versionen von Edge Microgateway konnten Sie die Software installieren, indem Sie eine ZIP-Datei heruntergeladen haben. Diese ZIP-Dateien werden nicht mehr unterstützt. Für die Installation von Edge Microgateway müssen Sie Folgendes verwenden:

npm install -g edgemicro

Weitere Informationen finden Sie im Installationsartikel.

Neue Funktionen und Verbesserungen in Version 2.3.1

Im Folgenden sind die neuen Funktionen und Verbesserungen in diesem Release aufgeführt.

Filterproxys

Mit einer neuen Konfiguration können Sie filtern, welche Proxys beim Start von Edge Microgateway geladen werden. Bisher wurden vom Microgateway alle Microgateway-kompatiblen Proxys (Proxys mit dem Namen „edgemicro_*“) geladen, die aus der Edge-Organisation/-Umgebung abgerufen wurden, die Sie im Befehl „edgemicro configure“ angegeben haben. Mit dieser neuen Funktion können Sie die Liste der Proxys filtern, sodass Edge Microgateway nur die von Ihnen angegebenen Proxys lädt. Fügen Sie der Microgateway-Konfigurationsdatei einfach das Proxies-Element hinzu:

edge micro:
proxies:
    - edgemicro_[name]
    - edgemicro_[name]
    ...

Angenommen, Sie haben 50 edgemicro_*-Proxys in Ihrer Edge-Organisation/Umgebung, darunter die Proxys edgemicro_foo und edgemicro_bar. Sie können das Microgateway so konfigurieren, dass nur diese beiden Proxys verwendet werden:

edge micro:
proxies:
    - edgemicro_foo
    - edgemicro_bar

Beim Start kann das Microgateway nur die angegebenen Proxys aufrufen. Alle Versuche, andere Microgateway-kompatible Proxys aufzurufen, die aus der Edge-Organisation/-Umgebung heruntergeladen wurden, führen zu einem Fehler.

Zielanfrageheader in Plugins festlegen

Es gibt zwei grundlegende Muster, die Sie berücksichtigen müssen, wenn Sie Zielanfrage-Headern hinzufügen oder sie ändern möchten: eines, bei dem die eingehende Anfrage Daten enthält (wie bei einer POST-Anfrage), und eines, bei dem dies nicht der Fall ist (wie bei einer einfachen GET-Anfrage).

Angenommen, die eingehende Anfrage enthält Daten und Sie möchten Anfrageheader für die Zielanfrage festlegen. In früheren Versionen von Edge Microgateway war es in diesem Fall nicht möglich, Zielheader zuverlässig festzulegen.

Der Schlüssel zu diesem Muster besteht darin, zuerst alle eingehenden Daten vom Client zu erfassen. Verwenden Sie dann in der Funktion onend_request() die neue Funktion request.setOverrideHeader(name, value), um die Header anzupassen.

Hier ist ein Beispiel für einen Plug-in-Code, der zeigt, wie das geht. Die in onend_request festgelegten Header werden an das Ziel gesendet:

module.exports.init = function(config, logger, stats) {


  function accumulate(req, data) {
    if (!req._chunks) req._chunks = [];
    req._chunks.push(data);
  }

  return {

    ondata_request: function(req, res, data, next) {
      if (data && data.length > 0) accumulate(req, data);
      next(null, null);
    },

    onend_request: function(req, res, data, next) {
      if (data && data.length > 0) accumulate(req, data);
      var content = Buffer.concat(req._chunks);
      delete req._chunks;
      req.setOverrideHeader('foo', 'bar');
      req.setOverrideHeader('content-length', content.length);
      next(null, content);
    },


    onerror_request: function(req, res, data, next) {
      next(null, null);
    }

  };

}

Wenn die Anfrage keine Daten enthält, können Sie Zielheader im onrequest()-Handler festlegen. Dieses Muster ist nicht neu. Es wurde bereits dokumentiert und in den Beispiel-Plug-ins verwendet, die mit Edge Microgateway bereitgestellt werden.

onrequest: function(req, res, next) {
      debug('plugin onrequest');
      req.headers['x-foo-request-id'] = "bar";
      req.headers['x-foo-request-start'] = Date.now();
      next();
    }

Funktion zum Aktualisieren ohne Ausfallzeiten

Nachdem Sie eine Konfigurationsänderung an Edge Microgateway vorgenommen haben, können Sie die Konfiguration laden, ohne dass Nachrichten verloren gehen. Durch diese Änderung wird Edge Microgateway immer im Clustermodus gestartet und die Option --cluster wurde aus dem Befehl edgemicro start entfernt.

Außerdem wurden drei neue Befehlszeilenbefehle hinzugefügt. Sie müssen diese Befehle im selben Verzeichnis ausführen, in dem der Befehl „edgemicro start“ ausgeführt wurde:

• edgemicro status – Prüft, ob Edge Microgateway ausgeführt wird.
• edgemicro stop: Stoppt den Edge Microgateway-Cluster.
• edgemicro reload – Lädt die Edge Microgateway-Konfiguration ohne Ausfallzeit neu.

Automatisches Neuladen der Konfiguration ohne Ausfallzeit

Edge Microgateway lädt regelmäßig eine neue Konfiguration und führt einen Reload aus, wenn sich etwas geändert hat. Beim Polling werden alle Änderungen erfasst, die in Edge vorgenommen wurden (Änderungen an Produkten, Microgateway-kompatiblen Proxys usw.), sowie Änderungen an der lokalen Konfigurationsdatei. Das Standard-Polling-Intervall beträgt 600 Sekunden (5 Minuten). Sie können die Standardeinstellung in der Microgateway-Konfigurationsdatei so ändern:

edgemicro:
    config_change_poll_interval: [seconds]

Versionsinformationen zur CLI hinzugefügt

Der Befehlszeile wurde das Flag --version hinzugefügt. So rufen Sie die aktuelle Version von Edge Microgateway ab:

edgemicro --version

Neue SSL-Optionen für Edge Microgateway-Server

Edge Microgateway unterstützt jetzt zusätzlich zu key und cert die folgenden Server-SSL-Optionen:

Log-Dateien an stdout senden

Mit einer neuen Konfigurationseinstellung können Sie Logdaten an die Standardausgabe senden:

edgemicro:
  logging:
    to_console: true  

Weitere Informationen finden Sie unter Logdateien verwalten.

Version 2.1.2

Im Folgenden sind die neuen Funktionen und Verbesserungen in diesem Release aufgeführt.

Benutzerdefinierten API-Endpunkt für die Konfiguration zulassen

Es gibt neue konfigurierbare Endpunkte für den Autorisierungsproxy, die die Verwendung eines benutzerdefinierten Autorisierungsdienstes unterstützen. Folgende Endpunkte sind verfügbar:

• edgeconfig:verify_api_key_url
• edgeconfig:products

Weitere Informationen finden Sie unter Benutzerdefinierten Authentifizierungsdienst verwenden.

Version 2.1.1

Im Folgenden sind die neuen Funktionen und Verbesserungen in diesem Release aufgeführt.

Plattformübergreifende Bereitstellung des Authentifizierungsproxys

Es wurde eine Verbesserung vorgenommen, sodass der Befehl zum Bereitstellen des Edge Microgateway-Autorisierungsproxys in Edge auf Windows-Systemen kompatibel ist.

Version 2.1.0

Neue Funktionen und Verbesserungen in Version 21.0

Im Folgenden sind die neuen Funktionen und Verbesserungen aufgeführt:

SSL/TLS-Clientoptionen angeben

Sie können Clientoptionen für SSL/TLS-Verbindungen zu Zielen mit einer neuen Reihe von Konfigurationsoptionen angeben. Weitere Informationen finden Sie unter Client-SSL/TLS-Optionen verwenden.

Version 2.0.11

Installationshinweis v2.0.11

In einigen früheren Versionen von Edge Microgateway konnten Sie die Software installieren, indem Sie eine ZIP-Datei heruntergeladen haben. Diese ZIP-Dateien werden nicht mehr unterstützt. Für die Installation von Edge Microgateway müssen Sie Folgendes verwenden:

npm install -g edgemicro

Weitere Informationen finden Sie im Installationsartikel.

Neue Funktionen und Verbesserungen – Version 2.0.11

Im Folgenden sind die neuen Funktionen und Verbesserungen aufgeführt:

Port beim Start angeben

Mit dem Startbefehl können Sie eine Portnummer angeben, um den in der Konfigurationsdatei angegebenen Port zu überschreiben. Sie können auch eine Portnummer mit der Umgebungsvariable PORT angeben. Weitere Informationen finden Sie unter Startbefehl.

Optional: Auth-Header beibehalten

Mit der neuen Konfigurationseinstellung keepAuthHeader können Sie den Autorisierungsheader beibehalten, der in der Anfrage gesendet wird. Wenn auf „true“ gesetzt, wird der Auth-Header an das Ziel weitergeleitet. Weitere Informationen finden Sie unter OAuth-Attribute.

Benutzerdefinierten Autorisierungsdienst verwenden

Wenn Sie einen eigenen benutzerdefinierten Dienst für die Authentifizierung verwenden möchten, ändern Sie den Wert authUri in der Edge Microgateway-Konfigurationsdatei, sodass er auf Ihren Dienst verweist. Weitere Informationen finden Sie unter Benutzerdefinierten Authentifizierungsdienst verwenden.

Version 2.0.4

Edge Microgateway v.2.0.4 wurde am 25. Mai 2016 veröffentlicht.

Neue Funktionen und Verbesserungen in Version 2.0.4

Im Folgenden sind die neuen Funktionen und Verbesserungen in diesem Release aufgeführt.

Unterstützung von Ressourcenpfaden in Produkten

Edge Microgateway unterstützt jetzt Ressourcenpfade in Produkten. Mit Ressourcenpfaden können Sie den Zugriff auf APIs basierend auf dem Proxy-Pfadsuffix einschränken. Weitere Informationen zum Erstellen von Produkten und Konfigurieren von Ressourcenpfaden finden Sie unter API-Produkte erstellen.

Unterstützung für die globale Installation von npm

Sie können Edge Microgateway jetzt mit der npm-Option „-g“ (global) installieren. Weitere Informationen zu dieser Option finden Sie in der npm-Dokumentation.

Version 2.0.0

Edge Microgateway v2.0.0 wurde am 18. April 2016 veröffentlicht.

Neue Funktionen und Verbesserungen in Version 2.0.0

Im Folgenden sind die neuen Funktionen und Verbesserungen in diesem Release aufgeführt.

Einzelner Prozessserver

Edge Microgateway ist jetzt ein Server mit einem einzelnen Prozess. Es wird kein Zwei-Prozess-Modell mehr verwendet, bei dem ein Prozess (früher als „Agent“ bezeichnet) Edge Microgateway, den zweiten Prozess, startet. Die neue Architektur erleichtert die Automatisierung und Containerisierung.

Konfigurationsdateien mit Namespaces

Konfigurationsdateien werden jetzt mit Organisation und Umgebung versehen, sodass mehrere Microgateway-Instanzen auf demselben Host ausgeführt werden können. Die Konfigurationsdateien finden Sie unter „~/.edgemicro“, nachdem Sie den Edge Microgateway-Konfigurationsbefehl ausgeführt haben.

Neue Umgebungsvariablen

Es gibt jetzt vier Umgebungsvariablen: EDGEMICRO_ORG, EDGEMICRO_ENV, EDGEMICRO_KEY und EDGEMICRO_SECRET. Wenn Sie diese Variablen in Ihrem System festlegen, müssen Sie ihre Werte nicht angeben, wenn Sie die Befehlszeilenschnittstelle (Command-Line Interface, CLI) zum Konfigurieren und Starten von Edge Microgateway verwenden.

Konfiguration im Cache

Edge Microgateway verwendet eine Konfigurationsdatei im Cache, wenn es ohne Verbindung zu Apigee Edge neu gestartet wird .

Clustermodus

Es gibt jetzt Optionen zum Starten von Edge Microgateway im Clustermodus. Im Clustermodus können Sie die Vorteile von Mehrkernsystemen nutzen. Das Microgateway verwendet für diese Funktion das Node.js-Clustermodul. Weitere Informationen finden Sie in der Node.js-Dokumentation.

Behobene Fehler in Version 2.0.0

Der Lebenszyklus von Plugin-Ereignissen verarbeitet jetzt asynchronen Code, der Code mit einem neuen Callback enthält, ordnungsgemäß.

Version 1.1.2

Edge Microgateway v. 1.1.2 wurde am 14. März 2016 veröffentlicht.

Neue Funktionen und Verbesserungen – Version 1.1.2

Im Folgenden sind die neuen Funktionen und Verbesserungen in diesem Release aufgeführt.

Leistungssteigerung

Edge Microgateway verwendet jetzt den Node.js-HTTP-Agenten ordnungsgemäß für ein besseres Verbindungspooling. Diese Verbesserung führt zu einer höheren Leistung und Stabilität bei hoher Last.

Unterstützung für Remotedebugger

Sie können Edge Microgateway so konfigurieren, dass es mit einem Remote-Debugger wie node-inspector ausgeführt wird.

Neuer Speicherort der Konfigurationsdatei

Wenn Sie Edge Microgateway konfigurieren, wird die Datei agent/config/default.yaml jetzt in ~./edgemicro/config.yaml kopiert.

Rotation von Protokolldateien

Mit einem neuen Konfigurationsattribut können Sie ein Rotationsintervall für Edge Microgateway-Logs angeben.

Behobene Fehler v1.1.2

Die folgenden Fehler wurden in Version 1.1.2 behoben.