4.15.07.00 – informacje o wersji Apigee Edge for Private Cloud

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

We wtorek 8 września 2015 r. opublikowaliśmy główną wersję funkcji Apigee Edge dla chmury prywatnej.

Od poprzedniej kwartalnej wersji Edge dla chmury prywatnej (4.15.04.00) pojawiły się te wersje, które są uwzględnione w tej wersji kwartalnej:

Do których wersji Edge można przejść 4.15.07.00

W zależności od używanej wersji Edge możesz:

  • Bezpośrednie uaktualnienie do wersji 4.15.07.00
  • Uaktualniaj stopniowo, co oznacza, że musisz uaktualnić obecną wersję do innej wersji Edge, a następnie do wersji 4.15.07.00.

Więcej informacji znajdziesz w artykule Które wersje Edge dla chmury prywatnej można uaktualnić do wersji 4.15.07.00.

Przed uaktualnieniem z wersji 4.15.01.x lub starszej

Przed uaktualnieniem upewnij się, że uaktualniono Cassandra SSTable na każdym węźle Cassandra:
  1. Sprawdź wersję Cassandra SSTable:
    1. Zmień katalog na /<install-root>/apigee4/data/cassandra/data.
    2. Uruchom polecenie find:
      > find . -name *-ic-*
      Jeśli używasz Cassandra 1 .2 SSTable, wyniki powinny zawierać zestaw plików.db.
    3. Uruchom to polecenie wyszukiwania:
      > find . -name *-hf-*
      Wyniki powinny być puste, co oznacza, że w formacie hf nie ma żadnych plików .db. Jeśli nie widzisz żadnych plików w formacie hf, możesz przejść na wersję 4.15.07.00.

      Format hf jest przeznaczony dla tabel SSTable w systemie Cassandra 1.0. Jeśli masz pliki *.db w formacie hf, musisz uaktualnić SSTable zgodnie z opisem w dalszej części tej procedury.
  2. Jeśli znajdziesz pliki *.db w formacie hf, uaktualnij SSTable, uruchamiając to polecenie na każdym węźle Cassandra, aż uaktualnisz wszystkie węzły Cassandra:
    > /<install-root>/apigee4/share/apache-cassandra/bin/nodetool -h localhost upgradesstables -a
  3. Powtórz krok 1, aby sprawdzić, czy wszystkie pliki *.db są w formacie ic dla wersji Cassandra 1.2.
  4. Powtórz kroki 1–3 na każdym węźle Cassandra w instalacji Edge.
  5. Uaktualnij do Edge 4.15.07.00.
  6. Po uaktualnieniu do wersji 4.15.07.00 sprawdź pliki *.db, aby upewnić się, że wszystkie zostały uaktualnione do stylu sstable C* 2.0:
    > cd /<install-root>/apigee4/data/cassandra/data
    > find . -name *-jb-*

    Jeśli używasz Cassandry 2 .0, to polecenie powinno zwrócić zestaw plików.db.

Nowe funkcje i ulepszenia

Poniżej znajdziesz nowe funkcje i ulepszenia wprowadzone w tej wersji.

Instalacja i uaktualnienie

Selektywne uaktualnianie i odinstalowywanie komponentów

Skrypty apigee-upgrade.sh i apigee-uninstall.sh umożliwiają teraz wybór komponentów Edge do uaktualnienia lub odinstalowania. Wcześniej uaktualniało lub odinstalowywało wszystkie komponenty w węźle. (OPDK-1377, OPDK-1175)

Wycofanie uaktualnienia

Jeśli skrypt apigee-upgrade.sh nie powiedzie się podczas uaktualniania, możesz teraz użyć skryptu apigee-rollback.sh, aby wycofać uaktualnienie. Po rozwiązaniu problemów z uaktualnieniem możesz spróbować ponownie. (OPDK-1275)

Opcje skróconego skryptu instalatora

Skrypty instalacyjne nie obsługują już długich form opcji, takich jak --help. Teraz akceptują tylko opcje jednoliterowe, takie jak -h. (OPDK-1356)

Instalacja SmartDocs

Podczas instalowania SmartDocs za pomocą skryptu setup-smartdocs.sh pojawi się prośba o podanie organizacji, środowiska i hosta wirtualnego, co zapewni, że SmartDocs zostanie zainstalowany w oczekiwanej lokalizacji. Wcześniej te wartości były zakodowane na stałe w skrypcie. (OPDK-1310)

Uruchamianie skryptu update-cass-pwd-in-config.sh bez wyświetlania próśb o potwierdzenie

Skrypt update-cass-pwd-in-config.sh może działać bez wyświetlania próśb, jeśli ustawisz zmienne środowiskowe ENABLE_CASS_AUTH, CASS_USERNAME i CASS_PASSWORD. (OPDK-1309)

Platforma Edge

Poniżej znajdziesz nowe funkcje platformy Edge, które są 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, ale nie obsługuje już JDK 1.6. (OPDK-1187)

Pomoc dotycząca systemu operacyjnego

Apigee Edge dla chmury prywatnej obsługuje teraz więcej systemów operacyjnych, w tym Red Hat Enterprise Linux 6.6 i 7.0 (64-bitowy), CentOS 6.5, 6.6 i 7.0 (64-bitowy) oraz Oracle Linux 6.5.

Cassandra 2.0.15 dołączona do OPDK 15.07

Ta wersja instaluje system Cassandra 2.0.15. Jeśli uaktualniasz poprzednią wersję, Twoja wersja Cassandra zostanie zaktualizowana. (OPDK-1197)

Obsługa SHA2 na potrzeby haszowania tokenów OAuth

