19.03.01 – informacje o wersji Apigee Edge dla Public Cloud

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

We wtorek 3 grudnia 2019 r. zaczęliśmy wdrażać aktualizację tej wersji Apigee Edge na potrzeby chmury publicznej. (Pierwotna data publikacji to czwartek, 18 kwietnia 2019 r.)

Nowe funkcje i aktualizacje

Oto nowe funkcje i aktualizacje wprowadzone w tej wersji.

Identyfikator problemu Nazwa komponentu Opis
1 października 2019 r. rozpoczęliśmy wprowadzanie tych aktualizacji Apigee:
110995050 Środowisko wykonawcze interfejsu API

Równoważenie obciążenia – większa kontrola nad usuwaniem serwerów, które uległy awarii

Podczas konfigurowania równoważenia obciążenia dla serwera proxy interfejsu API możesz określić, ile błędów odpowiedzi musi wystąpić, zanim serwer zostanie usunięty z rotacji równoważenia obciążenia. Brak odpowiedzi oznacza, że Apigee nie otrzymuje żadnej odpowiedzi z serwera docelowego. W takim przypadku licznik niepowodzeń zwiększa się o 1. Gdy Apigee otrzyma odpowiedź z celu, nawet jeśli jest to błąd HTTP (np. 500), jest ona traktowana jako odpowiedź z serwera docelowego, a licznik niepowodzeń jest resetowany. Aby mieć pewność, że nieprawidłowe odpowiedzi HTTP (np. 500) również zwiększają licznik błędów i jak najszybciej wyłączają z rotacji równoważenia obciążenia nieprawidłowo działający serwer, możesz dodać do konfiguracji systemu równoważenia obciążenia nowy element <ServerUnhealthyResponse> z elementami podrzędnymi <ResponseCode>. Edge będzie też traktować odpowiedzi z tymi kodami jako nieudane.

<HTTPTargetConnection>
  <LoadBalancer>
    <Algorithm>RoundRobin</Algorithm>
    <Server name="target1" />
    <Server name="target2" />
    <ServerUnhealthyResponse>
        <ResponseCode>500</ResponseCode>
        <ResponseCode>502</ResponseCode>
        <ResponseCode>503</ResponseCode>
    </ServerUnhealthyResponse>
    <MaxFailures>5</MaxFailures>
  </LoadBalancer>
</HTTPTargetConnection>
  
  
130416715 Bezpieczeństwo

Ulepszenia zasad AccessControl

Zasada AccessControl określa, które adresy IP mogą wywoływać serwer proxy interfejsu API. Nowy element tych zasad daje programistom interfejsów API większą kontrolę nad tym, które adresy IP mają być oceniane.

<IgnoreTrueClientIPHeader>: opcjonalne (wartość domyślna to false). Jeśli ustawisz tę wartość na „true”, zasada zignoruje nagłówek True-Client-IP i oceni adresy IP w nagłówku X-Forwarded-For zgodnie z skonfigurowanym przez Ciebie sposobem oceny nagłówka X-Forwarded-For.

<AccessControl async="false" continueOnError="false"
    enabled="true" name="Access-Control-1">
    <DisplayName>Access Control-1</DisplayName>
    <IgnoreTrueClientIPHeader>true</IgnoreTrueClientIPHeader>
    ...
</AccessControl>
18 kwietnia 2019 r. zespół Apigee wprowadził te aktualizacje:
117558815,
119856499,
110548137,
79526748,
72989449,
70712859,
69049041
Środowisko wykonawcze interfejsu API JWS i JWT
Dodaliśmy nowe zasady dotyczące obsługi JWS i ulepszyliśmy dotychczasowe zasady JWT.

Więcej informacji znajdziesz w tym poście na forum społeczności.

122610025 Środowisko wykonawcze interfejsu API Zezwól na ustawianie przez RaiseFault przyczyny błędu i dowolnych zmiennych, tak jak w przypadku AssignMessage

W zasadach RaiseFault dostępne są 2 nowe elementy, które sprawiają, że obsługa FaultRules jest bardziej przejrzysta i skuteczna.

  • ShortFaultReason to wartość logiczna, która po ustawieniu na „true” umieszcza nazwę zasady w zmiennej fault.reason.
  • AssignVariable, dostępny w FaultResponse, umożliwia przypisanie odpowiedzi na błąd do zmiennej, która będzie używana przez inne zasady w przepływie proxy interfejsu API.
121149811 Hostowane miejsca docelowe Limity egzekwowane w przypadku hostowanych miejsc docelowych

W przypadku hostowanych miejsc docelowych obowiązują teraz limity. Szczegółowe informacje o limitach znajdziesz w sekcji Limity.

117659213 Środowisko wykonawcze interfejsu API Parametryzowanie zakresów adresów IP w zasadach AccessControl

