Solución de Problemas con Certificados SSL y ServBay CA
Este documento ofrece una guía sobre problemas comunes y métodos de solución relacionados con los certificados SSL y la CA de ServBay en entornos de desarrollo local.
¿Qué hacer si se pierden los certificados SSL?
Durante el desarrollo de sitios web locales con ServBay, a veces puede ocurrir que los archivos de certificado SSL del sitio se pierdan accidentalmente. Esto causará que tu servidor web (como Nginx, Caddy o Apache) no pueda arrancar o cargar el sitio normalmente, mostrando mensajes de error relacionados con los archivos de certificado en los registros.
Descripción del problema
Cuando pierdes los certificados SSL (.crt
y .key
) emitidos automáticamente por ServBay para tu sitio local, es posible que veas mensajes similares en los registros de errores de tu servidor web. Estos errores suelen indicar que el servidor no puede encontrar o leer la ruta especificada del certificado.
Aquí tienes ejemplos de mensajes de error habituales:
Mensaje de error en Nginx:
nginx: [emerg] cannot load certificate "/Applications/ServBay/ssl/private/tls-certs/servb3ay.host/servbay.host.crt": BIO_new_file() failed (SSL: error:80000002:system library::No such file or directory:calling fopen(/Applications/ServBay/ssl/private/tls-certs/servb3ay.host/servbay.host.crt, r) error:10000080:BIO routines::no such file)
nginx: configuration file /Applications/ServBay/package/etc/nginx/nginx.conf test failed
2
Mensaje de error en Caddy:
Error: loading http app module: provision http: getting tls app: loading tls app module: provision tls: loading certificates: open /Applications/ServBay/ssl/private/tls-certs/servbay.host/ser3vbay.host.crt: no such file or directory
Mensaje de error en Apache:
AH00526: Syntax error on line 15 of /Applications/ServBay/package/etc/apache/vhosts/servbay.host.conf:
SSLCertificateFile: file '/Applications/ServBay/ssl/pri3vate/tls-certs/servbay.host/servbay.host.crt' does not exist or is empty
2
Todos estos mensajes tienen la misma causa principal: la ruta del certificado SSL configurada en el servidor web no es válida porque el archivo no existe o no es accesible.
Solución
Para los certificados SSL generados automáticamente por ServBay para tus sitios locales, ServBay ofrece un mecanismo automático de detección y reemisión para solucionar la pérdida de certificados.
Sigue estos pasos:
- Inicia la aplicación ServBay: Asegúrate de que la aplicación ServBay está en funcionamiento.
- Ve a la lista de sitios web: En la barra lateral izquierda de la aplicación ServBay, haz clic en Sitios web.
- Selecciona el sitio afectado: Busca el nombre del sitio local con el problema de certificado SSL perdido en la lista y haz clic sobre él.
- Detección y emisión automática: Al cargar la configuración del sitio, ServBay detectará automáticamente si existen los archivos de certificado SSL necesarios. Si detecta su ausencia (como archivos
.crt
o.key
faltantes), ServBay intentará reemitir y desplegar automáticamente nuevos certificados en la ruta correcta (/Applications/ServBay/ssl/private/tls-certs/tu-dominio/
). - Reinicia el servidor web: Una vez que los archivos del certificado han sido regenerados y desplegados exitosamente, necesitas reiniciar el paquete del servidor web correspondiente (Nginx, Caddy o Apache) para que cargue los nuevos certificados. Ve a la página Paquetes en la barra lateral izquierda, localiza el servidor web que usas y haz clic en el botón de reinicio (usualmente indicado por un ícono de flechas en círculo).
- Verifica la solución: Tras reiniciar el servidor web, intenta acceder a tu sitio local vía HTTPS desde el navegador (por ejemplo,
https://tu-dominio
). El problema debería estar resuelto y el sitio cargarse correctamente bajo una conexión HTTPS.
Notas Importantes
- Esta solución está dirigida principalmente a certificados SSL generados automáticamente por ServBay para sitios locales. Si usaste un certificado SSL personalizado importado por ti, ServBay no lo reemitirá automáticamente en caso de pérdida; deberás restaurarlo o importar uno nuevo manualmente.
- ServBay utiliza su CA interna, llamada ServBay User CA, para emitir certificados para sitios locales y permitir HTTPS en el entorno local. Si sigues viendo advertencias de certificados no confiables en el navegador al acceder a tu sitio local por HTTPS, probablemente sea porque tu sistema operativo o navegador no confía en la ServBay User CA. Consulta la documentación de ServBay sobre Confiar en ServBay CA para aprender cómo configurarlo.
- ServBay proporciona funciones para respaldar la configuración de sitios y los certificados SSL. Realiza copias de seguridad periódicamente para poder restaurar rápidamente tus datos ante cualquier eventualidad.
Preguntas Frecuentes (FAQ)
P: ¿Por qué ServBay emite certificados SSL automáticamente para sitios locales?
R: ServBay busca brindar un entorno de desarrollo local completo. Para simular el entorno de producción y facilitar el desarrollo y pruebas con HTTPS, ServBay genera automáticamente certificados SSL para los sitios locales utilizando su ServBay User CA, permitiendo el acceso HTTPS en local.
P: ¿Puedo usar mis propios certificados SSL?
R: Sí, ServBay permite importar y utilizar tus propios certificados SSL (incluyendo aquellos emitidos por ACME/Let's Encrypt). Esta guía de solución de problemas solo se aplica a los certificados generados automáticamente por ServBay.
P: ¿Es seguro volver a emitir un certificado?
R: Sí, en un entorno de desarrollo local, los certificados reemitidos por ServBay llevan la firma de su ServBay User CA y solo tienen validez para pruebas y desarrollo en tu máquina. No afectan la seguridad de tu sitio en Internet.
Resumen
ServBay facilita la gestión de los certificados SSL en entornos de desarrollo local. Si los certificados SSL emitidos automáticamente por ServBay para tus sitios locales se pierden, puedes restaurar rápidamente el acceso por HTTPS siguiendo unos sencillos pasos, ya que ServBay detectará y reemitirá automáticamente los certificados faltantes, permitiendo que tu sitio vuelva a funcionar bajo HTTPS sin complicaciones.