Informacje o wersji Edge Microgateway

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. info

Wersja 3.3.x

Poprawki błędów i ulepszenia w wersji 3.3.x

3.3.11

19 sierpnia 2026 r. – aktualizacja obrazu kontenera Dockera (tag: 3.3.11-sec.1)

19 sierpnia 2026 r. zespół Apigee wprowadził w Edge Microgateway te poprawki i ulepszenia:

Aktualizacje kontenera:

Problemy z bezpieczeństwem rozwiązane w aktualizacji kontenera Dockera

• GHSA-5p4m-2wfm-xmqj
• CVE-2026-13595
• CVE-2026-27456
• CVE-2026-12590
• CVE-2026-53614
• CVE-2026-53612
• CVE-2025-14104
• CVE-2026-53615
• CVE-2026-53613
• CVE-2026-34743

1 lipca 2026 r. – pierwsza wersja

1 lipca 2026 r.zespół Apigee wprowadził w Edge Microgateway 3.3.11 te poprawki:

Wersje komponentów

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.3.11. Pamiętaj, że ponieważ każdy komponent jest osobnym projektem, numery wersji mogą nie odpowiadać numerowi wersji głównego produktu:

Rozwiązane problemy z bezpieczeństwem

• CVE-2026-7383
• CVE-2026-9076
• CVE-2026-34180
• CVE-2026-34181
• CVE-2026-34182
• CVE-2026-34183
• CVE-2026-42764
• CVE-2026-42766
• CVE-2026-42767
• CVE-2026-42769
• CVE-2026-45445
• CVE-2026-45446
• CVE-2026-45447
• CVE-2026-53550

3.3.10

27 maja 2026 r. zespół Apigee wprowadził w Edge Microgateway te poprawki:

Wersje komponentów

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.3.10. Pamiętaj, że ponieważ każdy komponent jest osobnym projektem, numery wersji mogą nie odpowiadać wersji głównego produktu:

Rozwiązane problemy z bezpieczeństwem

• CVE-2026-41907
• CVE-2026-4800
• CVE-2026-2950
• CVE-2026-42338

3.3.9

1 kwietnia 2026 roku zespół Apigee wprowadził w Edge Microgateway te poprawki i ulepszenia:

Poprawki błędów i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.3.9. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą nie odpowiadać wersji głównego produktu:

Rozwiązane problemy z bezpieczeństwem

• CVE-2025-13465
• CVE-2026-24842
• CVE-2026-26996
• CVE-2026-2391
• CVE-2026-27904
• CVE-2026-27601
• CVE-2026-27903
• CVE-2026-26960
• CVE-2024-22365
• CVE-2026-24001
• CVE-2025-15284
• CVE-2025-64756
• CVE-2026-31802
• CVE-2026-29786
• CVE-2026-25547

3.3.8

16 grudnia 2025 r. zespół Apigee wprowadził w Edge Microgateway te poprawki i ulepszenia:

Poprawki błędów i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.3.8. Pamiętaj, że ponieważ każdy komponent jest osobnym projektem, numery wersji mogą nie odpowiadać wersji głównego produktu:

Rozwiązane problemy z bezpieczeństwem

• CVE-2025-59343
• CVE-2025-64756

3.3.7

17 lipca 2025 r. Apigee wprowadziło w Edge Microgateway te poprawki i ulepszenia:

Poprawki błędów i ulepszenia:

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

Rozwiązane problemy z bezpieczeństwem

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

3.3.6

16 kwietnia 2025 r. w usłudze Apigee wprowadziliśmy te poprawki i ulepszenia w mikrogateway Edge:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.3.6. Pamiętaj, że ponieważ każdy komponent jest osobnym projektem, numery wersji mogą nie odpowiadać wersji głównego produktu:

Rozwiązane problemy z bezpieczeństwem

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

3.3.5

20 grudnia 2024 roku zespół Apigee wprowadził w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.3.5. Pamiętaj, że ponieważ każdy komponent jest osobnym projektem, numery wersji mogą nie odpowiadać wersji głównego produktu:

Poprawki błędów i ulepszenia:

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

Rozwiązane problemy z bezpieczeństwem

• 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

18 września 2024 r. wprowadziliśmy w usłudze Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.3.4. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą nie odpowiadać numerowi wersji głównego produktu:

Poprawki błędów i ulepszenia:

Rozwiązane problemy z bezpieczeństwem

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

3.3.3

25 kwietnia 2024 r. zespół Apigee wprowadził w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.3.3. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą się różnić od numeru wersji głównego produktu:

Poprawki błędów i ulepszenia:

Rozwiązane problemy z bezpieczeństwem

• 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

18 sierpnia 2023 r. zespół Apigee wprowadził w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.3.2. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą się różnić od numeru wersji głównego produktu:

Poprawki błędów i ulepszenia:

Rozwiązane problemy z bezpieczeństwem

Brak.

3.3.1

7 czerwca 2022 r. zespół Apigee wprowadził w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.3.1. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą się różnić od numeru wersji głównego produktu:

Poprawki błędów i ulepszenia:

Rozwiązane problemy z bezpieczeństwem

3.3.0

4 lutego 2022 r. zespół Apigee wprowadził w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.3.0. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą nie odpowiadać numerowi wersji głównego produktu:

Poprawki błędów i ulepszenia:

npm install apigeetool@0.15.1

Wersja 3.2.x

Poprawki błędów i ulepszenia w wersji 3.2.x

3.2.3

17 września 2021 r. zespół Apigee wprowadził w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.2.3. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą się różnić od numeru wersji głównego produktu:

Poprawki błędów i ulepszenia:

Rozwiązane problemy z bezpieczeństwem

3.2.2

15 lipca 2021 r. zespół Apigee wprowadził w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.2.2. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą się różnić od numeru wersji głównego produktu:

Poprawki błędów i ulepszenia:

Rozwiązane problemy z bezpieczeństwem

3.2.1

5 marca 2021 r. zespół Apigee wprowadził w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.2.1. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą się różnić od numeru wersji głównego produktu:

Poprawki błędów i ulepszenia:

edgemicro:
 enable_GET_req_body: true

3.2.0

21 stycznia 2021 r. zespół Apigee wprowadził w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.2.0. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą się różnić od numeru wersji głównego produktu:

Poprawki błędów i ulepszenia:

Wersja 3.1.x

Poprawki błędów i ulepszenia w wersji 3.1.x

3.1.8

16 listopada 2020 r. zespół Apigee wprowadził w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.1.8. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą się różnić od numeru wersji głównego produktu:

Poprawki błędów i ulepszenia:

3.1.7

24 września 2020 r. wprowadziliśmy w usłudze Apigee Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.1.7. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą się różnić od numeru wersji głównego produktu:

Poprawki błędów i ulepszenia:

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

3.1.6

20 sierpnia 2020 r. zespół Apigee wprowadził w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.1.6. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą się różnić od numeru wersji głównego produktu:

Poprawki błędów i ulepszenia:

3.1.5

26 czerwca 2020 r. zespół Apigee wprowadził w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.1.5. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą się różnić od numeru wersji głównego produktu:

Poprawki błędów i ulepszenia:

3.1.4

23 kwietnia 2020 r. zespół Apigee wprowadził w Edge Microgateway następującą poprawkę.

Poprawka błędu:

Rozwiązaliśmy problem z zależnościami w wersji 3.1.3. Wersja 3.1.3 została oznaczona jako przestarzała w repozytorium npm. W przeciwnym razie wszystkie poprawki błędów i ulepszenia opisane w informacjach o wersji 3.1.3 dotyczą tej wersji.

3.1.3

15 kwietnia 2020 r. w usłudze Apigee wprowadziliśmy te poprawki i ulepszenia w Edge Microgateway.

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.1.3. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą się różnić od numeru wersji głównego produktu:

Poprawki błędów i ulepszenia:

• 153509313 – rozwiązaliśmy problem, który powodował wycieki pamięci w module debugowania Node.js. Problem występuje w wersjach 3.1.0, 3.1.1 i 3.1.2.
• 153509313 – rozwiązaliśmy problem, który powodował, że w danych wyjściowych rejestrowania był drukowany ten sam identyfikator wiadomości dla 2 różnych transakcji.
• 151673570. Rozwiązano problem polegający na tym, że Edge Microgateway nie był aktualizowany, aby korzystać z nowych interfejsów API Apigee KVM. Edge Microgateway używa teraz nowych poleceń do dodawania i aktualizowania wartości KVM.
• 152822846 – w poprzednich wersjach Edge Microgateway został zaktualizowany, aby jego przetwarzanie mapowania ścieżki zasobu było zgodne z przetwarzaniem w Apigee Edge. W tej wersji rozwiązaliśmy problem, który powodował nieprawidłowe działanie wzorca /literal_string/*. Na przykład: /*/2/*. Zobacz też Konfigurowanie działania ścieżki zasobu „/”, „/*” i „/**”.
• 152005003 – wprowadzono zmiany, aby włączyć identyfikatory o zakresie organizacji i środowiska na potrzeby limitów.
• 152005003 – wprowadzono zmiany, aby włączyć identyfikatory zakresu organizacji i środowiska na potrzeby limitów. Kombinacja „org + env + appName + productName” jest używana jako identyfikator limitu.

3.1.2

16 marca 2020 r. zespół Apigee wprowadził w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.1.3. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą się różnić od numeru wersji głównego produktu:

Poprawki błędów i ulepszenia:

• 151285018 – wprowadzono ulepszenie funkcji, aby dodać obsługę serwera proxy HTTP w przypadku ruchu między Edge Microgateway a backendami. Rozwiązaliśmy też problemy z obsługą istniejących serwerów proxy HTTP między Edge Microgateway a Apigee Edge. Więcej informacji znajdziesz w tych artykułach:
  • Używanie serwera proxy HTTP do komunikacji z Apigee Edge
  • Używanie serwera proxy HTTP do komunikacji z miejscem docelowym
• 149101890 – kod powiadomienia w dzienniku w przypadku, gdy serwer docelowy lub moduł równoważenia obciążenia zamyka połączenie, został zmieniony z ERROR na INFO.
• 150746985 – rozwiązaliśmy problem, który powodował, że polecenie edgemicro verify nie działało prawidłowo, jeśli w pliku konfiguracyjnym występowały parametry redisBasedConfigCache: true lub quotaUri: https://%s-%s.apigee.net/edgemicro-auth.
• 151284716 – wprowadzono ulepszenie, które umożliwia szybsze zamykanie połączeń z serwerem, gdy procesy robocze są ponownie uruchamiane podczas ponownego wczytywania.
• 151588764. Zaktualizuj wersję Node.js w obrazie Dockera używanym do uruchamiania Edge Microgateway w kontenerze Dockera do wersji 12, ponieważ Node.js w wersji 8 jest wycofany.
• 151306049 – zaktualizowano dokumentację, aby uwzględnić interfejsy API zarządzania Apigee Edge, które są używane przez polecenia interfejsu Edge Microgateway CLI. Zobacz Z jakich interfejsów API do zarządzania korzysta Edge Microgateway?

3.1.1

20 lutego 2020 r. zespół Apigee wprowadził w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.1.1. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą się różnić od numeru wersji głównego produktu:

Poprawki błędów i ulepszenia:

• 146069701. Rozwiązaliśmy problem polegający na tym, że moduł microgateway-core nie uwzględniał zmiennych środowiskowych HTTP_PROXY i HTTPS_PROXY. Po wprowadzeniu tej zmiany ustawienia serwera proxy w pliku konfiguracyjnym YAML, jeśli zostały określone, są teraz ignorowane. Do określania serwera proxy używane są tylko zmienne środowiskowe.

  Jeśli chcesz określić konfigurację serwera proxy w pliku konfiguracyjnym, musisz też podać zmienną HTTP_PROXY, która zawiera ten sam adres URL serwera proxy co ten podany w pliku konfiguracyjnym. Jeśli na przykład określisz taką konfigurację:

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

  Musisz też określić tę zmienną środowiskową:

  HTTP_PROXY=http://10.128.0.20:3128

• 146320620. Dodano nowy parametr konfiguracji: edgemicro.headers_timeout. Ten atrybut ogranicza czas (w milisekundach), przez jaki parser HTTP będzie czekać na otrzymanie pełnych nagłówków HTTP. Na przykład:

  edgemicro:
  keep_alive_timeout: 6000
  headers_timeout: 12000

  Wewnętrznie parametr ustawia atrybut Node.js Server.headersTimeout w żądaniach. (Domyślnie: 5 sekund więcej niż czas ustawiony za pomocą edgemicro.keep_alive_timeout. To ustawienie domyślne zapobiega nieprawidłowemu zamykaniu połączenia przez systemy równoważenia obciążenia lub serwery proxy).

• 149278885 – dodaliśmy nową funkcję, która umożliwia ustawienie limitu czasu docelowego interfejsu API na poziomie serwera proxy interfejsu API zamiast korzystania z jednego globalnego ustawienia limitu czasu.

  Jeśli w proxy interfejsu API ustawisz właściwość TargetEndpoint io.timeout.millis, Edge Microgateway będzie mógł pobrać tę właściwość i zastosować limity czasu specyficzne dla docelowego punktu końcowego. Jeśli ten parametr nie zostanie zastosowany, Edge Microgateway użyje globalnego limitu czasu określonego za pomocą edgemicro.request_timeout.

3.1.0

21 stycznia 2020 r. wprowadziliśmy w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.1.0. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą się różnić od numeru wersji głównego produktu:

Poprawki błędów i ulepszenia:

• 144187500. Gdy zostanie wywołana flaga quotas.failOpen, zostanie zarejestrowane nowe zdarzenie na poziomie OSTRZEŻENIE. Ten sygnał jest aktywowany, jeśli wystąpi błąd przetwarzania limitu lub jeśli żądanie „quota apply” do Edge nie zaktualizuje zdalnych liczników limitów. W takim przypadku limit będzie przetwarzany tylko na podstawie lokalnych wartości do czasu następnej pomyślnej synchronizacji zdalnej. Wcześniej to zdarzenie było rejestrowane tylko wtedy, gdy poziom rejestrowania był ustawiony na DEBUG.

  Na przykład:

  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. Rozwiązaliśmy problem, który powodował, że w trakcie przetwarzania lub nowe transakcje były dotknięte zmianami w proxy interfejsu API wykrywanymi przez Edge Microgateway. Gdy wprowadzisz zmiany w serwerze proxy, Edge Microgateway odświeży pamięć podręczną, a węzły robocze zostaną ponownie uruchomione. Ta zmiana nie ma wpływu na transakcje w toku ani na nowe wywołania interfejsu API wysyłane do mikrobramy.
• 146378327 – poziom logowania w przypadku sourceRequest, targetRequest i targetResponse został zmieniony na poziom INFORMACJE.
• 146019878 – usunięto rozbieżność między czasem oczekiwania obliczonym dla „Wydajności serwera proxy interfejsu API” w analizach Edge a zdarzeniami dziennika sourceResponse/targetResponse Edge Microgateway. Teraz opóźnienie w przypadku zdarzeń z dziennika Edge Analytics i Microgateway jest takie samo.
• Zmiany w logice dopasowywania wzorców:
  • 147027862 – wtyczka OAuth została zaktualizowana, aby obsługiwać te wzorce dopasowywania ścieżek zasobów określone w produktach API:
    • /{literal}**
    • /{literal}*
    • Dowolna kombinacja powyższych 2 wzorców

    Dzięki tej zmianie wtyczka Edge Microgateway będzie teraz stosować to samo dopasowywanie wzorców co Apigee Edge, co zostało wyjaśnione w artykule Konfigurowanie działania ścieżki zasobu „/”, „/*” i „/**”.

  • 145644205. Zaktualizuj logikę dopasowywania wzorców w przypadku wtyczki apiKeys, aby była zgodna z wtyczką oauth.
• 143488312 – rozwiązano problem, w którym spacje na początku lub na końcu parametru identyfikatora klienta powodowały, że lista produktów JWT była pusta w przypadku żądań tokena OAuth i klucza interfejsu API.
• 145640807 i 147579179 – dodano nową funkcję, która umożliwia specjalnej instancji Edge Microgateway o nazwie „synchronizator” pobieranie danych konfiguracyjnych z Apigee Edge i zapisywanie ich w lokalnej bazie danych Redis. Inne instancje mikrobramy można następnie skonfigurować tak, aby odczytywały dane konfiguracyjne z bazy danych. Ta funkcja zwiększa odporność Edge Microgateway. Umożliwia to uruchamianie i działanie instancji mikrobramy bez konieczności komunikowania się z Apigee Edge. Więcej informacji znajdziesz w artykule Korzystanie z synchronizatora.

  Funkcja synchronizatora jest obecnie obsługiwana w przypadku Redis w wersji 5.0.x.

Wersja 3.0.x

Poprawki błędów i ulepszenia w wersji 3.0.x

3.0.10

8 listopada 2019 r. zespół Apigee wprowadził w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.0.10. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą się różnić od numeru wersji głównego produktu:

Poprawki błędów i ulepszenia:

• 142677575 – wprowadziliśmy aktualizację funkcji, dzięki której dopasowywanie wzorców ścieżek zasobów używanych w produktach API w Edge Microgateway jest teraz zgodne z dopasowywaniem wzorców ścieżek zasobów używanym przez Apigee Edge, co opisano w artykule Konfigurowanie działania ścieżki zasobu „/”, „/*” i „/**”.

  Uwaga: jeśli używasz złożonego wzorca zasobów, np. /*/2/**, musisz się upewnić, że proxy edgemicro_auth jest dodane do samodzielnego produktu interfejsu API. Następnie musisz dodać ten produkt do aplikacji dewelopera serwera proxy, jak pokazano na tym zrzucie ekranu:

  

  Uwaga: właściwość konfiguracji features.isSingleForwardSlashBlockingEnabled opisana w artykule Konfigurowanie działania ścieżki zasobu „/”, „/*” i „/**” nie jest obsługiwana w przypadku Edge Microgateway.

• 143740696 – struktura konfiguracji quotas uległa zmianie (zobacz też informacje o wersji 3.0.9). Właściwość quotas służy do konfigurowania wtyczki limitu. Zmiana struktury została wprowadzona w celu zwiększenia przejrzystości elementów konfiguracji. Aby skonfigurować wtyczkę limitu, użyj poniższej konfiguracji YAML. Pamiętaj, że właściwość konfiguracji nazywa się quotas. Szczegółowe informacje o poszczególnych właściwościach konfiguracji quotas znajdziesz w artykule Opcje konfiguracji limitu.

  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. Dodaliśmy nową funkcję, która umożliwia używanie Redis jako pamięci zapasowej limitu. Jeśli useRedis ma wartość true, używany jest moduł volos-quota-redis. Jeśli wartość to „true”, limit jest ograniczony tylko do tych instancji Edge Microgateway, które łączą się z Redis. Jeśli wartość jest fałszywa, jako pamięć zapasowa używany jest moduł volos-quota-apigee, a licznik limitu jest globalny. Więcej informacji znajdziesz w artykule Opcje konfiguracji limitu. Na przykład:

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

• 140574210.Domyślny czas wygaśnięcia tokenów generowanych przez serwer proxy edgemicro-auth został zmieniony ze 108 000 milisekund (1,8 minuty) na 1800 sekund (30 minut).
• 143551282. Aby obsługiwać organizacje z włączonym SAML, polecenie edgemicro genkeys zostało zaktualizowane i zawiera teraz parametr ‑‑token. Ten parametr umożliwia użycie tokena OAuth do uwierzytelniania zamiast nazwy użytkownika i hasła. Więcej informacji znajdziesz w sekcji Generowanie kluczy.

3.0.9

11 października 2019 r. zespół Apigee wprowadził w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.0.9. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą się różnić od numeru wersji głównego produktu:

Poprawki błędów i ulepszenia:

• 141989374. Dodano nową funkcję „fail open” dla wtyczki limitów. Jeśli ta funkcja jest włączona, w przypadku wystąpienia błędu przetwarzania limitu lub niepowodzenia żądania „zastosuj limit” do Edge w celu zaktualizowania zdalnych liczników limitów limit będzie przetwarzany tylko na podstawie lokalnych wartości, dopóki nie nastąpi kolejna udana synchronizacja zdalnego limitu. W obu tych przypadkach w obiekcie żądania ustawiana jest flaga quota-failed-open.

  Aby włączyć funkcję „fail open” limitu, ustaw tę konfigurację:

  quotas :
   failOpen : true

  Uwaga: dodatkowo nazwa flagi obiektu żądania fail-open w przypadku wtyczki OAuth została zmieniona na oauth-failed-open.

• 142093764. W celu zapobiegania przekraczaniu limitów wprowadzono zmianę konfiguracji serwera proxy edgemicro-auth. Zmiana polega na ustawieniu typu limitu na calendar. Aby skorzystać z tego ulepszenia, musisz zaktualizować edgemicro-auth do wersji 3.0.7 lub nowszej.
• 142520568 - A new feature has been added to enable the logging of the MP (message processor) ID in quota responses. Aby korzystać z tej funkcji, musisz zaktualizować edgemicro-auth serwer proxy do wersji 3.0.7 lub nowszej i ustawić tę konfigurację:

  quotas:
    useDebugMpId: true

  Gdy ustawiona jest wartość useDebugMpId, odpowiedzi dotyczące limitu z Edge będą zawierać identyfikator MP i będą rejestrowane przez Edge Microgateway. Na przykład:

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

3.0.8

26 września 2019 r. zespół Apigee wprowadził w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.0.8. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą się różnić od numeru wersji głównego produktu:

Poprawki błędów i ulepszenia:

• 140025210 - Dodano nową funkcję „fail open”. Ta funkcja umożliwia kontynuowanie przetwarzania interfejsu API, jeśli nie można odświeżyć wygasłego tokena JWT z powodu błędu połączenia, który uniemożliwia wykonanie wywołania weryfikacji klucza interfejsu API do edgemicro-auth proxy.

  Ta funkcja umożliwia ustawienie okresu prolongaty, w którym stary token pozostaje w pamięci podręcznej i jest ponownie używany do czasu wygaśnięcia okresu prolongaty. Ta funkcja umożliwia Edge Microgateway dalsze przetwarzanie żądań w przypadku tymczasowej awarii połączenia. Gdy połączenie zostanie przywrócone i zakończy się powodzeniem wywołanie interfejsu Verify API Key, pobrany zostanie nowy token JWT, który zastąpi stary token JWT w pamięci podręcznej.

  Aby skonfigurować nową funkcję „fail open”:

  1. Ustaw te właściwości w sekcji oauth w pliku konfiguracji Edge Microgateway:

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

     Na przykład:

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

     W tym przykładzie stary token będzie używany przez 5 sekund, jeśli nie można go odświeżyć z powodu problemu z połączeniem. Po 5 sekundach zostanie zwrócony błąd uwierzytelniania.

• 141168968 – wprowadzono zmianę, aby uwzględnić correlation_id we wszystkich danych wyjściowych dziennika wtyczki. Poza tym w razie potrzeby zmieniliśmy poziomy logowania niektórych logów na error.
• 140193349 – wprowadzono aktualizację edgemicro-auth proxy, która wymaga weryfikacji klucza i obiektu tajnego Edge Microgateway w każdym żądaniu weryfikacji klucza interfejsu API. Edge Microgateway zostało zaktualizowane, aby zawsze wysyłać klucz i tajny klucz w każdym żądaniu weryfikacji klucza interfejsu API. Ta zmiana uniemożliwia klientom uzyskanie tokena JWT tylko za pomocą klucza interfejsu API.
• 140090250 – wprowadzono aktualizację, aby dodać rejestrowanie diagnostyczne do przetwarzania limitów. Dzięki tej zmianie można teraz korelować dane wyjściowe logów dotyczących limitów z pozostałymi logami Edge Microgateway.

3.0.7

12 września 2019 r. zespół Apigee wprowadził w usłudze Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.0.7. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą się różnić od numeru wersji głównego produktu:

Poprawki błędów i ulepszenia:

• 140075602. Wtyczka OAuth została zaktualizowana, aby w odpowiednich przypadkach zwracać kod stanu 5xx. Wcześniej wtyczka zwracała kody stanu 4xx we wszystkich przypadkach innych niż 200. Teraz w przypadku każdej odpowiedzi na wiadomość, która nie ma stanu 200, zwracany jest dokładny kod 4xx lub 5xx w zależności od błędu.

  Ta funkcja jest domyślnie wyłączona. Aby włączyć tę funkcję, dodaj do konfiguracji Edge Microgateway właściwość oauth.useUpstreamResponse: true. Na przykład:

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

• 140090623. W wersji 3.0.6 dodaliśmy nową właściwość konfiguracji: quota.quotaUri. Ustaw tę właściwość konfiguracji, jeśli chcesz zarządzać limitami za pomocą edgemicro-authserwera proxy wdrożonego w Twojej organizacji. Jeśli ta właściwość nie jest skonfigurowana, punkt końcowy limitu domyślnie przyjmuje wartość wewnętrznego punktu końcowego Edge Microgateway. Na przykład:

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

  W wersji 3.0.7 zaktualizowano edgemicro-auth, aby akceptować tę nową konfigurację. Aby używać właściwości quotaUri, musisz przejść na najnowszą wersję serwera proxy edgemicro-auth. Szczegółowe informacje znajdziesz w artykule Uaktualnianie serwera proxy edgemicro-auth.

• 140470888 – do wywołań związanych z limitami dodano nagłówek autoryzacji, aby zapewnić uwierzytelnianie. Zmodyfikowano też serwer proxy edgemicro-auth, aby usunąć z identyfikatora limitu słowo „organization”. Punkt końcowy limitu znajduje się w organizacji klienta, więc identyfikator limitu nie jest już potrzebny.
• 140823165. Nazwa usługi:

  edgemicro:
      keepAliveTimeout

  została nieprawidłowo udokumentowana w wersji 3.0.6. Prawidłowa nazwa usługi to:

  edgemicro:
      keep_alive_timeout

• 139526406 - Naprawiono błąd, który powodował nieprawidłowe zliczanie limitu, jeśli aplikacja dewelopera miała wiele produktów. Limit jest teraz prawidłowo egzekwowany w przypadku każdego produktu w aplikacji, która ma wiele produktów. Kombinacja „appName + productName” jest używana jako identyfikator limitu.

3.0.6

29 sierpnia 2019 r. zespół Apigee wprowadził w Edge Microgateway te poprawki i ulepszenia:

• 138633700 – dodano nową właściwość konfiguracji keepAliveTimeout. Ta właściwość umożliwia ustawienie limitu czasu Edge Microgateway (w milisekundach). (Domyślnie: 5000 milisekund)

  Na przykład:

  edgemicro:
    keep_alive_timeout: 600

• 140090623 – dodano nową właściwość konfiguracji quotaUri. Ustaw tę właściwość konfiguracji, jeśli chcesz zarządzać limitami za pomocą edgemicro-auth serwera proxy wdrożonego w Twojej organizacji. Jeśli ta właściwość nie jest skonfigurowana, punkt końcowy limitu domyślnie przyjmuje wewnętrzny punkt końcowy Edge Microgateway. Na przykład:

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

  Aby korzystać z tej funkcji, musisz najpierw wdrożyć w organizacji najnowszą wersję edgemicro-auth serwera proxy. Szczegółowe informacje znajdziesz w artykule Uaktualnianie serwera proxy edgemicro-auth.

• 138722809. Dodaliśmy nową właściwość konfiguracji: stack_trace. Ta właściwość pozwala określić, czy ślady stosu mają się pojawiać w plikach dziennika. Na przykład:

  stack_trace: false

  Jeśli wartość stack_trace to true, w logach zostanie wydrukowany zrzut stosu. Jeśli zasada ma wartość false, ślad stosu nie będzie drukowany w logach.

3.0.5

15 sierpnia 2019 r. zespół Apigee wprowadził w Edge Microgateway te poprawki i ulepszenia:

• 139005279 – rozwiązaliśmy problem, który powodował, że polecenie edgemicro status nie zwracało prawidłowej liczby procesów roboczych.
• 138437710 – w klasie ExitCounter naprawiono problem, który uniemożliwiał zapisanie prawidłowego dziennika.

• 139064652. Dodano możliwość dodawania poziomów rejestrowania trace i debug w przypadku dzienników zdarzeń i systemowych. Na razie dodaliśmy tylko możliwość dodawania tych poziomów logowania. Obecnie dostępne poziomy logowania to info, warn i error.
• 139064616. Ujednolicono dane wyjściowe logu dla wszystkich instrukcji logowania w konsoli. Instrukcje logowania w konsoli zawierają teraz te atrybuty:
• Sygnatura czasowa
• Nazwa komponentu
• Identyfikator procesu
• Komunikat logu konsoli

• 138413755. Ulepsz komunikaty dziennika związane z kluczem i sekretem JWT w przypadku tych poleceń CLI: cert, verify, upgradekvm, token, genkeys, revokekeys, rotatekey i configure.

• 138413577. Dodaj i ulepsz obsługę błędów w przypadku przekroczenia limitu czasu usługi backendu.
• 138413303. Dodanie i ulepszenie obsługi błędów w przypadku przekroczenia limitu czasu odpowiedzi i gniazda.
• 138414116. Dodanie i ulepszenie obsługi błędów „odmowa połączenia”.

3.0.4

1 sierpnia 2019 r. zespół Apigee wprowadził w Edge Microgateway te poprawki i ulepszenia:

• 134445926 – ulepszenia wewnętrznego uwierzytelniania Edge Microgateway.
• 137582169 – rozwiązaliśmy problem, który powodował uruchamianie niechcianych procesów. Dodatkowe procesy spowodowały ponowne wczytanie wtyczek i nadmierne wykorzystanie pamięci. Edge Microgateway utrzymuje teraz liczbę procesów w oczekiwanym limicie.
• 137768774. Ulepszenia komunikatów logu:
  • oczyszczone logi transakcji (żądania);
  • Dodano więcej wiadomości dziennika w miejscach, w których były potrzebne.
  • Przeniesiono komunikaty logu transakcji (żądania) z danych wyjściowych konsoli do odpowiedniego pliku logu.
  • Zaktualizowano logi konsoli, aby korzystały z scentralizowanej funkcji logowania.
• 138321133, 138320563 – podstawowa wewnętrzna zmiana bufora limitu, która umożliwi w przyszłości zwiększenie limitów.

3.0.3

23 lipca 2019 r. zespół Apigee wprowadził w Edge Microgateway te poprawki i ulepszenia:

• Ulepszenia rejestrowania: istniejące dzienniki czasu działania korzystają z nowej funkcji eventLog(), która rejestruje dane czasu działania w spójnym formacie. Informacje w logu obejmują:
  • Sygnatura czasowa (zgodnie z normą ISO 8601: RRRR-MM-DDTHH:mm:ss.sssZ).
  • Poziom logu (error, warn lub info).
  • Nazwa hosta – nazwa hosta z nagłówka żądania.
  • Identyfikator procesu – jeśli używasz klastra procesów Node.js, jest to identyfikator procesu, w którym nastąpiło logowanie.
  • Nazwa organizacji Apigee.
  • Nazwa środowiska w organizacji.
  • Nazwa proxy interfejsu API.
  • Adres IP klienta.
  • ClientId.
  • Identyfikator korelacji (nie jest obecnie ustawiony).
  • Nazwa komponentu Edge Microgateway.
  • Wiadomość niestandardowa – niektóre obiekty mogą drukować dodatkowe informacje przekazywane do tej właściwości błędu.
  • Metoda żądania (w przypadku żądania HTTP).
  • Kod stanu odpowiedzi (w przypadku żądania HTTP).
  • Komunikat o błędzie.
  • Kod błędu – jeśli obiekt zawiera kod błędu, jest on drukowany w tej właściwości.
  • Czas trwania.
  • System operacyjny znacznik końca wiersza.

  Wartości właściwości null powodują wyświetlanie pustych nawiasów kwadratowych, [].

  Poniżej znajdziesz przykład formatu logu:

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

  (137770055)

• Skuteczność: produkty interfejsu API nie były filtrowane na podstawie środowiska. Ten problem został rozwiązany. (135038879)
• Różne integracje testów funkcjonalnych i ulepszenia jakości kodu.

3.0.2

3 lipca 2019 r. zespół Apigee wprowadził w Edge Microgateway te poprawki i ulepszenia:

Jakość kodu – kod został sprawdzony pod kątem jakości i wprowadzono w nim zmiany, aby spełniał standardy jakości wymagane przez użytkowników. Usunęliśmy błędy i ostrzeżenia dotyczące jakości kodu pochodzące z JSHint. W rezultacie wykryto i naprawiono niektóre rzeczywiste błędy w kodzie. Wszystkie moduły Apigee Edge Microgateway zostały poddane temu procesowi. Zobacz zmiany z 28 czerwca i 2 lipca w przypadku microgateway-config, microgateway-core, microgateway-plugins i microgateway. Wszystkie moduły ze zmianami w jakości kodu zostały przetestowane za pomocą narzędzi wewnętrznych, które weryfikują działanie Edge Microgateway w przypadkach użycia klientów.

3.0.1

21 czerwca 2019 r. zespół Apigee wprowadził w Edge Microgateway te poprawki i ulepszenia:

• 134834551 - Change the supported Node.js versions for Edge Microgateway
  (Node.js supported versions: 8 and 12; versions 7, 9, and 11 are experimental)
• 134751883. Edge Microgateway ulega awarii podczas ponownego wczytywania pod obciążeniem
• 134518428. Punkt końcowy Products w Edge Microgateway zwraca błąd 5XX, jeśli wzorzec filtra jest nieprawidłowy
• 135113408. Workers should restart if they terminate unexpectedly
• 134945852 – tokenCacheSize nie jest używany w pluginie OAuth
• 134947757 - set cacheTTL in oauth plug-in
• 135445171 - gracePeriod calculation in OAuth is not correct
• Użyj modułu memored dostarczonego z instalacją Edge Microgateway.
• 135367906 - Security audit

Wersja 2.5.x

Nowe funkcje i ulepszenia w wersji 2.5.x

(Poprawiono w wersji 2.5.38, 06.07.2019)

Nieprawidłowo sformatowane tokeny JWT mogą powodować awarie procesów roboczych podczas korzystania z pamięci podręcznej tokenów. Naprawiono w module wtyczek mikrobramy Edge. (b/134672029)

(Dodano w wersji 2.5.37) Dodaj opcję interfejsu wiersza poleceń edgemicro-cert -t.

Opcja edgemicro cert -t umożliwia określenie tokena OAuth do uwierzytelniania interfejsów API zarządzania. Zobacz też Zarządzanie certyfikatami.

(Dodano 2.5.35) Dodano obsługę debugowania Edge Microgateway za pomocą edgemicroctl.

Możesz użyć flagi mgdebug z poleceniem edgemicroctl. Zobacz też zadania integracji z Kubernetes.

(Dodano w wersji 2.5.35) Włącz kompilację systemu Windows dla edgemicroctl.

(Dodano 2.5.31) Nowy interfejs API edgemicro-auth/token

Dodaliśmy nowy interfejs API edgemicro-auth/token, który umożliwia przekazywanie klienta/klucza tajnego jako nagłówka autoryzacji podstawowej zakodowanego w formacie Base64 oraz grant_type jako parametru formularza. Zobacz Bezpośrednie uzyskiwanie tokenów dostępu.

(Poprawka w wersji 2.5.31) Prywatna konfiguracja nie uwzględnia flagi tokena

Rozwiązaliśmy problem, który powodował, że skonfigurowanie Edge Microgateway do używania tokena dostępu OAuth2 w Edge dla chmury prywatnej nie działało prawidłowo (token nie był uwzględniany).

Docker: obsługa certyfikatów z podpisem własnym

(Dodano 2.5.29) Jeśli używasz urzędu certyfikacji, który nie jest domyślnie zaufany przez Node.js, możesz użyć parametru NODE_EXTRA_CA_CERTS podczas uruchamiania kontenera Dockera z Edge Microgateway. Więcej informacji znajdziesz w artykule Używanie urzędu certyfikacji, który nie jest zaufany przez Node.js.

Docker: obsługa TLS

(Dodano 2.5.29) Edge Microgateway działający w kontenerze Dockera obsługuje teraz TLS w przypadku przychodzących żądań do serwera Edge Microgateway (żądania wychodzące) i wychodzących żądań z Edge Microgateway do aplikacji docelowej (żądania przychodzące).

Poniższe przykłady szczegółowo wyjaśniają, jak skonfigurować te ustawienia TLS:

• Przykładowa konfiguracja protokołu TLS w kierunku północnym
• Przykładowa konfiguracja TLS w kierunku południowym

W tych przykładach zobaczysz, jak używać punktu podłączania kontenera /opt/apigee/.edgemicro do wczytywania certyfikatów, do których odwołuje się plik konfiguracyjny Edge Microgateway.

Docker: obsługa przekazywania żądań

(Dodano 2.5.27) Jeśli uruchamiasz Edge Microgateway w kontenerze Docker, możesz użyć tych opcji, aby kontrolować działanie serwera proxy, gdy mikrogateway działa za zaporą:

• HTTP_PROXY
• HTTPS_PROXY
• NO_PROXY

Szczegółowe informacje znajdziesz w artykule Uruchamianie Edge Micro jako kontenera Dockera.

Docker: zaktualizowane instrukcje dotyczące wtyczki

(Dodano 2.5.27) Jeśli używasz Edge Microgateway w kontenerze Docker, masz teraz 2 opcje wdrażania wtyczek. Jedna z nich, korzystająca z punktu podłączania Dockera, jest nowa. Druga opcja istniała już wcześniej i zasadniczo nie uległa zmianie, ale plik Dockerfile został zaktualizowany. Szczegółowe informacje znajdziesz na tych stronach:

• Opcja A. Zamontuj katalog wtyczek na woluminie (nowość)
• Opcja B. Wbuduj wtyczki w kontenerze (zaktualizowano)

Nowa obsługa tokenów OAuth w przypadku polecenia uaktualniania KVM

(Dodano 27.05.2024 r.) Za pomocą polecenia upgradekvm możesz użyć tokena OAuth. Więcej informacji znajdziesz w sekcji Uaktualnianie KVM.

Segregowanie interfejsów API w Edge Analytics

(Dodano 2.5.26) Nowe flagi wtyczki analitycznej umożliwiają wydzielenie konkretnej ścieżki interfejsu API, tak aby w panelach Edge Analytics była widoczna jako osobny serwer proxy. Możesz na przykład oddzielić interfejsy API kontroli stanu, aby nie mylić ich z rzeczywistymi wywołaniami interfejsu API. Więcej informacji znajdziesz w artykule Wykluczanie ścieżek z analiz.

Konfigurowanie lokalnego serwera proxy

(Dodano 2.5.25) W przypadku lokalnego serwera proxy nie musisz ręcznie tworzyć serwera proxy obsługującego mikrobramę w Apigee Edge. Zamiast tego mikrobrama będzie używać ścieżki podstawowej lokalnego serwera proxy. Więcej informacji znajdziesz w artykule Korzystanie z trybu lokalnego serwera proxy.

Korzystanie z trybu autonomicznego

(Dodano 2.5.25) Możesz uruchomić Edge Microgateway całkowicie odłączony od wszelkich zależności Apigee Edge. W tym scenariuszu, zwanym trybem samodzielnym, możesz uruchamiać i testować Edge Microgateway bez połączenia z internetem. Więcej informacji znajdziesz w artykule Uruchamianie Edge Microgateway w trybie samodzielnym.

Cofanie kluczy

(Dodano 2.5.19) Dodano nowe polecenie CLI, które cofa klucz i dane logowania do konfiguracji Edge Microgateway.

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

Obsługa Dockera

(Dodano 2.5.19) Najnowszą wersję Edge Microgateway możesz teraz pobrać jako obraz Dockera:

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

Obsługa Kubernetes

(Dodano 2.5.19) Edge Microgateway możesz wdrożyć jako usługę lub jako bramę pomocniczą przed usługami wdrożonymi w klastrze Kubernetes. Zobacz: Integrate Edge Microgateway with Kubernetes overview (Omówienie integracji Edge Microgateway z Kubernetes).

Obsługa opcji TCP nodelay

(Dodano 2.5.16) Do konfiguracji Edge Micro dodano nowe ustawienie konfiguracji nodelay.

Domyślnie połączenia TCP używają algorytmu Nagle do buforowania danych przed ich wysłaniem. Ustawienie nodelay na true wyłącza to działanie (dane będą wysyłane natychmiast za każdym razem, gdy zostanie wywołana funkcja socket.write()). Więcej informacji znajdziesz w dokumentacji Node.js.

Aby włączyć nodelay, zmodyfikuj plik konfiguracji Edge Micro w ten sposób:

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

Nowe opcje interfejsu wiersza poleceń do monitorowania ciągłego

(Dodano 2.5.12) Do polecenia edgemicro forever dodano nowe parametry. Te parametry umożliwiają określenie lokalizacji pliku forever.json oraz rozpoczęcie lub zatrzymanie procesu działającego w tle Forever. Zobacz też Stałe monitorowanie

Przykłady:

Aby rozpocząć korzystanie z Forever:

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

Aby zatrzymać Forever:

edgemicro forever -a stop

Rotacja klucza JWT

Dodaliśmy nową funkcję, która umożliwia rotację par kluczy publicznych i prywatnych używanych do generowania tokenów JWT używanych na potrzeby zabezpieczeń OAuth w Edge Microgateway. Zobacz Rotacja kluczy JWT.

Filtrowanie pobranych serwerów proxy interfejsu API

Domyślnie Edge Microgateway pobiera wszystkie serwery proxy w organizacji Edge, które zaczynają się od prefiksu „edgemicro_”. Możesz zmienić to ustawienie domyślne, aby pobierać serwery proxy, których nazwy pasują do wzorca. Zobacz Filtrowanie pobranych serwerów proxy.

Określanie produktów bez serwerów proxy interfejsu API

W Apigee Edge możesz utworzyć usługę interfejsu API, która nie zawiera żadnych serwerów proxy interfejsu API. Ta konfiguracja usługi umożliwia używanie klucza interfejsu API powiązanego z tą usługą w przypadku dowolnego serwera proxy wdrożonego w Twojej organizacji. Od wersji 2.5.4 Edge Microgateway obsługuje tę konfigurację produktu.

Obsługa stałego monitorowania

Edge Microgateway ma plik forever.json, który możesz skonfigurować, aby określić, ile razy i w jakich odstępach czasu Edge Microgateway ma być ponownie uruchamiany. Ten plik konfiguruje usługę o nazwie forever-monitor, która zarządza programem Forever. Zobacz Stałe monitorowanie.

Centralne zarządzanie plikiem konfiguracyjnym Edge Micro

Jeśli uruchamiasz wiele instancji Edge Microgateway, możesz zarządzać ich konfiguracjami z jednego miejsca. Możesz to zrobić, określając punkt końcowy HTTP, z którego Edge Micro może pobrać plik konfiguracji. Zobacz Określanie punktu końcowego pliku konfiguracji.

Obsługa opcji interfejsu wiersza poleceń forever

(Dodano w wersji 2.5.8) Użyj polecenia edgemicro forever [package.json], aby określić lokalizację pliku forever.json. Przed dodaniem tego polecenia plik config musiał znajdować się w katalogu głównym Edge Microgateway.

Na przykład:

edgemicro forever ~/mydir/forever.json

Dodanie opcji configUrl do polecenia reload

(Dodano w wersji 2.5.8) Możesz teraz używać opcji --configUrl lub -u z poleceniem edgemicro reload.

Okres prolongaty w przypadku różnic w czasie tokena JWT

(Dodano w wersji 2.5.7) Atrybut gracePeriod w konfiguracji OAuth pomaga zapobiegać błędom spowodowanym przez niewielkie rozbieżności między zegarem systemowym a czasem „Not Before” (nbf) lub „Issued At” (iat) określonym w tokenie autoryzacji JWT. Ustaw ten atrybut na liczbę sekund, która ma być dozwolona w przypadku takich rozbieżności. Zobacz Atrybuty OAuth.

(Dodano w wersji 2.5.7) Atrybut gracePeriod w konfiguracji OAuth pomaga zapobiegać błędom spowodowanym przez niewielkie rozbieżności między zegarem systemowym a czasem „Not Before” (nbf) lub „Issued At” (iat) określonym w tokenie autoryzacji JWT. Ustaw ten atrybut na liczbę sekund, która ma być dozwolona w przypadku takich rozbieżności. Zobacz Atrybuty OAuth.

Poprawione błędy w wersji 2.5.x

• (Problem 236) Poprawienie literówki w instrukcji czyszczenia pamięci podręcznej.
• (Problem nr 234) Ponowne wczytywanie powoduje awarię Edge Microgateway w wersji 2.5.35.
• (Problem 135) Błąd „Nieprawidłowe odwołanie do hosta wirtualnego »secure«” podczas używania opcji -v. Ta poprawka modyfikuje serwer proxy edgemicro-auth przed wdrożeniem, aby zapewnić, że hosty wirtualne dokładnie odpowiadają temu, co jest określone we fladze „-v”. Dodatkowo możesz określić dowolną liczbę hostów wirtualnych i dowolną nazwę (nie są już ograniczone do domyślnego i bezpiecznego).
• (Problem 141) Polecenie edgemicro reload nie obsługuje opcji pliku konfiguracyjnego -c. Naprawiliśmy ten problem.
• (Problem nr 142) Edge Microgateway zgłasza w momencie instalacji, że używa przestarzałego szyfrowania. Naprawiliśmy ten problem.
• (Problem nr 145) Limit nie działa w przypadku Edge Microgateway. Naprawiliśmy ten problem.
• (Problem na forum Apigee: EMG - JWT token validated against both API Proxies and Resource URI in OAUTH) Token JWT zweryfikowany pod kątem serwerów proxy interfejsów API i identyfikatora URI zasobu w OAUTH. Ten problem został rozwiązany.
• (Problem na forum Apigee: Microgateway working even without Oauth token in header) Microgateway nie działa z OAuth. Naprawiliśmy ten problem.
• Naprawiono pidPath w systemie Windows.
• (Problem nr 157) Rozwiązaliśmy problem, który powodował wyświetlanie tego komunikatu o błędzie:ReferenceError: deployProxyWithPassword is not defined.
• (Problem nr 169) Aktualizacja zależności Node.js (npm audit)
• Serwer proxy edgemicro-auth korzysta teraz z zasad JWT Edge. Serwer proxy nie zależy już od Node.js w zakresie obsługi JWT.

Wersja 2.4.x

Nowe funkcje i ulepszenia w wersji 2.4.x

1. Ustaw niestandardowy alias dla serwera proxy edgemicro-auth (PR 116)

Możesz zmienić domyślną ścieżkę podstawową dla serwera proxy edgemicro-auth. Domyślnie ścieżka podstawowa to /edgemicro-auth. Aby to zmienić, użyj flagi -x w poleceniu edgemicro configure.

Przykład:

edgemicro configure -x /mypath …

2. Obsługa symboli wieloznacznych w przypadku ścieżek podstawowych (PR 77)

W ścieżce podstawowej serwera proxy edgemicro_* możesz użyć co najmniej jednego symbolu wieloznacznego „*”. Na przykład ścieżka podstawowa /team/*/members umożliwia klientom wywoływanie adresów https://[host]/team/blue/members i https://[host]/team/green/members bez konieczności tworzenia nowych serwerów proxy interfejsu API do obsługi nowych zespołów. Pamiętaj, że /**/ nie jest obsługiwane.