Aby lepiej chronić tokeny OAuth w przypadku naruszenia bezpieczeństwa bazy danych, Edge obsługuje algorytmy SHA2 do haszowania tokenów OAuth (oprócz SHA1). Dzięki nowym właściwościom na poziomie organizacji możesz włączyć i skonfigurować haszowanie nowych tokenów, a także zachować starsze haszowanie tokenów, które istniały przed wprowadzeniem tej nowej funkcji. Wcześniej w Edge dla chmury prywatnej właściwość o nazwie hash.oauth.tokens.enabled w pliku keymanagement.properties (na serwerze zarządzania i procesorach komunikatów) umożliwiała automatyczne szyfrowanie tokenów OAuth za pomocą algorytmu SHA1. Ta właściwość została wycofana.

Jeśli wcześniej użyto właściwości hash.oauth.tokens.enabled do włączenia szyfrowania SHA1, skrypt uaktualnienia dla tej wersji automatycznie wygeneruje nowe właściwości na poziomie organizacji. Aby sprawdzić, czy uaktualnienie się powiodło, wyślij żądanie 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 za pomocą nowych właściwości znajdziesz w sekcji „Haszowanie tokenów w bazie danych” w artykule Żądanie tokenów dostępu.
  • Informacje o zbiorczym haszowaniu istniejących tokenów znajdziesz w Przewodniku po operacjach Edge dla chmury prywatnej. (APIRT-1389)

Płaska struktura katalogów plików dziennika

Możesz skonfigurować Edge tak, aby przechowywał pliki dziennika w płaskiej strukturze katalogów, ustawiając nową właściwość enable.flat.directory.structure na wartość „true” w pliku message-logging.properties. Więcej informacji znajdziesz w artykule Zasady rejestrowania wiadomości. (APIRT-1394)

Wydajność pamięci podręcznej środowiska

Aby usprawnić zarządzanie pamięcią podręczną pamięci RAM i jej wykorzystanie, ustawienie „Maksymalna liczba elementów w pamięci” w zasobach pamięci podręcznej środowiska zostało wycofane. Łączna liczba elementów we wszystkich zasobach pamięci podręcznej (w tym w domyślnej pamięci podręcznej) zależy od łącznej ilości pamięci przydzielonej do pamięci podręcznej. Domyślnie łączna alokacja pamięci na potrzeby buforowania w pamięci RAM na danym procesorze komunikatów wynosi 40% łącznej dostępnej pamięci, co jest określane przez ustawienia właściwości pamięci podręcznej pamięci RAM w pliku cache.properties procesora komunikatów. Elementy będą usuwane z pamięci podręcznej pamięci RAM tylko wtedy, gdy nie będzie wystarczającej ilości pamięci podręcznej pamięci RAM lub gdy elementy wygasną.

Aby przywrócić poprzednie działanie polegające na używaniu właściwości „Maksymalna liczba elementów w pamięci” do zarządzania pamięcią podręczną, ustaw właściwość overrideMaxElementsInCacheResource=false w pliku cache.properties. (APIRT-1140)


Usługi interfejsów API

Poniżej znajdziesz nowe funkcje usług interfejsów API, które są dostępne w tej wersji.

Nowy edytor proxy jako domyślny

Nowy edytor serwerów proxy interfejsu API jest domyślnie włączony w interfejsie zarządzania. Nowy edytor zawiera wiele ulepszeń ułatwiających obsługę, m.in. bardziej kompleksowe widoki przepływów warunkowych i punktów końcowych na stronie Przegląd, wszystkie konfiguracje na stronie Opracowywanie, bardziej intuicyjne dodawanie przepływów warunkowych, punktów końcowych i zasad, bardziej kompletne widoki XML zamiast małych fragmentów kodu, wyszukiwanie, które skanuje nazwy plików i tekst, i wiele innych. (MGMT-2279)

Nowa zasada usuwania informacji o OAuth 2.0

Nowa zasada „Usuń informacje OAuth 2.0” umożliwia usuwanie tokenów dostępu i kodów autoryzacji OAuth 2.0. Zasada zastępuje funkcje, które wcześniej były dostępne w interfejsie API zarządzania Google Analytics. Więcej informacji znajdziesz w artykule o zasadzie Delete OAuthV2 Info. (MGMT-2257)

Nowa zasada usuwania informacji o OAuth 1.0

Nowa zasada „Usuń informacje o OAuth 1.0” umożliwia usuwanie tokenów żądań, tokenów dostępu i kodów weryfikatora OAuth 1.0. Zasada zastępuje funkcje, które wcześniej były dostępne w interfejsie API zarządzania Google Analytics. Więcej informacji znajdziesz w artykule Zasada usuwania informacji OAuth w wersji 1. (APIRT-1351)

Zasady kontroli dostępu

Zasada kontroli dostępu została ulepszona, aby umożliwić bardziej szczegółową ocenę adresów IP na potrzeby list dozwolonych i odrzuconych, gdy adresy IP są zawarte w nagłówku HTTP X-FORWARDED-FOR.

Jeśli w nagłówku włączone jest sprawdzanie wielu adresów IP (skontaktuj się z zespołem pomocy, aby ustawić parametr feature.enableMultipleXForwardCheckForACL), nowy element <ValidateBasedOn> w zasadzie umożliwia sprawdzenie pierwszego adresu IP, ostatniego adresu IP lub wszystkich adresów IP w nagłówku. Więcej informacji znajdziesz w artykule Zasady kontroli dostępu.

Nowe encje w zasadach dotyczących encji dostępu

Zasada Access Entity zapewnia dostęp do tych nowych encji: consumerkey-scopes, authorizationcode, requesttoken i verifier. Więcej informacji znajdziesz w artykule Zasady dotyczące podmiotów mających dostęp.

Zasada modułu zbierającego statystyki: automatyczna konwersja nazwy statystyk na małe litery

Podczas tworzenia niestandardowej kolekcji statystyk w edytorze serwerów proxy interfejsu API (strona Programowanie > Narzędzia > Niestandardowa kolekcja statystyk) zmienna modułu zbierającego (statystyka) „Nazwa” musi być pisana małymi literami. Jeśli wpiszesz nazwę wielkimi literami, narzędzie automatycznie przekonwertuje nazwę statystyki na małe litery w zasadzie modułu zbierającego statystyki. (MGMT-740)

