Introducción

En ciertas pruebas, puede ser necesario utilizar una herramienta de proxy de depuración web para registrar el tráfico de datos entre el dispositivo utilizado para las pruebas y la Internet. Una de las herramientas comúnmente empleadas para este propósito es Charles Proxy, que puede ser necesario utilizar al realizar pruebas con algunos de nuestros clientes. A continuación, se describe el proceso para instalar y configurar Charles Proxy correctamente.

Primer paso: Configurar Charles Proxy en tu computadora

Para realizar pruebas tanto en la web como en aplicaciones, necesitarás un computador e instalar el programa Charles Proxy en ella.

Descarga la versión de prueba de Charles Proxy que coincida con tu sistema operativo aquí.
Instala la aplicación Charles Proxy.
En la aplicación Charles, ve al menú Proxy > Configuración de proxy externo....
Marca la casilla Usa servidores proxy externos.
Selecciona la casilla para Proxy web (HTTP) y marca Servidor proxy requiere una contraseña. Ingresa los detalles del proxy de la siguiente manera:
1. Servidor Proxy Web: forward.test.io:3128
2. Dominio: forward.test.io
3. Nombre de usuario: (puedes encontrar esta información en la descripción de la prueba)
4. Contraseña: (puedes encontrar esta información en la descripción de la prueba)
Selecciona la casilla para Proxy web seguro (HTTPS) y marca Servidor proxy requiere una contraseña. Repite los detalles del último paso.
Haz clic en el botón OK para guardar la configuración.

El proxy de Test IO ahora se guarda correctamente como el proxy externo en tu aplicación Charles Proxy.

Instalación del certificado SSL en tu computador con Windows

Antes de intentar navegar al sitio web del cliente que deseas probar, debes instalar un certificado SSL en tu dispositivo para que el tráfico de Internet se pueda capturar correctamente.

Prerrequisito: Has instalado y configurado Charles Proxy en tu computador.

Inicia la aplicación Charles Proxy en tu computador.
En el menú, ve a Ayuda > Proxy SSL > Instalar certificado raíz de Charles.
Haz clic en Instalar certificado... y selecciona Usuario actual.
Haz clic en Siguiente. Se te pedirá que selecciones dónde se guardarán los certificados en tu sistema.
Selecciona Colocar todos los certificados en el siguiente almacén y haz clic en Examinar...
Selecciona Autoridades de certificación raíz de confianza y haz clic en OK.
Haz clic en Siguiente y luego en Finalizar.
Reinicia tu computador para completar la instalación.

Ahora, el certificado SSL de Charles Proxy está completamente instalado en tu dispositivo.

Configuración de un dispositivo iOS

Prerrequisito: Has instalado y configurado Charles Proxy en tu computador.

Asegúrate de que tu dispositivo móvil y tu computador estén conectados a la misma red WiFi.
Inicia la aplicación Charles Proxy en tu computador.
En el menú, ve a Ayuda > Proxy SSL > Instalar certificado raíz de Charles en un dispositivo móvil o navegador remoto. Se abrirá una ventana que te proporcionará tu dirección IP local y un puerto para usar.
En tu dispositivo iOS, ve a la Configuración de WiFi y haz clic en el icono azul "i" junto a tu red WiFi.
En la parte inferior de la pantalla, toca en Configurar proxy y selecciona la opción Manual.
Ingresa la dirección IP local en el campo del servidor y el puerto proporcionado por la aplicación Charles Proxy en el paso 3.
Guarda la configuración. Debería aparecer un cuadro de diálogo en tu computadora pidiendo permiso para permitir este nuevo acceso.
Concede el permiso.

Ahora, el tráfico de internet de tu dispositivo se enruta a través de Charles Proxy. A partir de este momento, la conexión a Internet en tu dispositivo solo funcionará cuando la aplicación Charles Proxy esté abierta en tu computadora.

Instalación del certificado SSL en iOS

Antes de intentar lanzar la aplicación del cliente que deseas probar, debes instalar un certificado SSL en tu dispositivo para que el tráfico de Internet se pueda capturar correctamente.

Prerrequisitos:

Has instalado y configurado Charles Proxy en tu computador.
Has instalado y configurado Charles Proxy en tu dispositivo iOS.

Ve a chls.pro/ssl utilizando el navegador Safari en tu dispositivo móvil. Debería aparecer un cuadro de diálogo en tu dispositivo para instalar el certificado SSL.
Permite la instalación del certificado. Debería aparecer un cuadro de diálogo explicándote que debes revisar el perfil en la aplicación Configuración de tu dispositivo.
Cierra el modal y el navegador Safari.
Ve a la aplicación Configuración en tu dispositivo y sigue la ruta General > VPN y Administración de dispositivos > Perfiles descargados y selecciona Charles Proxy CA.
Toca en Instalar para instalar el certificado en tu dispositivo. Se te pedirá que ingreses la contraseña de tu dispositivo. Después de una autenticación exitosa, se mostrará una pantalla de advertencia. Toca en Instalar para completar la instalación del certificado.
Se mostrará una ventana de Confirmación de perfil instalado. Simplemente presiona Hecho.
Regresa al menú Configuración > General y navega a Acerca de > Configuración de confianza del certificado.
Habilita el certificado Charles Proxy CA.
Aparecerá una pantalla de advertencia. Toca en Continuar.

Ahora el certificado SSL de Charles Proxy está completamente instalado en tu dispositivo.

Configuración de un dispositivo Android

Prerrequisito: Has instalado y configurado Charles Proxy en tu computador.

Asegúrate de que tu dispositivo móvil y tu computador estén en la misma red WiFi.
Inicia la aplicación Charles Proxy en tu computador.
En el menú, ve a Ayuda > Proxy SSL > Instalar certificado raíz de Charles en un dispositivo móvil o navegador remoto. Se abrirá una ventana que te proporcionará tu dirección IP local y un puerto para usar.
En tu dispositivo Android, ve a la Configuración de WiFi y selecciona editar la red actual.
Busca la opción de Proxy y selecciona Manual.
Ingresa la dirección IP local en el campo Nombre del host del proxy y el puerto proporcionado por la aplicación Charles Proxy en el paso 3.
Guarda la configuración. Debería aparecer un cuadro de diálogo en tu computador pidiendo permiso para permitir este nuevo acceso.
Concede el permiso.

El tráfico de Internet de tu dispositivo ahora se enruta a través de Charles Proxy. A partir de este momento, la conexión a Internet en tu dispositivo solo funcionará cuando la aplicación Charles Proxy esté abierta en tu computadora.

Instalación del certificado SSL en Android 10 o inferior

Prerrequisitos:

Has instalado y configurado Charles Proxy en tu computador.
Has instalado y configurado Charles Proxy en tu dispositivo Android.

Antes de intentar lanzar la aplicación del cliente que deseas probar, debes instalar un certificado SSL en tu dispositivo. Sigue estos pasos:

Ve a chls.pro/ssl utilizando el navegador Chrome en tu dispositivo móvil. El archivo de certificado *.crt comenzará a descargarse en tu dispositivo.
Abre el archivo descargado y autentica.
Proporciona cualquier nombre para el certificado y asegúrate de que la opción VPN y aplicaciones esté seleccionada en el uso de credenciales.
Toca en OK.

Ahora, el certificado SSL de Charles Proxy está completamente instalado en tu dispositivo.

Instalación del certificado SSL en Android 11 o superior

Prerrequisitos:

Has instalado y configurado Charles Proxy en tu computador.
Has instalado y configurado Charles Proxy en tu dispositivo Android.

Antes de intentar lanzar la aplicación del cliente que deseas probar, debes instalar un certificado SSL en tu dispositivo. Sigue estos pasos:

Ve a chls.pro/ssl utilizando el navegador Chrome en tu dispositivo móvil. El archivo de certificado *.crt comenzará a descargarse en tu dispositivo.
Después de que el archivo se descargue, ve a la aplicación Configuración de tu dispositivo y busca una opción similar a "Instalar desde el almacenamiento del dispositivo" (generalmente se encuentra en la configuración de seguridad avanzada de tu dispositivo).
Selecciona CA Certificate y luego selecciona Instalar de todos modos en caso de que aparezca una pantalla de advertencia.
Autentica y busca el archivo *.crt descargado.
Selecciona el archivo descargado y toca en Hecho.

Ahora, el certificado SSL de Charles Proxy está completamente instalado en tu dispositivo.

Captura de un registro

Prerrequisito: Asegúrate de haber instalado y configurado Charles Proxy en tu computadora según se explica anteriormente. También, asegúrate de que el certificado SSL esté correctamente instalado en el dispositivo que estás utilizando para las pruebas.

Prerrequisitos:

Captura de un registro del tráfico de tu computadora: Asegúrate de que la opción Windows Proxy en el elemento de menú Proxy esté habilitada.
Captura de un registro del tráfico de tu dispositivo móvil: Asegúrate de que la opción Windows Proxy en el elemento de menú Proxy esté deshabilitada.

Nota: Siempre asegúrate de que solo un dispositivo esté conectado a Charles Proxy cada vez que captures un registro; de lo contrario, los datos de tráfico de todos los dispositivos se registrarán en tu registro.

Inicia la aplicación Charles Proxy en tu computador.
En el menú, ve a Proxy > Configuración de Proxy SSL...
Asegúrate de marcar la casilla Habilitar proxy SSL y, en la sección Incluir, haz clic en Agregar.
Ingresa el servidor(es) del cliente que deseas observar y el puerto (esta información se proporcionará en cada ciclo de prueba).
Haz clic en OK para regresar a la ventana de Configuración de Proxy SSL.
Haz clic en OK nuevamente para guardar la configuración.

Ahora, Charles Proxy aplicará el proxy SSL solo al servidor seleccionado. Para iniciar una nueva sesión, debes:

Asegurarte de que el botón de grabación (el círculo rojo ubicado justo debajo del menú principal en la aplicación Charles Proxy) esté habilitado.
Haz clic en el icono del cepillo para borrar los registros anteriores.
Navega al entorno de prueba (ya sea abriendo la aplicación del cliente o yendo a la página de inicio del sitio web).
Reproduce el comportamiento deseado (mencionado en las instrucciones del ciclo, en un reporte de error, una historia de usuario o un caso de prueba).
Una vez que hayas terminado, desactiva el botón de grabación para detener la captura del registro.

6. En el menú, ve a Archivo > Guardar sesión como..., selecciona la ubicación para guardar el archivo, ponle un nombre apropiado y asegúrate de que la extensión de archivo de Sesión de Charles (.chls) esté seleccionada.

Ahora puedes guardar tu archivo de registro de Charles Proxy y enviarlo.

Preguntas frecuentes

¿Cómo puedo saber si Charles Proxy está funcionando correctamente?

Puedes verificar si Charles Proxy está funcionando para un servidor específico abriendo la aplicación Charles Proxy, haciendo clic en el servidor que deseas verificar, y yendo a la información de Visión general > Notas, donde el valor debería ser "Habilitado el proxy SSL para este host".
Un valor de "Habilitado el proxy SSL" no está activado para este host. "Habilitar en el menú Proxy, Configuración de proxy SSL" significa que no has añadido el servidor actual a la lista de proxy SSL. Puedes añadir el servidor manualmente visitando las opciones de Configuración de proxy SSL o haciendo clic derecho en el servidor y seleccionando la opción "Habilitar proxy SSL".

Nota: Es posible que necesites iniciar una nueva sesión de registro para aplicar los nuevos ajustes.

¿Deben coincidir las grabaciones de pantalla capturadas en un reporte de error con los registros de Charles Proxy?

Al igual que cuando capturas un registro de bloqueo, si es necesario proporcionar una grabación de pantalla con tu registro (por ejemplo, al enviar un informe de error), las marcas de tiempo del registro de Charles Proxy y la grabación de pantalla deben coincidir; de lo contrario, tu registro será inválido.

¿Puedo usar los registros de Charles Proxy en informes de bloqueo?

Los registros de Charles Proxy no reemplazan los registros de bloqueo. Si estás informando de un bloqueo y el uso de Charles Proxy también es un requisito del ciclo, debes adjuntar ambos a tu informe.

No encuentro una opción para instalar el certificado SSL en mi dispositivo Android.

La ubicación de la opción para instalar el certificado SSL en tu Android será diferente según el dispositivo. Puedes utilizar la función de Chat disponible dentro de cada ciclo para pedir ayuda para localizar esta opción en tu dispositivo.

¿Por qué mi internet no funciona sin Charles Proxy después de completar el tutorial con éxito?

Si has completado todos los pasos mencionados, los datos de tráfico de tu dispositivo se dirigirán a la aplicación Charles Proxy en tu computadora. Después de haber terminado la sesión de prueba, puedes cerrar la aplicación Charles Proxy en tu computadora y restablecer la configuración de proxy de tu dispositivo móvil a Ninguno (Android) o Apagado (iOS). De esta manera, cerrarás la conexión a tu computadora y tu internet volverá a funcionar normalmente.

La aplicación Charles Proxy se cerró en medio de una sesión. ¿Qué sucedió?

La aplicación Charles Proxy en tu computadora solo se puede usar durante 30 minutos como máximo, a partir del momento en que la abriste. Entonces, si tu aplicación ya ha estado abierta durante un tiempo y encuentras un nuevo error, se recomienda cerrar el programa Charles Proxy y abrirlo nuevamente para que el límite de 30 minutos se restablezca y tengas tiempo para grabar tu registro.

No cuento con un computador de escritorio ni con una conexión WiFi. ¿Puedo realizar pruebas con Charles Proxy?

Desafortunadamente, es necesario disponer de una PC con Windows, MacOS o Linux conectada a la misma red WiFi a la que está conectado tu dispositivo móvil para capturar registros con Charles Proxy. Si no cumples con este requisito, es recomendable omitir este ciclo por el momento.

¿Por qué la aplicación Charles Proxy no está registrando la actividad de mi navegador, incluso después de haberla configurado correctamente?

Generalmente, una VPN y otras aplicaciones o configuraciones del sistema (como un firewall o software antivirus) pueden interferir con la aplicación Charles Proxy. Te recomendamos cerrar todas las conexiones VPN y desinstalar todas las extensiones del navegador para asegurarte de que Charles Proxy sea la única proxy vinculada al entorno de prueba desde tu dispositivo. También puedes utilizar un navegador diferente para supervisar el tráfico.