4.17.09 – informacje o wersji Edge dla Private Cloud

Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje

Od poprzedniej wersji funkcji Edge dla chmury prywatnej wystąpiły następujące wersje, które są uwzględnione w tej wersji funkcji:

Zapoznaj się z artykułem Informacje o numerowaniu wersji, aby dowiedzieć się, jak sprawdzić, czy konkretna wersja chmury jest uwzględniona w Twojej wersji Edge dla Private Cloud.

Ogólne informacje o wersji

Najważniejszą nową funkcją w tej wersji jest dodanie obsługi języka SAML 2.0 (Security Assertion Markup Language) jako mechanizmu uwierzytelniania w usługach Edge, API BaaS i portalu usług programisty. Używając SAML w Edge, możesz obsługiwać logowanie jednokrotne w interfejsie użytkownika Edge i interfejsie API, a także wszelkich innych udostępnianych przez Ciebie usługach, które również obsługują SAML.

Uwierzytelnianie SAML ma kilka zalet. Dzięki SAML możesz:

• Przejmij pełną kontrolę nad zarządzaniem użytkownikami. Gdy użytkownicy opuszczą organizację i zostaną wyrejestrowane centralnie, automatycznie utracą dostęp do Edge.
• Kontroluj sposób uwierzytelniania użytkowników, aby uzyskać dostęp do Edge. Możesz wybrać różne typy uwierzytelniania dla różnych organizacji Edge.
• Kontroluj zasady uwierzytelniania. Dostawca SAML może obsługiwać zasady uwierzytelniania bardziej zgodne ze standardami Twojej firmy.
• Możesz monitorować logowania, wylogowania, nieudane próby logowania i aktywności wysokiego ryzyka we wdrożeniu brzegowym.
• Pamiętaj, że SAML służy tylko do uwierzytelniania. Autoryzacja nadal jest kontrolowana przez role użytkowników Edge.

Więcej informacji znajdziesz w artykule o obsłudze SAML w Edge for Private Cloud.

W tej wersji wprowadziliśmy szereg innych ważnych funkcji, w tym:

• Możliwość migracji portalu usług dla programistów z Apache/MySQL do Postgres/Nginx
• Polecenie do wyłączenia TLS w interfejsie użytkownika Edge
• Nowe właściwości konfigurowania instalacji Edge
• Reguły nadawania niestandardowych kluczy klienta i nazw obiektów tajnych
• Obsługa systemów Red Hat/CentOS w wersji 7.4

W pozostałej części tego tematu znajdziesz szczegółowe informacje na temat wszystkich nowych funkcji, aktualizacji i poprawek błędów zawartych w tej wersji.

Wycofywanie i wycofanie

Poniższe funkcje zostały w tej wersji wycofane lub wycofane. Więcej informacji znajdziesz w zasadach wycofywania Edge.

Elementy wycofane

Wycofanie bezpiecznego magazynu Apigee (magazynów)

Bezpieczny magazyn Apigee, zwany też „vaults”, jest wycofywany i zostanie wycofany w kwietniu 2018 r. Vault, które zapewniają zaszyfrowane przechowywanie par klucz-wartość, są tworzone za pomocą interfejsu API zarządzania i udostępniane w czasie działania za pomocą funkcji w module Node.js apigee-access.

Zamiast korzystać z bezpiecznego magazynu, użyj zaszyfrowanych map par klucz-wartość (KVM) zgodnie z opisem w sekcji Praca z mapami par klucz-wartość. Zaszyfrowane KVM są równie bezpieczne jak magazyny oraz zapewniają więcej opcji tworzenia i pobierania. (MGMT-3848)

Wycofanie dodawania ścieżek na karcie Wydajność serwera proxy interfejsu API

Aż do tej wersji można było przejść do serwera proxy interfejsu API w interfejsie zarządzania, otworzyć kartę Skuteczność i utworzyć różne ścieżki porównania na wykresie na karcie Skuteczność serwera proxy i w panelu Transakcje biznesowe. Ta funkcja została wycofana i nie jest już dostępna w interfejsie. Informacje o alternatywie znajdziesz w tym artykule społeczności Apigee: https://community.apigee.com/articles/23936/alternative-to-business-transactions-api.html. (EDGEUI-902)

Nowe funkcje i aktualizacje

Poniżej znajdziesz opis nowych funkcji i ulepszeń wprowadzanych w tej wersji. Oprócz poniższych ulepszeń ta wersja zawiera też wiele ulepszeń w zakresie łatwości obsługi, wydajności, bezpieczeństwa i stabilności.

Chmura prywatna

Dodano obsługę SAML do Edge, API BaaS i portalu usług dla programistów

Edge obsługuje teraz SAML 2.0 jako mechanizm uwierzytelniania w usługach Edge, API BaaS i portalu usług dla programistów. SAML obsługuje środowisko logowania jednokrotnego. Korzystając z SAML, możesz obsługiwać logowanie jednokrotne (SSO) w Edge, a także w przypadku dowolnych innych udostępnianych przez Ciebie usług, które obsługują SAML.