Usunięcie klasycznego śledzenia w edytorze serwerów proxy interfejsu API

Najnowsza wersja funkcji śledzenia w edytorze serwerów proxy interfejsu API została przeniesiona z wersji beta do ogólnej dostępności. Dostęp do „klasycznego śledzenia” za pomocą linku „Uzyskaj dostęp do klasycznej wersji śledzenia” nie jest już możliwy.

Dostęp do społeczności Apigee z menu pomocy interfejsu zarządzania

Dostęp do społeczności Apigee możesz uzyskać z menu pomocy w interfejsie 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 grupował i wyświetlał wszystkie komunikaty o błędach w interfejsie przez całą sesję logowania, chyba że zostały odrzucone. Dzięki tej aktualizacji komunikaty o błędach są automatycznie usuwane, gdy opuścisz stronę, na której wystąpiły. (MGMT-2254)
  • Interfejs zarządzania nie ukrywa już powielonych komunikatów o błędach. (MGMT-2242)

Ulepszenia dotyczące wydajności interfejsu i błędów

Wprowadziliśmy ogólne ulepszenia w różnych obszarach interfejsu zarządzania, w tym poprawiliśmy wydajność wyświetlania stron i usunęliśmy komunikaty o błędach.

Na stronie Użytkownicy organizacji w interfejsie zarządzania (Administracja > Użytkownicy organizacji) nazwy ról są teraz hiperlinkami, 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ą pełniejszych informacji o adresach URL docelowych punktów końcowych i serwerów:

  • TargetEndpoint: request.url zastępuje target.basepath.with.query.
  • TargetServer: loadbalancing.targetserver zastępuje targetserver.name. Ponadto zmienna target.basepath jest wypełniana tylko wtedy, gdy element <Path> jest używany w elemencie HTTPTargetConnection <LoadBalancer> elementu TargetEndpoint.

Obsługa wskazania nazwy serwera (SNI)

Edge obsługuje używanie wskazania nazwy serwera w kierunku południowym (od procesora komunikatów do docelowych punktów końcowych). Jeśli chcesz używać SNI, skontaktuj się z zespołem pomocy Apigee Edge.

Wymagana jest Java 1.7.

Dzięki SNI, które jest rozszerzeniem TLS/SSL, wiele docelowych adresów HTTPS może być obsługiwanych przez ten sam adres IP i port bez konieczności używania tego samego certyfikatu przez wszystkie te adresy.

Nie jest wymagana żadna konfiguracja specyficzna dla Edge. Jeśli Twoje środowisko jest skonfigurowane pod kątem SNI southbound (Edge Cloud jest domyślnie), Edge obsługuje tę funkcję.

Edge automatycznie wyodrębnia nazwę hosta z adresu URL żądania i dodaje ją do żądania uzgadniania SSL. Jeśli na przykład hostem docelowym jest https://example.com/request/path, Edge dodaje rozszerzenie server_name, jak pokazano poniżej:

Więcej informacji o SNI znajdziesz na stronie http://en.wikipedia.org/wiki/Server_Name_Indication.

„Algorytm podpisu” w szczegółach certyfikatów SSL

Do szczegółów certyfikatu SSL dodano nowe pole „Algorytm podpisu”, które można wyświetlić w interfejsie użytkownika zarządzania (Administracja > Certyfikaty SSL) i interfejsie API zarządzania (Pobieranie szczegółów certyfikatu z magazynu kluczy lub magazynu zaufanych certyfikatów). W zależności od typu algorytmu szyfrowania użytego do wygenerowania certyfikatu w tym polu wyświetla się „sha1WithRSAEncryption” lub „sha256WithRSAEncryption”.

Wyświetlam certyfikaty SSL, które wkrótce wygasną

Na stronie Certyfikaty SSL w interfejsie zarządzania (Administrator > Certyfikaty SSL) wyświetlane są informacje o certyfikatach SSL, które wygasają w ciągu 10, 15, 30 lub 90 dni, w zależności od wyboru w nowym polu rozwijanym wygaśnięcia.

Konfiguracja błędu ochrony przed zagrożeniami

Domyślnie Edge zgłasza kod stanu HTTP 500 wewnętrzny błąd serwera i błąd ExecutionFailed, jeśli wiadomość nie przejdzie przez zasadę ochrony przed zagrożeniami JSON lub XML. Możesz zmienić to zachowanie błędu za pomocą nowej właściwości na poziomie organizacji. Gdy właściwość organizacji features.isPolicyHttpStatusEnabled jest ustawiona na wartość true, zachowanie jest następujące:

  • Żądanie: jeśli do dowolnego przepływu żądań jest dołączona zasada ochrony przed zagrożeniami, nieprawidłowe wiadomości zwracają kod stanu 400 wraz z odpowiednim komunikatem o błędzie zasady.
  • Odpowiedź: jeśli zasada ochrony przed zagrożeniami jest dołączona do dowolnego przepływu odpowiedzi, nieprawidłowe wiadomości nadal zwracają kod stanu 500 i wyświetlany jest jeden z odpowiednich komunikatów o błędzie zasady (a nie tylko ExecutionFailed).

Klienci korzystający z Cloud muszą skontaktować się z zespołem pomocy Apigee Edge, aby ustawić właściwość organizacji. Ta funkcja będzie dostępna dla klientów Edge Private Cloud w następnej kwartalnej wersji Private Cloud.

Zaktualizowane schematy punktów końcowych, serwerów proxy i innych encji

Zaktualizowano schematy referencyjne dla encji nieobjętych 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

Poniżej znajdziesz nowe funkcje usług dla deweloperów, które są dostępne w tej wersji.

Ogólna dostępność SmartDocs