3. Ścieżka konfiguracji niestandardowej dodana do interfejsu wiersza poleceń w konfiguracji chmury prywatnej (PR 99)

Domyślnie plik konfiguracji mikrobramy znajduje się w folderze ./config/config.yaml. W przypadku poleceń init, configure i start możesz teraz określić niestandardową ścieżkę konfiguracji w wierszu poleceń za pomocą flag -c lub --configDir. Rozwiązaliśmy problem, który powodował, że niestandardowy katalog konfiguracji w instalacjach chmury prywatnej nie był rozpoznawany.

Przykład:

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

4. Uwzględnianie zmiennych *_PROXY (PR 61)

Jeśli Edge Microgateway jest zainstalowany za zaporą i nie może komunikować się z Apigee Edge w chmurze publicznej, masz do wyboru 2 opcje:

Opcja 1:

Pierwsza opcja polega na ustawieniu w pliku konfiguracyjnym mikrobramy wartości true dla opcji edgemicro: proxy_tunnel:

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

Gdy wartość proxy_tunnel to true, Edge Microgateway używa metody HTTP CONNECT do tunelowania żądań HTTP przez jedno połączenie TCP. (To samo dotyczy sytuacji, gdy zmienne środowiskowe do konfigurowania serwera proxy mają włączony protokół TLS).

