Enviar arquivos de depuração HAR aos Serviços de Suporte da Esri para solução de problemas e revisão

Descrição

Arquivos de depuração que capturam a comunicação entre uma máquina cliente e máquinas do servidor, como o computador de um usuário e os servidores do ArcGIS Online, podem ser uma fonte vital de informações para resolver Casos de Suporte da Esri. Embora seja preferível solucionar problemas relacionados a aplicativos e serviços da Esri baseados na web por meio de compartilhamento de tela e por telefone, os Serviços de Suporte da Esri reconhecem que, em alguns casos complexos ou urgentes, os analistas precisarão solicitar aos usuários que forneçam esses arquivos de depuração para fins de solução de problemas. Esses arquivos de depuração podem ser capturados como arquivos HAR usando as Ferramentas de Desenvolvedor (DevTools) no navegador da web ou por meio de um programa de captura da web, como o Telrik's Fiddler.

Embora os arquivos de depuração possam ser cruciais para resolver problemas rapidamente, é importante observar que esses arquivos também podem conter informações confidenciais, incluindo, entre outras:

• Tokens de autorização do ArcGIS
• Parâmetros de Consulta de URL Confidenciais
• Informações confidenciais (nomes de usuário e senhas) no corpo da solicitação
• Informações confidenciais (outros parâmetros de consulta) no corpo de uma solicitação
• Informações confidenciais em um corpo de resposta
• Detalhes do cookie

A Esri valoriza a segurança e a privacidade dos dados de seus clientes e, como tal, reconhece os possíveis problemas de segurança e privacidade associados ao compartilhamento de arquivos de depuração. Para limitar esses riscos, a Esri recomenda 'limpar' esses arquivos (instruções abaixo) antes de compartilhar arquivos de depuração do cliente com o suporte da Esri.

A Esri não pode ser responsabilizada se este aviso for ignorado e a Esri não pode limpar arquivos de depuração em nome de um cliente. Embora, por política, os Serviços de Suporte da Esri usem um ambiente seguro para testar os dados do cliente e revisar os arquivos de depuração do cliente, esse ambiente, por necessidade, não pode ser completamente isolado e pode acessar:

• ArcGIS Online
• Serviços de transferência de arquivos gerenciados pela Esri (FTP de somente leitura para baixar conjuntos de dados fornecidos pelo cliente)
• Anexos de casos de Suporte da Esri (FTP de somente leitura para baixar conjuntos de dados fornecidos pelo cliente)

O acesso a todos os outros hosts é negado.

Todos os arquivos enviados para os serviços de suporte serão excluídos em 90 dias.

Se houver dúvidas sobre o conteúdo dos arquivos de depuração ou sobre os procedimentos de limpeza de rastreamento do cliente fornecidos pelo cliente da Esri, a Esri recomenda que os clientes optem por NÃO compartilhar arquivos de depuração com os serviços de suporte da Esri e trabalhar com o analista de suporte para resolver o problema por meio de outros métodos.

Solução ou Solução Provisória

Capturando arquivos de depuração (HAR) no navegador

As instruções a seguir são para capturar arquivos de depuração usando navegadores comuns. Em cada caso, é importante capturar apenas o tráfego que ocorre durante as etapas problemáticas para limitar a captura de informações seguras desnecessárias, reduzir o tamanho do arquivo e filtrar o tráfego não relacionado da análise de solução de problemas.

Google Chrome

1. Abra o Google Chrome e vá até a página onde o problema está ocorrendo. Execute todas as etapas do processo antes daquele que está causando o problema.
2. No navegador, no canto superior direito, clique no botão de reticências verticais () e no menu suspenso clique em Mais Ferramentas, e clique em Ferramentas do desenvolvedor.
3. Para desencaixar o painel DevTools, clique no botão de reticências verticais () no painel DevTools e selecione a primeira opção para Desencaixar em uma janela separada () na seção Encaixe lateral.
4. Selecione a guia Rede.
5. Procure um botão Gravar redondo ( ) no canto superior esquerdo e verifique se ele está vermelho. Se estiver cinza, clique uma vez para iniciar a gravação
6. Marque a caixa de seleção Preservar registro.
7. Clique no botão Limpar (   ) para limpar todas as solicitações de rede atuais do painel de rede.
8. Com o DevTools aberto, reproduza o problema enquanto as solicitações estiverem sendo gravadas.
9. Após reproduzir o problema, no Chrome, clique na seta para baixo Exportar HAR   () para baixar e salvar o arquivo em seu computador.

Para obter mais informações sobre como capturar um HAR com o Google Chrome, consulte Open Chrome DevTools no site do Google Developers.

Microsoft Edge (Chromium)

1. Abra o Microsoft Edge e vá até a página onde o problema está ocorrendo. Execute todas as etapas do processo antes daquela que causa o problema.
2. No navegador, no canto superior direito, clique no botão de reticências verticais () e no menu suspenso clique em Mais Ferramentas e clique em Ferramentas do desenvolvedor.
3. Para desencaixar o painel DevTools, clique no botão de reticências verticais () no painel DevTools e selecione a primeira opção para Desencaixar em uma janela separada ( ) na seção Encaixe lateral .
4. Selecione a guia Rede.
5. Procure um botão Gravar ( ) no canto superior esquerdo e verifique se ele está vermelho. Se estiver cinza, clique uma vez para iniciar a gravação
6. Selecione a caixa de seleção Preservar registro.
7. Clique no botão Limpar  ( ) para limpar todas as solicitações de rede atuais do painel de Rede.
8. Com o DevTools aberto, reproduza o problema enquanto as solicitações estiverem sendo gravadas.
9. Após reproduzir o problema no Edge, clique na seta para baixo do botão Exportar HAR () para baixar. Em seguida, salve o arquivo em seu computador. 

Para obter mais informações, consulte Salvar todas as solicitações de rede em um arquivo HAR na página Referência do Network Analysis do site Microsoft Docs.

Mozilla Firefox

1. Abra o Mozilla Firefox e vá até a página onde o problema está ocorrendo. Execute todas as etapas do processo antes daquele que está causando o problema.
2. No navegador, no canto superior direito, clique no botão de hambúrguer () e no menu suspenso clique em Mais Ferramentas e escolha  Ferramentas de Desenvolvedor da Web no menu suspenso secundário.
3. Para desencaixar o painel DevTools, clique no botão de reticências verticais () no painel DevTools e selecione a opção Janela Separada.
4. Selecione a guia Rede na parte superior para abrir.
5. Procure um botão Reproduzir/Pausar redondo no canto superior esquerdo da guia e certifique-se de mostrar a opção de pausar ( ) Se você visualizar o botão de reproduzir (), clique nele uma vez para iniciar a gravação
6. Clique no botão de engrenagem () no canto superior direito do painel e clique na opção Preservar Registro para marcá-la.
7. Com as Ferramentas de Desenvolvedor abertas, reproduza o problema enquanto as solicitações estiverem sendo registradas.
8. Após reproduzir o problema no Firefox, clique com o botão esquerdo em qualquer solicitação e selecione Salvar tudo como HAR e salve o arquivo em seu computador.

Capturando Arquivos de Depuração (.HAR) para outros programas

Esri Technical Support usa o Fiddler Classic da Telrik para capturar o tráfego que ocorre fora do navegador, como ao solucionar problemas do ArcGIS Pro. Assim como acontece com as capturas baseadas em navegador , é importante capturar apenas o tráfego que ocorre durante as etapas problemáticas.

Para capturar um arquivo . HAR usando o Fiddler Classic, você precisará:

1. Baixar Fiddler Classic
2. Siga as etapas 1 a 8 descritas em: Instrução: Usar o Fiddler para capturar conexões de https e descriptografar o tráfego de https, parando antes de salvar o arquivo. 
3. Após capturar o tráfego, abra o menu suspenso Arquivo > Exportar Sessão > Todas as sessões.
4. No menu suspenso pop-up, selecione HTTPArchive v1.2 e clique em Avançar.
5. Salve o arquivo.

Limpar arquivos HTTP Archive (.HAR)

Após o arquivo HAR ser capturado, você precisará inspecioná-lo com um editor de texto como o Notepad, Notepad ++ ou Sublime Text e remover todas as informações confidenciais usando as etapas abaixo.

1. Abra o arquivo HAR em um editor de texto, clique com o botão direito no arquivo, selecione Abrir Com e selecione o aplicativo editor de texto.
2. Use as ferramentas Localizar e Substituir do editor de texto para identificar e substituir todas as informações confidenciais capturadas no arquivo HAR. Que inclui:
   • nomes de usuários
   • senhas
   • Chaves de API - são longas sequências de letras, números e símbolos usados para acessar aplicativos personalizados e têm a seguinte aparência:

   AAPK5f9f39a988764653b27dd7d01fa14d35kfSLvKsiJoeoXX2oFBXE_021u_apQt1eAssZEfnmcri1hUhBmHEyxoOXJhaW9xgie

   • Tokens de Autorização - são longas sequências de letras, números e símbolos, semelhantes às chaves de API, mas usados em qualquer aplicativo da Esri baseado na web para autenticar o usuário. Tokens ficará assim:

    VBQlHZ__ONCdOUPteoQPfEEPYTyrfy3XugMasrGO90rUmGiMa_tzvjfksFsZ57MtTE1gywBYtVhrldIKuPPu7MFt4u6ukauvDtH4r2kZePZtgbCFomXc0ThIuwF9cPK6LNTFOJ3Q850ilLO2zP6kzmaY0cfnsJBMcoPmFH9BOLamDQFig3628HwU53xis4gIiEJNkWhnI3ynb

   • • Pesquise todas as chamadas "generateToken" e exclua-as.
   • Quaisquer outras informações confidenciais (por exemplo, se os seus dados incluírem um campo com informações de identificação sobre pacientes médicos, você deverá procurar e remover essas informações). Se você tiver alguma dúvida sobre se os seus dados são confidenciais, entre em contato com o proprietário do esquema de dados em sua organização e analise a classificação de dados com ele. A Esri não pode fornecer orientação sobre o que cada organização cliente considera sensível.

3. Salve o arquivo HAR editado com as informações confidenciais removidas.
4. Forneça o HAR aos Serviços de Suporte da Esri com notificação por escrito de que você:
   • revisou essas instruções
   • e sanitizou o arquivo de depuração do cliente antes de fornecê-lo aos Serviços de Suporte da Esri.

Se você não conseguir tomar as medidas apropriadas para limpar o arquivo HAR de tokens especificamente, aguarde 30 minutos a partir do momento em que o tráfego de rede foi capturado para compartilhar o arquivo por meio do caso de suporte.

• Isso é para garantir que todos os tokens tenham expirado e não possam ser usados para acesso/autorização indevido.

Se você tiver alguma dúvida sobre isso, sinta-se à vontade para discuti-la com o analista do Serviço de Suporte.