Funkcja SmartDocs wychodzi z wersji beta i staje się ogólnie dostępna. Aktualizacje i nowe funkcje obejmują:

  • Obsługa Swagger 2.0, w tym importowanie według pliku lub adresu URL, w tym obsługa obiektów zabezpieczeń o niestandardowych nazwach.
  • Ulepszenia wyglądu szablonów, które generują SmartDocs.
  • Ulepszenia użyteczności i przepływu pracy w portalu dla programistów, dostępne w menu Treść > SmartDocs w Drupalu.
  • Uwierzytelnianie za pomocą „tokena niestandardowego” jest teraz nazywane uwierzytelnianiem za pomocą „klucza interfejsu API”.
  • Obiekty „zabezpieczeń” uwierzytelniania zdefiniowane na poziomie wersji.
  • Konfiguracja uwierzytelniania klienta na poziomie szablonu. Nowe wersje nie powodują już resetowania wstępnie skonfigurowanych danych logowania klienta SmartDocs.

Więcej informacji o opisach cech znajdziesz w tym poście na blogu.

Dokumentację SmartDocs znajdziesz w artykule Dokumentowanie interfejsów API za pomocą SmartDocs.

Nazwa aplikacji dewelopera wyświetlana w interfejsie zarządzania

Aplikacje dewelopera w Edge mają zarówno wewnętrzną nazwę, która się nie zmienia, jak i wyświetlaną nazwę, którą można zmienić. Na stronie aplikacji dewelopera w interfejsie zarządzania (Opublikuj > Aplikacje dewelopera > nazwa aplikacji) wyświetlana jest wewnętrzna „Nazwa” aplikacji wraz z „Wyświetlaną nazwą”, co ułatwia wizualne identyfikowanie aplikacji po ich nazwach wewnętrznych na potrzeby rozwiązywania problemów i zarządzania interfejsami API.


Usługi analityczne

Poniżej znajdziesz nowe funkcje Analytics Services dostępne w tej wersji.

Limit czasu przechowywania danych

Podczas generowania raportów analitycznych za pomocą interfejsu zarządzania lub interfejsu API dane starsze niż 6 miesięcy od bieżącej daty są domyślnie niedostępne. Jeśli chcesz uzyskać dostęp do danych sprzed ponad 6 miesięcy, skontaktuj się z zespołem pomocy Apigee Edge.

Usunięcie klasycznej wersji raportów niestandardowych z interfejsu zarządzania

Opcjonalna klasyczna wersja niestandardowych raportów analitycznych nie jest już dostępna w interfejsie zarządzania.

Skuteczność widżetu zaangażowania deweloperów

Widżet ścieżki na głównym panelu statystyk (sekcja Zaangażowanie deweloperów) został ulepszony, aby zapewnić lepszą wydajność.


Zarabianie

Poniżej znajdziesz nowe funkcje zarabiania dostępne w tej wersji.

E-maile z powiadomieniem o abonamentach

Nowy typ powiadomienia e-mail dotyczącego abonamentu pozwala powiadamiać deweloperów, gdy osiągną określony limit transakcji lub kwoty w zakupionych abonamentach z pasmem wolumenu lub abonamentach pakietowych. Więcej informacji znajdziesz w artykule Konfigurowanie powiadomień za pomocą szablonów powiadomień.

Synchronizacja okresów Opłaty cyklicznej i Podstawy agregacji

W planie cenowym mogły obowiązywać 2 różne okresy:

  • Okres opłaty cyklicznej skonfigurowany na karcie Opłaty w planie taryfowym, który określał, kiedy deweloperzy byli obciążani opłatą cykliczną.
  • Okres podstawy agregacji, zdefiniowany w arkuszu stawek dla planów z pasmami wolumenu lub pakietami, który określał, kiedy użycie pakietu zostało zresetowane dla deweloperów.

Te 2 okresy są teraz zsynchronizowane. Jeśli w ramach abonamentu obowiązuje zarówno niezerowa opłata cykliczna, jak i tabela stawek z cenami zależnymi od ilości lub cenami pakietowymi, okres opłaty cyklicznej jest używany w obu przypadkach. Jeśli na przykład istnieje miesięczna opłata cykliczna, pakiety arkuszy stawek są również resetowane co miesiąc (domyślnie na początku miesiąca).

Jeśli nie ma opłaty cyklicznej, pakiety są resetowane na podstawie podstawy agregacji określonej w arkuszu stawek. Jeśli na przykład deweloper zacznie korzystać z karty stawek 19 dnia miesiąca, a podstawą agregacji jest każdy miesiąc, użycie pakietu zostanie zresetowane miesiąc po 19 dniu miesiąca.

Podstawa agregacji została wycofana i zostanie usunięta z funkcji zarabiania w przyszłej wersji. Więcej informacji znajdziesz w artykule Określanie szczegółów planu arkusza stawek.

Atrybuty niestandardowe w raportach Przychody

Zasady rejestrowania transakcji umożliwiają opcjonalne rejestrowanie danych atrybutów niestandardowych z transakcji. Możesz teraz uwzględniać te niestandardowe atrybuty transakcji w podsumowujących raportach dotyczących przychodów. Dodając do organizacji właściwość MINT.SUMMARY_CUSTOM_ATTRIBUTES, możesz wskazać, które atrybuty niestandardowe mają być dodawane do tabel bazy danych do wykorzystania w raportach.

Klienci Apigee Edge dla chmury prywatnej mogą ustawić flagę za pomocą tego wywołania interfejsu API i danych 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">[&quot;my_attribute_1&quot;,&quot;my_attribute_2&quot;]</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 SmartDocs

Jeśli korzystasz już z funkcji SmartDocs w okresie beta, nowe funkcje i możliwości w wersji ogólnej dostępności wymagają uaktualnienia SmartDocs w portalu dla programistów.

Wszystkie strony SmartDocs, które zostały już opublikowane w portalu dla programistów, będą nadal działać, ale przed edytowaniem lub opublikowaniem jakichkolwiek zmian na istniejących lub nowych stronach musisz wykonać proces aktualizacji.