Opcja 2:

Drugą opcją jest określenie serwera proxy i ustawienie wartości proxy_tunnel na false w pliku konfiguracyjnym mikrobramy. Na przykład:

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

W tym przypadku możesz ustawić te zmienne, aby określić hosty dla każdego serwera proxy HTTP, którego chcesz używać, lub hosty, które nie powinny obsługiwać serwerów proxy Edge Microgateway: HTTP_PROXY, HTTPS_PROXY i NO_PROXY. Możesz ustawić wartość NO_PROXY jako listę domen rozdzielonych przecinkami, do których Edge Microgateway nie powinien przekazywać żądań. Na przykład:

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

Więcej informacji o tych zmiennych znajdziesz w tych artykułach:

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

5. Ustawianie niestandardowego limitu czasu dla żądań kierowanych na środowisko docelowe (PR 57)

Możesz ustawić niestandardowy czas oczekiwania na żądania kierowania za pomocą tej konfiguracji:

edgemicro:
    request_timeout: 10

Czas oczekiwania jest podawany w sekundach. Jeśli upłynie czas oczekiwania, Edge Microgateway odpowie kodem stanu 504.

6. Uwzględnianie niestandardowych komunikatów o stanie HTTP w odpowiedzi docelowej (PR 53)

Edge Microgateway uwzględnia niestandardowe komunikaty o stanie HTTP ustawione w odpowiedzi docelowej. W poprzednich wersjach komunikaty o stanie wysyłane z urządzenia docelowego były zastępowane domyślnymi ustawieniami Node.js.

