Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje
We wtorek, 19 maja 2015 r., wydaliśmy kwartalną wersję Apigee Edge dla Private Cloud.
Nazwa usługi „Apigee Edge On-premises” lub „OPDK” to teraz „Apigee Edge for Private Cloud”.
Jeśli masz pytania, odwiedź stronę pomocy Apigee.
Listę wszystkich informacji o wersjach Apigee Edge znajdziesz w artykule Informacje o wersjach Apigee.
Nowe funkcje i ulepszenia
Poniżej znajdziesz nowe funkcje i udoskonalenia w tej wersji.
OpenLDAP – instalacja i uaktualnienie
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 udoskonalenia usług interfejsu Edge API.
WebSockets
Aby umożliwić komunikację internetową w czasie rzeczywistym między klientem a serwerem, Edge obsługuje protokół WebSocket. W komunikacji WebSocket przeglądarka Edge może pełnić rolę klienta lub serwera. Informacje o konfigurowaniu i używaniu WebSockets w Edge znajdziesz w przewodniku Apigee Edge w prywatnej chmurze korzystającej z WebSockets.
Obsługa zewnętrznego dostawcy uwierzytelniania w ramach zarządzania 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: konfigurowanie uwierzytelniania zewnętrznego.
Łączenie marek w interfejsie zarządzania
Możesz dodać do interfejsu zarządzania w usłudze Edge swoje logo, które będzie widoczne obok logo Apigee. Więcej informacji znajdziesz w sekcji „Dodawanie niestandardowego logo do menu interfejsu Apigee” w przewodniku Apigee Edge for Private Cloud Operations.
Logi Node.js w Trace
Podczas debugowania przekierowań interfejsu API Node.js możesz włączyć funkcję dzienników Node.js w widoku śledzenia w edytorze przekierowania interfejsu API. Aby włączyć tę funkcję, ustaw zmienną apigee.feature.disableNodeJSLogs="false" w pliku apige-base.conf lub apige-onpremise.conf w instalacji. Więcej informacji o logach Node.js znajdziesz w artykule Debugowanie i rozwiązywanie problemów z proxy Node.js.
Wygasanie haseł
W Edge 4.15.01.x hasła w Edge wygasają automatycznie po 30 dniach. Oznacza to, że użytkownik nie mógł się zalogować, chyba że zmienił hasło przed jego wygaśnięciem. Jednak spowodowało to też wygaśnięcie hasła administratora systemu, przez co nie mógł on zalogować się w Edge.
Po przejściu na wersję 4.15.04.00 domyślnie hasła nie będą wygasać. W razie potrzeby możesz skonfigurować wygasanie haseł w Edge za pomocą skryptu /opt/apigee4/bin/apigee-enable-pwlockout.sh. Więcej informacji znajdziesz w przewodniku Apigee Edge for Private Cloud Operations.
Ograniczanie dostępu administratora do określonych domen poczty e-mail
Możesz ograniczyć przynależność do ról administratora lub administratora 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 Apigee Edge for Private Cloud Operations.
Komunikaty o błędach w interfejsie zarządzania
Wyświetlanie komunikatów o błędach w interfejsie zarządzania zostało zmienione, aby bardziej efektywnie wykorzystywać przestrzeń ekranu.
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 zadziałała.
- oauthv2.<policy_name>.<fault_name> – nazwa błędu. Na przykład invalid_request.
- oauthv2.<policy_name>.<fault_cause> – przyczyna błędu. Na przykład: „Token wygasł”.
Więcej informacji znajdziesz na stronie http://apigee.com/docs/api-services/content/oauthv2-policy.
Tworzenie produktu
Podczas tworzenia nowego produktu możesz teraz określić nazwę produktu oprócz nazwy wyświetlanej.
Więcej informacji znajdziesz na stronie http://apigee.com/docs/developer-services/content/creating-api-products.
Interfejs do usuwania użytkowników z organizacji
Na stronie Użytkownicy organizacji w interfejsie użytkownika przycisk Usuń został zastąpiony przyciskiem Usuń. Ma to na celu ułatwienie zrozumienia, że po usunięciu użytkownika z organizacji jego konto Apigee pozostaje aktywne.
Więcej informacji znajdziesz na stronie http://apigee.com/docs/api-services/content/managing-organization-users.
Opcje filtrowania w interfejsie zarządzania
Na stronach „Proxy interfejsu API”, „Produkty”, „Deweloperzy” i „Aplikacje” w interfejsie zarządzania dostępne są nowe opcje filtrowania wyszukiwania.
Narzędzie do śledzenia offline
Narzędzie Offline Trace umożliwia wyświetlanie i analizowanie wcześniej zapisanych sesji śledzenia. Zapisana sesja śledzenia to w podstawie „nagranie” sesji śledzenia. Może być przydatna w przypadkach, gdy potrzebne 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) wyświetlane są role użytkownika.
Ulepszenia interfejsu zarządzania Edge
Ta wersja zawiera kilka drobnych ulepszeń interfejsu zarządzania Edge pod kątem łatwości obsługi i spójności.
Usługi Analytics
Poniżej znajdziesz nowe funkcje i ulepszenia usług Edge Analytics.
Dostępne są dane z 6 miesięcy
Podczas generowania raportów analitycznych za pomocą interfejsu zarządzania lub interfejsu API domyślnie nie są dostępne dane starsze niż 6 miesięcy. Jeśli chcesz uzyskać dostęp do danych starszych niż 6 miesięcy, skontaktuj się z zespołem pomocy Apigee.
Zmienne dodane do funkcji analitycznych
Te nowe zmienne są przekazywane do usługi Edge Analytics i są widoczne na etapie AX w oknie pośredniego śledzenia 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 niebędącymi błędami po stronie docelowej w przypadku nieudanych odpowiedzi HTTP (wartość „0”). W przypadku prawidłowej odpowiedzi HTTP wartość jest pusta.
-
apigee.edge.execution.is_policy_error – umożliwia określenie, czy w przypadku niepomyślnej odpowiedzi HTTP wystąpiła zasada (wartość „1”) lub nie (wartość „0”). Wartość null występuje w przypadku pomyślnej odpowiedzi HTTP.
Poniższe zmienne zawierają szczegółowe informacje o zasadzie, która jako pierwsza nie przeszła weryfikacji. Jeśli żadna zasada nie zawiodła, wartości są równe null.- apigee.edge.execution.fault_policy_name – nazwa zasady, która nie zadziałała.
- apigee.edge.execution.fault_flow_name – nazwa przepływu w zasadach, która nie powiodła się (np. PreFlow, PostFlow lub zdefiniowany przez użytkownika przepływ).
- apigee.edge.execution.fault_flow_state – lokalizacja, w której 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 dotyczące interfejsów API, deweloperów, produktów i aplikacji dla deweloperów zostały przeniesione. Wcześniej były one wyświetlane na dole głównych stron tych podmiotów. Teraz możesz uzyskać dostęp do wykresów, wybierając kartę Analityka u góry każdej strony.
- Ta wersja obejmuje istotne zmiany w tych dotychczasowych i nowych panelach:
- Panel Apigee (zmieniona wersja): zawiera 3 wykresy danych: „Ruch przez serwer proxy”, „Zaangażowanie deweloperów” i „Aplikacje deweloperów”. Każdy wykres zawiera widok „Więcej szczegółów”, który umożliwia zgłębienie poszczególnych danych. Otwórz panel Apigee.
- Wydajność serwera proxy (nowość): pokazuje wzorce ruchu serwera proxy interfejsu API oraz czas przetwarzania. Zastępuje panel wydajności proxy interfejsu API. Zobacz Wydajność serwera proxy interfejsu API.
- Skład ruchu (zmieniona wersja): całkowicie zmieniony wygląd panelu oraz jego zawartość. Mierzy względny udział Twoich najpopularniejszych interfejsów API, aplikacji, deweloperów i produktów w ogólnym programie interfejsów API. Zobacz Skład ruchu.
- Analiza błędów (zmieniona): całkowicie zmieniony wygląd i zawartość. Pokazuje odsetki błędów w przypadku proxy i celów interfejsu API. Otwórz panel informacyjny Analiza kodu błędu.
-
Zmieniono nazwy tych dotychczasowych paneli:
- Nazwa Skuteczność punktu końcowego została zmieniona na Skuteczność celu: pokazuje wzorce ruchu i dane o skuteczności dla celów w backendzie proxy API. Sprawdź docelową skuteczność.
- Nazwa Udział partnera została zmieniona na Udział dewelopera: pokazuje, którzy z zarejestrowanych deweloperów aplikacji generują najwięcej ruchu w interfejsie API. W przypadku każdego dewelopera możesz sprawdzić, kto generuje najwięcej ruchu w interfejsie API i błędów. Zobacz zaangażowanie deweloperów.
Usługi dla deweloperów
Poniżej znajdziesz nowe funkcje i ulepszenia w usłudze Edge Developer Services.
Obsługa Swagger 2.0 w przypadku SmartDocs
SmartDocs obsługuje importowanie dokumentów specyfikacji Swagger 2.0 i zachowuje zgodność wsteczną ze specyfikacją Swagger 1.2. Obsługa obiektów schematu zabezpieczeń i scentralizowanych schematów będzie dostępna w późniejszej wersji.
Zarabianie
Poniżej znajdziesz nowe funkcje i ulepszenia zarabiania na Edge. Więcej informacji o zarabianiu znajdziesz też w sekcji „Znane problemy”.
Oddzielne traktowanie firm i programistów
Firmy i deweloperzy są teraz obsługiwani oddzielnie, co pozwala na większą elastyczność w dodawaniu wielu firm do deweloperów i wielu deweloperów do firm. Interfejs zarządzania zawiera teraz osobne okna „Firmy” i „Dla deweloperów” (dostępne w menu „Opublikuj”).
Zobacz Zarządzanie firmami i programistami.
W raportach dotyczących zarabiania firmy pozostają głównym filtrem, ale etykieta filtra zmieniła się z „Deweloperzy” na „Firmy”.
Naprawione błędy
W tej wersji naprawiliśmy te błędy:
| Identyfikator problemu | Opis |
|---|---|
| OPDK-954 | 4.15.01 Schemat Cassandra nie jest uaktualniony |
| MGMT-1986 | Błąd interfejsu podczas dodawania dewelopera |
| MGMT-1983 | Interfejs API Get an OAuth 2.0 authorization code zwraca nieprawidłowy stan |
| MGMT-1962 | Błąd podczas logowania się w interfejsie zarządzania przy użyciu silnego hasła Nie można już logować się w interfejsie przy użyciu niektórych znaków specjalnych, takich jak znak procenta. |
| MGMT-1894 | Strona Aplikacje dewelopera nigdy nie wczytuje się w kolumnie dewelopera |
| MGMT-1872 | Nie można pobrać raportów niestandardowych |
| MGMT-1777 | Nie można dodać użytkownika z adresem e-mail, który ma domenę najwyższego poziomu .acn |
| MGMT-1362 | E-mail „Nie pamiętam hasła” nie działa, jeśli adres e-mail zawiera znak „_” Rozwiązano problem z resetowaniem hasła w chmurze prywatnej w przypadku adresów e-mail zawierających znak podkreślenia. |
| CORERT-613 | Błędy uzgadniania SSL z powodu „unrecognized_name” |
| APIRT-1346 | OAuth2.0 – w odpowiedzi na żądanie tokena dostępu zwracana jest wartość zaszyfrowana, 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 tej wersji nie uwzględniono 2 skryptów Cassandra, których instalator używa podczas instalacji lub aktualizacji monetyzacji. Aby rozwiązać ten problem, uruchom te polecenia po zainstalowaniu lub uaktualnieniu Cassandra:
|
| CORERT-318 | Wywołania interfejsu API z dużymi ładunkami (100 KB) mogą czasami utknąć. Aby obejść ten problem, ustaw tę wartość właściwości w pliku router.properties:HTTPServer.streaming.buffer.limit=0 (ustawienie domyślne to 10) |