Pamiętaj, że chociaż możesz renderować i publikować SmartDocs w portalu dla programistów, SmartDocs są generowane na podstawie modelu interfejsu API, który znajduje się w usługach zarządzania interfejsami API Edge firmy Apigee. Wszelkie zmiany wprowadzone w modelu interfejsu API w Edge będą takie same we wszystkich środowiskach Pantheon (podobnie jak deweloperzy istnieją we wszystkich środowiskach Pantheon).

Przechodzenie z wersji beta SmartDocs na ogólną dostępność

  1. Zaktualizuj i przetestuj wersję 15.05.27 w środowisku programistycznym lub testowym w Pantheon.
  2. Utwórz nowy model, aby zastąpić dotychczasowy model interfejsu API.
    • Jeśli importujesz dokumenty Swagger lub WADL, zaimportuj je ponownie do nowej wersji.
    • Jeśli model interfejsu API był utrzymywany za pomocą modułu SmartDocs, wyeksportuj go jako plik JSON SmartDocs i zaimportuj do nowego modelu za pomocą załącznika.
  3. Ustaw właściwości zabezpieczeń wersji modelu. Na stronie Treść > SmartDocs > model wybierz Ustawienia zabezpieczeń.
  4. Sprawdź wstępnie skonfigurowane uwierzytelnianie na stronie ustawień modelu (Treść > SmartDocs), klikając Ustawienia w kolumnie Operacje.
  5. Zaktualizuj wszystkie szablony niestandardowe, aby używały wersji 6 komponentów CSS i JS, oraz wprowadź zmiany odzwierciedlające nowe nazwy obiektów, takie jak authSchemes i apiSchema. Informacje o aktualizowaniu szablonów SmartDocs znajdziesz w artykule Korzystanie z funkcji SmartDocs do dokumentowania interfejsów API.
  6. Ponownie wyrenderuj i opublikuj wersję modelu.
  7. Po sprawdzeniu nowej dokumentacji zaktualizuj portal produkcyjny do wersji 15.05.27.

Jeśli jesteś klientem korzystającym z Edge Enterprise i masz pytania lub wątpliwości dotyczące procesu uaktualniania, wyślij e-maila na adres marsh@apigee.com i cnovak@apigee.com. W przeciwnym razie, aby uzyskać najlepszą odpowiedź, skorzystaj ze społeczności Apigee.


Przyszłe zmiany i ulepszenia funkcji

W tej sekcji znajdziesz podgląd oczekiwanych zmian i ulepszeń funkcji:

Zmiana zachowania zasady pamięci podręcznej odpowiedzi

W przyszłej wersji (do ustalenia) działanie domyślne elementu <ExcludeErrorResponse> zasady Response Cache ulegnie zmianie.

Obecne działanie: element <ExcludeErrorResponse> w zasadzie pamięci podręcznej odpowiedzi ma domyślnie wartość false. Oznacza to, że domyślnie odpowiedzi z dowolnym możliwym kodem stanu HTTP (w tym 3xx) są zapisywane w pamięci podręcznej przez zasadę Response Cache.

Przyszłe działanie: element <ExcludeErrorResponse> w zasadzie Response Cache będzie domyślnie ustawiony na wartość true. Oznacza to, że domyślnie w pamięci podręcznej będą zapisywane tylko odpowiedzi z kodami stanu HTTP od 200 do 205. Aby zastąpić to zachowanie i zapisać w pamięci podręcznej odpowiedzi dla wszystkich kodów stanu, musisz wyraźnie ustawić element <ExcludeErrorResponse> na wartość true.

Obecne obejście: w przypadku chmury prywatnej w wersji 4.15.07.00 i starszych, jeśli chcesz zapisywać w pamięci podręcznej odpowiedzi tylko z kodami stanu od 200 do 205, musisz wyraźnie ustawić element <ExcludeErrorResponse> na wartość true.


Naprawione błędy

W tej wersji naprawiliśmy te błędy.