7. Nagłówek X-Forwarded-For może ustawić parametr client_ip na potrzeby analityki

Jeśli nagłówek X-Forwarded-For jest obecny, ustawi zmienną client_ip, która jest raportowana w Edge Analytics. Ta funkcja umożliwia sprawdzenie adresu IP klienta, który wysłał żądanie do Edge Microgateway.

8. Zmiany w pluginie OAuth

Wtyczka OAuth obsługuje weryfikację klucza interfejsu API i weryfikację tokena dostępu OAuth. Przed tą zmianą wtyczka akceptowała obie formy zabezpieczeń. Dzięki tej zmianie możesz zezwolić tylko na 1 z tych modeli zabezpieczeń (przy zachowaniu zgodności wstecznej).

Wtyczka OAuth dodaje 2 nowe flagi:

• allowOAuthOnly – jeśli ma wartość true, każdy interfejs API musi zawierać nagłówek Authorization z tokenem dostępu Bearer.

• allowAPIKeyOnly – jeśli ma wartość true, każdy interfejs API musi zawierać nagłówek x-api-key (lub niestandardową lokalizację) z kluczem interfejsu API.

Te flagi ustawia się w pliku konfiguracyjnym Edge Microgateway w ten sposób:

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

9. Ulepszono serwer proxy edgemicro-auth (PR 40)

