Mantenimiento de Apigee mTLS

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.

  1. Detén todos los componentes principales de Apigee:
    /opt/apigee/apigee-service/bin/apigee-all stop
    Consulta Inicia, detén y verifica todos los componentes.
  2. Detén apigee-mtls:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls stop
  3. Desinstala apigee-mtls:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls uninstall
  4. Vuelve a instalar apigee-mtls:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls install
  5. Ejecuta apigee-mtls setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls setup -f /opt/silent.conf
  6. Reinicia apigee-mtls:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls start
  7. Reinicia todos los componentes principales de Apigee:
    /opt/apigee/apigee-service/bin/apigee-all start
    Consulta Inicia, detén y verifica todos los componentes.

Rota certificados locales con una autoridad certificadora (AC) personalizada

Para rotar los certificados locales con una AC personalizada, sigue estos pasos:

  1. Sigue los pasos que se indican en Usa un certificado personalizado para generar los certificados nuevos que usarás.
  2. Detén todos los componentes principales de Apigee:
    /opt/apigee/apigee-service/bin/apigee-all stop
    Consulta Inicia, detén y verifica todos los componentes.
  3. Detén apigee-mtls:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls stop
  4. 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.pem
    rm -f /opt/apigee/apigee-mtls/source/certs/local_cert.pem
    rm -f /opt/apigee/apigee-mtls/source/certs/local_key.pem
    rm -rf /opt/apigee/data/apigee-mtls
  5. 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.pem
    
    chmod \
      --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
      /opt/apigee/apigee-mtls/certs/local_cert.pem
    
    chown \
      --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
      /opt/apigee/apigee-mtls/certs/local_cert.pem
    
    cp ${new_cert} /opt/apigee/apigee-mtls/source/certs/local_cert.pem
    
    chmod \
      --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
      /opt/apigee/apigee-mtls/source/certs/local_cert.pem
    
    chown \
      --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
      /opt/apigee/apigee-mtls/source/certs/local_cert.pem
    
    cp ${new_key} /opt/apigee/apigee-mtls/certs/local_key.pem
    
    chmod \
      --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
      /opt/apigee/apigee-mtls/source/certs/local_cert.pem
    
    chown \
      --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
      /opt/apigee/apigee-mtls/source/certs/local_cert.pem
    
    cp ${new_key} /opt/apigee/apigee-mtls/source/certs/local_key.pem
    
    chmod \
      --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
      /opt/apigee/apigee-mtls/source/certs/local_cert.pem
    
    chown \
      --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
      /opt/apigee/apigee-mtls/source/certs/local_cert.pem
  6. Reinicia apigee-mtls:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls start
  7. Reinicia todos los componentes principales de Apigee:
    /opt/apigee/apigee-service/bin/apigee-all start
    Consulta Inicia, detén y verifica todos los componentes.