Możesz teraz używać zmiennych szablonu wiadomości do ustawiania adresów IP i masek CIDR w zasadach AccessControl. Jeśli na przykład chcesz zapisać adres IP i maskę w mapie klucz-wartość (KVM), możesz pobrać te wartości ze zmiennej ustawionej w przepływie serwera proxy interfejsu API. Dzięki temu możesz łatwiej zmieniać wartości adresów IP w czasie działania bez konieczności zmiany konfiguracji zasad.

Na przykład zamiast:

<MatchRule action="DENY">
    <SourceAddress mask="24">198.51.100.1</SourceAddress>
</MatchRule>
     

Możesz skonfigurować zasadę w ten sposób, zakładając, że wartości są przechowywane w KVM, a do pobierania wartości i przypisywania ich do zmiennych pokazanych poniżej używasz zasady KeyValueMapOperations:

<MatchRule action="DENY">
    <SourceAddress mask="{kvm.mask.ref}">{kvm.ip.ref}</SourceAddress>
</MatchRule>
     
113599885 Monitorowanie interfejsów API Role w API Monitoring

Monitorowanie interfejsu API udostępnia 2 role: administrator monitorowania interfejsu API i użytkownik monitorowania interfejsu API. Więcej informacji znajdziesz w artykule Uzyskiwanie dostępu do monitorowania interfejsu API. Zostały one udostępnione w grudniu 2018 r.

132256772 Środowisko wykonawcze interfejsu API Nagłówek X-Apigee.Message-Timeout dodany do żądania

Edge dodaje teraz do każdego żądania nagłówek X-Apigee.Message-Timeout. Ten nagłówek jest przeznaczony do użytku wewnętrznego w Edge. Nie polegaj na wartościach w nagłówkach X-Apigee.* w swoich serwerach proxy interfejsu API, ponieważ te nagłówki nie są przeznaczone do użytku przez klientów i mogą zostać usunięte lub zmienione przez Apigee w dowolnym momencie.

78575018 Chmura prywatna / OPDK Pomijanie serwera zarządzającego w celu pominięcia rejestracji magazynu danych bramy, gdy jest wiele zasobników bramy

Naprawione błędy

W tej wersji naprawiliśmy te błędy: Ta lista jest przeznaczona głównie dla użytkowników, którzy chcą sprawdzić, czy ich zgłoszenia zostały rozwiązane. Nie jest on przeznaczony do dostarczania szczegółowych informacji wszystkim użytkownikom.

Identyfikator problemu Nazwa komponentu Opis
3 grudnia 2019 r. rozpoczęliśmy wdrażanie tych poprawek:
poprawki zabezpieczeń,
29 października 2019 r. rozpoczęliśmy wdrażanie tych poprawek w usłudze Apigee:
139381794 Serwer zarządzania

Obsługa błędów usuwania magazynu kluczy, aby wywołanie interfejsu API nie kończyło się niepowodzeniem

1 października 2019 r. rozpoczęliśmy wdrażanie tych poprawek:
140761319 Środowisko wykonawcze interfejsu API

x-apigee.edge.execution.sense.action jest zawsze ustawiony na wartość null

139091614 Środowisko wykonawcze interfejsu API

W zasadach ResponseCache wątek NIOThread jest wykonywany bez odrzucenia z puli wątków

131331305 Usługi podstawowe

Wielu eksporterów dzienników na routerach Apigee powoduje wysokie zużycie procesora

136690640 Środowisko wykonawcze interfejsu API

Sporadyczne błędy 404 w określonych organizacjach

140948100 Środowisko wykonawcze interfejsu API

Wdrożony przepływ współdzielony nie jest wykonywany na niektórych procesorach wiadomości

