Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację
Apigee X. info
19 maja 2015 r. udostępniliśmy kwartalną wersję Apigee Edge for Private Cloud.
Poprzednia nazwa usługi "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 artykule Informacje o wersjach Apigee.
Nowe funkcje i ulepszenia
Poniżej znajdziesz informacje o nowych funkcjach i ulepszeniach w tej wersji.
OpenLDAP – instalacja i uaktualnienie
OpenLDAP jest teraz jedynym serwerem LDAP obsługiwanym przez Edge w przypadku nowych instalacji i uaktualnień.
Usługi API
Poniżej znajdziesz informacje o nowych funkcjach i ulepszeniach w usługach API Edge.
WebSockets
Aby umożliwić komunikację w czasie rzeczywistym między klientem a serwerem, Edge obsługuje protokół WebSocket. W komunikacji WebSocket Edge może pełnić rolę klienta lub serwera. Informacje o konfigurowaniu i używaniu protokołu WebSocket w Edge znajdziesz w przewodniku Apigee Edge for Private Cloud Using WebSockets.
Obsługa zewnętrznego dostawcy uwierzytelniania na potrzeby zarządzania interfejsami API
Edge integruje się z Active Directory i innymi zewnętrznymi dostawcami uwierzytelniania oraz systemami LDAP, które zawierają użytkowników administracyjnych interfejsu API. Więcej informacji znajdziesz w przewodniku Edge for Private Cloud External Authentication Configuration.
Łączenie marek w interfejsie zarządzania
Możesz połączyć interfejs zarządzania Edge ze swoim logo, które będzie wyświetlane obok logo Apigee. Więcej informacji znajdziesz w sekcji "Dodawanie niestandardowego logo do menu interfejsu Apigee" w przewodniku Apigee Edge for Private Cloud Operations Guide.
Logi Node.js w Trace
Podczas debugowania proxy interfejsów API Node.js możesz włączyć funkcję logowania Node.js w widoku Trace edytora 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 logowaniu 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 Edge automatycznie wygasały po 30 dniach. Oznaczało to, że użytkownik był blokowany, chyba że zmienił hasło przed jego wygaśnięciem. Powodowało to jednak również wygaśnięcie hasła administratora systemu, co uniemożliwiało mu dostęp do Edge.
Po uaktualnieniu do wersji 4.15.04.00 domyślne ustawienie zmieni się tak, że hasła nie będą wygasać. 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
Apigee Edge for Private Cloud Operations Guide.
Ograniczanie dostępu administratora systemu do określonych domen e-mail
Możesz ograniczyć członkostwo w rolach administratora systemu lub administratora systemu tylko do odczytu 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 Apigee Edge for Private Cloud Operations Guide.
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 – ustawiona na 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. Na przykład: Token Expired.
Zobacz http://apigee.com/docs/api-services/content/oauthv2-policy.
Tworzenie usługi
Podczas tworzenia nowej usługi możesz teraz oprócz nazwy wyświetlanej podać też nazwę usługi.
Zobacz 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 przyciskiem Usuń. Ma to na celu wyjaśnienie, że po usunięciu użytkownika z organizacji jego konto Apigee pozostaje aktywne.
Zobacz http://apigee.com/docs/api-services/content/managing-organization-users.
Opcje filtrowania w interfejsie zarządzania
Na stronach Proxy interfejsów API, Usługi, Deweloperzy i Aplikacje w interfejsie zarządzania dostępne są nowe opcje filtrowania na potrzeby wyszukiwania.
Narzędzie Trace offline
Narzędzie Trace offline umożliwia wyświetlanie i analizowanie zapisanych wcześniej 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 Trace offline jest podobny do interfejsu narzędzia Trace "na żywo".
Więcej informacji znajdziesz w artykule Korzystanie z narzędzia Trace 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 Edge
Ta wersja zawiera szereg drobnych ulepszeń w zakresie użyteczności i spójności w interfejsie zarządzania Edge.
Usługi Analytics
Poniżej znajdziesz informacje o nowych funkcjach i ulepszeniach w usługach Analytics Edge.
Dostępnych jest 6 miesięcy danych
Podczas generowania raportów Analytics w interfejsie zarządzania lub interfejsie API domyślnie nie można uzyskać dostępu do danych starszych niż 6 miesięcy od bieżącej daty. Jeśli chcesz uzyskać dostęp do danych starszych niż sześć miesięcy, skontaktuj się z zespołem pomocy Apigee Edge.
Zmienne dodane do Analytics
Te nowe zmienne są przekazywane do Analytics Edge i widoczne na etapie AX w oknie śledzenia 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 innymi niż docelowe w przypadku nieudanych odpowiedzi HTTP (wartość „0”). W przypadku udanej odpowiedzi HTTP wartość jest równa null.
-
apigee.edge.execution.is_policy_error – umożliwia określenie, czy zasada
nie powiodła się (wartość „1”), czy w przypadku nieudanej odpowiedzi HTTP nie powiodła się żadna zasada (wartość „0”). W
przypadku udanej odpowiedzi HTTP wartość jest równa null.
Te powiązane zmienne zawierają szczegółowe informacje o zasadzie, która nie powiodła się jako pierwsza. Jeśli żadna zasada nie powiodła się, wartości są równe null.- 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, która nie powiodła się (np. PreFlow, PostFlow lub przepływ 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, usług i aplikacji deweloperów zostały przeniesione. Wcześniej były wyświetlane u dołu głównych stron tych encji. Teraz możesz uzyskać dostęp do wykresów, klikając kartę Analytics u góry każdej strony.
- Ta wersja obejmuje znaczące zmiany w tych istniejących lub nowych panelach:
- Panel Apigee (zmieniony): zawiera 3 wykresy danych: ruch proxy , zaangażowanie deweloperów i aplikacje deweloperów. Każdy wykres zawiera widok „Więcej szczegółów” który umożliwia szczegółowe analizowanie poszczególnych danych. Zobacz Panel Apigee.
- Skuteczność proxy (nowy): pokazuje wzorce ruchu proxy interfejsu API i czasy przetwarzania. Zastępuje panel Skuteczność proxy interfejsu API. Zobacz Skuteczność proxy interfejsu API.
- Struktura ruchu (zmieniony): całkowicie zmieniony wygląd zawartość i działanie panelu. Mierzy względny udział najważniejszych interfejsów API, aplikacji, deweloperów i usług w ogólnym programie interfejsów API. Zobacz Struktura ruchu.
- Analiza błędów (zmieniony): całkowicie zmieniony wygląd, zawartość i działanie. Pokazuje odsetek błędów proxy interfejsów API i celów. Zobacz Panel analizy kodów błędów Dashboard.
-
Nazwy tych istniejących paneli zostały zmienione:
- Skuteczność punktu końcowego została zmieniona na Skuteczność celu: pokazuje wzorce ruchu i dane o skuteczności celów backendu proxy interfejsu API. Zobacz Skuteczność celu.
- Zaangażowanie partnerów zostało zmienione na Zaangażowanie deweloperów: pokazuje, którzy zarejestrowani deweloperzy aplikacji generują największy ruch interfejsu API. W przypadku każdego dewelopera możesz sprawdzić, kto generuje największy ruch interfejsu API i najwięcej błędów. Zobacz Zaangażowanie deweloperów.
Usługi dla deweloperów
Poniżej znajdziesz informacje o nowych funkcjach i ulepszeniach w usługach dla deweloperów Edge.
Obsługa Swagger 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 schematów scentralizowanych będzie dostępna w przyszłej wersji.
Zarabianie
Poniżej znajdziesz informacje o nowych funkcjach i ulepszeniach w zarabianiu w Edge. Więcej informacji o zarabianiu znajdziesz też w sekcji „Znane problemy” .
Oddzielna obsługa 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 zawiera teraz osobne okna „Firmy” i „Deweloperzy” (dostępne w menu „Opublikuj” ).
Zobacz Zarządzanie firmami i deweloperami.
W raportach zarabiania firmy pozostają filtrem podstawowym, chociaż etykieta filtra zmieniła się z „Deweloperzy” na „Firmy”.
Poprawione błędy
W tej wersji usunęliśmy te błędy.
| Identyfikator problemu | Opis |
|---|---|
| OPDK-954 | Schemat Cassandra 4.15.01 nie jest uaktualniany |
| 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 do interfejsu zarządzania za pomocą silnego hasła Logowanie do interfejsu za pomocą niektórych znaków specjalnych, np. znaku procenta, nie powoduje już błędu. |
| MGMT-1894 | Strona Aplikacje deweloperów nigdy się nie wczytuje w kolumnie Deweloper |
| 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 z przypomnieniem hasła nie działa, jeśli adres e-mail zawiera
„_” Rozwiązuje problem z resetowaniem hasła w chmurze prywatnej w przypadku adresów e-mail zawierających podkreślenie. |
| CORERT-613 | Błędy uzgadniania połączenia SSL spowodowane przez „unrecognized_name” |
| APIRT-1346 | OAuth2.0 – w odpowiedzi tokena dostępu zwracana jest wartość haszowana, gdy 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 uaktualniania zarabiania. Aby obejść ten problem, po instalacji lub uaktualnieniu Cassandra uruchom te polecenia, aby dokończyć instalację lub uaktualnienie zarabiania:
|
| CORERT-318 | Wywołania interfejsu API z dużymi ładunkami (setki KB) mogą czasami się zawieszać. Aby obejść ten
problem, ustaw w pliku router.properties tę wartość właściwości:HTTPServer.streaming.buffer.limit=0 (ustawienie domyślne to 10). |