Actualiza un certificado TLS para la nube privada

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

El método que usas para especificar el nombre del almacén de claves y el almacén de certificados de confianza en el host virtual o el extremo/servidor de destino determina cómo se realiza la actualización del certificado. Puedes especificar el nombre del almacén de claves y el almacén de certificados de confianza con lo siguiente:

• Referencias: preferido
• Nombres directos
• Variables de flujo

Cada uno de estos métodos tiene diferentes repercusiones en el proceso de actualización del certificado, como se describe en la siguiente tabla.

Prueba el certificado antes y después de la actualización

Usa los siguientes openssl comandos para probar el certificado actual antes de actualizar it:

echo | openssl s_client -servername hostAlias -connect hostAlias.apigee.net:443 2>/dev/null | openssl x509 -noout -dates -subject

En el ejemplo anterior, hostAlias es el alias de host del host virtual o la dirección IP. Por ejemplo:

echo | openssl s_client -servername api.myCompany.com -connect api.myCompany.com:443 2>/dev/null | openssl x509 -noout -dates -subject

Deberías ver un resultado como el siguiente:

notBefore=Dec 30 22:11:38 2015 GMT
notAfter=Dec 30 22:11:38 2016 GMT
subject= /OU=Domain Control Validated/CN=*.apigee.net

Usa el mismo comando después de actualizar el certificado para probarlo.

Actualiza un certificado TLS en un almacén de claves

Para una implementación local de Edge, haz lo siguiente:

1. Crea un almacén de claves nuevo y sube un certificado y una clave como se describe en Almacenes de claves y almacenes de confianza. En el almacén de claves nuevo, asegúrate de usar el mismo nombre para el alias de clave que se usó en el almacén de claves existente.
   
   Nota: Puedes borrar el almacén de claves actual y crear uno nuevo con el mismo nombre y alias. No es necesario reiniciar el router. Sin embargo, las solicitudes a la API fallarán hasta que el nuevo almacén de claves y alias esté configurado.
2. Para un host virtual que usan las conexiones entrantes, es decir, una solicitud a la API en Edge:
   1. Si tu host virtual usa una referencia al almacén de claves, actualiza la referencia como se describe en Trabaja con referencias.
   2. Si tu host virtual usa un nombre directo del almacén de claves, haz lo siguiente:
      1. Actualiza los hosts virtuales que hicieron referencia al almacén de claves y al alias de clave anteriores para que hagan referencia al almacén de claves y al alias de clave nuevos.
      2. Reinicia los routers, uno a la vez. Ten en cuenta que, si borraste el almacén de claves anterior y creaste uno nuevo con el mismo nombre, no es necesario reiniciar el router.
         
         No es necesario volver a implementar el proxy.
3. Para un extremo o servidor de destino que usan las conexiones salientes, es decir, de Apigee a un servidor de backend:
   1. Si el extremo o servidor de destino usa referencias al almacén de claves, actualiza la referencia como se describe en Trabaja con referencias. No es necesario volver a implementar el proxy.
   2. Si el extremo o servidor de destino usa una variable de flujo, actualiza la variable de flujo. No es necesario volver a implementar el proxy.
   3. Si el extremo o servidor de destino usa un nombre directo del almacén de claves, haz lo siguiente:
      1. Actualiza la configuración del extremo o servidor de destino para cualquier proxy de API que haya hecho referencia al almacén de claves y al alias de clave anteriores para que hagan referencia al almacén de claves y al alias de clave nuevos.
      2. Para cualquier proxy de API que haga referencia al almacén de claves desde una definición de TargetEndpoint, debes volver a implementar el proxy.
         
         Si TargetEndpoint hace referencia a una definición de TargetServer y la definición de TargetServer hace referencia al almacén de claves, no es necesario volver a implementar el proxy.
      3. Si el almacén de claves se usa para la TLS bidireccional entre el perímetro y el servicio de backend, y borraste o volviste a crear el almacén de claves con el mismo nombre, debes reiniciar los procesadores de mensajes de Edge.
4. Después de confirmar que tu nuevo almacén de claves funciona correctamente, borra el almacén de claves anterior con el certificado y la clave vencidos como se describió anteriormente.

Actualiza un certificado TLS en un almacén de confianza

Si usas referencias al almacén de certificados de confianza, el proceso de actualización de un certificado en un almacén de certificados de confianza es el mismo que para un almacén de claves, como se muestra más arriba. Las únicas diferencias son las siguientes:

• Cuando subes el certificado nuevo al almacén de certificados de confianza nuevo, el nombre del alias no es importante para los almacenes de certificados de confianza.
• Si un certificado es parte de una cadena, debes crear un solo archivo que contenga todos los certificados y subir ese archivo a un solo alias, o subir todos los certificados de la cadena por separado al almacén de confianza mediante un alias diferente para cada certificado.

Si usas nombres directos de tus almacenes de claves y almacenes de confianza, haz lo siguiente:

1. Sube un certificado nuevo al almacén de confianza como se describe en Almacenes de claves y almacenes de confianza. No es necesario borrar el certificado anterior.
2. Para un host virtual que usan las conexiones entrantes, es decir, una solicitud a la API en Edge, reinicia los routers uno a la vez.
3. Para un extremo o servidor de destino que usan las conexiones salientes, es decir, de Apigee a un servidor de backend, reinicia los procesadores de mensajes de Edge uno a la vez.
4. Confirma que tu nuevo almacén de certificados de confianza funciona correctamente.