Identyfikator problemu Opis
OPDK-1521 Problem z szyfrowaniem hasła
OPDK-1201 Nie można przywrócić danych interfejsu
OPDK-1112 Niestandardowe zasady haseł LDAP nie są stosowane do administratora Apigee
OPDK-1097 Wyjątek dotyczący przestrzeni kluczy podczas uaktualniania OPDK
OPDK-1068 Możliwość zmiany hasła administratora, jeśli nie powiedzie się to podczas instalacji
OPDK-1053 Zookeeper jest uruchomiony jako root
OPDK-967 Gdy ustawisz automatyczne uruchamianie OpenLDAP za pomocą set-autostart.sh, all-status.sh zgłasza, że usługa nie działa
OPDK-905 Smartdocs prod already registered in group axgroup001
OPDK-899 Błąd podczas wprowadzania
OPDK-847 Użytkownik utworzony podczas wprowadzania nie otrzymuje e-maila z prośbą o zresetowanie hasła
OPDK-817 Skrypty init.d zgłaszają błąd
OPDK-815 Skrypt ax-purge.sh wymaga czyszczenia tabel próbkowania
MGMT-2246 Strona „Utwórz raport niestandardowy” nie wyświetla się prawidłowo w interfejsie zarządzania
MGMT-2235 W przypadku wygasających certyfikatów SSL względny czas wygaśnięcia może być zaokrąglany w sposób mylący
W przypadku wygasających certyfikatów SSL względny czas wygaśnięcia jest zawsze wyświetlany w dniach, a nie zaokrąglany do miesięcy, gdy certyfikat wygasa w ciągu 90 dni lub mniej.
MGMT-2193 Wskaźnik ładowania podczas edytowania interfejsu API
MGMT-2173 Interfejs logów czasu nie zezwala na prawidłowe adresy URL
Interfejs logów czasu umożliwia teraz wysyłanie żądań z wartościami parametrów zapytania, które zawierają zagnieżdżone parametry zapytania.
MGMT-2162 Problem z kompilacją JavaScriptu
MGMT-2124 Uprawnienia roli klienta są resetowane podczas zapisywania uprawnień w interfejsie
MGMT-2114 Nieprawidłowy adres IP syslogu w zasadzie MessageLogging powinien powodować wyświetlenie odpowiedniego błędu podczas wdrażania
MGMT-2067 Śledzenie: jeśli wersja proxy interfejsu API została wdrożona w 2 środowiskach, wybór wersji i środowiska nie działa prawidłowo
MGMT-2061 Funkcja „Nie pamiętam hasła” powinna wysyłać e-maile tylko do zarejestrowanych użytkowników
Link „Nie pamiętasz hasła?” na stronie logowania interfejsu zarządzania wysyła e-maile tylko do zarejestrowanych użytkowników Apigee.
MGMT-2048 Użytkownik z rolą niestandardową, która ogranicza uprawnienia do wdrażania do jednego środowiska, może wdrażać w innych środowiskach
MGMT-2041 Usunięcie 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ż automatycznie dodawany podczas tworzenia serwerów proxy interfejsu API ani dodawania zasad.
MGMT-2034 Pobieranie WSDL zwraca błąd: „Błąd pobierania WSDL: błąd przetwarzania WSDL”.
MGMT-1986 Błąd interfejsu podczas dodawania dewelopera
MGMT-1983 Interfejs API „Uzyskiwanie kodu autoryzacji OAuth 2.0” zwraca nieprawidłowy stan
MGMT-1962 Błąd podczas logowania się w interfejsie zarządzania przy użyciu silnego hasła
Logowanie się w interfejsie przy użyciu niektórych znaków specjalnych, takich jak znak procentu, nie powoduje już błędu.
MGMT-1947 Nieintuicyjne role w interfejsie zarządzania
Jeśli użytkownik nie ma uprawnień do tworzenia ani edytowania zasad rejestrowania transakcji, przyciski interfejsu do tworzenia i edytowania zasad rejestrowania transakcji są teraz wyłączone.
MGMT-1899 Ścieżki zasobów usuwane po zapisaniu ustawień usługi
Podczas edytowania usługi API ścieżki zasobów usługi mogły zostać usunięte, jeśli użytkownik kliknął dwukrotnie przycisk Zapisz. Naprawiliśmy ten problem.
MGMT-1894 Strona Aplikacje dewelopera nigdy nie kończy się ładować w kolumnie dewelopera
MGMT-1882 Nowy serwer proxy interfejsu API z WSDL pokazuje tylko szczegóły ostatniego parametru
MGMT-1878 Jeśli w środowisku wdrożono kilka wersji, Trace wyświetla tylko jedną z nich
MGMT-1872 Nie można pobrać raportów niestandardowych
MGMT-1863 Logi Node.js nie są widoczne w interfejsie zarządzania
MGMT-1843 Nie można otworzyć serwera proxy interfejsu API
MGMT-1833 Użytkownik sysadmin nie powinien mieć opcji zmiany hasła w interfejsie OPDK
MGMT-1825 Błędy typu cross-site scripting (XSS)
MGMT-1824 Błąd pobierania pliku WSDL podczas importowania pliku WSDL z rozszerzeniem .xml
MGMT-1812 Dodanie weryfikacji TargetEndpoint podczas importowania
Podobnie jak w przypadku ProxyEndpoint, podczas importowania serwera proxy interfejsu API TargetEndpoint będzie sprawdzany pod kątem prawidłowego schematu i wyrażeń używanych w warunkach.
MGMT-1804 Interfejs API Node.js w niektórych przypadkach wysyła nieprawidłowy kod JSON
Ekran logów Node.js wyświetlał niesformatowane logi, jeśli dane JSON zawierały nieprawidłowe znaki. W tej wersji problem został rozwiązany, a interfejs wyświetla teraz prawidłowo sformatowane logi node.js.
MGMT-1802 Adres URL resetowania hasła #118
Jeśli interfejs użytkownika zarządzania znajduje się za serwerem kończącym SSL, interfejs użytkownika zarządzania prawidłowo generuje teraz e-maila z prośbą o zresetowanie hasła z linkiem do adresu URL https zamiast http.
MGMT-1799 Luka w zabezpieczeniach interfejsu użytkownika podczas wysyłania żądania w Trace
MGMT-1777 Nie można dodać użytkownika z adresem e-mail z domeną najwyższego poziomu .acn
MGMT-1735 Błąd podczas pobierania W w przypadku marki
Ze skutkiem natychmiastowym usunęliśmy obsługę niestandardowej marki w Edge OPDK. Zdajemy sobie sprawę, że może to rozczarować nielicznych klientów, którzy korzystali z tej funkcji, ale nie poprawia ona bezpośrednio możliwości Edge w zakresie zarządzania interfejsami API.
MGMT-1569 Problem z dołączaniem serwera proxy interfejsu API do istniejącego produktu interfejsu API
Rozwiązaliśmy problem z dołączaniem serwera proxy interfejsu API do produktu interfejsu API w interfejsie zarządzania, gdy serwer proxy interfejsu API miał zasób dla ścieżki „/”.
MGMT-1563 Przycisk wysyłania w Trace pozostaje wyłączony, jeśli wystąpi błąd
MGMT-1362 E-mail z linkiem do resetowania hasła nie działa, jeśli adres e-mail zawiera znak „_”
Rozwiązuje problem z resetowaniem hasła w OPDK w przypadku adresów e-mail zawierających podkreślenie.
MGMT-1345 Importowanie pliku WSDL z wieloma przestrzeniami nazw powoduje nieprawidłowy krok tworzenia SOAP
MGMT-1193 Zapisanie serwera proxy jako nowej wersji powoduje nieoczekiwaną zmianę reguły trasy
MGMT-1061 SmartDocs: opis parametru typu treści w definicji Swagger nie jest wyświetlany w interfejsie dokumentacji
MGMT-800 Utworzenie zasobu o nazwie „default” powoduje uszkodzenie interfejsu
MGMT-787 Problem z użytecznością alertu w interfejsie
W interfejsie zarządzania, gdy klikniesz + proxy interfejsu API i pojawi się okno New API Proxy, możesz nacisnąć Esc, aby je zamknąć.
MGMT-619 Aktywowanie podziału na strony na stronie interfejsu użytkownika serwera proxy interfejsu API
MGMT-602 Widok programowania serwera proxy interfejsu API: dodanie zasady Response Cache, gdy punkt końcowy nie ma PreFlow/PostFlow, powoduje błąd
MGMT-460 Zmiana nazwy zasady powoduje błędy i tworzenie zduplikowanej zasady, której nie można usunąć
DEVRT-1644 Wyszukiwanie powiadomień według nazwy powoduje wysłanie nieprawidłowego e-maila
DEVRT-1583 Interfejs zarabiania wyświetla plakietkę „Przyszły” dla bieżącego abonamentu
DEVRT-1546 Limity abonamentu nie działają
DEVRT-1511 Błąd mint.resourceDoesNotExist w przypadku istniejącego dewelopera
CORERT-639 TCPSysLogSocket musi być asynchroniczny
CORERT-613 Błędy uzgadniania połączenia za pomocą protokołu SSL z powodu „unrecognized_name”
AXAPP-1728 Ignorowanie zmiennych związanych z zarabianiem w statystykach
AXAPP-1708 Interfejs Analytics API podaje różne liczby dla tej samej statystyki w zależności od tego, jak sformułuję zapytanie
AXAPP-1707 Ulepszanie skuteczności bezpłatnych statystyk podcastu
AXAPP-1690 „Błąd nieprawidłowego interfejsu API” w raportach niestandardowych
AXAPP-1533 Mapa geograficzna Analytics zgłasza błąd nieprawidłowego wywołania interfejsu API
AXAPP-1493 Nieprawidłowe statystyki wydajności pamięci podręcznej
APIRT-1436 Tworzenie narzędzia lub skryptu do szyfrowania niezaszyfrowanych tokenów
APIRT-1425 Atrybut continueOnError ustawiony na „true” nie ma wpływu na zasadę JavaCallout
APIRT-1346 OAuth2.0 – wartość skrótu jest zwracana w odpowiedzi tokena dostępu, gdy parametr hash.oauth.tokens.enabled ma wartość true
APIRT-1206 target_ip nie jest rejestrowany w tabeli faktów w przypadku błędów 503 i większości błędów 504
APIRT-1170 Brak pliku zasobu spowodował, że MP nie udało się wczytać środowiska
APIRT-1148 GET of {message.version} variable in ResponseFlow, for a Node.js target throws NPE
APIRT-1054 Rejestrowanie komunikatów nie działa podczas próby rejestrowania w innym katalogu niż domyślny
APIRT-387 Uruchamianie usługi OrganizationService w wariancie „inne” na platformie handlowej
APIRT-67 Zasada GenerateAccessToken protokołu OAuth nie ustawia prawidłowo zmiennej oauthV2.failed
APIRT-52 Raporty niestandardowe: kody stanu odpowiedzi dla wielu interfejsów API mają wartość null

