Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

4.53.00.02 - Note di rilascio di Edge for Private Cloud

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X. info

Il 19 dicembre 2024 abbiamo rilasciato una nuova versione di Apigee Edge for Private Cloud.

Procedura di aggiornamento

Questa sezione descrive come installare questa release se esegui l'aggiornamento dalla release precedente di Edge for Private Cloud. Se devi eseguire l'aggiornamento da una release precedente, consulta Applicare più versioni di patch.

L'aggiornamento di questa release aggiornerà i componenti elencati di seguito:

apigee-nginx-1.26.1-el8.x86_64.rpm
apigee-nginx-1.26.1-el9.x86_64.rpm
apigee-qpidd-8.0.6-0.0.2534.noarch.rpm
apigee-sso-4.53.00-0.0.21506.noarch.rpm
apigee-tomcat-9.0.86-0.0.948.noarch.rpm

Puoi controllare le versioni RPM attualmente installate per verificare se devono essere aggiornate inserendo:

apigee-all version

Per aggiornare l'installazione, esegui la seguente procedura sui nodi Edge:

Su tutti i nodi Edge:
1. Pulisci i repository Yum:
```
sudo yum clean all
```
2. Scarica l'ultimo file bootstrap_4.53.00.sh di Edge 4.53.00 in /tmp/bootstrap_4.53.00.sh:
```
curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
```
3. Installa l'utilità apigee-service e le dipendenze di Edge 4.53.00:
```
sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
```
  dove uName e pWord sono il nome utente e la password che hai ricevuto da Apigee. Se ometti pWord, ti verrà chiesto di inserirla.
4. Utilizza il comando source per eseguire lo script apigee-service.sh:
```
source /etc/profile.d/apigee-service.sh
```

Su tutti i nodi Qpid, esegui lo script update.sh:

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

Sui nodi SSO, segui la procedura descritta nella sezione Passaggi per aggiornare Apigee SSO dalle versioni precedenti:

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

Passaggi per aggiornare Apigee SSO dalle versioni precedenti

In Edge for Private Cloud 4.53.00, le chiavi e i certificati IDP utilizzati nel componente apigee-sso vengono ora configurati tramite un keystore. Dovrai esportare la chiave e il certificato utilizzati in precedenza in un keystore, configurarlo e poi procedere con l'aggiornamento SSO come di consueto.

Identifica la chiave e il certificato esistenti utilizzati per la configurazione dell'IDP:
1. Recupera il certificato cercando il valore di SSO_SAML_SERVICE_PROVIDER_CERTIFICATE nel file di configurazione dell'installazione SSO o eseguendo una query sul componente apigee-sso per conf_login_service_provider_certificate.
  
  Utilizza il seguente comando sul nodo SSO per eseguire una query su apigee-sso per il percorso del certificato IDP. Nell'output, cerca il valore nell'ultima riga.
```
apigee-service apigee-sso configure -search conf_login_service_provider_certificate
```
2. Recupera la chiave cercando il valore di SSO_SAML_SERVICE_PROVIDER_KEY nel file di configurazione dell'installazione SSO o eseguendo una query sul componente apigee-sso per conf_login_service_provider_key.
  
  Utilizza il seguente comando sul nodo SSO per eseguire una query su apigee-sso per il percorso della chiave IDP. Nell'output, cerca il valore nell'ultima riga.
```
apigee-service apigee-sso configure -search conf_login_service_provider_key
```
Esporta la chiave e il certificato in un keystore:
1. Esporta la chiave e il certificato in un keystore PKCS12:
```
sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>
```
  Parametri:
  - certificate_path: percorso del file del certificato recuperato nel passaggio 1.a.
  - key_path: percorso del file della chiave privata recuperato nel passaggio 1.b.
  - keystore_path: percorso del keystore appena creato contenente il certificato e la chiave privata.
  - alias: alias utilizzato per la coppia chiave-certificato all'interno del keystore.
  Per ulteriori dettagli, consulta la documentazione di OpenSSL.
