Apresentação
Em determinados testes, pode ser necessário utilizar uma ferramenta de proxy de depuração web para registrar o tráfego de dados entre o dispositivo usado para testes e a internet. Uma das ferramentas comumente empregadas para esse fim é o Charles Proxy, a qual você pode necessitar ao realizar testes com alguns de nossos clientes. O processo de instalação e configuração adequada do Charles Proxy é descrito abaixo.
Primeira etapa: Configurando o Charles Proxy no seu computador
Para testes na web e em aplicativos, será necessário um computador e a instalação do programa Charles Proxy.
Baixe a versão de avaliação do Charles Proxy que corresponde ao seu sistema de computador aqui.
Instale o aplicativo Charles Proxy.
No aplicativo Charles, vá para o item de menu Proxy > Configurações externas do proxy....
Marque a caixa de seleção Usar servidores de proxy externos.
Marque a caixa de seleção para Web Proxy (HTTP) e marque Proxy server requires a password. Insira os detalhes do proxy conforme abaixo:
Servidor de Proxy da Web: forward.test.io:3128
Domínio: forward.test.io
Nome de usuário: você pode encontrar essa informação na descrição do teste.
Senha: você pode encontrar essa informação na descrição do teste.
Marque a caixa de seleção Secure Web Proxy (HTTPS) e marque Proxy server requires a password. Repita os campos de detalhes da etapa anterior.
Clique em OK para salvar as configurações.
O proxy da Test IO agora está corretamente salvo como o proxy externo no seu aplicativo Charles Proxy.
Instalando o Certificado SSL no seu computador Windows
Antes de tentar acessar o site do cliente que você deseja testar, é necessário instalar um certificado SSL no seu dispositivo para que o tráfego da internet possa ser capturado corretamente.
Pré-requisito: Você instalou e configurou o Charles Proxy no seu computador.
Inicie o aplicativo Charles Proxy no seu computador.
No menu, vá para Ajuda > Proxy SSL > Instalar Certificado Raiz do Charles.
Clique em Instalar Certificado... e selecione Usuário Atual.
Clique em Avançar. Você será solicitado a selecionar onde os certificados serão armazenados no seu sistema.
Selecione Colocar todos os certificados no seguinte repositório e clique em Procurar...
Selecione Autoridades de Certificação Raiz Confiáveis e clique em OK.
Clique em Avançar e depois em Concluir.
Reinicie seu computador para concluir a instalação.
Agora, o certificado SSL do Charles Proxy está totalmente instalado no seu dispositivo.
Configurando um dispositivo iOS
Pré-requisito: Você instalou e configurou o Charles Proxy no seu computador.
Certifique-se de que seu dispositivo móvel e computador estão conectados à mesma rede WiFi.
Inicie o aplicativo Charles Proxy no seu computador.
No menu, vá para Ajuda > Proxy SSL > Instalar Certificado Raiz do Charles em um Dispositivo Móvel ou Navegador Remoto. Uma janela será aberta, fornecendo seu endereço IP local e uma porta para usar.
No seu dispositivo iOS, vá para as Configurações do Wi-Fi e clique no ícone azul "i" ao lado da sua rede Wi-Fi.
Na parte inferior da tela, toque em Configurar Proxy e selecione a opção Manual.
Digite o endereço IP local no campo do servidor e a porta fornecida pelo aplicativo Charles Proxy no passo 3.
Salve as configurações > Uma caixa de diálogo deve aparecer no seu computador solicitando permissão para permitir esse novo acesso.
Dê permissão.
O tráfego de internet do seu dispositivo agora está sendo roteado pelo Charles Proxy. A partir de agora, a internet no seu dispositivo só funcionará enquanto o aplicativo Charles Proxy estiver aberto no seu computador.
Instalando o Certificado SSL no iOS
Antes de tentar iniciar o aplicativo do cliente que deseja testar, é necessário instalar um certificado SSL no seu dispositivo para que o tráfego da internet possa ser capturado corretamente.
Pré-requisitos:
Você instalou e configurou o Charles Proxy no seu computador.
Você instalou e configurou o Charles Proxy no seu dispositivo iOS.
Acesse chls.pro/ssl usando o navegador Safari no seu dispositivo móvel. Deve aparecer um diálogo no seu dispositivo para instalar o certificado SSL.
Permita a instalação do certificado. Deve aparecer um diálogo explicando que você deve revisar o perfil no aplicativo Configurações do seu dispositivo.
Feche a janela modal e o navegador Safari.
Acesse o aplicativo Configurações no seu dispositivo e siga o caminho Geral > VPN e Gerenciamento de Dispositivos > Perfil Baixado e selecione o Charles Proxy CA.
Toque em Instalar para instalar o certificado no seu dispositivo. Você será solicitado a inserir a senha do seu dispositivo. Após uma autenticação bem-sucedida, uma tela de aviso será exibida. Toque em Instalar para concluir a instalação do certificado.
Uma janela de confirmação de Perfil Instalado será exibida. Basta pressionar Concluído.
Volte para Configurações > Geral e navegue até Sobre > Configurações de Confiança do Certificado.
Ative o certificado Charles Proxy CA.
Uma tela de aviso será exibida. Toque em Continuar.
Agora, o certificado SSL do Charles Proxy está totalmente instalado no seu dispositivo.
Configurando um dispositivo Android
Pré-requisito: Você instalou e configurou o Charles Proxy no seu computador.
Certifique-se de que seu dispositivo móvel e computador estão na mesma rede Wi-Fi.
Inicie o aplicativo Charles Proxy no seu computador.
No menu, vá para Ajuda > SSL Proxying > Instalar Certificado Raiz do Charles em um Dispositivo Móvel ou Navegador Remoto.
Uma janela será aberta, fornecendo seu endereço IP local e uma porta a ser usada.
No seu dispositivo Android, vá para as Configurações de Wi-Fi e selecione para editar a rede atual.
Procure pela opção Proxy e selecione Manual.
Digite o endereço IP local no campo Nome do host do proxy e a porta fornecida pelo aplicativo Charles Proxy no passo 3.
Salve as Configurações > Uma caixa de diálogo deve aparecer no seu computador solicitando permissão para permitir esse novo acesso.
Dê permissão.
O tráfego de internet do seu dispositivo agora está sendo roteado através do Charles Proxy. A partir de agora, a internet no seu dispositivo só funcionará enquanto o aplicativo Charles Proxy estiver aberto no seu computador.
Instalando o Certificado SSL no Android 10 ou inferior
Pré-requisitos:
Você instalou e configurou o Charles Proxy no seu computador.
Você instalou e configurou o Charles Proxy no seu dispositivo Android.
Antes de tentar iniciar o aplicativo do cliente que você deseja testar, é necessário instalar um certificado SSL no seu dispositivo para que o tráfego de internet seja capturado corretamente, seguindo as etapas a seguir:
Acesse chls.pro/ssl usando o Navegador Chrome no seu dispositivo móvel. O arquivo de certificado ❝*.crt❞ começará a ser baixado para o seu dispositivo.
Abra o arquivo baixado e faça a autenticação.
Forneça qualquer nome para o certificado e certifique-se de que a opção VPN e apps está selecionada em Utilização de credenciais.
Toque em OK.
Agora o certificado Charles Proxy SSL está totalmente instalado no seu dispositivo.
Instalando o Certificado SSL no Android 11+
Antes de tentar iniciar o aplicativo do cliente que você deseja testar, é necessário instalar um certificado SSL no seu dispositivo para que o tráfego de internet seja capturado corretamente, seguindo as etapas a seguir:
Pré-requisitos:
Você instalou e configurou o Charles Proxy no seu computador.
Você instalou e configurou o Charles Proxy no seu dispositivo Android.
Acesse chls.pro/ssl usando o Navegador Chrome no seu dispositivo móvel. O arquivo de certificado ❝*.crt❞ começará a ser baixado para o seu dispositivo.
Após o download do arquivo, acesse o aplicativo Configurações do seu dispositivo e procure por uma opção semelhante a Instalar do armazenamento do dispositivo (geralmente localizada nas configurações Avançadas de Segurança no seu dispositivo).
Selecione Certificado CA e, caso uma tela de aviso seja exibida, escolha Instalar mesmo assim.
Autentique-se e procure pelo arquivo baixado ❝*.crt❞.
Selecione o arquivo baixado e toque em Concluído.
Agora o certificado Charles Proxy SSL está totalmente instalado no seu dispositivo.
Capturando um log com o Charles Proxy
Pré-requisito: Certifique-se de ter instalado e configurado o Charles Proxy no seu computador conforme explicado acima. Também certifique-se de que o certificado SSL está corretamente instalado no dispositivo que você está usando para teste.
Pré-requisitos:
Capturando um log do tráfego do seu computador: Certifique-se de que a opção Windows Proxy no item de menu Proxy está ativada.
Capturando um log do tráfego do seu dispositivo móvel: Certifique-se de que a opção Windows Proxy no item de menu Proxy está desativada.
Nota: Sempre certifique-se de que apenas um dispositivo esteja conectado ao Charles Proxy cada vez que estiver capturando um log, caso contrário, os dados de tráfego de todos os dispositivos serão registrados no seu log.
Inicie o aplicativo Charles Proxy no seu computador.
No menu, vá para Proxy > Configurações de SSL Proxying…
Certifique-se de marcar a caixa de seleção Enable SSL Proxying e, na seção Include, clique em Add.
Insira o(s) servidor(es) do cliente que você deseja monitorar e a porta (essas informações serão fornecidas em cada ciclo de teste).
Clique em OK para retornar à janela de Configurações de SSL Proxying.
Clique novamente em OK para salvar as configurações.
Agora, o Charles Proxy aplicará o SSL proxying apenas aos servidores selecionados. Para iniciar uma nova sessão, você deve:
Certificar-se de que o botão de gravação (o círculo vermelho localizado logo abaixo do menu principal no aplicativo Charles Proxy) está ativado.
Clique no ícone de pincel para limpar os logs anteriores.
Vá para o ambiente de teste (abra o aplicativo do cliente ou acesse a página inicial do site).
Reproduza o comportamento desejado (mencionado nas instruções do ciclo, em um relatório de bug, História xs Usuário ou Caso de Teste).
Quando terminar, desative o botão de gravação para interromper a captura do log.
No menu, vá para Arquivo > Salvar Sessão Como..., selecione o local para salvar o arquivo, dê um nome apropriado e certifique-se de que a extensão do arquivo de Sessão Charles (.chls) esteja selecionada.
Agora você pode salvar seu arquivo de log do Charles Proxy e enviá-lo.
Perguntas Frequentes (FAQ)
Como posso saber se o Charles Proxy está funcionando corretamente?
Você pode verificar se o Charles Proxy está funcionando para um servidor específico abrindo o aplicativo Charles Proxy, clicando no servidor que deseja verificar, navegando até Visão geral > Notas, e o valor deve ser SSL Proxying enabled for this host.
Um valor de SSL Proxying is not enabled for this host. Enable in the Proxy Menu, SSL Proxying Settings significa que você não adicionou o servidor atual à lista de proxy SSL. Você pode adicionar o servidor manualmente visitando as opções de Configurações de Proxy SSL ou clicando com o botão direito no servidor e selecionando a opção Enable SSL Proxying.
Nota: Talvez seja necessário iniciar uma nova sessão de log para aplicar as novas configurações.
As capturas de tela capturadas em um relatório de bug devem corresponder aos logs do Charles Proxy?
Sim, ao capturar um Log de travamento, se for necessário fornecer uma gravação de tela com seu log (por exemplo, ao enviar um relatório de bug), os carimbos de data e hora do log do Charles Proxy e da gravação de tela devem corresponder. Caso contrário, seu log será considerado inválido.
Posso usar logs do Charles Proxy em relatórios de travamento?
Os logs do Charles Proxy não substituem os Logs de travamento. Portanto, se você estiver relatando um travamento e o uso do Charles Proxy também for um requisito do ciclo, você deve anexar ambos ao seu relatório.
Não consigo encontrar uma opção para instalar o certificado SSL no meu dispositivo Android.
A localização da opção para instalar o certificado SSL no seu Android pode variar dependendo do dispositivo. Você pode usar o recurso de Chat disponível dentro de cada ciclo para pedir ajuda para localizar esta opção no seu dispositivo.
Por que minha internet não está funcionando sem o Charles Proxy depois de concluir o tutorial com sucesso?
Se você concluiu todas as etapas mencionadas, os dados de tráfego do seu dispositivo serão roteados para o aplicativo Charles Proxy no computador. Após terminar a sessão de teste, certifique-se de fechar o aplicativo Charles Proxy no computador e retornar as configurações de proxy do seu dispositivo móvel para Nenhum (Android) ou Desligado (iOS). Dessa forma, você encerrará a conexão com o seu computador, e sua internet voltará a funcionar normalmente.
O aplicativo Charles Proxy fechou no meio de uma sessão. O que aconteceu?
O aplicativo Charles Proxy no computador só pode ser usado por no máximo 30 minutos, a partir do momento em que você o abriu. Portanto, se o aplicativo já estiver aberto por um tempo e você encontrar um novo bug, é recomendável fechar o programa Charles Proxy e abri-lo novamente para que o limite de 30 minutos seja redefinido, e você tenha tempo suficiente para gravar o log.
Não tenho um computador desktop ou uma conexão Wi-Fi. Posso ainda testar com o Charles Proxy?
Infelizmente, um PC com Windows, MacOS ou Linux usando a mesma rede Wi-Fi à qual seu dispositivo móvel está conectado é obrigatório para capturar logs do Charles Proxy. Se você não atender a esse requisito, será necessário pular o ciclo por enquanto.
Por que o aplicativo Charles Proxy não está capturando o log do meu navegador mesmo após configurá-lo com sucesso?
Normalmente, uma VPN e outros aplicativos ou configurações do sistema (por exemplo, firewall ou software antivírus) podem interferir no aplicativo Charles Proxy. Recomendamos fechar todas as conexões VPN e desinstalar todas as extensões de navegador para garantir que o aplicativo Charles Proxy seja o único proxy vinculado ao ambiente de teste do seu dispositivo. Você também pode usar um navegador diferente para monitorar o tráfego.