Wprowadziliśmy ulepszenia serwera proxy edgemicro-auth. Przed wprowadzeniem tych zmian serwer proxy przechowywał klucze w zaszyfrowanym magazynie Edge Secure Store. Teraz serwer proxy przechowuje klucze na zaszyfrowanej mapie klucz-wartość (KVM) Edge.

10. Przepisywanie domyślnego docelowego adresu URL w wtyczce (PR 74)

Możesz też zastąpić port docelowego punktu końcowego i wybrać protokół HTTP lub HTTPS. Zmodyfikuj w kodzie wtyczki te zmienne: req.targetPort i req.targetSecure. Aby wybrać HTTPS, ustaw wartość req.targetSecure na true, a w przypadku HTTP ustaw ją na false. Jeśli ustawisz wartość req.targetSecure na true, więcej informacji znajdziesz w tym wątku dyskusji.

11. Wstępna obsługa uwierzytelniania za pomocą tokena OAuth (PR 125)

Możesz skonfigurować Edge Microgateway tak, aby do uwierzytelniania używał tokena OAuth zamiast nazwy użytkownika i hasła. Aby użyć tokena OAuth, użyj tego parametru w poleceniu edgemicro configure:

-t, --token <token>

Na przykład:

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

Poprawki błędów w wersji 2.4.3

