4.19.06.10 – Informacje o wersji Edge dla Private Cloud

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X.
info

29 września 2020 r. udostępniliśmy nową wersję Apigee Edge for Private Cloud.

Procedura aktualizacji

Aktualizacja tej wersji spowoduje zaktualizowanie komponentów z tej listy pakietów RPM:

  • edge-gateway-4.19.06-0.0.20094.noarch.rpm
  • edge-management-server-4.19.06-0.0.20094.noarch.rpm
  • edge-message-processor-4.19.06-0.0.20094.noarch.rpm
  • edge-postgres-server-4.19.06-0.0.20094.noarch.rpm
  • edge-qpid-server-4.19.06-0.0.20094.noarch.rpm
  • edge-router-4.19.06-0.0.20094.noarch.rpm
  • apigee-mtls-4.19.06-0.0.20189.noarch.rpm
  • apigee-mtls-consul-4.19.06-0.0.20128.noarch.rpm
  • apigee-cassandra-2.1.16-0.0.2508.noarch.rpm
  • edge-ui-4.19.06-0.0.20164.noarch.rpm
  • edge-management-ui-static-4.19.06-0.0.20018.noarch.rpm
  • apigee-sso-4.19.06-0.0.20080.noarch.rpm
  • apigee-setup-4.19.06-0.0.1122.noarch.rpm

Aby sprawdzić, czy zainstalowane wersje pakietów RPM wymagają aktualizacji, wpisz:

apigee-all version

Aby zaktualizować instalację, wykonaj te czynności na węzłach brzegowych:

  1. Na wszystkich węzłach brzegowych:

    1. Wyczyść repozytoria Yum:
      sudo yum clean all
    2. Pobierz najnowszy plik Edge 4.19.06 bootstrap_4.19.06.sh do /tmp/bootstrap_4.19.06.sh:
      curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
    3. Zainstaluj narzędzie apigee-service Edge 4.19.06 i zależności:
      sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord

      gdzie uName:pWord to nazwa użytkownika i hasło otrzymane od Apigee. Jeśli pominiesz pWord, pojawi się prośba o jego wpisanie.

    4. Zaktualizuj narzędzie apigee-setup:
      sudo /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    5. Użyj polecenia source, aby wykonać skrypt apigee-service.sh:
      source /etc/profile.d/apigee-service.sh
  2. Zaktualizuj wszystkie węzły Cassandra:

    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

    gdzie configFile określa plik konfiguracji użyty do zainstalowania Apigee Edge na potrzeby chmury prywatnej. Na przykład: /opt/silent.conf.

  3. Na wszystkich węzłach brzegowych wykonaj skrypt update.sh dla procesu edge. Aby to zrobić, uruchom na każdym węźle to polecenie:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. Aktualizowanie interfejsu Edge:

    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  5. Wykonaj skrypt update.sh dla logowania jednokrotnego na wszystkich węzłach. Na każdym węźle wykonaj to polecenie:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  6. Jeśli korzystasz z nowej wersji Edge, uruchom to polecenie:
    /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
  7. Jeśli używasz Apigee mTLS, wykonaj procedurę opisaną w artykule Uaktualnianie Apigee mTLS.

    Więcej informacji znajdziesz w artykule Wprowadzenie do wzajemnego uwierzytelniania TLS w Apigee.

Obsługiwane oprogramowanie

Bez zmian.

Wycofania i zakończenia

Brak nowych wycofań ani zakończeń obsługi.

Nowe funkcje

W tej sekcji znajdziesz listę nowych funkcji w tej wersji.

Szyfrowanie haseł JMX

Możesz teraz szyfrować hasła JMX. Więcej informacji znajdziesz w artykułach Włączanie szyfrowania haseł JMX i Włączanie uwierzytelniania JMX w przypadku Cassandry. (150633039)

Poprawione błędy

W tej wersji naprawiliśmy te błędy:

Identyfikator problemu Opis
159360654

Certyfikaty apigee-mtls były ważne tylko przez 30 dni.

Nowe certyfikaty są teraz ważne przez rok. Aby zastąpić stary 30-dniowy certyfikat nowym certyfikatem ważnym przez rok, zapoznaj się z artykułem Uaktualnianie MTLS Apigee.