13 września 2019 r. zespół Apigee wprowadził te poprawki:
132654321 Serwer zarządzania Dzienniki kontrolne nie zawierają danych
131246911 Serwer zarządzania W przypadku adresów e-mail deweloperów w portalu włącz obsługę nowszych domen, takich jak *.games czy *.asia.
18 kwietnia 2019 r. zespół Apigee wprowadził te poprawki:
123844598 Serwer zarządzania Usuniętych kluczy aplikacji nie można ponownie zaimportować po upływie 24 godzin
123588156 Środowisko wykonawcze interfejsu API Usunięcie nagłówka Content-Length z odpowiedzi kończy się niepowodzeniem i zwraca kod 304
122732400 Środowisko wykonawcze interfejsu API Ustawienie api.timeout zastępuje io.timeout.millis
122545281 Środowisko wykonawcze interfejsu API Maska danych DebugSession dla JSON powinna uwzględniać przypadek, w którym jsonPayload jest tablicą
122355807 Serwer zarządzania Nieprawidłowe działanie uprawnień w przypadku użytkowników z wieloma rolami
121393556 Środowisko wykonawcze interfejsu API x_apigee_fault_code ma wartość „org/codehaus/jackson/map/ObjectMapper”
120998548 Interfejs Edge Błąd w komunikacie o błędzie: Cert is invalid or cannot be not be trusted
120990929 Środowisko wykonawcze interfejsu API Odpowiedź HTTP-413 z Nginx/Apigee-Router ujawnia typ serwera
120799489 Środowisko wykonawcze interfejsu API Podczas korzystania z httpClient z asynchronicznym wywołaniem zwrotnym JavaScriptu httpComplete() dane wyjściowe debugsession (trace) są wyciszone
120794339 Środowisko wykonawcze interfejsu API Drifted MPs for organization
120277011 Serwer zarządzania Wymagana weryfikacja danych wejściowych: nie można wdrożyć serwera proxy, jeśli nazwa hosta serwera docelowego zawiera **
119976417 Monitorowanie interfejsów API Monitorowanie interfejsu API pokazuje długi czas odpowiedzi proxy, a analityka – długi czas odpowiedzi docelowej
119947481 Środowisko wykonawcze interfejsu API W wyjątkowych sytuacjach ładunek do zamaskowania jest rejestrowany jako zwykły tekst
119877164 Chmura prywatna / OPDK Routery generują błędy, procesor wiadomości przechodzi w tryb offline z włączonym protokołem TLS

Poprawka zostanie uwzględniona w kolejnej wersji Edge for Private Cloud.

119816218 Środowisko wykonawcze interfejsu API Pamięć podręczna odpowiedzi ignoruje nagłówek Expires, jeśli jego wartość wynosi 0 lub jest liczbą ujemną
119770242 Środowisko wykonawcze interfejsu API Nie udało się nawiązać komunikacji między routerem a procesorem wiadomości, co spowodowało całkowitą przerwę w działaniu: błąd w PostClientFlow powoduje nieskończoną pętlę
119443145 Serwer zarządzania Serwer proxy interfejsu API zwraca błąd 404, gdy punkt końcowy proxy zostanie zmieniony i ponownie wdrożony
119260281 Środowisko wykonawcze interfejsu API Błąd w logu „Nie udało się przeanalizować jako ciągu znaków3000.0”
118743407 Serwer zarządzania Czas wdrażania serwera proxy Apigee
118447966 Środowisko wykonawcze interfejsu API Błąd w przypadku wywołań JavaScriptu w ramach MP Release 180608_07
117549719 Środowisko wykonawcze interfejsu API Niezgodność między identyfikatorem URI żądania a ścieżką podstawową serwera proxy
117219520 Środowisko wykonawcze interfejsu API MessageLogging: rejestrator Syslog używa nieprawidłowego formatu daty jako domyślnego i nieprawidłowo wyświetla milisekundy
117116435 Środowisko wykonawcze interfejsu API Sporadyczne błędy w pliku JavaScript
117091520 Środowisko wykonawcze interfejsu API Wywołania JavaCallout nie działają po wydaniu procesora wiadomości w wersji 18.06.08
116165318 Środowisko wykonawcze interfejsu API Jednoczesne wdrażanie tego samego pakietu powoduje wyjątek RepositoryException
116055025 Usługa Configstore Po uruchomieniu brakuje procesorów wiadomości, wirtualnych hostów i aplikacji
115614498 Środowisko wykonawcze interfejsu API Potrzebujesz pomocy dotyczącej ILB w OPDK

Poprawka zostanie uwzględniona w kolejnej wersji Edge dla chmury prywatnej.