• Rozwiązaliśmy problem, który powodował, że do prawidłowego działania serwera proxy edgemicro-auth wymagana była płatna organizacja. Teraz możesz używać Edge Microgateway także w organizacjach testowych. (PR 5)
• Rozwiązaliśmy problem, który powodował, że strumień nie kończył przetwarzania danych, ale mimo to wykonywane były procedury obsługi zakończenia. Spowodowało to wysłanie odpowiedzi częściowej. (PR 71)
• Rozwiązaliśmy problem, który powodował, że niestandardowy katalog konfiguracji w instalacjach chmury prywatnej nie był rozpoznawany. (PR 110)
• Rozwiązaliśmy problem z dwukierunkowym protokołem SSL między klientem a Edge Microgateway. (PR 70)
• Rozwiązano problem, który wymagał ukośnika na końcu ścieżki podstawowej serwera proxy, aby weryfikacja klucza interfejsu API działała prawidłowo. Teraz ukośnik na końcu ścieżki podstawowej nie jest już potrzebny. (PR 48)

Wersja 2.3.5

Nowe funkcje i ulepszenia w wersji 2.3.5

Filtrowanie serwera proxy

Możesz filtrować, które serwery proxy obsługujące mikrobramę będą przetwarzane przez instancję Edge Microgateway. Po uruchomieniu Edge Microgateway pobiera wszystkie serwery proxy obsługujące mikrobramę w organizacji, z którą jest powiązana. Użyj poniższej konfiguracji, aby ograniczyć liczbę serwerów proxy, które będzie przetwarzać mikrobrama. Na przykład ta konfiguracja ogranicza liczbę serwerów proxy, które będzie przetwarzać mikrobrama, do 3: edgemicro_proxy-1, edgemicro_proxy-2 i edgemicro_proxy-3:

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

Maskowanie danych Analytics

Nowa konfiguracja umożliwia ukrywanie informacji o ścieżce żądania w statystykach Edge. Aby zamaskować identyfikator URI żądania lub ścieżkę żądania, dodaj do konfiguracji mikrobramy te elementy: Pamiętaj, że identyfikator URI składa się z nazwy hosta i ścieżki żądania.

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

Wersja 2.3.3

Nowe funkcje i ulepszenia w wersji 2.3.3

Oto nowe funkcje i ulepszenia w tej wersji.

Wyłączanie automatycznego sprawdzania zmian

Możesz wyłączyć automatyczne sprawdzanie zmian, ustawiając ten atrybut w konfiguracji mikrobramy:

disabled_config_poll_interval: true

Domyślnie okresowe sprawdzanie wykrywa wszelkie zmiany wprowadzone w Edge (zmiany w produktach, serwerach proxy obsługujących mikrobramy itp.), a także zmiany wprowadzone w lokalnym pliku konfiguracji. Domyślny interwał odpytywania to 600 sekund (5 minut).

Przepisywanie docelowych adresów URL w przypadku wtyczek

Możesz dynamicznie zastąpić domyślny docelowy adres URL w wtyczce, modyfikując te zmienne w kodzie wtyczki: req.targetHostname i req.targetPath.

Nowy podpis funkcji wtyczki

Dodaliśmy nowy podpis funkcji wtyczki, który przekazuje odpowiedź docelową jako argument. Ułatwia to wtyczkom dostęp do docelowej odpowiedzi.

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

Uproszczone domyślne dane wyjściowe logowania

Domyślnie usługa rejestrowania pomija teraz pliki JSON pobranych serwerów proxy, produktów i JWT. Możesz zmienić domyślne ustawienie, aby te obiekty były wyświetlane, ustawiając DEBUG=* podczas uruchamiania Edge Microgateway. Na przykład:

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

Ścieżka konfiguracji niestandardowej dodana do interfejsu wiersza poleceń

Domyślnie plik konfiguracji mikrobramy znajduje się w folderze ./config/config.yaml. W przypadku poleceń init, configure i start możesz teraz określić niestandardową ścieżkę konfiguracji w wierszu poleceń. Obejmuje to na przykład:

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

Poprawione błędy w wersji 2.3.3

• Usunięto wyciek pamięci, który występował podczas dużych żądań i odpowiedzi.
• Ustalono kolejność wykonywania wtyczek. Działa teraz zgodnie z opisem w dokumentacji.
• Wtyczka accumulate-request nie zawiesza już żądań GET.
• W wtyczce accumulate-response rozwiązaliśmy problem, który powodował błędy z powodu braku treści odpowiedzi.

Wersja 2.3.1

Uwaga dotycząca instalacji

W niektórych poprzednich wersjach Edge Microgateway można było zainstalować oprogramowanie, pobierając plik ZIP. Te pliki ZIP nie są już obsługiwane. Aby zainstalować Edge Microgateway, musisz użyć:

npm install -g edgemicro

Więcej informacji znajdziesz w temacie dotyczącym instalacji.

Nowe funkcje i ulepszenia w wersji 2.3.1

Oto nowe funkcje i ulepszenia w tej wersji.

Filtrowanie serwerów proxy

Nowa konfiguracja umożliwia filtrowanie serwerów proxy, które Edge Microgateway będzie wczytywać podczas uruchamiania. Wcześniej mikrobrama wczytywała wszystkie serwery proxy obsługujące mikrobramę (serwery proxy o nazwie edgemicro_*) pobrane z organizacji lub środowiska Edge określonego w poleceniu edgemicro configure. Ta nowa funkcja umożliwia filtrowanie listy serwerów proxy, dzięki czemu Edge Microgateway wczytuje tylko te, które określisz. Po prostu dodaj element proxies do pliku konfiguracyjnego mikrobramy w ten sposób:

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

Załóżmy na przykład, że w organizacji/środowisku Edge masz 50 serwerów proxy edgemicro_*, w tym serwery o nazwach edgemicro_foo i edgemicro_bar. Możesz poinformować mikrobramę, aby używała tylko tych 2 serwerów proxy, w ten sposób:

edge micro:
proxies:
    - edgemicro_foo
    - edgemicro_bar

Po uruchomieniu mikrobrama będzie mogła wywoływać tylko określone serwery proxy. Wszelkie próby wywołania innych serwerów proxy obsługujących mikrobramę pobranych z organizacji lub środowiska Edge będą powodować błąd.

Ustawianie nagłówków żądania docelowego w pluginach

Jeśli chcesz dodać lub zmodyfikować nagłówki żądania docelowego, możesz zastosować 2 podstawowe wzorce: jeden, w którym żądanie przychodzące zawiera dane (jak w przypadku żądania POST), i drugi, w którym ich nie zawiera (jak w przypadku prostego żądania GET).

Rozważmy przypadek, w którym przychodzące żądanie zawiera dane, a Ty chcesz ustawić nagłówki żądania w żądaniu docelowym. W poprzednich wersjach Edge Microgateway nie można było w tym przypadku niezawodnie ustawić nagłówków docelowych.

Kluczem do tego wzorca jest najpierw zgromadzenie wszystkich danych przychodzących od klienta. Następnie w funkcji onend_request() użyj nowej funkcji request.setOverrideHeader(name, value), aby dostosować nagłówki.

Oto przykładowy kod wtyczki, który pokazuje, jak to zrobić. Nagłówki ustawione w onend_request są wysyłane do miejsca docelowego:

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);
    }

  };

}

Jeśli żądanie nie zawiera danych, możesz ustawić nagłówki docelowe w onrequest()handlerze. Ten wzorzec nie jest nowy – został już wcześniej udokumentowany i był używany w przykładowych wtyczkach dostarczanych z Edge Microgateway.

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

Funkcja ponownego ładowania bez przestoju