147736003

Nieaktualna biblioteka na stronie enterprise.apigee.com powodowała problemy z bezpieczeństwem.

Biblioteka została zaktualizowana.

150594487

Zestaw zasobów Java na poziomie organizacji powodował, że procesory wiadomości nie mogły wczytać organizacji.

149739904

Maskowanie danych w przypadku nagłówków HTTP uwzględniało wielkość liter.

Problem został rozwiązany: maskowanie danych nie uwzględnia już wielkości liter.

130416715

Potencjalna luka w zabezpieczeniach z powodu nagłówka „True-Client-IP”

W tej wersji wprowadziliśmy nowy element zasad kontroli dostępu, IgnoreTrueClientIPHeader, który rozwiązuje ten problem. Zobacz element IgnoreTrueClientIPHeader.

161858295

Niektóre zmienne ciche zostały błędnie napisane.

Zmienna instalacji cichej SSO_JWT_SIGNING_KEY_FILEPATH nie jest już błędnie zapisywana.

160951701

Instalacja mTLS nie powiodła się z powodu problemu z serwerem Consul.

Plik binarny Consul został uaktualniony z wersji 1.6.2 do najnowszej stabilnej wersji 1.8.0.

132654321

W dziennikach audytu nie byli widoczni użytkownicy, których role zostały zaktualizowane.

Po wprowadzeniu zmian w rolach obecnych użytkowników lub dodaniu obecnego użytkownika do organizacji w dzienniku kontrolnym pojawiał się komunikat „Update user undefined” (Zaktualizowano niezdefiniowanego użytkownika), który uniemożliwiał sprawdzenie, którego użytkownika dotyczyło działanie.

160916451

Instalacja mTLS nie powiodła się z powodu nieaktualnej wersji binarnej Consul.

Binarny plik Consul został uaktualniony z wersji 1.6.2 do najnowszej stabilnej wersji 1.8.0.

apigee-mtls prawidłowo obsługuje teraz serwery z wieloma interfejsami sieciowymi i adresami.

161764596

Podczas stosowania aktualizacji poprawek nie aktualizowano apigee-tomcat.

Problem został rozwiązany.

133145969

Brakowało dokumentacji dotyczącej wyłączania protokołów w interfejsie.

Nową dokumentację znajdziesz w artykule wyłączanie protokołów TLS.

Znane problemy

W tej wersji występują te znane problemy:

Identyfikator problemu Opis
149245401

Problem z puli połączeń w zasadach LDAP

Ustawienia puli połączeń LDAP dla JNDI skonfigurowane za pomocą zasobu LDAP nie są odzwierciedlane, a ustawienia domyślne JNDI powodują, że za każdym razem używane są połączenia jednorazowe. W rezultacie połączenia są otwierane i zamykane za każdym razem do jednorazowego użytku, co powoduje dużą liczbę połączeń z serwerem LDAP w ciągu godziny.

Obejście:

Aby zmienić właściwości puli połączeń LDAP, wykonaj te czynności, aby wprowadzić globalną zmianę we wszystkich zasadach LDAP.

  1. Utwórz plik właściwości konfiguracji, jeśli jeszcze nie istnieje:
    /opt/apigee/customer/application/message-processor.properties
  2. Dodaj do pliku te wiersze (zastąp wartości właściwości Java Naming and Directory Interface (JNDI) zgodnie z wymaganiami konfiguracji zasobu LDAP).
    bin_setenv_ext_jvm_opts="-Dcom.sun.jndi.ldap.connect.pool.maxsize=20
    -Dcom.sun.jndi.ldap.connect.pool.prefsize=2
    -Dcom.sun.jndi.ldap.connect.pool.initsize=2
    -Dcom.sun.jndi.ldap.connect.pool.timeout=120000
    -Dcom.sun.jndi.ldap.connect.pool.protocol=ssl"
  3. Upewnij się, że plik /opt/apigee/customer/application/message-processor.properties należy do użytkownika apigee:apigee.
  4. Uruchom ponownie każdy procesor wiadomości.

Aby sprawdzić, czy właściwości JNDI puli połączeń działają, możesz wykonać tcpdump, aby obserwować zachowanie puli połączeń LDAP w czasie.