Zobacz Obsługa SAML w Edge for Private Cloud.

Dodano narzędzie apigee-ssoadminapi.sh

Po włączeniu SAML możesz używać nowego pliku apigee-ssoadminapi.sh do wykonywania wielu zadań administracyjnych, takich jak tworzenie użytkowników i organizacji.

Zapoznaj się z artykułem o używaniu apigee-ssoadminapi.sh.

(DOS-5118)

Możliwość migracji portalu usług dla programistów z Apache/MySQL/MariaDB do Nginx/postgres

Instalacja portalu usług dla programistów oparta na pliku .tar korzysta z Apache i MySQL lub MariaDB. Możesz teraz przenieść istniejącą instalację portalu, aby używać Nginx i Postgres. Ta migracja jest wymagana, jeśli chcesz zaktualizować portal do wersji 4.17.09.

Zobacz Konwertowanie portalu opartego na tar. na portal oparty na RPM.

Dodaliśmy obsługę Red Hat/CentOS w wersji 7.4

Możesz teraz wdrożyć Edge dla chmury Private Cloud, API BaaS i portalu usług dla programistów w Red Hat/CentOS w wersji 7.4.

Sprawdź obsługiwane oprogramowanie i jego wersje.

Dodano właściwość, która sprawia, że instalator sprawdza podczas instalacji wymagania dotyczące procesora i pamięci.

Plik konfiguracji instalacji Edge obsługuje teraz tę właściwość:

ENABLE_SYSTEM_CHECK=y 

W przypadku wartości „y” instalator sprawdza, czy system spełnia wymagania dotyczące procesora i pamięci dla instalowanego komponentu. Wymagania dotyczące poszczególnych komponentów znajdziesz w wymaganiach dotyczących instalacji. Domyślna wartość to „n”, która wyłącza sprawdzanie.

Zobacz odniesienie do pliku konfiguracji brzegu.

(DOS-4772)

Dodano właściwość, która pozwala wybrać adres IP używany przez instalatora na serwerze ma kilka kart interfejsu

Jeśli serwer ma wiele kart interfejsów, polecenie „nazwa hosta -i” zwraca listę adresów IP rozdzielonych spacjami. Domyślnie instalator Edge używa pierwszego zwróconego adresu IP, co w niektórych sytuacjach może nie być prawidłowe. Możesz też ustawić tę właściwość w pliku konfiguracji instalacji:

ENABLE_DYNAMIC_HOSTIP=y

Gdy ta właściwość ma wartość „y”, instalator prosi o wybranie adresu IP, którego chcesz użyć podczas instalacji. Wartością domyślną jest „n”.

Zobacz odniesienie do pliku konfiguracji brzegu.

(DOS-5117)

Dostępne są nowe opcje interfejsu użytkownika i interfejsy API do konfigurowania protokołu TLS

Wersja beta nowej, samoobsługowej funkcji TLS/SSL dla chmury jest teraz dostępna w chmurze prywatnej jako funkcja beta. Za pomocą wersji beta możesz:

• Tworzenie, modyfikowanie i usuwanie magazynów kluczy oraz magazynów zaufania w interfejsie użytkownika oraz interfejsie API
• Prześlij certyfikaty TLS jako PKCS12/PFX
• Generowanie certyfikatów podpisanych samodzielnie z poziomu interfejsu użytkownika lub interfejsu API
• Przetestuj poprawność magazynu kluczy lub magazynu zaufania w interfejsie

Dokumentacja wersji beta tych funkcji (PDF) jest dostępna tutaj:

• Tworzenie magazynów kluczy i magazynów zaufania przy użyciu interfejsu Edge Cloud
• Tworzenie magazynów kluczy i magazynów zaufania przy użyciu interfejsu Edge API

Szczegółowe informacje znajdziesz w dodatkowej dokumentacji (PDF):

• Opcje konfigurowania TLS
• Konfigurowanie dostępu TLS do interfejsu API w chmurze
• Konfigurowanie protokołu TLS z serwera brzegowego do backendu
• Aktualizowanie certyfikatu TLS dla chmury

(EDGEUI-1058)

Dodano polecenie zaciemnionego hasła

Dodaliśmy polecenie generowania zaciemnionego hasła, które pozwala każdemu komponentowi wygenerować zaszyfrowane hasło. Zaciemnione hasło możesz wygenerować przy użyciu tego polecenia na serwerze zarządzania brzegowym:

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server generate-obfuscated-password

Wpisz nowe hasło i potwierdź je w wyświetlonym oknie. Ze względów bezpieczeństwa tekst hasła nie jest wyświetlany. To polecenie zwraca hasło w takiej postaci:

OBF:58fh40h61svy156789gk1saj
MD5:902fobg9d80e6043b394cb2314e9c6

Zobacz Konfigurowanie protokołu TLS/SSL dla środowiska Edge On.

(250 Do ustalenia)