2. (Facoltativo) Esporta la chiave e il certificato da PKCS12 a un keystore JKS:
```
sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>
```
  Parametri:
  - PKCS12_keystore_path: percorso del keystore PKCS12 creato nel passaggio 2.a, contenente il certificato e la chiave.
  - destination_keystore_path: percorso del nuovo keystore JKS in cui verranno esportati il certificato e la chiave.
  - alias: alias utilizzato per la coppia chiave-certificato all'interno del keystore JKS.
Modifica il proprietario del file del keystore di output in modo che sia l'utente "apigee":
```
sudo chown apigee:apigee <keystore_file>
```

Aggiungi le seguenti proprietà nel file di configurazione di Apigee SSO e aggiornale con il percorso del file del keystore, la password, il tipo di keystore e l'alias:

# Path to the keystore file
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PATH=${APIGEE_ROOT}/apigee-sso/source/conf/keystore.jks

# Keystore password
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PASSWORD=Secret123  # Password for accessing the keystore

# Keystore type
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_TYPE=JKS  # Type of keystore, e.g., JKS, PKCS12

# Alias within keystore that stores the key and certificate
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_ALIAS=service-provider-cert

Aggiorna il software Apigee SSO sul nodo SSO come di consueto utilizzando il seguente comando:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf
```

Correzioni di bug

Questa sezione elenca i bug di Private Cloud corretti in questa release.

ID problema	Descrizione
379446933	È stato risolto il problema che impediva a `nginx` di eseguire il binding alla porta 443.

Problemi di sicurezza risolti

Di seguito è riportato un elenco dei problemi di sicurezza noti che sono stati risolti in questa release. Per evitare questi problemi, installa l'ultima versione di Edge Private Cloud.

ID problema	Descrizione
344961470	È stata applicata una patch al portale di gestione di QPID per una vulnerabilità XSS.

Modifiche al software supportato

In questa release non è stato incluso il supporto per nuovi software.

Ritiri e dismissioni

Non sono previsti nuovi ritiri o dismissioni in questa release.

Nuove funzionalità

Questa sezione elenca le nuove funzionalità di questa release.

ID problema	Descrizione
379125083	È stata attivata la funzionalità Single Sign-On (SSO) negli ambienti RHEL-8 con FIPS.
379125495	SSO ora accetta chiavi e certificati per IDP in formato keystore.

Problemi noti

Per un elenco completo dei problemi noti, vedi Problemi noti con Edge for Private Cloud.

Applicare più versioni di patch

Questa sezione descrive come applicare più versioni di patch, nel caso in cui esegui l'aggiornamento da una versione di Edge for Private Cloud precedente alla versione della patch release precedente.

Ogni patch release contiene aggiornamenti a componenti specifici di Edge for Private Cloud, come edge-management-server. Per applicare più versioni di patch, devi aggiornare ogni componente Edge incluso in una patch release successiva alla versione attualmente installata. Puoi trovare questi componenti consultando le note di release di Edge for Private Cloud per tutte le versioni successive alla tua versione attuale e controllando l'elenco degli RPM per queste release. Consulta le note di release di Apigee per i link a tutte le note di release di Edge for Private Cloud.

Nota: devi aggiornare ogni componente una sola volta, installando l'RPM per l'ultima versione del componente incluso nelle patch release. Per aggiornare il componente, segui le istruzioni riportate nelle note di release per quella versione.

Nota: l'upgrade di un componente installa automaticamente l'ultima versione della patch di un componente. Se vuoi eseguire l'upgrade a una versione della patch diversa dall'ultima, devi mantenere la tua copia tarball del repository di Apigee utilizzando il mirror di Apigee e utilizzare questo mirror per le installazioni di Apigee. Per ulteriori informazioni, consulta Utilizzare un repository Edge locale per mantenere la versione di Edge.