En esta página, se describen las tareas de mantenimiento de mTLS de Apigee que se deben realizar con regularidad.
Rota certificados locales
Los certificados locales, que se instalan en cada host de Apigee, deben reemplazarse por otros nuevos cada año. Esto se denomina rotación de certificados. Existen dos formas de rotar certificados, según si usas una autoridad certificadora personalizada o un certificado instalado por Consul.
Rota certificados locales sin una autoridad certificadora (AC) personalizada
La forma más sencilla de rotar certificados sin una AC personalizada es
desinstalar y
volver a instalar apigee-mtls.
Esto quita todos los certificados antiguos presentes y genera certificados nuevos de forma local.
Para ello, puedes ejecutar los siguientes comandos en cada host, uno por uno, con un tiempo de inactividad mínimo:
Nota: Se supone que el mismo archivo silent.conf que se usó para la instalación inicial está presente.
- Detén todos los componentes principales de Apigee:
Consulta Inicia, detén y verifica todos los componentes./opt/apigee/apigee-service/bin/apigee-all stop
- Detén
apigee-mtls:/opt/apigee/apigee-service/bin/apigee-service apigee-mtls stop
- Desinstala
apigee-mtls:/opt/apigee/apigee-service/bin/apigee-service apigee-mtls uninstall
- Vuelve a instalar
apigee-mtls:/opt/apigee/apigee-service/bin/apigee-service apigee-mtls install
- Ejecuta
apigee-mtls setup:/opt/apigee/apigee-service/bin/apigee-service apigee-mtls setup -f /opt/silent.conf
- Reinicia
apigee-mtls:/opt/apigee/apigee-service/bin/apigee-service apigee-mtls start
- Reinicia todos los componentes principales de Apigee:
Consulta Inicia, detén y verifica todos los componentes./opt/apigee/apigee-service/bin/apigee-all start
Rota certificados locales con una autoridad certificadora (AC) personalizada
Para rotar los certificados locales con una AC personalizada, sigue estos pasos:
- Sigue los pasos que se indican en Usa un certificado personalizado para generar los certificados nuevos que usarás.
- Detén todos los componentes principales de Apigee:
Consulta Inicia, detén y verifica todos los componentes./opt/apigee/apigee-service/bin/apigee-all stop
- Detén
apigee-mtls:/opt/apigee/apigee-service/bin/apigee-service apigee-mtls stop
- Quita los archivos de certificados locales antiguos:
rm -f /opt/apigee/apigee-mtls/certs/local_cert.pem
rm -f /opt/apigee/apigee-mtls/certs/local_key.pemrm -f /opt/apigee/apigee-mtls/source/certs/local_cert.pemrm -f /opt/apigee/apigee-mtls/source/certs/local_key.pemrm -rf /opt/apigee/data/apigee-mtls - Copia el nuevo par de certificado y par de claves generado en el primer paso en las siguientes ubicaciones y
actualiza los permisos:
cp ${new_cert} /opt/apigee/apigee-mtls/certs/local_cert.pemchmod \ --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \ /opt/apigee/apigee-mtls/certs/local_cert.pemchown \ --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \ /opt/apigee/apigee-mtls/certs/local_cert.pemcp ${new_cert} /opt/apigee/apigee-mtls/source/certs/local_cert.pemchmod \ --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \ /opt/apigee/apigee-mtls/source/certs/local_cert.pemchown \ --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \ /opt/apigee/apigee-mtls/source/certs/local_cert.pemcp ${new_key} /opt/apigee/apigee-mtls/certs/local_key.pemchmod \ --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \ /opt/apigee/apigee-mtls/source/certs/local_cert.pemchown \ --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \ /opt/apigee/apigee-mtls/source/certs/local_cert.pemcp ${new_key} /opt/apigee/apigee-mtls/source/certs/local_key.pemchmod \ --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \ /opt/apigee/apigee-mtls/source/certs/local_cert.pemchown \ --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \ /opt/apigee/apigee-mtls/source/certs/local_cert.pem - Reinicia
apigee-mtls:/opt/apigee/apigee-service/bin/apigee-service apigee-mtls start
- Reinicia todos los componentes principales de Apigee:
Consulta Inicia, detén y verifica todos los componentes./opt/apigee/apigee-service/bin/apigee-all start