Znane problemy

W tej wersji występują te znane problemy.

Identyfikator problemu Opis
OPDK-1586

Jeśli obsługa protokołu IPv6 nie jest włączona, nie można uruchomić portalu API BaaS
Aby uruchomić portal API BaaS, możesz zmienić w komentarz ten wiersz IPv6 w pliku /<install-dir>/apigee4/conf/nginx/conf.d/loadbalancer.conf lub włączyć obsługę protokołu IPv6:

# listen [::]:8080;

OPDK-1785

Instalowanie komponentu zarabiania w uaktualnionym środowisku Edge
Jeśli uaktualnisz instalację Edge do wersji 4.15.07.00 i nie korzystasz jeszcze z zarabiania, nie możesz zainstalować zarabiania w Edge w wersji 4.15.07.00.

Aby rozwiązać ten problem, przed próbą zainstalowania Zarabiania ustaw odpowiednią wersję Zarabiania w pliku apigee-env.sh. Aby uzyskać wersję Zarabiania w 4.15.07 (po uaktualnieniu do Edge 4.15.07), uruchom:
> 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 install-dir to /opt.
Wartość VER z powyższego przykładu musi być ustawiona w pliku apigee-env.sh:
> sed -i "s/^MONETIZATION_VERSION=.*/MONETIZATION_VERSION=$VER/" /install-dir/apigee4/bin/apigee-env.sh
Jeśli spróbujesz zainstalować funkcję Zarabianie bez wykonania powyższych czynności, instalacja się nie powiedzie i prawdopodobnie w katalogu udostępniania pojawi się nieaktywne dowiązanie symboliczne. Musisz usunąć to dowiązanie symboliczne:
> rm /install-dir/apigee4/share/monetization
Po usunięciu dowiązania symbolicznego wykonaj opisane powyżej czynności, aby ustawić wersję Monetization, a następnie spróbuj ponownie zainstalować Monetization.
OPDK-1857 Wersja Pythona 2.6 zakodowana na stałe w bin/qpid-stat.sh i bin/qpid-config.sh

W systemach CentOS i RedHat 7.0 kilka skryptów w bin/qpid-stat.sh i bin/qpid-config.sh jest zakodowanych na stałe, aby używać Pythona w wersji 2.6.

Aby obejść ten problem, zmień wiersz eksportujący PYTHONPATH w plikach qpid-stat.sh i qpid-config.sh w katalogu apigee4/bin.

export PYTHONPATH="${QPID_DIR}/lib/python2.6/site-packages"

Aby określić wersję Pythona w systemie, sprawdź wersję Pythona w katalogu /opt/apigee4/share/apache-qpid/lib. Katalog to najprawdopodobniej python2.7.

Następnie musisz zaktualizować ustawienie PYTHONPATH w plikach qpid-stat.sh i qpid-config.sh, podając prawidłową ścieżkę. Na przykład:

export PYTHONPATH="${QPID_DIR}/lib/python2.7/site-packages"

DEVRT-1574 Niespójne saldo i wykorzystanie w przypadku deweloperów z wieloma aktywnymi planami taryfowymi
W przypadku zarabiania, jeśli deweloper ma więcej niż 1 aktywny plan taryfowy z opłatami za wywołanie interfejsu API, wykorzystanie salda może być czasami niespójne.
APIBAAS-1647 Po zalogowaniu się jako administrator systemu interfejs BaaS wyświetla komunikat „Error getting roles” (Błąd podczas pobierania ról)
Ten komunikat o błędzie pojawia się przy pierwszym logowaniu się administratora systemu po uaktualnieniu z wersji 4.15.01 do 4.15.07. Możesz zignorować tę wiadomość.
DEVRT-1834 Uaktualnienie modułu zarabiania do wersji 4.15.07
Skrypt apigee-upgrade.sh wyświetla na końcu ten komunikat z prośbą o wykonanie innego skryptu:
**************************************
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 W nowej instalacji funkcji zarabiania brakuje konfiguracji powiadomień
W nowej instalacji Apigee Edge dla chmury prywatnej w wersji 4.15.07.00 brakuje tych konfiguracji powiadomień o zarabianiu. Odpowiadają one typom powiadomień na stronie Administracja > 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 rozwiązać ten problem, wykonaj te czynności. Potrzebujesz adresu IP instancji Cassandra. Znajdziesz go w pliku <installation-root>/apigee4/conf/cassandra/cassandra.yaml lub <installation-root>/apigee4/conf/cassandra/cassandra-topology.properties.
  1. Uruchom te polecenia. Zmienną {ORG_ID} pozostaw bez zmian, ale zastąp zmienne <org_name>, <installation-root> i <cassandra_ip_address>.
    sed -e "s/\${ORG_ID}/<org_name>/g" <installation-root>/apigee4/share/monetization/schema/cassandra/org/ui/mint-org-specific-ui-schedulers.txt > /tmp/mint-org-specific-ui-schedulers.txt
    
    <installati>on-root/apigee4/share/apache-cassandra/bin/cassandra-cli -h <cassandra_ip_address> -f /tmp/mint-org-specific-ui-schedulers.txt
  2. Ponownie uruchom serwer zarządzania.
DEVRT-1952 W przypadku uaktualnienia Zarabiania z wersji 4.14.07.00 brakuje konfiguracji powiadomień
Podczas uaktualniania Apigee Edge dla chmury prywatnej z wersji 4.14.07.00 do 4.15.07.00 brakuje tych konfiguracji powiadomień o zarabianiu, co powoduje nieprawidłowe działanie raportów dotyczących zarabiania.
mint.scheduler.${ORG_ID}.chargedaily@@@management
mint.scheduler.${ORG_ID}.chargehourly@@@management
Aby rozwiązać ten problem, wykonaj te czynności. Potrzebujesz adresu IP instancji Cassandra. Znajdziesz go w pliku <installation-root>/apigee4/conf/cassandra/cassandra.yaml lub <installation-root>/apigee4/conf/cassandra/cassandra-topology.properties.
  1. Uruchom te polecenia. Zmienną {ORG_ID} pozostaw bez zmian, ale zastąp zmienne <org_name>, <installation-root> i <cassandra_ip_address>.
    sed -e "s/\${ORG_ID}/<org_name>/g" <installation-root>/apigee4/share/monetization/schema/cassandra/org/system/mint-org-specific-system-schedulers.txt > /tmp/mint-org-specific-system-schedulers.txt
    
    <installati>on-root/apigee4/share/apache-cassandra/bin/cassandra-cli -h <cassandra_ip_address> -f /tmp/mint-org-specific-system-schedulers.txt
  2. Ponownie uruchom serwer zarządzania.
OPDK-1878 Nie można ustawić nazwy poda w instalacji w wielu centrach danych
Przewodnik instalacji Edge określa, że w plikach instalacji dyskretnej w przypadku instalacji w wielu centrach danych nazwy podów należy ustawić jako „gateway-1” i „gateway-2”. Jednak zmiana nazwy poda uniemożliwia prawidłowe zarejestrowanie routerów i procesorów komunikatów oraz dostęp do nich. Ten problem uniemożliwia też skryptowi setup-org.sh znalezienie dostępnych procesorów komunikatów.

Obejście polega na ustawieniu nazwy poda na „gateway” za pomocą właściwości MP_POD w pliku instalacji dyskretnej dla obu centrów danych.
OPDK-1886

Node nie może uzyskać dostępu do lokalnych adresów IP, takich jak 192.168.x.y
Podczas próby uzyskania dostępu do lokalnego adresu IP pojawia się błąd „connect EINVAL”.
Aby obejść ten problem, zmodyfikuj plik /<install_dir>/apigee4/conf/apigee/message-processor/nodejs.properties w węzłach procesora komunikatów, aby zmienić w komentarz ten wiersz:

connect.ranges.denied=10.0.0.0/8,192.168.0.0/16,127.0.0.1/32

Następnie uruchom ponownie węzły procesora komunikatów:

<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 na serwerze zarządzania.
W czasie działania te komponenty wymagają dostępu do portu 8080 na serwerze zarządzania: router, procesor komunikatów, interfejs, Postgres i Qpid. Jednak podczas uaktualniania wszystkie węzły, w tym węzły Cassandra i Zookeeper, będą wymagać dostępu do portu 8080 na serwerze zarządzania.
OPDK-1962 Po uaktualnieniu musisz ponownie skonfigurować SSL dla interfejsu API Edge
Jeśli przed uaktualnieniem do wersji 4.15.07.00 interfejs API Edge został skonfigurowany do korzystania z SSL, po uaktualnieniu musisz ponownie skonfigurować SSL. Procedurę konfigurowania protokołu SSL dla interfejsu API Edge znajdziesz w Przewodniku po operacjach Edge.