Przeglądasz dokumentację Apigee Edge.
Przejdź do
Dokumentacja Apigee X. informacje.
We wtorek 8 września 2015 roku opublikowaliśmy dużą wersję funkcji Apigee Edge dla prywatnych Google Cloud.
Od poprzedniej kwartalnej wersji Edge for Private Cloud (4.15.04.00) wprowadziliśmy Liczba nowych wersji, które są uwzględnione w tym kwartalnym wydaniu:
Na które wersje Edge możesz przejść 4.15.07.00
W zależności od używanej wersji Edge możesz:
- Bezpośrednio przejdź na wersję 4.15.07.00
- stopniowe uaktualnianie, co oznacza konieczność uaktualnienia aktualnej wersji do innej. Edge, a następnie uaktualnij ją do wersji 4.15.07.00.
Więcej informacji znajdziesz w artykule Na którą wersję Edge for Private Cloud możesz przejść 4.15.07.00.
Przed aktualizacją z wersji 4.15.01.x lub wcześniejszej wersji
- Sprawdź wersję systemu Cassandra SSTable:
- Zmień katalog na /<install-root>/apigee4/data/cassandra/data.
- Uruchom polecenie znajdowania (
) > Znajdź . -name *-ic-*
Jeśli korzystasz z Cassandra 1 .2 SSTable, wyniki powinny zwrócić zestaw plików.db. - Uruchom to polecenie znajdowania:
> Znajdź . -name *-hf-*
Wyniki powinny być puste, co oznacza, że żaden plik .db nie jest w formacie hf. Jeśli nie widzisz żadnych plików w hf, można zaktualizować do wersji 4.15.07.00.
Format hf jest przeznaczony dla Cassandra 1.0 SSTables. Jeśli masz pliki *.db w formacie hf, musisz uaktualni SSTable w sposób opisany w dalszej części tej procedury.
- Jeśli znajdziesz pliki *.db w formacie hf, uaktualnij SSTable
przez uruchamianie następującego polecenia w każdym węźle Cassandra, dopóki nie uaktualnisz wszystkich węzłów Cassandra
węzły:
/<install-root>/apigee4/share/apache-cassandra/bin/nodetool -h localhostUpgradesstables –A - Powtórz krok 1, aby sprawdzić, czy wszystkie pliki *.db są w formacie ic dla systemu Cassandra 1.2. wersji.
- Powtórz kroki od 1 do 3 w każdym węźle Cassandra w instalacji Edge.
- Uaktualnij do wersji Edge 4.15.07.00.
- Po uaktualnieniu do wersji 4.15.07.00 sprawdź pliki *.db, by upewnić się, że wszystkie zostały uaktualnione
do wersji stabilnej w stylu C* 2.0:
> cd /<install-root>/apigee4/data/cassandra/data
> Znajdź . -nazwa *-jb-*
Jeśli korzystasz z systemu Cassandra 2 .0, polecenie to powinno zwrócić zestaw plików.db.
Nowe funkcje i ulepszenia
Poniżej przedstawiamy nowe funkcje i ulepszenia wprowadzone w tej wersji.
Instalacja i aktualizacja
Wybiórcze uaktualnianie i odinstalowanie komponentów
Skrypty apigee-upgrade.sh i apigee-uninstall.sh umożliwiają teraz wybór komponentów Edge aby go uaktualnić lub odinstalować. Wcześniej uaktualnił lub odinstalował wszystkie komponenty w węźle. (OPDK-1377, OPDK-1175)
Przywrócenie uaktualnienia
Jeśli podczas uaktualnienia plik apigee-upgrade.sh przestanie działać, możesz skorzystać z pliku apigee-rollback.sh skrypt cofania uaktualnienia. Gdy rozwiążesz problemy z uaktualnieniem, możesz spróbować ponownie. (OPDK-1275)
Skrócone opcje skryptu instalatora
Skrypty instalacyjne nie używają już długich opcji, takich jak --help. Teraz tylko oni wybierz opcje jednoliterowe, na przykład -h. (OPDK-1356)
Instalacja SmartDocuments
Podczas instalowania Dokumentów SmartDocuments przy użyciu skryptu setup-smartdocs.sh pojawi się prośba o wpisanie organizacji, środowiska i hosta wirtualnego, dzięki czemu aplikacja SmartDocuments oczekiwaną lokalizację. Wcześniej te wartości były zakodowane na stałe w skrypcie. (OPDK-1310)
Uruchamianie pliku update-cass-pwd-in-config.sh bez promptów
Skrypt update-cass-pwd-in-config.sh może być uruchamiany bez monitów, jeśli ustawisz w parametrze Zmienne środowiskowe ENABLE_CASS_AUTH, CASS_USERNAME i CASS_PASSWORD. (OPDK-1309)
Platforma brzegowa
Oto nowe funkcje platformy Edge dostępne w tej wersji.
OpenJDK 1.7 obsługiwany przez Edge Private Cloud
Ta wersja Edge obsługuje Oracle JDK 1.7 i OpenJDK 7 oraz obsługuje pakiet JDK 1.6. (OPDK-1187)
Obsługa systemu operacyjnego
Apigee Edge dla Private Cloud obejmuje teraz obsługę systemu operacyjnego Red Hat Enterprise Linux 6.6 i 7.0 (64-bitowa), CentOS 6.5, 6.6 i 7.0 (64-bitowa) i Oracle Linux 6.5
Cassandra 2.0.15 w pakiecie OPDK 15.07
Ta wersja instaluje Cassandra 2.0.15. Jeśli przeprowadzasz uaktualnienie do poprzedniej wersji, wersji Cassandra zostanie zaktualizowana. (OPDK-1197)
Obsługa szyfrowania SHA2 w przypadku haszowania tokenów OAuth.
Aby lepiej chronić tokeny OAuth w przypadku naruszenia bezpieczeństwa bazy danych, Edge obsługuje SHA2. do szyfrowania tokenów OAuth (oprócz SHA1). Z nowym poziomem organizacji możesz włączyć i skonfigurować szyfrowanie dla nowych tokenów oraz zachować starsze metody haszowania. na wszystkich tokenach, które istniały przed wprowadzeniem tej funkcji. Wcześniej w Edge dla Private Cloud o nazwie hash.oauth.tokens.enabled w pliku keymanagement.properties (na koncie serwer zarządzania i firmy przetwarzające wiadomości) włączyły automatyczne szyfrowanie SHA1 tokenów OAuth. Ten została wycofana.
Jeśli wcześniej do włączenia szyfrowania SHA1 została użyta właściwość hash.oauth.tokens.enabled, skrypt uaktualniania tej wersji automatycznie generuje dla Ciebie nowe właściwości na poziomie organizacji. Do Sprawdź po uaktualnieniu, wykonaj metodę GET jako administrator systemu za pomocą tego interfejsu API: https://{host}:{port}/v1/o/{your_org}.
- Informacje o włączaniu haszowania tokenów w organizacji z użyciem nowych właściwości znajdziesz w artykule „Haszowanie tokenów w bazie danych” w sekcji Prośba o tokeny dostępu temat.
- Informacje o zbiorczym haszowaniu istniejących tokenów znajdziesz na stronie Edge for Private Cloud Przewodnik po korzystaniu z usługi. (APIRT-1389)
Płaska struktura katalogów na pliki dziennika
Możesz skonfigurować Edge tak, aby pliki dziennika były przechowywane w płaskiej strukturze katalogów, ustawiając nowy
enable.flat.directory.structure
ma wartość true (prawda) w message-logging.properties
. Więcej informacji znajdziesz w artykule o zasadach rejestrowania wiadomości.
(APIRT-1394)
Wydajność pamięci podręcznej środowiska
Aby zapewnić lepsze wykorzystanie pamięci podręcznej i zarządzanie nią, kolumna „Maksymalna liczba elementów w pamięci” ustawienia zasobów pamięci podręcznej środowiska zostały wycofane. łączna liczba elementów w wszystkich zasobów pamięci podręcznej (w tym domyślnej pamięci podręcznej) zależy od łącznej pamięci przydzielonej do pamięci podręcznej. Domyślnie łączna ilość pamięci przydzielonej do buforowania w pamięci przez dany procesor wiadomości to 40% łącznej dostępnej pamięci, zgodnie z ustawieniami właściwości pamięci podręcznej w wiadomości procesora. Elementy są usuwane z pamięci podręcznej tylko wtedy, gdy istnieje za mało pamięci podręcznej lub elementy tracą ważność.
Aby wrócić do starego sposobu korzystania z ustawienia „Maksymalna liczba elementów w pamięci” usługa dla
zarządzania pamięcią podręczną, ustaw właściwość overrideMaxElementsInCacheResource=false
w
Cache.properties (APIRT-1140)
Usługi API
Poniżej przedstawiamy nowe funkcje usług interfejsu API zawarte w tej wersji.
Nowy edytor proxy jako domyślny
Nowy edytor serwera proxy interfejsu API jest domyślnie włączony w interfejsie zarządzania. Nowy edytor zawiera łatwiejszą obsługę, w tym bardziej kompleksowe spojrzenie na przepływy warunkowe, punktów końcowych na stronie Przegląd, wszystkie konfiguracje na stronie Programowanie, bardziej intuicyjne dodawanie przepływy warunkowe, punkty końcowe i zasady, pełniejsze widoki XML zamiast krótkich fragmentów, które indeksuje nazwy plików, tekst itp. (MGMT-2279)
Nowa zasada „Usuń informacje” dotycząca protokołu OAuth 2.0
Nowe okno „Usuń informacje o protokole OAuth v2.0” zasada pozwala usuwać tokeny dostępu i autoryzację OAuth v2 kodami. Ta zasada zastępuje funkcje udostępnione wcześniej przez interfejs API do zarządzania. Więcej informacje można znaleźć w sekcji Usuwanie Zasady dotyczące informacji protokołu OAuthV2 (MGMT-2257)
Nowa zasada „Usuń informacje” dotycząca protokołu OAuth 1.0
Nowe okno „Usuń informacje o protokole OAuth v1.0” pozwala usuwać tokeny żądań OAuth v1.0, dostęp tokeny i kody weryfikatora. Zasada zastępuje funkcje udostępnione wcześniej przez do zarządzania interfejsami API. Więcej informacji znajdziesz w artykule Usuwanie zasady dotyczącej informacji o protokole OAuth V1. (APIRT-1351)
Zasada kontroli dostępu
Zasada kontroli dostępu została rozszerzona, aby umożliwić bardziej szczegółową ocenę adresów IP
do tworzenia list dozwolonych i odrzuconych, gdy adresy IP
Nagłówek HTTP X-FORWARDED-FOR
.
Po włączeniu sprawdzania wielu adresów IP w nagłówku (aby ustawić
features.enableMultipleXForwardCheckForACL),
nowy element <ValidateBasedOn>
w zasadzie umożliwia sprawdzenie
pierwszy adres IP, ostatni adres IP lub wszystkie adresy IP w nagłówku. Więcej informacji znajdziesz w artykule na temat zasad kontroli dostępu.
Nowe encje w zasadach dotyczących jednostek dostępu
Zasada dotycząca dostępu zapewnia dostęp do tych nowych elementów: Consumerkey-scopes, kodu autoryzacji, tokena żądania i weryfikatora. Więcej informacji znajdziesz w artykule Zasady dotyczące jednostek dostępu.
Zasada kolektora statystyk: automatyczna konwersja nazwy statystyk na małe litery
Podczas tworzenia niestandardowej kolekcji danych analitycznych w edytorze serwera proxy interfejsu API (strona Programowanie > Narzędzia) > Niestandardowa kolekcja Analytics), zmienna kolektora (statystyka) „Nazwa” musi być zapisana małymi literami. Jeśli wpiszesz nazwę zapisaną wielkimi literami, narzędzie automatycznie przekonwertuje nazwę statystyczną w zasadzie kolektora statystyk. (MGMT-740)
Usunięcie klasycznego śledzenia w edytorze proxy interfejsu API
Najnowsza wersja funkcji Trace w edytorze serwera proxy interfejsów API została przeniesiona z wersji beta do powszechnej dostępności. Dostęp do „klasycznego logu czasu” z opcją „Dostęp do klasycznej wersji logu czasu” Link nie jest już dostępny.
Dostęp do społeczności Apigee z menu pomocy interfejsu zarządzania
Dostęp do społeczności Apigee możesz uzyskać w menu pomocy interfejsu zarządzania.
Komunikaty o błędach w interfejsie zarządzania
Poniżej znajdziesz ulepszenia komunikatów o błędach w interfejsie zarządzania:
- interfejs zarządzania używany do grupowania i wyświetlania wszystkich komunikatów o błędach w całym interfejsie o ile ich nie zostały zamknięte. Dzięki tej aktualizacji komunikaty o błędach są usuwane automatycznie, kiedy opuścisz stronę, na której się pojawiły. (MGMT-2254)
- Interfejs zarządzania nie ukrywa już zduplikowanych komunikatów o błędach. (MGMT-2242)
Ulepszenia wydajności interfejsu i błędów
Wprowadziliśmy ogólne ulepszenia w różnych obszarach interfejsu zarządzania, w tym w wyświetlaniu stron. jak zwiększyć skuteczność reklam i komunikaty o błędach.
Hiperłącza ról na stronie Użytkownicy organizacji w interfejsie zarządzania
Na stronie Użytkownicy organizacji w interfejsie zarządzania (Administracja > Użytkownicy organizacji) – mają teraz hiperlinki, co pozwala szybko przechodzić do stron ról. (MGMT-1055)
Nowe zmienne docelowe w przepływie wiadomości
Nowe zmienne w przepływach wiadomości dostarczają bardziej szczegółowe informacje o adresach URL docelowych punktów końcowych serwery docelowe:
-
Docelowy punkt końcowy:
request.url
zastępujetarget.basepath.with.query
. -
Serwer docelowy:
loadbalancing.targetserver
zastępujetargetserver.name
. Poletarget.basepath
jest wypełniane tylko wtedy, gdy Element<Path>
jest używany w parametrze TargetEndpoint Element HTTPTargetConnection<LoadBalancer>
.
Obsługa rozszerzenia SNI (Server Name Indication)
Edge obsługuje stosowanie wskaźnika nazwy serwera (Server Name Indication) w kierunku południowym (od procesora wiadomości do środowiska docelowego punkty końcowe). Jeśli chcesz używać SNI, skontaktuj się z zespołem pomocy Apigee.
Wymagana jest wersja Java 1.7.
Dzięki SNI, który jest rozszerzeniem protokołu TLS/SSL, można udostępniać wiele celów HTTPS w tym samym miejscu Adres IP i port bez konieczności używania tego samego certyfikatu przez wszystkie środowiska docelowe.
Konfiguracja Edge nie jest wymagana. Jeśli środowisko jest skonfigurowane pod kątem południa SNI (domyślnie chmura Edge), Edge ją obsługuje.
Edge automatycznie wyodrębnia nazwę hosta z adresu URL żądania i dodaje go do żądania uzgadniania połączenia SSL. Jeśli np. host docelowy to https://example.com/request/path, Edge dodaje rozszerzenie server_name zgodnie z przykładem. poniżej:
Więcej informacji na temat rozszerzenia SNI znajdziesz na stronie http://en.wikipedia.org/wiki/Server_Name_Indication (Wskazanie_nazwy_serwera).
„Algorytm podpisu” w szczegółach certyfikatów SSL
Nowy algorytm podpisu do szczegółów certyfikatu SSL, które są widoczne w interfejsu zarządzania (Administracja > Certyfikaty SSL) i interfejsu API do zarządzania (Pobierz (szczegóły certyfikatu z magazynu kluczy lub Truststore)). Pole zawiera wartość „sha1WithRSAEncryption”. lub „sha256WithRSAEncryption” w zależności od typu algorytmu haszowania używanego do wygenerowania certyfikat.
Wyświetlam certyfikaty SSL, które niedługo wygasną
Strona Certyfikaty SSL w interfejsie zarządzania (Administracja > Certyfikaty SSL) wskazuje, kiedy Ważność certyfikatu SSL wygaśnie w ciągu 10, 15, 30 lub 90 dni, w zależności od wyboru nowe pole wyboru daty ważności.
Konfiguracja błędu ochrony przed zagrożeniami
Domyślnie Edge wysyła kod stanu wewnętrznego błędu serwera HTTP 500 i błąd ExecutionFailed
jest wyświetlany, gdy wiadomość nie przejdzie poza zasadę ochrony przed zagrożeniami JSON lub XML. Możesz zmienić
z nową usługą na poziomie organizacji. Podczas ustawiania organizacji
właściwość features.isPolicyHttpStatusEnabled
ma wartość true (prawda), następujące
zachowanie zachodzi:
- Żądanie: gdy do każdego przepływu żądań dołączona jest zasada ochrony przed zagrożeniami, nieprawidłowe wiadomości zwraca kod stanu 400 i odpowiedni komunikat o błędzie związanym z zasadami.
- Odpowiedź: gdy do dowolnego przepływu odpowiedzi dołączono zasadę ochrony przed zagrożeniami, nieprawidłowe wiadomości nadal zwraca kod stanu 500 i pojawia się jeden z odpowiednich komunikatów o błędzie związanym z zasadami (a nie tylko ExecutionFailed).
Klienci Google Cloud muszą skontaktować się z zespołem pomocy Apigee, aby ustawić usłudze organizacji. Ta funkcja będzie dostępna dla klientów Edge Private Cloud w następnym okresie Kwartalna aktualizacja Private Cloud.
Zaktualizowano schematy punktów końcowych, serwerów proxy i innych elementów
Schematy referencyjne zostały zaktualizowane dla encji niezwiązanych z zasadami, takich jak TargetEndpoint ProxyEndpoint, APIProxy i wiele innych. Więcej informacji znajdziesz na stronie https://github.com/apigee/api-platform-samples/tree/master/schemas. (APIRT-1249)
Usługi dla deweloperów
Oto nowe funkcje Usług dla deweloperów w tej wersji.
Ogólna dostępność usługi SmartDocuments
Przejście z wersji beta na platformę SmartDocuments Aktualizacje i nowe funkcje uwzględnij:
- Obsługa Swagger 2.0, w tym importowanie według pliku lub adresu URL, w tym obsługa obiektów zabezpieczeń o niestandardowej nazwie.
- Ulepszenia wizualne w szablonach, które generują pliki SmartDocuments.
- Ulepszenia łatwości obsługi i przepływu pracy w Portalu dla programistów, dostępne na stronie Treści > Menu SmartDocuments (Dokumenty) w Drupal.
- Działanie nazywane „tokenem niestandardowym”. uwierzytelnianie jest teraz nazywane „kluczem interfejsu API”.
- „Zabezpieczenia” uwierzytelniania obiektów zdefiniowanych na poziomie wersji.
- Konfiguracja uwierzytelniania klientów na poziomie szablonu. Nowe wersje nie są już resetowane ze wstępnie skonfigurowanych danych logowania klienta SmartDocuments.
Więcej opisów funkcji znajdziesz na tym blogu post.
Dokumentację korzystania z Dokumentów Google znajdziesz w tym artykule. interfejsów API.
Nazwa aplikacji dewelopera wyświetlana w interfejsie zarządzania
Aplikacje deweloperskie w Edge mają zarówno nazwę wewnętrzną, która się nie zmienia, jak i wyświetlaną nazwę co możesz zmienić. Na stronie aplikacji związanej z deweloperem w interfejsie zarządzania (Opublikuj > Aplikacje deweloperskie > nazwa aplikacji), wewnętrzna „Nazwa” aplikacji jest wyświetlana wraz z „Wyświetlaną nazwą”, co ułatwia do wizualnego identyfikowania aplikacji według wewnętrznych nazw na potrzeby rozwiązywania problemów i zarządzania interfejsami API.
Usługi analityczne
Poniżej przedstawiamy nowe funkcje usług Analytics dostępne w tej wersji.
Limit czasu przechowywania danych
Podczas generowania raportów analitycznych za pomocą interfejsu użytkownika lub interfejsu API do zarządzania danymi starsze niż 6 miesięcy od bieżącej daty jest domyślnie niedostępny. Jeśli chcesz uzyskać dostęp do danych starszych niż 6 lat , skontaktuj się z zespołem pomocy Apigee.
Klasyczna wersja raportów niestandardowych usuwana z interfejsu zarządzania
Opcjonalna klasyczna wersja niestandardowych raportów analitycznych nie jest już dostępna w za pomocą prostego interfejsu zarządzania.
Skuteczność widżetu Zaangażowanie dewelopera
Widżet ścieżki w głównym panelu statystyk (sekcja Zaangażowanie deweloperów) został ulepszony aby zwiększyć wydajność.
Zarabianie
Oto nowe funkcje zarabiania dostępne w tej wersji.
E-maile z powiadomieniami o planie stawek
Nowy typ powiadomień e-mail z planem stawek pozwala powiadamiać deweloperów, gdy osiągną określony transakcji lub dolara w kupionych abonamentach o zakresie ilościowym lub w pakietach. Dla: Więcej informacji znajdziesz w sekcji Konfiguracja za pomocą szablonów powiadomień.
Synchronizacja okresów opłaty cyklicznej i podstawy agregacji
W planie stawek mogły obowiązywać 2 różne okresy:
- Cykliczny okres opłaty skonfigurowany na karcie Opłaty w planie stawek, który został określony, obciążani są cykliczną opłatą.
- Okres podstawy agregacji określony w arkuszu stawek dla abonamentów o zakresie ilościowym lub pakietach, który określić datę i godzinę zresetowania użycia pakietu przez deweloperów.
Te dwa okresy są teraz zsynchronizowane. Gdy zarówno niezerowa opłata cykliczna, jak i ograniczenie ilościowe lub arkusz stawek pakietu znajduje się w planie stawek, okres opłaty cyklicznej jest używany w obu z nich. Przykład: jeśli istnieje miesięczna opłata cykliczna, pakiety arkusza stawek również są resetowane co miesiąc (domyślnie jest to na początku miesiąca).
Jeśli nie ma opłat cyklicznych, pakiety są resetowane na podstawie Podstawy agregacji zdefiniowanej na stronie arkusza stawek. Jeśli na przykład deweloper zacznie używać arkusza stawek 19 dnia miesiąca, a parametr Podstawa agregacji jest określana co miesiąc, a po 19 dniu miesiąca jest resetowana.
Wycofujemy podstawę agregacji i w przyszłości nie będzie można korzystać z funkcji zarabiania wersji. Więcej informacji znajdziesz w artykule Określanie abonamentu arkusza stawek .
Atrybuty niestandardowe w podsumowujących raportach o przychodach
Zasady rejestrowania transakcji umożliwiają opcjonalnie przechwytywanie danych atrybutów niestandardowych z transakcji. Możesz uwzględniać te niestandardowe atrybuty transakcji w podsumowaniu przychodów raportów. Dodając do organizacji właściwość MINT.SUMMARY_CUSTOM_ATTRIBUTES, możesz wskazują, które atrybuty niestandardowe mają być dodawane do tabel bazy danych na potrzeby raportów.
Klienci Apigee Edge dla Private Cloud mogą ustawić tę flagę za pomocą następującego wywołania interfejsu API Dane logowania administratora systemu.
curl -u email:password -X PUT -H "Content-type:application/xml" http://host:8080/v1/o/myorg -d \ "<Organization type="trial" name="MyOrganization"> <Properties> <Property name="features.isMonetizationEnabled">true</Property> <Property name="MINT.SUMMARY_CUSTOM_ATTRIBUTES">["my_attribute_1","my_attribute_2"]</Property> <Property name="features.topLevelDevelopersAreCompanies">false</Property> </Properties> </Organization>"
Pamiętaj, że tablica atrybutów niestandardowych w wywołaniu interfejsu API jest zakodowana na potrzeby adresu URL.
Proces uaktualniania do Dokumentów Google
Jeśli zdarzyło Ci się już korzystać z Dokumentów Google w wersji beta, nowe funkcje i możliwości w wersji ogólnej dostępności wymaga uaktualnienia Dokumentów SmartDocuments z portalu.
Wszystkie strony SmartDocument, które zostały już opublikowane w Twoim portalu dla deweloperów, będą nadal ale przed opublikowaniem lub edycją jakichkolwiek zmian w istniejących musisz przeprowadzić aktualizację lub nowych stron.
Pamiętaj, że chociaż możesz renderować i publikować dokumenty SmartDocuments w portalu dla programistów, Dokumenty inteligentne są generowane na podstawie modelu API, który działa w ramach zarządzania interfejsem Edge API przez Apigee Usługi. Wszystkie zmiany wprowadzone w modelu API w Edge będą takie same we wszystkich usługach Pantheon (podobnie jak w przypadku programistów w środowiskach Pantheon).
Aby przejść z wersji beta SmartDocuments na ogólnie dostępną
- Zaktualizuj i przetestuj wersję 15.05.27 w środowiska deweloperskiego lub testowego na Panteon.
- Utwórz nowy model, aby zastąpić dotychczasowy model interfejsu API.
- Jeśli importujesz dokumenty Swagger lub WADL, zaimportuj je ponownie do nowego wersji.
- Jeśli model API był przez Ciebie utrzymywany za pomocą modułu SmartDocuments, wyeksportuj jako Plik JSON z informacjami o SmartDokumentach i zaimportuj go do nowego modelu, używając załącznika.
- Ustaw właściwości zabezpieczeń wersji modelu. W sekcji Treść >
SmartDokumenty > modelu, wybierz Security Settings (Ustawienia zabezpieczeń).
- Sprawdź wszystkie skonfigurowane wstępnie uwierzytelnianie na stronie ustawień modelu (Treść >
SmartDocuments), klikając Ustawienia w narzędziu Operacje.
.
- Zaktualizuj wszystkie szablony niestandardowe, tak aby korzystały z zasobów CSS i JS w wersji 6, oraz wprowadź zmiany, które nowe nazwy obiektów, takie jak authSchemes i apiSchema. Informacje na temat aktualizowania plików Dokumentów Patrz: Korzystanie z szablonów Dokumenty za pomocą interfejsów API dokumentów.
- Wyrenderuj ponownie i opublikuj wersję modelu.
- Po sprawdzeniu nowej dokumentacji zaktualizuj portalu produkcyjnego do wersji 15.05.27.
Jeśli korzystasz z Edge Enterprise i masz pytania lub wątpliwości dotyczące uaktualnienia , wyślij e-maila na adresy marsh@apigee.com i cnovak@apigee.com. W przeciwnym razie użyj ze społeczności Apigee, .
przyszłe zmiany i ulepszenia funkcji,
Ta sekcja zawiera podgląd przyszłych zmian w funkcjach i ulepszeniach:
Zmień na Zachowanie zasady pamięci podręcznej odpowiedzi
Funkcja, która pojawi się w przyszłej wersji (jeszcze do ustalenia), będzie domyślnie działać <ExcludeErrorResponse> element zasady pamięci podręcznej odpowiedzi ulegnie zmianie.
Obecne zachowanie: element <ExcludeErrorResponse> w domyślnie zasada pamięci podręcznej odpowiedzi ma wartość Fałsz. Oznacza to, że domyślnie odpowiedzi z dowolnymi możliwe kody stanu HTTP (w tym 3xx) są zapisywane w pamięci podręcznej przez zasadę pamięci podręcznej odpowiedzi.
Zachowanie w przyszłości: element <WykluczErrorResponse>. w Zasada pamięci podręcznej odpowiedzi ma domyślnie wartość Prawda. Oznacza to, że domyślnie tylko odpowiedzi z protokołem HTTP Kody stanu 200–205 będą zapisywane w pamięci podręcznej. Aby zastąpić to zachowanie i buforować odpowiedzi dla wszystkich kodów stanu, należy ustawić element <ExcludeErrorResponse> do .
Obecne obejście: dla Private Cloud w wersji 4.15.07.00 i starszych, jeśli chcesz przechowywać w pamięci podręcznej tylko odpowiedzi z kodami stanu 200–205, musisz wyraźnie wskazać element <ExcludeErrorResponse> na wartość true (prawda).
Usunięto błędy
W tej wersji poprawiono następujące błędy.
Identyfikator problemu | Opis |
---|---|
OPDK-1521 | Problem z szyfrowaniem hasła |
OPDK-1201 | Nie udało się przywrócić danych interfejsu |
OPDK-1112 | Niestandardowe zasady dotyczące haseł LDAP nie są stosowane do administratora Apigee użytkownik |
OPDK-1097 | Wyjątek przestrzeni kluczy podczas uaktualniania OPDK |
OPDK-1068 | Możliwość zmiany hasła administratora, jeśli podczas instalacji wystąpi błąd |
OPDK-1053 | Zookeeper działa jako użytkownik root |
OPDK-967 | Podczas ustawiania automatycznego uruchamiania OpenLDAP przy użyciu set-autostart.sh, all-status.sh Zgłasza je jako martwe |
OPDK-905 | Produkt produkcyjny Smartdocs jest już zarejestrowany w grupie axgroup001 |
OPDK-899 | Błąd podczas wprowadzenia |
OPDK-847 | Użytkownik utworzony podczas rejestracji nie otrzymuje e-maila do zresetowania hasło |
OPDK-817 | Skrypty int.d zwracają błąd |
OPDK-815 | Skrypt ax-purge.sh wymaga trwałego usunięcia tabel próbkowania |
MGMT-2246 | Strona tworzenia raportu niestandardowego nie jest prawidłowo wyświetlana w sekcji zarządzania Interfejs |
MGMT-2235 | W przypadku wygasających certyfikatów SSL czas utraty ważności może być mylący.
w zaokrągleniu W przypadku wygasających certyfikatów SSL względny czas ważności daty ważności jest zawsze podawany w dniach zamiast zaokrąglania w górę do miesięcy, gdy certyfikat traci ważność po 90 dniach lub mniej. |
MGMT-2193 | Wskaźnik postępu ładowania podczas edytowania interfejsu API |
MGMT-2173 | Interfejs śledzenia nie zezwala na legalne adresy URL Interfejs usługi Trace umożliwia teraz wysyłanie żądań z wartościami parametrów zapytania, które zawierają zagnieżdżone parametrów zapytania. |
MGMT-2162 | Problem z kompilacją JavaScript |
MGMT-2124 | Uprawnienia roli klienta są resetowane po zapisaniu uprawnień w Interfejs |
MGMT-2114 | Nieprawidłowy adres IP serwera Syslog w zasadzie MessageLogging powinien zgłaszać odpowiedni błąd podczas wdrożenie |
MGMT-2067 | Ślad: jeśli wersja serwera proxy interfejsu API została wdrożona w 2 środowiskach, wybranie wersji środowisko nie działa prawidłowo |
MGMT-2061 | Nie pamiętam hasła powinno być ono wysyłane tylko do zarejestrowanych użytkowników Opcja „Nie pamiętasz hasła?” link na stronie logowania w interfejsie zarządzania wysyła e-maile tylko do zarejestrowanych użytkowników Apigee. |
MGMT-2048 | Użytkownik z niestandardową rolą, która ogranicza uprawnienia do wdrażania do jednego środowiska, może wdrażać w innych |
MGMT-2041 | Usuwanie elementu FaultRules z domyślnego szablonu załącznika Element FaultRules, który nie jest używany w zasadach ani krokach serwera proxy interfejsu API, nie jest już używany automatycznie dodawane podczas tworzenia serwerów proxy interfejsów API lub dodawania zasad. |
MGMT-2034 | Pobierz WSDL zwraca błąd: „Pobierz WSDL Błąd: Błąd podczas przetwarzania” WSDL”. |
MGMT-1986 | Podczas dodawania dewelopera wystąpił błąd interfejsu |
MGMT-1983 | Interfejs API pobierania kodu autoryzacji OAuth 2.0 zwraca nieprawidłowy stan |
MGMT-1962 | Podczas logowania do interfejsu zarządzania silnym hasłem wystąpił błąd Logowanie się do interfejsu przy użyciu niektórych znaków specjalnych, takich jak znak procentu, niepowodzenie. |
MGMT-1947 | Nieintuicyjne role w interfejsie zarządzania Jeśli użytkownik nie ma uprawnień do tworzenia lub edytowania zasad rejestrowania transakcji, interfejs użytkownika przyciski umożliwiające tworzenie i edytowanie zasad rejestrowania transakcji są teraz wyłączone. |
MGMT-1899 | Ścieżki zasobów zostały usunięte po zapisaniu ustawień usługi Podczas edytowania usługi API ścieżki zasobów usługi mogą zostać usunięte, jeśli użytkownik kliknij dwukrotnie przycisk Zapisz. Naprawiliśmy ten problem. |
MGMT-1894 | Strona aplikacji dla deweloperów nigdy się nie wczytuje kolumna |
MGMT-1882 | Nowy serwer proxy interfejsu API z WSDL pokazuje tylko szczegóły ostatniego parametru |
MGMT-1878 | Jeśli w środowisku wdrożonych jest wiele wersji, śledzenie pokazuje tylko jedną z |
MGMT-1872 | Nie można pobrać raportów niestandardowych |
MGMT-1863 | Logi Node.js nie są widoczne w interfejsie zarządzania |
MGMT-1843 | Serwer proxy interfejsu API nie chce się otworzyć |
MGMT-1833 | Użytkownik sysadmin nie powinien mieć możliwości zmiany hasła w interfejsie użytkownika OPDK |
MGMT-1825 | Błędy XSS |
MGMT-1824 | Błąd pobierania WSDL podczas importowania pliku WSDL z rozszerzeniem .xml |
MGMT-1812 | Dodawanie weryfikacji docelowego punktu końcowego podczas importowania Podobnie jak w przypadku ProxyEndpoint punkt docelowy zostanie zweryfikowany pod kątem właściwego schematu i wyrażenia używane w warunkach podczas importowania serwera proxy interfejsu API. |
MGMT-1804 | W niektórych przypadkach interfejs Node.js API wysyła nieprawidłowy kod JSON Ekran logów Node.js używany do wyświetlania niesformatowanych logów, jeśli dane JSON były nieprawidłowe znaków. W tej wersji poprawiono to i interfejs wyświetla teraz dobrze sformatowany plik node.js dzienników. |
MGMT-1802 | adres URL resetowania hasła nr 118 Jeśli interfejs zarządzania jest za serwerem, który kończy połączenie SSL, interfejs zarządzania jest teraz prawidłowo generuje wiadomość e-mail do zresetowania hasła zawierającą link do adresu URL HTTPS zamiast do adresu URL HTTP. |
MGMT-1799 | Żądanie wysłania prośby o wysłanie luk w zabezpieczeniach w interfejsie w systemie Trace |
MGMT-1777 | Nie można dodać użytkownika z adresem e-mail w domenie najwyższego poziomu .acn |
MGMT-1735 | Marka „Błąd podczas pobierania W” Natychmiast wyłączyliśmy obsługę niestandardowego promowania marki w Edge OPDK. Choć mogą zawieść niewielu klientów, którzy z niej korzystali. Nie oznacza to jednak, funkcja, która bezpośrednio zwiększa możliwości Edge w zakresie zarządzania interfejsami API. |
MGMT-1569 | Problem z dołączeniem serwera proxy interfejsu API do istniejącej usługi API Rozwiązaliśmy problem z dołączaniem serwera proxy interfejsu API do usługi API w interfejsie zarządzania, gdy serwer proxy interfejsu API miał zasobu dla ścieżki „/” ścieżki konwersji. |
MGMT-1563 | Przycisk Wyślij w Trace pozostaje wyłączony w przypadku wystąpienia błędu |
MGMT-1362 | Funkcja „Nie pamiętam hasła” nie działa, jeśli adres e-mail zawiera
'_' Rozwiązaliśmy problem z resetowaniem hasła w pliku OPDK w przypadku adresów e-mail zawierających podkreślenia. |
MGMT-1345 | Import WSDL z wieloma przestrzeniami nazw skutkuje nieprawidłowym SOAP kompilacji Krok |
MGMT-1193 | Zapisywanie serwera proxy jako nowej wersji nieoczekiwanie zmienia regułę trasy |
MGMT-1061 | Dokumenty SmartDocuments: opis parametru typu sylwetki w definicji Swagger nie jest widoczny w interfejsie dokumentu |
MGMT-800 | Tworzenie zasobu o nazwie „default” może to spowodować uszkodzenie interfejsu. |
MGMT-787 | Problem z obsługą alertów w interfejsie Gdy w interfejsie zarządzania klikniesz + Serwer proxy interfejsu API, pojawi się okno Nowy serwer proxy interfejsu API, naciśnij Esc, by zamknąć to okno. |
MGMT-619 | Aktywuj podział na strony na stronie interfejsu API serwera proxy |
MGMT-602 | Widok programowania serwera proxy interfejsu API: dodaj zasadę pamięci podręcznej odpowiedzi, gdy punkt końcowy nie ma PreFlow/PostFlow powoduje błąd |
MGMT-460 | Zmiana nazwy zasady powoduje błędy, więc powielanie zasad jest niemożliwe. usunięto |
DEVRT-1644 | Wyszukiwanie powiadomień według nazwy powodujące wysłanie nieprawidłowego e-maila |
DEVRT-1583 | Interfejs zarabiania z napisem „Przyszłość” plakietka aktualnego abonamentu |
DEVRT-1546 | Limity abonamentu nie działają |
DEVRT-1511 | Błąd mint.resource wstępneNotExist w przypadku istniejącego dewelopera |
CORERT-639 | TCPSysLogSocket musi być asynchroniczny |
CORERT-613 | Nieudane uzgadnianie połączenia SSL z powodu „unrecognized_name” |
AXAPP-1728 | Ignorowanie zmiennych dotyczących zarabiania w statystykach |
AXAPP-1708 | Wygląda na to, że Analytics API zwraca różne liczby dla tych samych statystyk w zależności od prośby |
AXAPP-1707 | Zwiększanie skuteczności bezpłatnych statystyk podów |
AXAPP-1690 | „Nieprawidłowy błąd interfejsu API” raportów niestandardowych |
AXAPP-1533 | Geomapa Analytics zgłasza błąd nieprawidłowego wywołania interfejsu API |
AXAPP-1493 | Niepoprawne statystyki wydajności pamięci podręcznej |
APIRT-1436 | Tworzenie narzędzia/skryptu do haszowania niezaszyfrowanych tokenów |
APIRT-1425 | AtrybutcontinueOnError, gdy ma wartość „true” nie ma efektu w JavaCallout |
APIRT-1346 | OAuth2.0 – zaszyfrowana wartość jest zwracana w odpowiedzi tokena dostępu, gdy: hash.oauth.tokens.enabled ma wartość prawda |
APIRT-1206 | Parametr target_ip nie jest rejestrowany w tabeli faktów dla błędów 503 i większości 504 |
APIRT-1170 | Brak pliku zasobów spowodował, że MP nie załadował środowiska |
APIRT-1148 | GET zmiennej {message.version} w ResponseFlow dla zgłoszeń docelowych Node.js NPE |
APIRT-1054 | Logowanie wiadomości kończy się niepowodzeniem przy próbie zalogowania się w katalogu innym niż domyślny |
APIRT-387 | Spraw, aby organizacja OrganizationService działała w trybie „inne” na MP |
APIRT-67 | Zasada OAuth GenerateAccessToken nie ustawia zmiennej oauthV2.failed prawidłowo |
APIRT-52 | Raporty niestandardowe: kod stanu odpowiedzi w przypadku wielu interfejsów API ma wartość null |
Znane problemy
W tej wersji występują następujące znane problemy.
Identyfikator problemu | Opis |
---|---|
OPDK-1586 |
Nie można uruchomić portalu interfejsu API BaaS, jeśli obsługa IPV6 nie jest włączona
|
OPDK-1785 |
Zainstaluj komponent zarabiania na uaktualnionej przeglądarce Edge
środowisko
Rozwiązaniem jest ustawienie odpowiedniej wersji funkcji zarabiania w pliku apigee-env.sh
przed zainstalowaniem funkcji Zarabianie. Aby korzystać z wersji Zarabianie w wersji 4.15.07
(po uaktualnieniu do wersji Edge 4.15.07):
> source /{install-dir}/apigee4/bin/apigee-env.sh > VER=`basename $(find $SHARE_DIR/installer/monetization -name "mint-*.zip") | cut -d "-" -f 2,3,4`
Domyślnie parametr install-dir to /opt.
Powyższą wartość VER należy ustawić w apigee-env.sh:
> sed -i "s/^MONETIZATION_VERSION=.*/MONETIZATION_VERSION=$VER/" /install-dir/apigee4/bin/apigee-env.sh
Jeśli próbujesz zainstalować zarabianie, nie wykonując powyższych czynności,
instalacja kończy się niepowodzeniem i prawdopodobnie w katalogu udziału znajduje się martwy dowiązanie symboliczne. Potrzebujesz
aby usunąć ten dowiązanie symboliczne:
> rm /install-dir/apigee4/share/monetization
Po usunięciu tego dowiązania wykonaj czynności opisane powyżej, aby ustawić wersję Zarabianie.
a potem spróbuj ponownie zainstalować funkcję Zarabianie.
|
OPDK-1857 |
zakodowana na stałe wersja Pythona 2.6 w pliku bin/qpid-stat.sh oraz
bin/qpid-config.sh W systemach CentOS i RedHat 7.0 kilka skryptów w katalogach bin/qpid-stat.sh i bin/qpid-config.sh są zaprogramowane na stałe tak, aby korzystały z Pythona w wersji 2.6. Obejściem tego problemu jest zmiana wiersza eksportującego ścieżkę PYTHONPATH w pliku qpid-stat.sh oraz qpid-config.sh w katalogu apigee4/bin.
Aby określić wersję Pythona w systemie, sprawdź jej wersję w Directory /opt/apigee4/share/apache-qpid/lib. Najprawdopodobniej jest to python2.7. Następnie zaktualizuj ustawienie PYTHONPATH w qpid-stat.sh i qpid-config.sh za pomocą właściwą ścieżkę. Na przykład:
|
DEVRT-1574 | Niespójne saldo i wykorzystanie w przypadku deweloperów z wieloma aktywnymi stawkami
abonamenty W sekcji Zarabianie, jeśli deweloper korzysta z więcej niż 1 abonamentu z wywołaniem interfejsu API. płatności, wykorzystanie salda pieniężnego może być czasami niespójne. |
APIBAAS-1647 | Po zalogowaniu się jako administrator Sys w interfejsie użytkownika BaaS występuje błąd „Błąd podczas pobierania ról”
wiadomość Ten komunikat o błędzie pojawia się przy pierwszym logowaniu w systemie przez administratora systemu po aktualizację z wersji 4.15.01 do 4.15.07. Możesz zignorować tę wiadomość. |
DEVRT-1834 |
Uaktualnienie ustawień zarabiania do wersji 4.15.07 Skrypt apigee-upgrade.sh na końcu wyświetla następujący komunikat z prośbą o wykonaj inny skrypt: ************************************** In order to complete the monetization upgrade please run: sudo /opt/apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/ 365-create-notification-condition.sh ************************************** Możesz zignorować tę wiadomość. Ten skrypt nie jest wymagany i nie można go wykonać. |
DEVRT-1951 |
Zarabianie na nowej instalacji – brakujące konfiguracje powiadomień
Podczas nowej instalacji Apigee Edge dla Private Cloud w wersji 4.15.07.00 narzędzie
brak poniższych konfiguracji powiadomień o przychodach. Odpowiadają one
do typów powiadomień w sekcji Administracja > Strona Powiadomienia w interfejsie zarządzania.
mint.scheduler.${ORG_ID}.adhocnotify@@@management
mint.scheduler.${ORG_ID}.expiringrateplannotify@@@management
mint.scheduler.${ORG_ID}.newpkgnotify@@@management
mint.scheduler.${ORG_ID}.newproductnotify@@@management
mint.scheduler.${ORG_ID}.newrateplannotify@@@management
mint.scheduler.${ORG_ID}.tncacceptancenotify@@@management
Aby obejść ten problem, wykonaj te czynności. Potrzebny będzie adres IP
Instancja Cassandra. Aby ją znaleźć, zajrzyj do
<installation-root>/apigee4/conf/cassandra/cassandra.yaml lub
<installation-root>/apigee4/conf/cassandra/cassandra-topology.properties.
|
DEVRT-1952 |
Brak powiadomienia o nowym zarabianiu od wersji 14.07.00
konfiguracje
Po uaktualnieniu Apigee Edge z wersji 4.14.07.00 do wersji 4.15.07.00
brak tych konfiguracji powiadomień o przychodach, co powoduje
aby raporty o przychodach działały nieprawidłowo.
mint.scheduler.${ORG_ID}.chargedaily@@@management
mint.scheduler.${ORG_ID}.chargehourly@@@management
Aby obejść ten problem, wykonaj te czynności. Potrzebny będzie adres IP
Instancja Cassandra. Aby ją znaleźć, zajrzyj do
<installation-root>/apigee4/conf/cassandra/cassandra.yaml lub
<installation-root>/apigee4/conf/cassandra/cassandra-topology.properties.
|
OPDK-1878 | Nie można ustawić nazwy poda w instalacji w wielu centrach danych Przewodnik instalacji Edge określa, aby ustawić nazwy podów jako „gateway-1”. i „gateway-2” w pliki instalacji dyskretnych dla instalacji w wielu centrach danych. Zmiana nazwy poda zapobiega prawidłowej rejestracji routerów i procesorów wiadomości oraz i łatwo dostępnych rozwiązań. Ten problem uniemożliwia też skryptowi setup-org.sh, aby: znaleźć dostępne procesory wiadomości. Obejściem problemu jest ustawienie nazwy poda za pomocą właściwości MP_POD na „brama”. w cichy plik instalacji dla obu centrów danych. |
OPDK-1886 |
Węzeł nie ma dostępu do lokalnych adresów IP, takich jak 192.168.x.y
connect.ranges.denied=10.0.0.0/8,192.168.0.0/16,127.0.0.1/32
Następnie ponownie uruchom węzły procesora wiadomości:
<install_dir>/apigge4/bin/apigee-service message-processor restart
|
OPDK-1958 | Podczas uaktualniania wszystkie węzły będą wymagać dostępu do portu 8080 w ramach zarządzania
Serwer W czasie działania te komponenty wymagają dostępu do portu 8080 na serwerze zarządzania: Router, procesor wiadomości, interfejs użytkownika, Postgres i Qpid. Jednak podczas uaktualniania wszystkie węzły wymagają dostępu do portu 8080 na serwerze zarządzania, w tym do Cassandra i Zookeeper. węzłów. |
OPDK-1962 | Po uaktualnieniu należy ponownie skonfigurować SSL dla interfejsu Edge API Jeśli interfejs Edge API został skonfigurowany do korzystania z SSL przed aktualizacją do wersji 4.15.07.00, musisz ponownie skonfigurować protokół SSL po uaktualnieniu. Zapoznaj się z przewodnikiem po operacjach na urządzeniu Edge, aby skonfigurować SSL dla interfejsu Edge API. |