Wyświetlasz dokumentację Apigee Edge.
Zapoznaj się z dokumentacją Apigee X. info
We wtorek 19 maja 2015 r. udostępniliśmy kwartalną wersję Apigee Edge Private Cloud.
Poprzednia nazwa produktu „Apigee Edge On-premises” lub „OPDK” to teraz „Apigee Edge for Private Cloud”.
Jeśli masz pytania, skontaktuj się z zespołem pomocy Apigee Edge.
Listę wszystkich informacji o wersjach Apigee Edge znajdziesz w informacjach o wersjach Apigee.
Nowe funkcje i ulepszenia
Poniżej znajdziesz nowe funkcje i ulepszenia w tej wersji.
OpenLDAP – instalacja i uaktualnianie
OpenLDAP jest teraz jedynym serwerem LDAP obsługiwanym przez Edge w przypadku nowych instalacji i aktualizacji.
Usługi API
Poniżej znajdziesz nowe funkcje i ulepszenia w usługach API Edge.
WebSockets
Aby umożliwić komunikację w czasie rzeczywistym między klientem internetowym a serwerem, Edge obsługuje protokół WebSocket. Edge może pełnić rolę klienta lub serwera w komunikacji WebSocket. Informacje o konfigurowaniu i używaniu protokołu WebSocket w Edge znajdziesz w przewodniku Apigee Edge dla chmury prywatnej z użyciem protokołu WebSocket.
Obsługa zewnętrznego dostawcy uwierzytelniania w zarządzaniu interfejsami API
Edge integruje się z Active Directory i innymi zewnętrznymi dostawcami uwierzytelniania lub systemami LDAP, które zawierają użytkowników administracyjnych interfejsu API. Więcej informacji znajdziesz w przewodniku Edge for Private Cloud – konfiguracja uwierzytelniania zewnętrznego.
Łączenie marek w interfejsie zarządzania
Możesz dodać do interfejsu zarządzania Edge własne logo, które będzie wyświetlane obok logo Apigee. Więcej informacji znajdziesz w rozdziale „Dodawanie niestandardowego logo do menu interfejsu Apigee” w Przewodniku po operacjach Apigee Edge na potrzeby chmury prywatnej.
Logi Node.js w Trace
Podczas debugowania serwerów proxy interfejsu API Node.js możesz włączyć funkcję dziennika Node.js w widoku śledzenia edytora serwera proxy interfejsu API. Aby włączyć tę funkcję, ustaw
apigee.feature.disableNodeJSLogs="false" w pliku apigee-base.conf lub
apigee-onpremise.conf w instalacji. Więcej informacji o logach Node.js znajdziesz w sekcji Debugowanie i rozwiązywanie problemów z proxy Node.js.
Wygasanie haseł
W Edge w wersji 4.15.01.x hasła Edge automatycznie wygasały po 30 dniach. Oznaczało to, że użytkownik tracił dostęp do konta, chyba że zmienił hasło przed jego wygaśnięciem. Spowodowało to jednak również wygaśnięcie hasła administratora systemu, przez co nie mógł on zalogować się w Edge.
Po uaktualnieniu do wersji 4.15.04.00 domyślne ustawienie zostanie zmienione tak, aby hasła nie wygasały. W razie potrzeby możesz skonfigurować wygasanie haseł Edge za pomocą skryptu /opt/apigee4/bin/apigee-enable-pwlockout.sh. Więcej informacji znajdziesz w Przewodniku po operacjach Apigee Edge na potrzeby chmury prywatnej.
Ograniczanie dostępu administratora systemu do określonych domen poczty e-mail
Możesz ograniczyć członkostwo w rolach administratora systemu lub administratora systemu tylko do odczytu do użytkowników z określonych domen e-mail. Aby włączyć tę funkcję, dodaj dozwolone domeny do pliku apigee4/conf/apigee/management-server/security.properties zgodnie z opisem w Przewodniku po operacjach Apigee Edge w chmurze prywatnej.
Komunikaty o błędach w interfejsie zarządzania
Wyświetlanie komunikatów o błędach w interfejsie zarządzania zostało przeprojektowane, aby efektywniej wykorzystywać miejsce na ekranie.
Nowe zmienne błędów OAuthV2
Te nowe zmienne związane z błędami są ustawiane przez zasadę OAuthV2:
- oauthV2.<policy-name>.failed – ustaw wartość „true”, jeśli zasada nie powiodła się.
- oauthv2.<policy_name>.<fault_name> – nazwa błędu. Na przykład invalid_request
- oauthv2.<policy_name>.<fault_cause> – przyczyna błędu. Przykład: Token wygasł
Zobacz http://apigee.com/docs/api-services/content/oauthv2-policy.
Tworzenie produktu
Podczas tworzenia nowego produktu możesz teraz podać jego nazwę oprócz nazwy wyświetlanej.
Zobacz http://apigee.com/docs/developer-services/content/creating-api-products.
Interfejs usuwania użytkowników z organizacji
Na stronie Użytkownicy organizacji w interfejsie przycisk Usuń został zastąpiony przyciskiem Usuń. Ma to na celu wyjaśnienie, że gdy usuniesz użytkownika z organizacji, jego konto Apigee pozostanie aktywne.
Zobacz http://apigee.com/docs/api-services/content/managing-organization-users.
Opcje filtrowania w interfejsie zarządzania
Na stronach Interfejsy API, Produkty, Deweloperzy i Aplikacje w interfejsie zarządzania dostępne są nowe opcje filtrowania wyszukiwania.
Narzędzie Offline Trace
Narzędzie Offline Trace umożliwia wyświetlanie i analizowanie wcześniej zapisanych sesji śledzenia. Zapisana sesja śledzenia to w zasadzie „nagranie” sesji śledzenia, które może być przydatne w przypadkach, gdy wymagane jest rozwiązywanie problemów i dalsza analiza. Interfejs narzędzia do śledzenia offline jest podobny do interfejsu narzędzia do śledzenia „na żywo”.
Więcej informacji znajdziesz w artykule Korzystanie z narzędzia do śledzenia offline.
Role użytkowników wyświetlane w ustawieniach użytkownika
Na stronie Ustawienia użytkownika w interfejsie zarządzania (nazwa użytkownika > Ustawienia użytkownika) są teraz wyświetlane role użytkownika.
Ulepszenia interfejsu zarządzania urządzeniami brzegowymi
Ta wersja zawiera szereg drobnych ulepszeń interfejsu zarządzania Edge, które zwiększają łatwość obsługi i spójność.
Usługi analityczne
Poniżej znajdziesz nowe funkcje i ulepszenia w usługach analitycznych Edge.
Dostępne dane z 6 miesięcy
Podczas generowania raportów analitycznych w interfejsie zarządzania lub interfejsie API dane starsze niż 6 miesięcy od bieżącej daty nie są domyślnie dostępne. Jeśli chcesz uzyskać dostęp do danych starszych niż 6 miesięcy, skontaktuj się z zespołem pomocy Apigee Edge.
Zmienne dodane do statystyk
Do Edge Analytics są przekazywane te nowe zmienne, które są widoczne na etapie AX w oknie śledzenia serwera proxy interfejsu API.
- apigee.edge.execution.is_target_error – umożliwia określenie, czy błędy interfejsu API są błędami po stronie docelowej (wartość „1”) czy błędami po stronie innej niż docelowa w przypadku nieudanych odpowiedzi HTTP (wartość „0”). W przypadku prawidłowej odpowiedzi HTTP wartość jest równa null.
-
apigee.edge.execution.is_policy_error – umożliwia określenie, czy zasada zakończyła się niepowodzeniem (wartość „1”), czy w nieudanej odpowiedzi HTTP nie zakończyła się niepowodzeniem żadna zasada (wartość „0”). W przypadku prawidłowej odpowiedzi HTTP wartość jest równa null.
Poniższe powiązane zmienne zawierają szczegółowe informacje o zasadach, które jako pierwsze spowodowały błąd. Wartości są puste, jeśli żadna zasada nie została naruszona.- apigee.edge.execution.fault_policy_name – nazwa zasady, która spowodowała błąd.
- apigee.edge.execution.fault_flow_name – nazwa procesu w zasadach, które spowodowały błąd (np. PreFlow, PostFlow lub proces zdefiniowany przez użytkownika).
- apigee.edge.execution.fault_flow_state – miejsce, w którym zasada została dołączona do przepływu. Możliwe wartości: PROXY_REQ_FLOW, TARGET_REQ_FLOW, TARGET_RESP_FLOW, PROXY_RESP_FLOW.
Panele
- Wykresy skuteczności interfejsów API, deweloperów, produktów i aplikacji deweloperów zostały przeniesione. Wcześniej były one wyświetlane u dołu głównych stron tych podmiotów. Teraz możesz uzyskać dostęp do wykresów, klikając kartę Statystyki u góry każdej strony.
- Ta wersja zawiera ważne zmiany w tych dotychczasowych i nowych panelach:
- Panel Apigee (zmieniony): zawiera 3 wykresy danych: ruch serwera proxy, zaangażowanie deweloperów i aplikacje deweloperów. Każdy wykres zawiera widok „Więcej szczegółów”, który umożliwia zgłębianie poszczególnych rodzajów danych. Zobacz panel Apigee.
- Wydajność serwera proxy (nowość): pokazuje wzorce ruchu serwera proxy interfejsu API i czasy przetwarzania. Zastępuje panel Skuteczność proxy interfejsu API. Zobacz Wydajność serwera proxy interfejsu API.
- Skład wizyt (zmieniony): całkowicie zmieniony wygląd i zawartość panelu. Mierzy względny udział najlepszych interfejsów API, aplikacji, programistów i usług w całym programie API. Zobacz Skład ruchu.
- Analiza błędów (zmieniona): całkowicie zmieniony wygląd i treść. Wyświetla odsetek błędów w przypadku proxy interfejsu API i celów. Zobacz panel analizy kodów błędów.
-
Zmieniliśmy nazwy tych paneli:
- Skuteczność punktu końcowego została zmieniona na Skuteczność celu: pokazuje wzorce ruchu i dane o skuteczności docelowych punktów końcowych backendu proxy interfejsu API. Zobacz Docelowa skuteczność.
- Raport Zaangażowanie partnerów został zmieniony na Zaangażowanie deweloperów: pokazuje, którzy zarejestrowani deweloperzy aplikacji generują największy ruch w interfejsie API. W przypadku każdego dewelopera możesz sprawdzić, kto generuje największy ruch w interfejsie API i najwięcej błędów. Zobacz sekcję Zaangażowanie deweloperów.
Usługi dla deweloperów
Poniżej znajdziesz nowe funkcje i ulepszenia w usługach dla deweloperów Edge.
Obsługa Swaggera 2.0 w SmartDocs
SmartDocs obsługuje importowanie dokumentów specyfikacji Swagger 2.0 i zachowuje zgodność wsteczną ze Swagger 1.2. Obsługa obiektów schematu zabezpieczeń i scentralizowanych schematów będzie dostępna w kolejnej wersji.
Zarabianie
Oto nowe funkcje i ulepszenia w zakresie zarabiania na Edge: Więcej informacji o zarabianiu znajdziesz też w sekcji „Znane problemy”.
Oddzielne traktowanie firm i deweloperów
Firmy i deweloperzy są teraz obsługiwani oddzielnie, co zapewnia większą elastyczność w dodawaniu wielu firm do deweloperów i wielu deweloperów do firm. Interfejs zarządzania ma teraz osobne okna „Firmy” i „Deweloperzy” (dostępne w menu „Opublikuj”).
Zobacz Zarządzanie firmami i deweloperami.
W raportach dotyczących zarabiania firmy pozostają głównym filtrem, chociaż etykieta filtra zmieniła się z „Deweloperzy” na „Firmy”.
Usunięte błędy
W tej wersji naprawiliśmy te błędy:
| Identyfikator problemu | Opis |
|---|---|
| OPDK-954 | 4.15.01 Nie uaktualniono schematu Cassandra |
| MGMT-1986 | Błąd interfejsu podczas dodawania dewelopera |
| MGMT-1983 | Interfejs API pobierania kodu autoryzacji OAuth 2.0 zwraca nieprawidłowy stan |
| MGMT-1962 | Błąd logowania się w interfejsie zarządzania przy użyciu silnego hasła Logowanie się w interfejsie przy użyciu niektórych znaków specjalnych, np. znaku procentu, nie kończy się już niepowodzeniem. |
| MGMT-1894 | Strona Aplikacje dewelopera nigdy się nie wczytuje w przypadku kolumny dewelopera |
| MGMT-1872 | Nie można pobrać raportów niestandardowych |
| MGMT-1777 | Nie można dodać użytkownika z adresem e-mail, którego domena najwyższego poziomu to .acn |
| MGMT-1362 | E-mail z prośbą o zresetowanie hasła nie działa, jeśli adres e-mail zawiera znak „_” Rozwiązuje problem z resetowaniem hasła w chmurze prywatnej w przypadku adresów e-mail zawierających znak podkreślenia. |
| CORERT-613 | Nieudane uzgodnienia połączenia za pomocą protokołu SSL z powodu błędu „unrecognized_name” |
| APIRT-1346 | OAuth 2.0 – w odpowiedzi tokena dostępu zwracana jest wartość skrótu, gdy parametr hash.oauth.tokens.enabled ma wartość true |
Ta wersja zawiera też poprawki błędów z tych wersji:
| Edge Cloud | Edge for Private Cloud |
|---|---|
Znane problemy
W tej wersji występują te znane problemy.
| Identyfikator problemu | Opis |
|---|---|
| Nie dotyczy |
W wersji nie uwzględniono 2 skryptów Cassandry, których instalator używa podczas instalacji lub uaktualniania monetyzacji. Aby obejść ten problem, po zainstalowaniu lub uaktualnieniu Cassandry uruchom te polecenia, aby dokończyć instalację lub uaktualnienie funkcji zarabiania:
|
| CORERT-318 | Wywołania interfejsu API z dużymi ładunkami (setki kilobajtów) mogą czasami się zawieszać. Aby obejść ten problem, ustaw w pliku router.properties tę wartość właściwości:HTTPServer.streaming.buffer.limit=0 (domyślne ustawienie to 10) |