Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

4.53.00.02: Notas de la versión de Edge para la nube privada

Estás viendo la documentación de Apigee Edge.
Ir a la documentación de Apigee X. info

El 19 de diciembre de 2024, lanzamos una nueva versión de Apigee Edge para la nube privada.

Procedimiento de actualización

En esta sección, se describe cómo instalar esta versión si realizas la actualización desde la versión anterior de Edge para la nube privada. Si necesitas actualizar desde una versión anterior, consulta Cómo aplicar varias versiones de parche.

Si actualizas esta versión, se actualizarán los componentes que se indican a continuación:

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

Para verificar si las versiones de RPM instaladas actualmente deben actualizarse, ingresa lo siguiente:

apigee-all version

Para actualizar la instalación, sigue el siguiente procedimiento en los nodos de Edge:

En todos los nodos de Edge, haz lo siguiente:
1. Limpia los repositorios de Yum:
```
sudo yum clean all
```
2. Descarga el archivo bootstrap_4.53.00.sh más reciente de Edge 4.53.00 en /tmp/bootstrap_4.53.00.sh:
```
curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
```
3. Instala la utilidad apigee-service y las dependencias de Edge 4.53.00:
```
sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
```
  donde uName y pWord son el nombre de usuario y la contraseña que recibiste de Apigee. Si omites pWord, se te pedirá que lo ingreses.
4. Usa el comando source para ejecutar la secuencia de comandos apigee-service.sh:
```
source /etc/profile.d/apigee-service.sh
```
En todos los nodos de Qpid, ejecuta la secuencia de comandos update.sh:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
En los nodos de SSO, sigue el procedimiento que se detalla en la sección Pasos para actualizar Apigee SSO desde versiones anteriores:

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

Pasos para actualizar Apigee SSO desde versiones anteriores

En Edge para la nube privada 4.53.00, las claves y los certificados de IDP que se usan en el componente apigee-sso ahora se configuran a través de un almacén de claves. Deberás exportar la clave y el certificado que se usaron antes a un almacén de claves, configurarlo y, luego, continuar con la actualización de SSO como de costumbre.

Identifica la clave y el certificado existentes que se usan para configurar IDP:
1. Para recuperar el certificado, busca el valor de SSO_SAML_SERVICE_PROVIDER_CERTIFICATE en el archivo de configuración de instalación de SSO o consulta el componente apigee-sso para conf_login_service_provider_certificate.
  
  Usa el siguiente comando en el nodo de SSO para consultar apigee-sso para la ruta de acceso del certificado de IDP. En el resultado, busca el valor en la última línea.
```
apigee-service apigee-sso configure -search conf_login_service_provider_certificate
```
2. Para recuperar la clave, busca el valor de SSO_SAML_SERVICE_PROVIDER_KEY en el archivo de configuración de instalación de SSO o consulta el componente apigee-sso para conf_login_service_provider_key.
  
  Usa el siguiente comando en el nodo de SSO para consultar apigee-sso para la ruta de acceso de la clave de IDP. En el resultado, busca el valor en la última línea.
```
apigee-service apigee-sso configure -search conf_login_service_provider_key
```
Exporta la clave y el certificado a un almacén de claves:
1. Exporta la clave y el certificado a un almacén de claves PKCS12:
```
sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>
```
  Parámetros:
  - certificate_path: Es la ruta de acceso al archivo de certificado recuperado en el paso 1.a.
  - key_path: Es la ruta de acceso al archivo de claves privadas recuperado en el paso 1.b.
  - keystore_path: Es la ruta de acceso al almacén de claves recién creado que contiene el certificado y la clave privada.
  - alias: Es el alias que se usa para el par de claves y certificados dentro del almacén de claves.
  Consulta la documentación de OpenSSL para obtener más detalles.
2. (Opcional) Exporta la clave y el certificado de PKCS12 a un almacén de claves JKS:
```
sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>
```
  Parámetros:
  - PKCS12_keystore_path: Es la ruta de acceso al almacén de claves PKCS12 creado en el paso 2.a, que contiene el certificado y la clave.
  - destination_keystore_path: Es la ruta de acceso al nuevo almacén de claves JKS en el que se exportarán el certificado y la clave.
  - alias: Es el alias que se usa para el par de claves y certificados dentro del almacén de claves JKS.
Cambia el propietario del archivo de almacén de claves de salida al usuario "apigee":
```
sudo chown apigee:apigee <keystore_file>
```

Agrega las siguientes propiedades en el archivo de configuración de Apigee SSO y actualízalas con la ruta de acceso del archivo de almacén de claves, la contraseña, el tipo de almacén de claves y el 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

Actualiza el software de Apigee SSO en el nodo de SSO como de costumbre con el siguiente comando:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf
```

Correcciones de errores

En esta sección, se enumeran los errores de la nube privada que se corrigieron en esta versión.

ID del problema	Descripción
379446933	Se corrigió el problema que impedía que `nginx` se vinculara al puerto 443.

Problemas de seguridad corregidos

A continuación, se incluye una lista de problemas de seguridad conocidos que se corrigieron en esta versión. Para evitar estos problemas, instala la versión más reciente de Edge para la nube privada.

ID del problema	Descripción
344961470	Se aplicó un parche al portal de administración de QPID para una vulnerabilidad de XSS.

Cambios en el software compatible

En esta versión, no se incluyó compatibilidad con software nuevo.

Bajas y retiros

No hay bajas ni retiros nuevos en esta versión.

Nuevas funciones

En esta sección, se enumeran las nuevas funciones de esta versión.

ID del problema	Descripción
379125083	Se habilitó la funcionalidad de inicio de sesión único (SSO) en entornos RHEL-8 habilitados para FIPS.
379125495	SSO ahora acepta claves y certificados para IDP en formato de almacén de claves.

Problemas conocidos

Consulta Problemas conocidos con Edge para la nube privada para obtener una lista completa de los problemas conocidos.

Cómo aplicar varias versiones de parche

En esta sección, se describe cómo aplicar varias versiones de parche, en caso de que realices la actualización desde una versión de Edge para la nube privada anterior a la versión de parche anterior.

Cada versión de parche contiene actualizaciones de componentes específicos de Edge para la nube privada, como edge-management-server. Para aplicar varias versiones de parche, debes actualizar cada componente de Edge que se incluyó en una versión de parche posterior a la versión instalada actualmente. Para encontrar estos componentes, consulta las notas de la versión de Edge para la nube privada para todas las versiones posteriores a la versión actual y verifica la lista de RPM para esas versiones. Consulta las Notas de la versión de Apigee para obtener vínculos a todas las notas de la versión de Edge para la nube privada.

Nota: Solo debes actualizar cada componente una vez. Para ello, instala el RPM de la versión más reciente del componente incluido en las versiones de parche. Sigue las instrucciones de las notas de la versión para actualizar el componente.

Nota: Cuando actualizas un componente, se instala automáticamente la versión de parche más reciente de un componente. Si deseas actualizar a una versión de parche que no sea la más reciente, debes mantener tu propia copia de tarball del repositorio de Apigee con el mirror de Apigee y usar este mirror para las instalaciones de Apigee. Para obtener más información, consulta Cómo usar un repositorio local de Edge para mantener tu versión de Edge.