Po wprowadzeniu zmiany konfiguracji Edge Microgateway możesz załadować konfigurację bez utraty żadnych wiadomości. W związku z tą zmianą Edge Microgateway zawsze uruchamia się w trybie klastra, a opcja --cluster została usunięta z polecenia edgemicro start.

Dodaliśmy też 3 nowe polecenia interfejsu wiersza poleceń. Te polecenia musisz uruchomić w tym samym katalogu, w którym zostało wykonane polecenie edgemicro start:

• edgemicro status – sprawdza, czy Edge Microgateway jest uruchomiony.
• edgemicro stop – zatrzymuje klaster Edge Microgateway.
• edgemicro reload – ponownie wczytuje konfigurację Edge Microgateway bez przestoju.

Automatyczne ponowne wczytywanie konfiguracji bez przestoju

Edge Microgateway okresowo wczytuje nową konfigurację i wykonuje ponowne wczytanie, jeśli coś się zmieniło. Sondaż wykrywa wszelkie zmiany wprowadzone w Edge (zmiany w produktach, serwerach proxy obsługujących mikrobramy itp.) oraz zmiany wprowadzone w lokalnym pliku konfiguracji. Domyślny interwał odpytywania to 600 sekund (5 minut). Domyślne ustawienie możesz zmienić w pliku konfiguracyjnym mikrobramy w ten sposób:

edgemicro:
    config_change_poll_interval: [seconds]

Dodano informacje o wersji do interfejsu CLI

Do interfejsu CLI dodano flagę --version. Aby uzyskać bieżącą wersję Edge Microgateway, użyj tego polecenia:

edgemicro --version

Nowe opcje SSL serwera Edge Microgateway

Edge Microgateway obsługuje teraz te opcje SSL serwera oprócz key i cert:

Wysyłanie plików dziennika do stdout

Dane logowania możesz wysyłać do standardowego wyjścia za pomocą nowego ustawienia konfiguracji:

edgemicro:
  logging:
    to_console: true

Zobacz Zarządzanie plikami dziennika.

Wersja 2.1.2

Oto nowe funkcje i ulepszenia w tej wersji.

Zezwalaj na niestandardowy punkt końcowy interfejsu API na potrzeby konfiguracji

Dostępne są nowe konfigurowalne punkty końcowe dla serwera proxy autoryzacji, które obsługują korzystanie z niestandardowej usługi uwierzytelniania. Są to:

• edgeconfig:verify_api_key_url
• edgeconfig:products

Więcej informacji znajdziesz w artykule Korzystanie z niestandardowej usługi uwierzytelniania.

Wersja 2.1.1

Oto nowe funkcje i ulepszenia w tej wersji.

Wdrażanie serwera proxy uwierzytelniania zgodnego z wieloma platformami

Wprowadziliśmy ulepszenie, dzięki któremu polecenie używane do wdrażania proxy autoryzacji Edge Microgateway w Edge jest zgodne z systemami Windows.

Wersja 2.1.0

Nowe funkcje i ulepszenia w wersji 21.0

Oto nowe funkcje i ulepszenia:

Określanie opcji SSL/TLS klienta

Możesz określić opcje klienta dla połączeń SSL/TSL z miejscami docelowymi za pomocą nowego zestawu opcji konfiguracji. Zapoznaj się z sekcją Korzystanie z opcji SSL/TLS klienta.

Wersja 2.0.11

Uwaga dotycząca instalacji w wersji 2.0.11

W niektórych poprzednich wersjach Edge Microgateway można było zainstalować oprogramowanie, pobierając plik ZIP. Te pliki ZIP nie są już obsługiwane. Aby zainstalować Edge Microgateway, musisz użyć:

npm install -g edgemicro

Więcej informacji znajdziesz w temacie dotyczącym instalacji.

Nowe funkcje i ulepszenia w wersji 2.0.11

Oto nowe funkcje i ulepszenia:

Określanie portu podczas uruchamiania

Polecenie start umożliwia określenie numeru portu, który zastąpi port podany w pliku konfiguracyjnym. Możesz też określić numer portu za pomocą zmiennej środowiskowej PORT. Więcej informacji znajdziesz w sekcji polecenie start.

Opcjonalne zachowywanie nagłówków uwierzytelniania

Nowe ustawienie konfiguracji keepAuthHeader umożliwia zachowanie nagłówka autoryzacji wysłanego w żądaniu. Jeśli ma wartość Prawda, nagłówek Auth jest przekazywany do miejsca docelowego. Zobacz atrybuty oauth.

Możliwość korzystania z niestandardowej usługi autoryzacji

Jeśli chcesz używać własnej usługi niestandardowej do obsługi uwierzytelniania, zmień wartość authUri w pliku konfiguracyjnym Edge Microgateway tak, aby wskazywała Twoją usługę. Więcej informacji znajdziesz w artykule Korzystanie z niestandardowej usługi uwierzytelniania.

Wersja 2.0.4

25 maja 2016 r.opublikowano Edge Microgateway w wersji 2.0.4.

Nowe funkcje i ulepszenia w wersji 2.0.4

Oto nowe funkcje i ulepszenia w tej wersji.

Obsługa ścieżek zasobów w usługach

Edge Microgateway obsługuje teraz ścieżki zasobów w produktach. Ścieżki zasobów umożliwiają ograniczenie dostępu do interfejsów API na podstawie sufiksu ścieżki serwera proxy. Szczegółowe informacje o tworzeniu usług API i konfigurowaniu ścieżek zasobów znajdziesz w artykule Tworzenie usług API.

Obsługa globalnej instalacji npm

Możesz teraz zainstalować Edge Microgateway za pomocą opcji npm -g (global). Szczegółowe informacje o tej opcji znajdziesz w dokumentacji npm.

Wersja 2.0.0

Wersja 2.0.0 Edge Microgateway została opublikowana 18 kwietnia 2016 r.

Nowe funkcje i ulepszenia w wersji 2.0.0

Oto nowe funkcje i ulepszenia w tej wersji.

Serwer z jednym procesem

Edge Microgateway to teraz serwer z jednym procesem. Nie korzysta już z modelu dwuprocesowego, w którym jeden proces (wcześniej nazywany „agentem”) uruchamia Edge Microgateway, a drugi proces. Nowa architektura ułatwia automatyzację i konteneryzację.

Pliki konfiguracji z przestrzenią nazw

Pliki konfiguracyjne mają teraz przestrzenie nazw z użyciem organizacji i środowiska, dzięki czemu na tym samym hoście może działać wiele instancji Microgateway. Po uruchomieniu polecenia konfiguracji Edge Microgateway pliki konfiguracyjne znajdziesz w katalogu ~/.edgemicro.

Nowe zmienne środowiskowe

Obecnie są 4 zmienne środowiskowe: EDGEMICRO_ORG, EDGEMICRO_ENV, EDGEMICRO_KEY i EDGEMICRO_SECRET. Jeśli ustawisz te zmienne w swoim systemie, nie musisz podawać ich wartości podczas konfigurowania i uruchamiania Edge Microgateway za pomocą interfejsu wiersza poleceń.

Konfiguracja w pamięci podręcznej

Jeśli Edge Microgateway zostanie ponownie uruchomiony bez połączenia z Apigee Edge, użyje pliku konfiguracyjnego z pamięci podręcznej .

Tryb klastra

Dostępne są teraz opcje uruchamiania Edge Microgateway w trybie klastra. Tryb klastra umożliwia korzystanie z systemów wielordzeniowych. Mikrobrama korzysta z modułu klastra Node.js. Szczegółowe informacje znajdziesz w dokumentacji Node.js.

Poprawione błędy w wersji 2.0.0

Cykl życia zdarzenia wtyczki prawidłowo obsługuje teraz kod asynchroniczny, który zawiera kod z nowym wywołaniem zwrotnym.

Wersja 1.1.2

Wersja 1.1.2 Edge Microgateway została wydana 14 marca 2016 r.

Nowe funkcje i ulepszenia w wersji 1.1.2

Oto nowe funkcje i ulepszenia w tej wersji.

Wzrost skuteczności

Edge Microgateway używa teraz agenta HTTP Node.js w prawidłowy sposób, aby lepiej zarządzać pulą połączeń. To ulepszenie zwiększa wydajność i ogólną stabilność przy dużym obciążeniu.

Obsługa debugera zdalnego

Możesz skonfigurować Edge Microgateway tak, aby działał ze zdalnym debugerem, takim jak node-inspector.

Nowa lokalizacja pliku konfiguracyjnego

Po skonfigurowaniu Edge Microgateway plik agent/config/default.yaml jest teraz kopiowany do ~./edgemicro/config.yaml.

Rotacja plików dziennika

Nowy atrybut konfiguracji umożliwia określenie interwału rotacji logów Edge Microgateway.

Usunięte błędy w wersji 1.1.2

W wersji 1.1.2 usunięto te błędy: