Los errores SSL son la segunda gran frustración de Python en 2026, justo después de pip. Aparecen al instalar paquetes, al hacer peticiones HTTP, al descargar en Jupyter y al autenticarte contra servicios en la nube. “SSL: CERTIFICATE_VERIFY_FAILED”, “self-signed certificate in certificate chain”, “Hostname mismatch”: mensajes claros con causas muy variadas. Esta guía gratuita conecta cada síntoma con su causa raíz y su arreglo exacto.
Escrita para quien choca con CERTIFICATE_VERIFY_FAILED en una instalación nueva, para el equipo que pelea contra proxies corporativos que interceptan TLS (Zscaler, Palo Alto, Netskope) y para cualquiera cuyo entorno SSL se degradó hasta volverse inservible. No asume conocimientos de criptografía ni de TLS.
Lo que aprenderás
- Cómo funciona TLS en Python hoy: OpenSSL 3.x, certifi y el almacén de CA del sistema
- El triaje de 60 segundos para saber qué capa falló
- Por qué
requestsfunciona perourllibno, y cómo alinearlos - Instalar la CA raíz de un proxy corporativo que intercepta TLS
- Certificados autofirmados en desarrollo con mkcert, sin inventarlos a mano
- Reloj del sistema, validez del certificado y errores por desfase horario
- Patrones concretos para requests, httpx, aiohttp y urllib3
- Peculiaridades de macOS (Install Certificates.command, Keychain) y del almacén de Windows
- Cuándo y cómo desactivar la verificación sin abrir un agujero de seguridad
- La receta de reinstalación segura para dejar el entorno impecable
Cada comando fue verificado para 2026. Es gratis: sin registro y sin correo. En AI Learning Guides publicamos estas guías porque librarte de una sesión SSL desesperante es útil, compres o no una de nuestras guías de pago.
Caleb Martin –
Well organized and beginner-friendly without being watered down. Learned a ton fast.