Certificados

La autoridad de certificación

En el primer arranque, Joppa crea una autoridad de certificación (CA) propia de tu usuario, «Joppa local CA», válida durante 10 años. Su clave privada se queda en tu equipo, legible solo por ti, en la carpeta ca/ de Joppa. Solo puede firmar para nombres locales reservados (.test, .localhost, .internal, .local, .home.arpa, .example, .invalid): aunque se copie, su clave no permite hacerse pasar por un sitio real. Una CA creada por una versión anterior de Joppa no tiene este límite; para cambiarla, borra la carpeta ca/, reinicia Joppa y aprueba la nueva CA.

Si ya usas mkcert, Joppa reutiliza su CA (la de $CAROOT o, si no, la de la ubicación por defecto de mkcert). Los certificados de Joppa se aceptan entonces en todos los sitios donde ya se aceptaba mkcert. Ajustes › Autoridad de certificación indica cuál se usa: «Joppa» o «mkcert (compartida)».

Los certificados de los dominios

Joppa firma un certificado al vuelo, en la primera conexión a cada dominio. Cubre el dominio y sus subdominios (miproyecto.test y *.miproyecto.test) y es válido durante 397 días, la duración máxima que aceptan los navegadores. No hay nada que generar ni que renovar.

Hacer que se apruebe la CA

El navegador solo muestra el candado si el sistema confía en la CA. En el primer arranque, Joppa pide aprobarla enseguida: el sistema te pide la contraseña y Joppa añade la CA a su lista de confianza (en macOS: tu llavero de sesión y tus ajustes de confianza). Si la cancelas, un aviso en la parte superior de la ventana ofrece Aprobar, y un clic en CA … no aprobada en la barra de estado abre el mismo botón. Ajustes › Autoridad de certificación muestra el estado, el mismo botón (Aprobar la autoridad) y el comando equivalente, para ejecutarlo una vez en un terminal si lo prefieres:

Sistema	Comando	Comprobación
macOS	sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain "<rootCA.pem>"	Automática
Linux (Debian, Ubuntu)	sudo cp <rootCA.pem> /usr/local/share/ca-certificates/joppa-rootCA.crt && sudo update-ca-certificates	Joppa no puede comprobarla
Linux (Arch, Manjaro)	sudo cp <rootCA.pem> /etc/ca-certificates/trust-source/anchors/joppa-rootCA.crt && sudo update-ca-trust	Joppa no puede comprobarla
Linux (Fedora)	sudo cp <rootCA.pem> /etc/pki/ca-trust/source/anchors/joppa-rootCA.crt && sudo update-ca-trust	Joppa no puede comprobarla

La barra de estado muestra CA Joppa ok cuando está aprobada y CA Joppa no aprobada si no lo está (se puede pulsar: abre Aprobar).