4.15.07.00 – Informacje o wersji Apigee Edge dla Private Cloud

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

Przed uaktualnieniem upewnij się, że w każdym węźle Cassandra została uaktualniona platforma Cassandra SSTable:
  1. Sprawdź wersję systemu Cassandra SSTable:
    1. Zmień katalog na /<install-root>/apigee4/data/cassandra/data.
    2. Uruchom polecenie znajdowania (
      ) > Znajdź . -name *-ic-*
      Jeśli korzystasz z Cassandra 1 .2 SSTable, wyniki powinny zwrócić zestaw plików.db.
    3. 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.
  2. 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
  3. Powtórz krok 1, aby sprawdzić, czy wszystkie pliki *.db są w formacie ic dla systemu Cassandra 1.2. wersji.
  4. Powtórz kroki od 1 do 3 w każdym węźle Cassandra w instalacji Edge.
  5. Uaktualnij do wersji Edge 4.15.07.00.
  6. 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:
    &gt; cd /&lt;install-root&gt;/apigee4/data/cassandra/data
    &gt; 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) &gt; 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.

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ępuje target.basepath.with.query.
  • Serwer docelowy: loadbalancing.targetserver zastępuje targetserver.name. Pole target.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 &gt; 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">[&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 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ą

  1. Zaktualizuj i przetestuj wersję 15.05.27 w środowiska deweloperskiego lub testowego na Panteon.
  2. 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.
  3. Ustaw właściwości zabezpieczeń wersji modelu. W sekcji Treść > SmartDokumenty > modelu, wybierz Security Settings (Ustawienia zabezpieczeń).
  4. Sprawdź wszystkie skonfigurowane wstępnie uwierzytelnianie na stronie ustawień modelu (Treść > SmartDocuments), klikając Ustawienia w narzędziu Operacje. .
  5. 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.
  6. Wyrenderuj ponownie i opublikuj wersję modelu.
  7. 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ć &lt;ExcludeErrorResponse&gt; 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
Obejściem problemu jest skomentowanie tego wiersza IPV6 w pliku /&lt;install-dir&gt;/apigee4/conf/nginx/conf.d/loadbalancer.conf aby uruchomić portal BaaS API lub włączyć obsługę IPV6:

# listen [::]:8080;

OPDK-1785

Zainstaluj komponent zarabiania na uaktualnionej przeglądarce Edge środowisko
Jeśli po zaktualizowaniu instalacji Edge do wersji 4.15.07.00 nie był używany zarabiania przed aktualizacją, nie możesz zainstalować funkcji zarabiania w 15.07.04. Edge.

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.

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

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:

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

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 &lt;installation-root&gt;/apigee4/conf/cassandra/cassandra-topology.properties.
  1. Uruchom następujące polecenia. Pozostaw zmienną {ORG_ID} bez zmian, ale zastąp <nazwa_organizacji>, <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
    
    <installation-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 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 &lt;installation-root&gt;/apigee4/conf/cassandra/cassandra-topology.properties.
  1. Uruchom następujące polecenia. Pozostaw zmienną {ORG_ID} bez zmian, ale zastąp <nazwa_organizacji>, <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
    
    <installation-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, 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
Pojawia się błąd „połącz EINVAL” podczas próby uzyskania dostępu do lokalnego adresu IP.
Można obejść ten problem, edytując plik /&lt;install_dir&gt;/apigee4/conf/apigee/message-processor/nodejs.properties w węzłach procesora wiadomości, dodając komentarz w tym wierszu:

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.