Przeglądasz dokumentację Apigee Edge.
Przejdź do
Dokumentacja Apigee X. informacje.
W tych dniach zaczęliśmy publikować aktualizacje komponentów Apigee Edge dla Cloud Public Cloud:
- Podmiot przetwarzający wiadomości: piątek, 1 maja 2020 r.
- Zarządzanie interfejsami API: poniedziałek, 20 kwietnia 2020 r.
- Zarządzanie zarabianiem: poniedziałek, 20 kwietnia 2020 r.
- Wersja poprawki do zarządzania interfejsami API: poniedziałek, 22 czerwca 2020 r.
- Aktualizacja poprawki do zarządzania zarabianiem: poniedziałek, 6 lipca 2020 r.
- Aktualizacja zabezpieczeń serwera zarządzania: poniedziałek, 24 sierpnia 2020 r.
- Wersja poprawki procesora wiadomości z poprawkami błędów: czwartek, 24 września 2020 r.
- Wersja poprawki procesora wiadomości z poprawkami błędów: poniedziałek, 26 października 2020 r.
- Wersja poprawki procesora wiadomości z poprawkami błędów: poniedziałek, 1 lutego 2021 r.
Nowe funkcje i aktualizacje
Poniżej znajduje się lista nowych funkcji i aktualizacji wprowadzonych w tej wersji.
Zasady JWT
-
Szyfrowanie JWT
Zasady JWT pozwalają generować, weryfikować i dekodować zaszyfrowane tokeny. Nowe żywioły dotyczące zasad to między innymi:
<Type>
– pozwala określić, czy tokeny mają być podpisane czy zaszyfrowane.<EncryptionAlgorithms>
– pozwala ustawić<Key>
i<Content>
algorytmów szyfrowania.
(67165581)
Obsługa algorytmów PSS w podpisanych tokenach
Zasady generowania i weryfikacji tokenów JWT i JWS obsługują teraz PS256, PS384, i algorytmy PS512, jak opisano w IETF RFC 7518. (119856499)
Względny czas rozpoczęcia generowania JWT dla tokena
Podczas generowania tokena JWT za pomocą zasady generowania JWT Element
<NotBefore>
pozwala możesz określić czas względny, który upływa od momentu wygenerowania tokena do chwili, gdy stanie się on ważny. Na przykład wartość<NotBefore>
o wartości 2h oznacza, że token nie jest ważny do 2 godziny od jego wygenerowania. Możesz ustawić<NotBefore>
raz w: milisekundy (ms), sekundy (s), minuty (m), godziny (h), dni (d) lub tygodnie (W). (126261970)-
Odniesienie do klucza publicznego/certyfikatu w VerifyJWT
W zasadzieVerifyJWT tag
<PublicKey>
/ Element<Certificate>
pozwala odwołać się certyfikat w formacie PEM, który służy do weryfikowania przychodzących podpisów JWT. Na przykład:<PublicKey> <Certificate ref='public.certificate_pem'/> </PublicKey>
(132918033)
Funkcje szablonów wiadomości
Obserwowane są nowe elementy funkcji szablonów wiadomości dostępnych w tej wersji:
- firstnonull – zwraca wartość pierwszego (pierwszego od lewej) argumentu niepustego. (139698514)
- xpath – pozwala zastosować wyrażenie ścieżki XML (XPath) do analizy zmiennych XML. (123246424)
Zasada AssignMessage: funkcja AssignAttribute umożliwia odwoływanie się do szablonu wiadomości.
W zasadzie AssignMessage para klucz-wartość
Element <AssignVariable>
/ <Template>
zezwala
ref
, który umożliwia wstrzyknięcie wstępnie zdefiniowanego szablonu w czasie działania
bez konieczności modyfikowania zasad. (118396082)
Wiele aliasów certyfikatów
Gdy
skonfigurowanie TLS i używanie wielu certyfikatów w magazynie kluczy, z których każdy
jako inny alias, Edge umożliwia odwoływanie się do określonych aliasów certyfikatów
Konfiguracja <SSLInfo><KeyAlias>
. Aby włączyć to zaktualizowane działanie,
ustaw nową właściwość HTTPClient.choose.alias.by.keyalias
na „true” w pliku http.properties w procesorach wiadomości. Edge dla użytkowników chmury publicznej
musi skontaktować się z
pomocy, aby dodać tę usługę. (142141620)
Zasada JSONtoXML: pomiń deklarację XML, dodaj wcięcie wyjściowe
Dwie nowe opcje wartości logicznej w zasadzie JSONtoXML dają Ci większą kontrolę nad kodem XML dane wyjściowe.
<Options> <OmitXmlDeclaration>
– gdy ma wartość Prawda (wartość domyślna to fałsz), element<OmitXmlDeclaration>
pomija domyślnie<?xml version="1.0" encoding="UTF-8"?>
Deklaracja XML wygenerowana przez zasadę.<Options> <Indent>
– gdy ma wartość Prawda (wartość domyślna to false), element<Indent>
dodaje wcięcia do danych wyjściowych XML. Na przykład zamiast tych danych wyjściowych:<Array><n>1</n><n>2</n><n>3</n></Array>
Element Wcięcie generuje:
<Array> <n>1</n> <n>2</n> <n>3</n> </Array>
(65142394)
Odpowiedzi na temat skanowania hostów wirtualnych
Jeśli wysłano żądanie do adresu IP punktu końcowego Apigee (nie określono hosta wirtualnego), Edge zwróciła odpowiedź HTTP 200 i pusty dokument HTML z domyślnego Apigee hosta wirtualnego powiązanego z tym adresem IP. Aby uniknąć błędnego wyświetlenia, taka odpowiedź może stanowić potencjalną lukę w zabezpieczeniach, którą można wykorzystać, połączenie zostanie przerwane i nie zostanie zwrócona żadna odpowiedź. (140005396)
Właściwości serwera docelowego w Trace ułatwiające rozwiązywanie problemów
Te nowe właściwości śledzenia ułatwiają rozwiązywanie problemów z połączeniem docelowym przez
pokazując, czy klient HTTPClient serwera docelowego został zapisany w pamięci podręcznej:
isHttpClientCached
i isFromClientPool
. (140574604)
Zasada MessageLogging: komunikat syslog
W zasadach MessageLogging znajdziesz nowy
<Syslog>
na <PayloadOnly>
element
(wartość logiczna) pozwala określić, czy treść ma być automatycznie dodawana na początku
do zdefiniowanego przez Ciebie <Message>
. Jeśli ustawisz
<PayloadOnly>
to prawda. Nic nie jest dołączane do
definicji wiadomości (niezależnie od <FormatMessage>
). Jeśli zasada ma wartość Fałsz (domyślnie),
Ustawienie <FormatMessage>
określa, co zostanie dołączone
do komunikatu logu. (68722102)
Wygaśnięcie zasad dotyczących pamięci podręcznej
Nowy element wygaśnięcia <TimeoutInSeconds>
w
Zasada ResponseCache i zasada PopulationCache
działa tak, jak istniejący element <TimeoutInSecs>
która miała działać. Użyj nowego elementu.
Wycofany atrybut <TimeoutInSecs>
wciąż istnieje na potrzeby zgodności wstecznej. Jeśli zarówno
<TimeoutInSecs>
i <TimeoutInSeconds>
Liczba skonfigurowanych elementów: <TimeoutInSeconds>
. (119172893)
Zmienna przepływu wirtualnego host.aliases.values
Nowy przepływ wiadomości w usłudze virtualhost.aliases.values
tylko do odczytu
zwraca tablicę w formacie JSON wszystkich aliasów przypisanych do funkcji
hosta wirtualnego, który został wywołany w żądaniu przychodzącym. (128453178)
Nowy parametr zapewniający usunięcie wersji serwera proxy
Do funkcji force
został dodany nowy parametr zapytania
usunięcie wersji serwera proxy API.
W przypadkach, gdy wersja jest wymieniona w interfejsie List API Proxies API
ale nie może być wykonywane zapytanie, ten parametr zapewnia usunięcie wersji serwera proxy. (111691721)
Na przykład:
DELETE /v1/organizations/myorg/apis/myproxy/revisions/2?force=true
Nowa zmienna procesu dla wartości aliasów wirtualnego hosta
Nowa zmienna przepływu wiadomości virtualhost.aliases.values
(tylko do odczytu) zwraca dane w formacie JSON
tablica wszystkich aliasów przypisanych do hosta wirtualnego, który został wywołany w żądaniu przychodzącym. (128453178)
Usunięto błędy
W tej wersji poprawiono następujące błędy. Ta lista jest przeznaczona głównie dla użytkowników sprawdzających aby sprawdzić, czy jego zgłoszenia zostały rozwiązane. Nie zapewnia on szczegółowych informacji dla wszystkich użytkowników.
Identyfikator problemu | Nazwa komponentu | Opis |
---|---|---|
143313772 | procesor komunikatów |
Naprawiono błąd w zasadzie SpikeArrest, który występował,
Usługa (W wersji poprawki z 1.02.2021 r.) |
154428338 | Środowisko wykonawcze API |
Procesor wiadomości nie wczytuje środowisk, gdy skonfigurowane są magazyny kluczy o podobnych nazwach lub aliasach. Naprawiliśmy konflikt wyszukiwania wyrażeń regularnych podczas wczytywania magazynów kluczy o podobnych nazwach i konwencją. Powodowało to, że nie udało się wczytać środowisk procesora wiadomości powiązane z magazynem kluczy lub nie uruchamiają się, gdy jest kilka magazynów kluczy powodujących konflikty które zostały zwrócone podczas wyszukiwania. |
149507805 | Zarządzanie interfejsami API |
Włączanie wdrażania/konfiguracji przez HTTP na wszystkich produkcyjnych serwerach MGMT Aktualizacje konfiguracji są przeprowadzane przez HTTP zamiast RPC, co zwiększa niezawodność i rejestrowanie błędów. |
137217974 | Zarządzanie interfejsami API |
Podczas konfigurowania MP przez HTTP, propaguj błąd, gdy serwer docelowy jest nadal w użyciu W związku z poprawkami niezawodności wprowadzonymi w numerze 149507805 błędy odpowiedzi związane z usunięciem serwera docelowego były błędnie zgłaszane jako stan 200 (powodzenie), jeśli usunięcie nie powiodło się. Po wprowadzeniu tej poprawki w przypadku niepowodzenia usunięcia są teraz prawidłowo zgłaszane jako stan 400. Pamiętaj, że usunięcie serwera docelowego może się nie powieść, jeśli do którego odwołuje się obecnie wdrożony serwer proxy. Przed usunięciem celu serwer, sprawdź, czy do serwera docelowego nie odwołują się żadne Serwery proxy interfejsów API, które są obecnie wdrożone. |
69765558 | Zarządzanie interfejsami API |
Interfejs Resource Permissions API zwraca błąd 403 |
149545506 | Zarządzanie interfejsami API |
Rozwiązuje problem z zabezpieczeniami interfejsu API związany z dodawaniem użytkownika do roli. |
131246911 | Zarządzanie interfejsami API |
W przypadku adresów e-mail programistów w portalu włącz obsługę nowszych domen, takich jak *.games, *.asia
Rozwiązaliśmy problem, który powodował, że niektóre nazwy domen, takie jak |
142217645 | Zarządzanie interfejsami API |
PUT v1/o/{org_name}/apiproducts/{product_name} – nie usuwa limity |
162299668 | Serwer zarządzania |
Potencjalna luka w zabezpieczeniach została usunięta. |
135856488 | Serwer zarządzania |
Powolne działanie interfejsu |
139407965 | Serwer zarządzania |
Rozwiązaliśmy problem, który umożliwiał utworzenie KVM bez nazwy. |
112488235 | Serwer zarządzania |
Dodaliśmy weryfikację, aby uniemożliwić tworzenie hostów wirtualnych za pomocą spacje w nazwie. W nazwach hostów wirtualnych nie można używać spacji. |
132433193 | Zarządzanie zarabianiem |
Rozwiązaliśmy problem z aktualizacją aplikacji. |
152514520 | Zarządzanie zarabianiem |
Rozwiązaliśmy problem z wywołaniami interfejsu zarządzania interfejsami API dotyczącymi usuwania encji. |
128450374 | Środowisko wykonawcze API |
Zasady JWT/JWS powinny uwzględniać ignorowane zmienne nierozwiązane – powoduje zgłoszenie błędu jeśli zmienna nie jest zdefiniowana |
135354517 | Środowisko wykonawcze API |
Organizacja nie spełnia wymagań Release_190301 z powodu rygorystycznego egzekwowania zasad dotyczących ciągu znaków typ danych w BasicAuth |
131763486 | Środowisko wykonawcze API |
Procesor wiadomości powinien zignorować ścieżkę podstawową udostępnianego przepływu. |
135972575 | Środowisko wykonawcze API |
Private Cloud w wersji 4.19.01 wykazuje inne zachowanie podczas wdrażania z ustawieniem override=true&delay=300 Ta poprawka zostanie uwzględniona w przyszłej wersji Edge dla Private Cloud. |
141601836 | Środowisko wykonawcze API |
Poprawianie nazwy hosta w komunikacie logu |
116834109 | Środowisko wykonawcze API |
Nieprawidłowe wartości parametrów fault.cause, fault.cause i fault.name w Trace |
130653816 | Środowisko wykonawcze API |
Sporadyczne błędy 404 w ruchu w czasie działania |
132777537 | Środowisko wykonawcze API |
Błąd zasadyWyodrębnianie zmiennych w przypadku prawidłowej ścieżki JSONPath |
133713555 | Środowisko wykonawcze API |
Nagłówek daty zmiany routera brzegowego |
133253435 | Środowisko wykonawcze API |
Wysokie wykorzystanie procesora przez wątek główny Apigee |
111553402 | Środowisko wykonawcze API |
Usługa API z nieprawidłowymi znakami w ścieżce nieprzechwyconej do czasu działania |
126240341 | Środowisko wykonawcze API |
Poprawianie ogólnego komunikatu „Nie udało się wygenerować” komunikat o błędzie utworzenia zasady JWT |
119854424 | Środowisko wykonawcze API |
System równoważenia obciążenia z jednym serwerem docelowym nie powinien być nieaktywny w przypadku błędu połączenia |
129275412 | Środowisko wykonawcze API |
Dodawanie nagłówków HTTP do zastępczego hosta wirtualnego na potrzeby ogólnych skanowań adresów IP |
129351507 | Środowisko wykonawcze API |
Zasada uwierzytelniania Basic nie dekoduje, jeśli hasło zawiera dwukropek |
65852874 | Środowisko wykonawcze API |
Dopilnuj, aby HTTPClient nie próbował ponownie użyć połączenia z aplikacją Connection:close nagłówek odpowiedzi |
138951646 | Środowisko wykonawcze API |
Limit czasu nie działa w JavaScripcie w przypadku |
139051927 | Środowisko wykonawcze API |
Duże opóźnienie przetwarzania żądań |
132443137 | Środowisko wykonawcze API |
Zmiana działania procesora wiadomości w celu obsługi nieznanych wewnętrznych nagłówków x-apigee |
138310777 | Środowisko wykonawcze API |
Wywołanie wdrożenia przepływu współdzielonego losowo zwraca błąd 504 |
67170148 | Środowisko wykonawcze API |
Różnice między czasem upływu czasu a czasem realizacji w objaśnieniach dotyczących usługi |
124049692 | Środowisko wykonawcze API |
NullPointerException w zasadach VerifyApiKey |
135031506 | Środowisko wykonawcze API |
Dodaj komunikat logu w przypadku nieoczekiwanego formatu klucza JWT |
137312366 | Środowisko wykonawcze API |
Sprawdzanie poprawności treści według nagłówka Content-Type |
109871907 | Środowisko wykonawcze API |
Opóźnienia wykonywania wywołań usługi bez elementu Response |
143722867 | Środowisko wykonawcze API |
JWT musi egzekwować konfigurowalny limit liczby iteracji dla PBKDF2 |
144286363 | Śledzenie hybrydowe |
Maska debugowania w pliku env.json nie maskuje danych odpowiedzi w środowisku hybrydowym Apigee |
147769812 | Środowisko wykonawcze API |
Deklarowanie właściwości skrótu OAuth jako zmienne w flagach funkcji |
149037704 | Środowisko wykonawcze API |
Rozwiązaliśmy problem, który powodował, że wartość przypisana do zmiennej procesu |
148972262 | Środowisko wykonawcze API |
DecodeJWS wysyła ładunek do zmiennej kontekstu w postaci bezużytecznej |
116580622 | Środowisko wykonawcze API |
Niespójna odpowiedź |
149739904 | Środowisko wykonawcze API |
Maskowanie danych w nagłówkach HTTP nie powinno uwzględniać wielkości liter |
149431545 | Środowisko wykonawcze API |
Funkcje GenerateJWT i VerifyJWT z SecretKey nie akceptują kodowania innego niż UTF-8 |
155448596 | Zarządzanie interfejsami API – poprawka |
Brak uprawnień do domyślnej roli apimonitoringadmin Do roli apimonitoringadmin dodano brakujące uprawnienia. |
158592076 | Zarządzanie interfejsami API – poprawka |
Brak uprawnień do domyślnej roli devadmin Do roli devadmin dodano brakujące uprawnienia. |
152856311 | Zarządzanie interfejsami API – poprawka |
Weryfikacja odrzucania certyfikatów PKCS7 i DER w magazynie kluczy i magazynie zaufania podczas tworzenia i aktualizacji hosta wirtualnego Podczas tworzenia lub aktualizacji hosta wirtualnego weryfikacja jest wymuszana w celu sprawdź, czy certyfikaty dodane w aliasie magazynu kluczy i magazynie zaufania są w PEM a nie niezgodnych formatów, takich jak PKCS7, DER itp. |
155478545 | Poprawka w zarządzaniu zarabianiem |
Rozwiązaliśmy problem z aktualizacjami stanu e-maili z powiadomieniami. |
154121499 | Poprawka w zarządzaniu zarabianiem |
Problem polegający na tym, że interfejs API |
152356393 | Poprawka w zarządzaniu zarabianiem |
Weryfikacja długości nazwy firmy nie naruszała zasad generowania przychodu i w efekcie utworzenia firmy. |
138542921 | Poprawka w zarządzaniu zarabianiem |
Rozwiązano problem polegający na tym, że nie można było utworzyć planu stawek w przypadku kilku atrybutów niestandardowych w pakiecie produktów. |
150948843 | Poprawka w zarządzaniu zarabianiem |
Rozwiązaliśmy problem, który powodował, że w interfejsie Monetization |
155443118 | Poprawka w zarządzaniu zarabianiem |
Pole |
150948843 | Poprawka w zarządzaniu zarabianiem |
Rozwiązaliśmy problem, który powodował, że w interfejsie Monetization |