113972537 Środowisko wykonawcze interfejsu API Wiele zgłoszeń o priorytecie P1 – wyjątek NullPointerException wywoływany przez kod Node.js w serwerach proxy Trireme – 500 Wewnętrzny błąd serwera
113904969 Pomoc dotycząca Apigee Problem z usuwaniem serwerów proxy interfejsu API w organizacjach demonstracyjnych
113554802 Środowisko wykonawcze interfejsu API Weryfikacja asercji SAML kończy się niepowodzeniem z błędem NullPointerException
113315737 Serwer zarządzania Nie udało się wdrożyć proxy z powodu braku rekordów wdrożenia w Zookeeperze
112767195 Środowisko wykonawcze interfejsu API Sporadyczne błędy DataStore podczas uzyskiwania dostępu do zasad KVM
112162179 Środowisko wykonawcze interfejsu API Buforowanie obiektu JavaScriptu bez przekształcania go w ciąg znaków może prowadzić do zakleszczeń
111860576 Środowisko wykonawcze interfejsu API Brak błędu w zasadach dotyczących limitów
111671525 Hostowane miejsca docelowe Kody odpowiedzi inne niż kody powodzenia z hostowanych miejsc docelowych wywołują przepływ błędów w serwerze proxy
111523933 Rozszerzenia(złącza) Problem z buforowaniem zasad ExtensionCallout
111420263 Środowisko wykonawcze interfejsu API Wyjątek ConcurrentModification w MessageLogging
110843526 Serwer zarządzania Interfejs Management API do tworzenia i aktualizowania punktu zaczepienia przepływu powinien weryfikować udostępniony przepływ
110805739 Środowisko wykonawcze interfejsu API W przypadku przepływu CPS wartość TTL nie jest ustawiona na -1, gdy parametr Reuserefreshtoken ma wartość „true”, a data ważności tokena odświeżania nie jest ustawiona wprost.
110429629 Środowisko wykonawcze interfejsu API Zasada BasicAuthentication emituje zmienną request.headers.Authorization do DebugSession
110425503 Środowisko wykonawcze interfejsu API Ponowne załadowanie Nginx powoduje problemy z dostępnością MP
110311540 Środowisko wykonawcze interfejsu API NPE podczas wyłączania MP
110161455 Środowisko wykonawcze interfejsu API W przypadku organizacji korzystających z CPS funkcja AccessEntity powinna używać metody pobierania według nazwy aplikacji zamiast pobierania wszystkich aplikacji
90695522 Środowisko wykonawcze interfejsu API context.proxyRequest.asForm generates java.lang.ArrayIndexOutOfBoundsException: 1
79734096 Serwer zarządzania Logi kontrolne dotyczące serwerów proxy nie są już filtrowane pod kątem serwerów proxy
78105568 Serwer zarządzania Po zaktualizowaniu wdrożonego współdzielonego przepływu w wywołaniach interfejsu API zarządzania /org/{org}/sharedflows/{sharedflow}/deployments nie są widoczne wdrożenia współdzielonego przepływu
77528868 Trireme Regresja Trireme: skrypt server.js został zamknięty z kodem stanu -1: nie znaleziono właściwości 0
73766568 Środowisko wykonawcze interfejsu API Uaktualnienie wersji 170213_02 do 171117_01 spowodowało ogromny wzrost opóźnienia w przypadku serwera proxy z docelowym węzłem Trireme
72710481 Środowisko wykonawcze interfejsu API CacheServiceImpl/CacheMemoryLimiter NullPointerException
68861063 Środowisko wykonawcze interfejsu API Obsługa błędu NPE podczas zamykania routerów
68833699 Środowisko wykonawcze interfejsu API Informacje o serwerze proxy interfejsu API czasami nie są usuwane z drzewa klasyfikacji interfejsów API
67377575 Hostowane miejsca docelowe Niezgodność między rekordem analitycznym a informacjami wysyłanymi do klienta w serwerze proxy Node.js
112481174 Hostowane miejsca docelowe Nie wycofuj wdrożenia proxy z powodu błędu Turbo
117171470 Hostowane miejsca docelowe Rozwiązywanie problemów z komunikatem o błędzie dotyczącym nieprawidłowego pliku app.yaml
67169139 Środowisko wykonawcze interfejsu API Format sygnatury czasowej syslog w zasadach MessageLogging jest nieprawidłowy
67165418 Środowisko wykonawcze interfejsu API Błąd licencji dotyczący używania większej liczby procesorów wiadomości, nawet jeśli używana jest mniejsza liczba niż licencjonowana

Poprawka zostanie uwzględniona w kolejnej wersji Edge dla chmury prywatnej.

67165195 Środowisko wykonawcze interfejsu API Funkcja ValidateSAMLAssertion nie weryfikuje podpisu w asercji osadzonej w podpisanej odpowiedzi
66214414 Środowisko wykonawcze interfejsu API Zmienna currentstep.flowstate zawsze zwraca wartość „SHARED_FLOW”, gdy jest używana w współdzielonym przepływie
65731656 Środowisko wykonawcze interfejsu API Interfejs API ochrony przed zagrożeniami okresowo zawodzi w przypadku tego samego żądania
133197060 Środowisko wykonawcze interfejsu API Otrzymywanie z MP do miejsca docelowego kodu 57 Gateway timeout
110535186 Środowisko wykonawcze interfejsu API ServiceCallout bez elementu Response i HTTPTargetConnection wskazujący na serwer proxy: CZASAMI brak wywołania
132443137 Środowisko wykonawcze interfejsu API Zmień działanie procesora wiadomości, aby ignorował nagłówki zaczynające się od znaku X-Apigee-*. W związku z tym musisz zmodyfikować każdy kod, który używa X-Apigee-*nagłówków, i zastąpić je obsługiwanymi nagłówkami.
125709964 Środowisko wykonawcze interfejsu API Unieważnianie pamięci podręcznej za pomocą funkcji purgeChildEntries nie działa zgodnie z oczekiwaniami