Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje
We wtorek 19 maja 2015 roku opublikowaliśmy kwartalną wersję Apigee Edge dla Private Cloud.
Wcześniejsza nazwa usługi „Apigee Edge On-propertys” lub „OPDK” to teraz „Apigee Edge dla Private Cloud”.
Jeśli masz pytania, skontaktuj się z obsługą klienta Apigee.
Listę wszystkich informacji o wersji Apigee Edge znajdziesz w artykule Informacje o wersji Apigee.
Nowe funkcje i ulepszenia
Poniżej znajdziesz opis nowych funkcji i ulepszeń wprowadzanych w tej wersji.
OpenLDAP – instalacja i aktualizacja
OpenLDAP jest teraz jedynym serwerem LDAP obsługiwanym przez Edge w przypadku nowych i uaktualnionych instalacji.
Usługi interfejsu API
Poniżej znajdziesz nowe funkcje i ulepszenia w usługach Edge API.
WebSockets
Aby umożliwić komunikację internetową w czasie rzeczywistym między klientem internetowym a serwerem, Edge obsługuje protokół WebSocket. Edge może odgrywać rolę klienta lub serwera w komunikacji WebSocket. Informacje o konfigurowaniu i używaniu WebSockets w przeglądarce Edge znajdziesz w przewodniku Apigee Edge for Private Cloud Using WebSockets.
Obsługa zewnętrznego dostawcy uwierzytelniania w zakresie zarządzania interfejsami API
Edge integruje się z Active Directory i innymi zewnętrznymi dostawcami uwierzytelniania/systemami LDAP, które zawierają administratorów interfejsu API. Więcej informacji znajdziesz w przewodniku Konfiguracja uwierzytelniania zewnętrznego w usłudze Edge dla Private Cloud.
Wspólne budowanie marki w interfejsie zarządzania
Możesz dodać elementy do interfejsu zarządzania Edge własnym logo, które pojawia się obok logo Apigee. Więcej informacji znajdziesz w sekcji o dodawaniu niestandardowego logo do menu interfejsu Apigee w przewodniku po operacjach Apigee Edge dla prywatnej chmury.
Logi Node.js w logu czasu
Podczas debugowania serwerów proxy interfejsu API Node.js możesz włączyć funkcję logu Node.js w widoku śledzenia w edytorze serwerów proxy interfejsu API. Aby włączyć tę funkcję, ustaw w instalacji plik apigee.feature.disableNodeJSLogs="false" w pliku apigee-base.conf lub apigee-onproperty.conf. Więcej informacji o logu Node.js znajdziesz w artykule o debugowaniu i rozwiązywaniu problemów z serwerami proxy Node.js.
Wygasanie haseł
W przeglądarce Edge 4.15.01.x hasła do Edge automatycznie wygasają po 30 dniach. W związku z tym użytkownik został zablokowany, chyba że zmienił hasło przed jego wygaśnięciem. Powodujeło to jednak również wygaśnięcie hasła administratora systemu, przez co administrator systemu miał dostęp do Edge.
Po uaktualnieniu do wersji 4.15.04.00 domyślne zmiany zostaną zastosowane, aby hasła nie wygasały. W razie potrzeby możesz skonfigurować wygasanie haseł Edge przy użyciu skryptu /opt/apigee4/bin/apigee-enable-pwlockout.sh. Więcej informacji znajdziesz w przewodniku po operacjach Apigee Edge dla Private Cloud.
Ograniczenie dostępu administratora sysadmin do określonych domen e-mail
Możesz ograniczyć członkostwo w rolach sysadmin lub sysadmin do użytkowników w określonych domenach 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 for Private Cloud.
Komunikaty o błędach w interfejsie zarządzania
Zmieniliśmy wygląd komunikatów o błędach w interfejsie zarządzania, by efektywniej korzystać z miejsca na ekranie.
Nowe zmienne błędów OAuthV2
Te nowe zmienne związane z błędami są ustawiane przez zasadę OAuthV2:
- oauthV2.<nazwa-zasady>.failed – ustaw wartość „prawda”, jeśli zasada nie została skonfigurowana.
- 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 nowej usługi oprócz wyświetlanej nazwy możesz teraz podać jej nazwę.
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 przycisk Usuń został zastąpiony przez przycisk Usuń. Chcemy w ten sposób podkreślić, że po usunięciu użytkownika z organizacji jego konto Apigee pozostanie aktywne.
Więcej informacji znajdziesz w artykule http://apigee.com/docs/api-services/content/managing-organization-users.
Opcje filtrowania w interfejsie zarządzania
Na stronach Proxies API, Usługi, Programiści i Aplikacje w interfejsie zarządzania dostępne są nowe opcje filtrowania wyszukiwania.
Narzędzie do śledzenia offline
Narzędzie do śledzenia offline pozwala wyświetlać i analizować sesje śledzenia, które zostały wcześniej zapisane. Zapisana sesja logu czasu to zasadniczo „rejestracja” sesji śledzenia i może być przydatna w przypadkach, gdy wymagane są rozwiązywanie problemów i dalsza analiza. Interfejs narzędzia do śledzenia offline jest podobny do „aktywnego” narzędzia do śledzenia.
Więcej informacji znajdziesz w artykule o używaniu narzędzia do śledzenia w trybie offline.
Role użytkownika wyświetlane w Ustawieniach użytkownika
Role użytkownika są teraz widoczne na stronie Ustawienia użytkownika w interfejsie zarządzania (nazwa użytkownika > Ustawienia użytkownika).
Ulepszenia interfejsu zarządzania brzegiem
Ta wersja zawiera kilka niewielkich ulepszeń w zakresie łatwości obsługi i spójności w interfejsie zarządzania brzegowym.
Usługi analityczne
Poniżej przedstawiono nowe funkcje i ulepszenia w usługach Edge Analytics.
Dostępne dane z 6 miesięcy
Jeśli generujesz raporty analityczne za pomocą interfejsu użytkownika lub interfejsu API zarządzania, dane starsze niż 6 miesięcy od bieżącej daty są domyślnie niedostępne. Jeśli chcesz uzyskać dostęp do danych starszych niż 6 miesięcy, skontaktuj się z zespołem pomocy Apigee.
Zmienne dodane do Analytics
Poniższe nowe zmienne są przekazywane do analityki brzegowej, które są widoczne na etapie AX okna śledzenia serwera proxy interfejsu API.
- apigee.edge.execution.is_target_error – pozwala określić, czy w przypadku nieudanych odpowiedzi HTTP (wartość „0”) błędy interfejsu API są błędami po stronie docelowej (wartość 1) czy nie są związane z wartością docelową (wartość „0”). Wartość null oznacza pomyślną odpowiedź HTTP.
-
apigee.edge.execution.is_policy_error: pozwala określić, czy zasada nie powiodła się (wartość 1) lub czy żadna zasada nie powiodła się w przypadku nieudanej odpowiedzi HTTP (wartość „0”). Jeśli odpowiedź HTTP zakończy się powodzeniem, wartość to null.
Poniższe powiązane zmienne zawierają szczegółowe informacje o zasadzie, która nie powiodła się jako pierwsza. Jeśli żadna zasada nie zadziała, wartości będą puste.- apigee.edge.execution.fault_policy_name – nazwa zasady, która nie powiodła się.
- apigee.edge.execution.fault_flow_name – nazwa przepływu w zasadzie, w przypadku którego wystąpił błąd (np. PreFlow, PostFlow lub przepływ zdefiniowany przez użytkownika).
- apigee.edge.execution.fault_flow_state – lokalizacja, w której została dołączona zasada w procesie. Możliwe wartości: PROXY_REQ_FLOW, TARGET_REQ_FLOW, TARGET_RESP_FLOW, PROXY_RESP_FLOW.
Panele
- Przeniesiono wykresy wydajności interfejsów API, aplikacji dla deweloperów, usług i aplikacji dla deweloperów. Kiedyś były one wyświetlane u dołu stron głównych tych elementów. Teraz możesz wyświetlić wykresy, wybierając kartę Statystyki u góry każdej strony.
- Ta wersja obejmuje istotne prace związane z istniejącymi i nowymi panelami:
- Panel Apigee (nowa wersja): zawiera 3 wykresy danych: Ruch z serwerów proxy, Zaangażowanie dewelopera i Aplikacje dewelopera. Każdy wykres zawiera widok „więcej szczegółów”, który umożliwia zgłębianie poszczególnych wskaźników. Zobacz Panel Apigee.
- Wydajność serwera proxy (nowa): pokazuje wzorce ruchu przez serwer proxy interfejsu API i czasy przetwarzania. Zastępuje panel wydajności serwera proxy interfejsu API. Zobacz Wydajność serwera proxy interfejsu API.
- Struktura ruchu (poprawiona): zupełnie nowy wygląd, styl i treść panelu. Mierzy względny udział Twoich najpopularniejszych interfejsów API, aplikacji, deweloperów i usług w ogólnym programie interfejsów API. Zobacz Informacje o rozkładzie ruchu.
- Analiza błędów (poprawiona): w pełni poprawiony wygląd, styl i treść. Pokazuje odsetek błędów dotyczących serwerów proxy i celów interfejsu API. Zobacz Panel analizy kodu błędów.
-
Nazwy tych istniejących paneli zostały zmienione:
- Nazwa Wydajność punktów końcowych została zmieniona na Docelowa wydajność: pokazuje wzorce ruchu i dane dotyczące wydajności dla celów backendu serwera proxy interfejsu API. Patrz sekcja Docelowa skuteczność.
- Nazwa Zaangażowanie partnera została zmieniona na Zaangażowanie dewelopera: pokazuje, którzy z zarejestrowanych deweloperów aplikacji generują najwięcej ruchu API. W przypadku każdego z deweloperów możesz sprawdzić, kto generuje najwięcej ruchu przez interfejs API i najwięcej błędów. Więcej informacji znajdziesz w sekcji Zaangażowanie dewelopera.
Usługi dla deweloperów
Poniżej znajdziesz nowe funkcje i ulepszenia w usługach Edge dla deweloperów.
Obsługa Swagger 2.0 w inteligentnych Dokumentach
Dokument SmartDokumentacja obsługuje importowanie dokumentów specyfikacji Swagger 2.0 i zachowuje zgodność wsteczną ze standardem Swagger 1.2. Obsługa obiektów schematów zabezpieczeń i scentralizowanych schematów będzie dostępna w kolejnej wersji.
Zarabianie
Poniżej znajdziesz nowe funkcje i ulepszenia związane z zarabianiem na Edge. Więcej informacji o zarabianiu znajdziesz w sekcji „Znane problemy”.
Osobna obsługa firm i deweloperów
Firmy i deweloperzy są teraz obsługiwane osobno, co daje większą elastyczność przy dodawaniu wielu firm do deweloperów i wielu deweloperów do firm. W interfejsie zarządzania znajdują się teraz osobne okna dla sekcji „Firmy” i „Deweloperzy” (dostępne w menu „Publikowanie”).
Więcej informacji znajdziesz w artykule Zarządzanie firmami i deweloperami.
W raportach o przychodach firmy pozostają głównym filtrem, choć etykieta filtra zmieniła się z „Deweloperzy” na „Firmy”.
Naprawione błędy
Poprawiliśmy w niej wymienione niżej błędy.
| Identyfikator problemu | Opis |
|---|---|
| OPDK-954 | Schemat Cassandra nie został uaktualniony |
| MGMT-1986 | Błąd interfejsu podczas dodawania dewelopera |
| MGMT-1983 | Pobieranie interfejsu API 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 użytkownika przy użyciu niektórych znaków specjalnych, takich jak znak procentu, już się nie kończy. |
| MGMT-1894 | Strona Aplikacje dla deweloperów nigdy się nie wczytuje |
| MGMT-1872 | Brak możliwości pobrania raportów niestandardowych |
| MGMT-1777 | Nie można dodać użytkownika z adresem e-mail w domenie .acn |
| MGMT-1362 | Adres e-mail nie pamiętam hasła nie działa, jeśli adres e-mail zawiera „_” Rozwiązuje problem z resetowaniem hasła w Private Cloud, w przypadku adresów e-mail zawierających podkreślenie. |
| CORERT-613 | Nieudane uzgadnianie połączenia SSL z powodu błędu „unrecognized_name” |
| APIRT-1346 | Protokół OAuth2.0 – zaszyfrowana wartość jest zwracana w odpowiedzi tokena dostępu, gdy parametr hash.oauth.tokens.enabled ma wartość prawda |
Zawiera ona też poprawki błędów z następujących wersji:
| Edge Cloud | Edge dla chmury prywatnej |
|---|---|
Znane problemy
W tej wersji występują opisane poniżej znane problemy.
| Identyfikator problemu | Opis |
|---|---|
| Nie dotyczy |
W tej wersji nie znalazły się 2 skrypty Cassandra, których instalator używa podczas instalacji lub uaktualniania służącego do zarabiania. Aby obejść ten problem, uruchom następujące polecenia po instalacji lub uaktualnieniu Cassandra, aby dokończyć instalację lub uaktualnienie zarabiania:
|
| CORERT-318 | Wywołania interfejsu API z dużymi ładunkami (100 KB) mogą czasem się zawieszać. 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). |