Por qué las apps con certificate pinning y mTLS fallan bajo inspección SWG
Comprende por qué las aplicaciones que usan TLS certificate pinning o TLS mutuo (mTLS) fallan detrás de una SWG corporativa con break-and-inspect en macOS aunque MDM confíe en la CA raíz.
SWG bar · Actualizado
Quienes trabajan con Mac administrados por MDM observan con frecuencia que los sitios web normales funcionan sin problemas detrás de una pasarela web segura (SWG) corporativa, mientras que ciertas aplicaciones de escritorio, actualizadores de seguridad, SDK móviles o API de desarrollo fallan de inmediato en el handshake TLS. En la mayoría de los casos, la causa es certificate pinning o TLS mutuo (mTLS) al chocar con la inspección HTTPS/SSL (break-and-inspect) de la SWG.
Por qué la confianza raíz de MDM no soluciona el certificate pinning
Durante la navegación HTTPS habitual, Safari y Chrome confían en cualquier cadena de certificados válida cuya raíz pertenezca a una autoridad presente en el Llavero de macOS, incluidas las CA raíz corporativas desplegadas por MDM.
Las aplicaciones que implementan TLS certificate pinning (fijación HPKP / SPKI) dan un paso más: incrustan el hash de clave pública esperado (SPKI) o el certificado hoja o intermedio directamente dentro del binario de la aplicación. Cuando una SWG corporativa termina TLS y vuelve a firmar el certificado con su propia CA raíz empresarial:
- El Llavero de macOS indica que el certificado de la SWG es válido.
- La aplicación con pinning compara la huella de clave pública del certificado de la SWG con su pin integrado.
- Las huellas no coinciden, por lo que la aplicación aborta el handshake TLS de inmediato para protegerse frente a una interceptación man-in-the-middle.
Por qué TLS mutuo (mTLS) falla durante break-and-inspect
Con TLS mutuo (mTLS), ambas partes se autentican: el cliente presenta un certificado de cliente al servidor de origen antes de recibir acceso (habitual en API bancarias, endpoints B2B, API zero-trust y servicios para desarrolladores respaldados por hardware).
Si una SWG se interpone y termina la conexión TLS para descifrar las cargas HTTP, el servidor de origen ve la conexión de la SWG en lugar del handshake TLS de cliente de tu Mac, rompiendo la validación de certificado de cliente de extremo a extremo salvo que la pasarela actúe únicamente como paso cifrado o excluya ese host.
Diagnostica qué nombres de host se interceptan en tu Mac
Antes de solicitar una regla de pasarela a TI o configurar una regla local, identifica el nombre de host exacto al que se conecta la aplicación con pinning o mTLS:
- Abre SWG bar y reproduce el error de conexión en tu aplicación.
- Revisa SWG bar → Dominios (o ejecuta
swgbar domains list --status confirmed) para localizar el nombre de host exacto de API, CDN o actualización que contacta esa app. - Inspecciona los detalles del dominio y la pestaña Certificados para confirmar si la CA raíz de la SWG corporativa está terminando TLS para ese host.
Verifica en SWG bar si el nombre de host de API o actualización de una app aparece bajo una agrupación de CA de inspección.
Elige la solución adecuada
- Entornos de producción / corporativos gestionados: Solicita una excepción de inspección TLS (regla de no descifrado) específica a tu equipo de TI o seguridad para el nombre de host con pinning o mTLS, manteniendo el enrutamiento por la pasarela sin romper el pinning TLS. Consulta Bypass de SWG frente a excepción de inspección TLS.
- Pruebas locales y desarrollo autorizados: En redes que administras o estás autorizado a probar, utiliza la evasión de SWG por dominio desde Dominios o
swgbar bypass enable <domain>para que ese nombre de host concreto conecte sin descifrado de pasarela. - Errores del almacén de CA en CLI y entornos de IA: Si el fallo no es pinning estricto, sino que
git,npm,Python,Claude CodeoCursorignoran el Llavero de macOS, sigue Solucionar errores de certificados TLS y SSL de SWG en herramientas CLI y de IA en Mac.