Dodano nowe polecenie maskujące nowe hasło podczas zmiany hasła użytkownika organizacji.

Aby zresetować hasło użytkownika organizacji, użyj narzędzia apigee-service, aby wywołać apigee-openldap:

> /opt/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-user-password -u userEmail

Pojawi się prośba o podanie hasła administratora systemu, a następnie nowego hasła użytkownika. Ze względów bezpieczeństwa wpisywany tekst nie jest wyświetlany.

Zobacz Resetowanie haseł na serwerach brzegowych.

(DBS-1733)

Dodaj polecenie wyłączania TLS w interfejsie użytkownika Edge

Teraz możesz wyłączyć protokół TLS w interfejsie użytkownika Edge za pomocą tego polecenia:

/opt/apigee/apigee-service/bin/apigee-service edge-ui disable-ssl

Zobacz Konfigurowanie TLS w interfejsie zarządzania.

(EDGEUI-1114)

Dodano właściwość, która umożliwia kontrolowanie formatu sygnatury czasowej w komunikatach logu

Domyślnie sygnatura czasowa w komunikatach logu utworzonych przez zasadę logowania wiadomości ma format:

yyyy-MM-dd'T'HH:mm:ss.sssZ

Na przykład:

2017-05-08T13:33:00.000+0000

Do sterowania tym formatem możesz używać właściwości conf_system_apigee.syslogger.dateFormat w procesorze wiadomości Edge.

Zobacz zasady logowania wiadomości.

(APIRT-4196)

Do instalacji interfejsu API BaaS dodano nowy wymagany parametr konfiguracji SMTP

Musisz teraz użyć parametru SMTPMAILFROM w pliku konfiguracji instalacyjnym interfejsu API BaaS. Ten parametr określa adres e-mail używany, gdy API BaaS wysyła automatyczne e-maile, na przykład gdy użytkownik prosi o zresetowanie hasła.

Zobacz odniesienie do pliku konfiguracji BaaS.

(APIBAAS-2103)

Dodaliśmy obsługę zezwalania routerowi brzegowemu i serwerowi WWW Nginx na dostęp portalu do portów poniżej 1000

Teraz możesz używać serwera WWW Router i Nginx portalu, aby uzyskiwać dostęp do portów poniżej 1000 bez konieczności uruchamiania ich jako innego użytkownika. W poprzednich wersjach routery i serwer WWW Nginx nie mogły uzyskać dostępu do portów poniżej 1000 bez uruchomienia ich jako specjalnego użytkownika.

Zmieniono sposób konfigurowania poziomu rejestrowania w interfejsie Edge

Właściwości używane do konfigurowania poziomu rejestrowania w interfejsie użytkownika Edge uległy zmianie. Nowe właściwości i procedurę znajdziesz w sekcji Ustawianie poziomu logowania komponentu Edge.

(EDGEUI-886)

Usługi interfejsu API

Reguły nadawania niestandardowych kluczy klienta i nazw obiektów tajnych

Zaktualizowaliśmy reguły nazewnictwa i weryfikację, aby umożliwić tworzenie niestandardowego klucza klienta i tajnego klucza dla aplikacji dewelopera. Klucze klienta i obiekty tajne mogą zawierać litery, cyfry, podkreślenia i łączniki. Inne znaki specjalne nie są dozwolone.

Proces tworzenia niestandardowego klucza/klucza tajnego jest lepiej udokumentowany w artykule Importowanie istniejących kluczy i obiektów tajnych klienta. (MGMT-3916)

Sprawdzanie poprawności nazwy magazynu kluczy i serwera docelowego

Nazwy magazynów kluczy i serwerów docelowych mogą mieć maksymalnie 255 znaków i mogą zawierać litery, cyfry, spacje, łączniki, podkreślenia i kropki. Edge sprawdza teraz to podczas tworzenia. (MGMT-4098)

Naprawione błędy

Poprawiliśmy w niej wymienione niżej błędy. Ta lista jest przeznaczona głównie dla użytkowników, którzy chcą sprawdzić, czy ich zgłoszenia do zespołu pomocy zostały rozwiązane. Jej zadaniem nie jest dostarczanie szczegółowych informacji o wszystkich użytkownikach.

Private Cloud 4.17.09

connect.ranges.denied=
connect.ranges.allowed=
connect.ports.allowed=

Cloud 17.08.16 (UI)

Cloud 17.08.14 (zarządzanie interfejsami API i środowisko wykonawcze)

Cloud 17.07.31 (zarządzanie interfejsami API)

Cloud 17.07.17 (zarządzanie interfejsami API i środowisko wykonawcze)

Cloud 17.06.20 (UI)

Cloud 17.06.14 (UI)

Cloud 17.05.22.01 (Zarabianie)

Cloud 17.05.22 (UI)

Cloud 17.05.22 (zarządzanie interfejsami API)

Cloud 17.05.08 (UI)

Cloud 17.04.22 (zarządzanie interfejsami API)

Znane problemy

W tej wersji występują następujące znane problemy: