Source: https://swgbar.com/es/guides/certificate-pinning-mtls-swg-inspection-macos/
Language: es

# 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 18 de noviembre de 2026

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:

1.  El Llavero de macOS indica que el certificado de la SWG es válido.
2.  La aplicación con pinning compara la huella de clave pública del certificado de la SWG con su pin integrado.
3.  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:

1.  Abre [SWG bar](<https://swgbar.com/es/install/>) y reproduce el error de conexión en tu aplicación.
2.  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.
3.  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.

![Pestaña Certificados de SWG bar mostrando CA raíz y recuento de dominios asociados; vista previa ilustrativa.](<https://swgbar.com/optimized/panel-native-certificates-four-tabs-720.webp>)

_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](<https://swgbar.com/es/guides/swg-bypass-vs-tls-exception/>).
*   **Pruebas locales y desarrollo autorizados**: En redes que administras o estás autorizado a probar, utiliza la [evasión de SWG por dominio](<https://swgbar.com/es/guides/how-to-bypass-swg/>) 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 Code` o `Cursor` ignoran el Llavero de macOS, sigue [Solucionar errores de certificados TLS y SSL de SWG en herramientas CLI y de IA en Mac](<https://swgbar.com/es/guides/swg-tls-certificate-errors-macos/>).

## Sigue leyendo

*   [Cómo evitar una SWG en Mac (evasión por dominio en 1 clic y CLI)](<https://swgbar.com/es/guides/how-to-bypass-swg/>)
*   [Cómo evitar la inspección SSL en un Mac (SWG corporativa y solución por dominio)](<https://swgbar.com/es/guides/bypass-ssl-inspection-mac/>)
*   [Cómo evitar la inspección HTTPS y TLS en macOS (guía de break-and-inspect)](<https://swgbar.com/es/guides/bypass-https-tls-inspection-mac/>)
*   [Cómo evitar un proxy corporativo y la inspección SSL de SWG en un Mac](<https://swgbar.com/es/guides/bypass-corporate-proxy-ssl-inspection-mac/>)
*   [Cómo saber si tu Mac está interceptado por una SWG (inspección HTTPS y SSL)](<https://swgbar.com/es/guides/detect-https-inspection/>)
*   [Cómo saber si tu empresa o Mac de trabajo está interceptando HTTPS (inspección SSL)](<https://swgbar.com/es/guides/check-if-work-mac-intercepting-https/>)
*   [Comprobador de inspección SSL para Mac: herramienta de barra de menús para detectar interceptación HTTPS](<https://swgbar.com/es/guides/ssl-inspection-checker-mac/>)
*   [Inspección SSL de Zscaler en Mac: cómo comprobar y evitar por dominio](<https://swgbar.com/es/guides/zscaler-ssl-inspection-bypass-mac/>)
*   [Inspección SSL de Netskope en Mac: comprobar descifrado y evitar por dominio](<https://swgbar.com/es/guides/netskope-ssl-inspection-bypass-mac/>)
*   [Inspección TLS de Cloudflare WARP y Zero Trust en Mac: detectar y evitar](<https://swgbar.com/es/guides/cloudflare-warp-tls-inspection-mac/>)
*   [Inspección HTTPS Confirmado frente a Sospechoso en SWG bar](<https://swgbar.com/es/guides/confirmed-vs-suspected-https-inspection/>)
*   [Inspeccionar certificados raíz MITM y emisores en SWG bar](<https://swgbar.com/es/guides/inspect-mitm-root-certificates-macos/>)
*   [Inspección HTTPS de SWG corporativa y MDM en un Mac](<https://swgbar.com/es/guides/enterprise-swg-https-inspection-macos/>)
*   [Bypass de SWG frente a excepción de inspección TLS (break-and-inspect)](<https://swgbar.com/es/guides/swg-bypass-vs-tls-exception/>)
*   [Evitar SWG en aplicaciones web multidominio, SSO, CDN y APIs en Mac](<https://swgbar.com/es/guides/multi-domain-sso-api-cdn-swg-bypass/>)
*   [Solucionar Recuperando…, Evasión pausada y errores de conexión al evitar SWG en Mac](<https://swgbar.com/es/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)
*   [Interfaces virtuales VPN en macOS frente a inspección HTTPS de SWG](<https://swgbar.com/es/guides/macos-vpn-virtual-interface-vs-swg-inspection/>)
*   [Solucionar errores de certificados TLS y SSL de SWG en herramientas CLI y de IA en Mac](<https://swgbar.com/es/guides/swg-tls-certificate-errors-macos/>)
*   [Confianza de CA para Homebrew, Docker, Python y Node.js detrás de una SWG en Mac](<https://swgbar.com/es/guides/homebrew-docker-python-node-ca-trust-swg-macos/>)
*   [Corregir 'unable to get local issuer certificate' en Claude Code y Cursor en Mac (SWG y MCP)](<https://swgbar.com/es/guides/ai-coding-agents-claude-code-cursor-swg-macos/>)
*   [Verificar certificados TLS con openssl y security verify-cert en Mac](<https://swgbar.com/es/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>)
*   [Permisos de SWG bar, privacidad local y límites de sondeo TLS](<https://swgbar.com/es/guides/macos-network-extension-privacy-probe-limits/>)
*   [Cómo comprueba SWG bar la inspección HTTPS](<https://swgbar.com/es/how-it-works/>)
*   [Descargar e instalar SWG bar para Mac (macOS 14+)](<https://swgbar.com/es/install/>)
*   [Extensión de Chrome para detectar inspección SSL y HTTPS (complemento de SWG bar)](<https://swgbar.com/es/chrome-extension/>)
*   [Guía de SWG bar CLI](<https://swgbar.com/es/cli/>)
*   [Guía de SWG bar MCP](<https://swgbar.com/es/mcp/>)
*   [Información de versiones de SWG bar](<https://swgbar.com/es/releases/>)
*   [Acerca de SWG bar](<https://swgbar.com/es/about/>)
