APIs e Ambiente do Updater

2.4. Updater não inicia o download da versão.

Verificações:

• A versão desejada foi liberada no Update Center para o cliente? 109

• A versão do sistema instalado na máquina já se comunicou com o Updater? 110

• O sistema está registrado com o código do cliente corretamente? 111

• A versão que precisa ser baixada está liberada para o código do cliente corretamente no site? 112

• O cliente em questão possui mais de um CRM com o mesmo CNPJ? Se sim, o cadastro deve ser acertado na administração113.

• Procure no log de eventos do master algum log referente ao download em questão114.

• O sistema já está cadastrado na base do Updater master? Verifique na área "Licenças" do Updater Manager do master, clicando em detalhes da licença do cliente, aba "Aplicativos Registrados no Updater"115.

• Se nenhuma inconsistência for encontrada após as verificações acima: Salve e limpe o log de eventos da máquina do master e clique no botão "Buscar Atualizações Agora" do Updater Manager. Dois minutos depois, acompanhe o log de eventos para verificar se o download da versão iniciou ou se ocorreu algum erro ou alerta referente ao Updater116.

2.5. O download da versão está na pasta mas o Updater não entrega para o sistema. 117

• Verificações:

• Verifique se o sistema está registrado com o código do cliente corretamente118.

• Verifique na base do Updater se o download em questão está vinculado ao código do cliente corretamente119.

2.6. O sistema não está se comunicando com o Updater.

• Constatação: Verifique na área "Licenças" do Updater Manager do master, clicando em detalhes da licença do cliente, aba "Aplicativos Registrados no Updater". Se o sistema não for apresentado na lista, provavelmente não está se comunicando com o Updater120. Antes de verificar no Updater Manager, feche e abra o sistema novamente121.

• Causas possíveis:

• Bonjour não está instalado ou com o serviço paralisado122.

• Presença de Malware/Vírus na máquina que possa estar influenciando na comunicação entre o sistema e o Updater123.

• Se as dicas acima não resolverem: Verifique o log de eventos do Windows para ocorrências do Updater que possam ajudar124.

2.7. Travamento tela de passaporte. 125

• Ao tentar autenticar o passaporte no acesso ao sistema e ficar travada na tela do site Alterdata.com.br, realize as seguintes verificações:

• Redefinir o Internet Explorer126.

• Verificar acesso aos sites Passaporte2.alterdata.com.br e Passaporte2-basico.alterdata.com.br127.

• Verificar instalação do Updater128.

• Verificar o diagnóstico e ver se aponta algum tipo de bloqueio como proxy, firewall ou domínio129.

• Caso não funcione, testar acesso no redfrom130.

• Verificar acesso ao passaporte Test.dll (funciona colocando na %temp% quando o installer está em execução)131.

• Verificar o link com https://passaporte2-basico.alterdata.com.br/passaporte-rest-api/rest/admin/usuarios/info?include=assinantes&info=eyJjaGF2ZSI6IjBDM0q5cGFSX2RJcG9jMi16Vnk1ejRDajYwZ3BfWndsTjBUR3BIQmt0Z210a2VGeTFqTmFZTE9adFo2SUZSYmJHZkJIZy0yS2pCQWVVa29CeDlyUzBUekkzaVhnN2J2UFd3cm9iTjZFM25DVzIMd2VmcWcxTENTT2IBcWNXNTNJMVQwR0NhSF9MVFAtTTIfRUqtLVh5Q0cydXh2SUpST0tPeUhidHV0WVJCdTBITzFxbHB0MGZjZzNBWHdLWVFXU0NnbjlnVzRESGpFbzlsNU IZPaXNMUnNjNHVnR0htcEtNdUY0NnpBcjVTSjdCRml6LUppcWluWIRIMnB2ZW1jck1EUk15bGRUMHqxZTFWcGstR1YyUnIZZS1qa1NWcFJocUR3N3N PVkZGX2RIbFBBdylsInRva2VueiI6ImMtdl9jMG5ETWZOR3BO MnNlIQTIIbGFqRkdpbWduemhjLWQ3cHBiV1ladVRycUxqSnRibnByVlYlQjEtQXZCS3M3cnVIYk9mOUc0R0JpQlk5TzN5d1hRVnNza0JZSFNMcTZRZVpMT2dzTWw3Sk10WktGVTVjc2VEdjlUZOjWEg3WU1nUmNxTHJaTVRvbE56T KOTIECFpIYXg1cFNSMzFIQ3RUdWFCR1IMbjWJsaTBzc3ZXaFh4dXNXY2NKdWI1F2bFFJSG1icWpuNRuaUwzcGNuMWpQV2VDMWg1N001RUNpMkx3T3NXOGEzejlyUGVFS1QtZnNkU115WXINNXFxdIBDV01ORUJFcFJvRXBxcEZSdnBiTzM4c2Q3MXV2QVoxeVFHZVRCOTI1bE1mUVBzQ3NfV0UtSUZIenICMFExaUpEdnE4MzVHWkhrSWF FZUIMWEtJdUp6WTNFUnJ3bzIOTVktVkxjSWVCMkMwZTFjYjRtdzh4TnJ6OG1rUkxtV2ZDY0dTeWtYdFdLa3Z4QnkySDh OYONMOFF1RIMyeTZmMFVMWUtGeUhMMWItOE93TIN6SEljeWs2YWICcnMtRkdhTzNJM29pVFVRN2RCMEtXY0hfUjBpTVlicnc4S0VYNklxQTdxYkhGaEE1MEZSejIZUm12djZmZGptUVVrTIVRa3MifQ (lembrando de modificar com as informações de chave de autenticação do cliente)132.

• Não passando, verificar se a chave HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\fipsalgorithmpolicy no regedit está com valor 0. Caso esteja com valor 1, modificar para 0 conforme dica do link https://support.microsoft.com/pt-br/help/981119/fix-you-cannot-run-an-asp-net-3-5-based-application-that-uses-a-script133.

2.8. Erro na rotina 'Procurar NovasAtualizacoes OnLine'. 134

• Log de Erro: System.Reflection.TargetInvocationException: Uma exceção foi acionada pelo destino de uma chamada. ---> System.InvalidOperationException: Esta implementação não faz parte dos algoritmos criptográficos validados por FIPS da Plataforma Windows. 135

• Solução: É necessário fazer uma configuração no gpedit do Windows136:

1. Com credenciais administrativas, clique em Iniciar, Executar, digite gpedit.msc e pressione Enter137.

2. No Editor de Diretiva de Grupo Local, clique em Configuração do Computador, clique duas vezes em Configurações do Windows e, em seguida, clique duas vezes em Configurações de Segurança138.

3. Clique em Definições de segurança, faça duplo clique em Políticas locais e, em seguida, clique em Opções de segurança139.

4. No painel de detalhes, clique duas vezes em "Criptografia do sistema: Use algoritmos compatíveis com FIPS para criptografia"140.

5. Clique em "Habilitado" e em OK para fechar a caixa de diálogo141.

6. Feche o Editor de Diretiva de Grupo Local142.

• Alternativamente: Altere a chave de registro HKLM\System\CurrentControlSet\Control\Lsa\FIPSAlgorithmPolicy\Habilitado para 1143.

2.9. Updater não inicia (Erros diversos).

• Log de Erro: "...System.IO.FileNotFoundException: Não foi possível carregar arquivo ou assembly 'System.EnterpriseServices.Wrapper.dll' ou uma de suas dependências. De: Não foi Possível Encontrar o módulo Especificado..." 144
  
  

• Problema: Problema com o .NET Framework do cliente145.

• Solução: Reinstalar o Framework (NÃO REPARAR)146.

• Log de Erro: "Erro ao abrir a conexão com o servidor: Uma tentativa de conexão falhou porque o componente conectado não respondeu corretamente após um período de tempo ou a conexão estabelecida falhou porque o host conectado não respondeu xx.x.x.x:8767" 147
  
  

• Problema: A porta 8767 não está liberada no firewall148.

• Solução: Liberar as portas 8767 e 8766 nas regras de entrada e saída do firewall. Reiniciar o serviço do Updater149.

• Consta em nossos cadastros que xxxx possui 0 licenças para utilização..... 150
  
  

• Updater funcionando sem nenhum erro nos logs?

• Não: Contingência não está funcionando nesta versão - resolver updater151.

• Sim: Verifique se a quantidade de usuários entregue está de acordo com o cadastro no CRM152.

• Verifique pela endpoint: {{host}}/api/licenca quantas licenças são retornadas (pesquisar pela palavra "usuarios")153.

• Compare se a quantidade de usuários retornada pelo Postman é igual à quantidade de usuários no Updater do cliente (consultar licença ativada pelo botão escondido do Updater Manager e pesquisar por "usuários")154.

• Normalmente, quando o cliente não tem controle de usuários, a quantidade retornada é 999 (ilimitado)155.

• Se houver dúvida, consulte o CRM do cliente, clicando no produto pai e na aba "complemento do produto" (deve apresentar "usuários/conexões simultâneas = x")156.

• A quantidade de usuários é determinada pelo cadastro do cliente no CRM. Inconsistências devem ser alteradas pela ADM157.

• Este computador não pode ser identificado. 158
  
  

• Verificações (sem erro aparente): IE, Antivírus, Proxy, Domínio, Versão do Updater, Atualizações do Windows, Logs de eventos159.

• Solução: Em um caso, o Read From foi testado, e o passaporte não abriu, dando erro no System.auditoria. Verificou-se no CMD (arquivo regasm.exe em C:\Windows\Microsoft.NET\Framework\v4.0.30319) que o .NET Framework do cliente estava desatualizado. Baixar e atualizar para a versão mais recente do .NET Framework, e reiniciar a máquina, resolveu160.

2.10. Installer Erro: "Error connecting with SSL. EOF was observed that violates the protocol." 161161161161

• Causa: O pfSense (ou outro firewall) pode estar bloqueando o SSL TSL 2.

• Solução: Em um caso, a troca de rede resolveu, indicando um bloqueio pelo firewall do pfSense162.

2.11. Error: System.Net.WebException: A conexão subjacente estava fechada: Erro inesperado em um recebimento. ---> System.ComponentModel.Win32Exception: O cliente e o servidor não podem se comunicar porque não possuem um algoritmo em comum. 163

• Dica: Renan pediu para guardar essa dica com a vida. Possivelmente relacionado a problemas de comunicação de algoritmo entre cliente e servidor. A referência citada é "Multiple Products: SQL Server service will not start, error code-2146893007-Knowledgebase / Software - Wasp Helpdesk"164.

3. APIs Consultadas pelo Updater

O Updater se comunica com diversas APIs para realizar suas funções. As principais APIs e seus usos são:

• Ambientes e URLs das APIs: Para verificar os serviços nas demais APIs, basta trocar o link do Post, sem necessidade de alterar o corpo (body)176.
  
  

• Oficial:

• https://updatecenter.alterdata.com.br/api/licenca 177

• http://updatecenter.alterdata.com.br/api/verificar_atualizacoes 178

• http://updatecenter.alterdata.com.br/api/maiorversaoinstaller 179

• Homologação:

• http://updatecenter-homolog.alterdatasoftware.com.br/api/licenca 180

• http://updatecenter-homolog.alterdatasoftware.com.br/api/verificar_atualizacoes 181

• http://updatecenter-homolog.alterdatasoftware.com.br/api/maiorversaoinstaller 182

• QA:

• http://updatecenter-qa.alterdatasoftware.com.br/api/licenca 183

• http://updatecenter-qa.alterdatasoftware.com.br/api/verificar_atualizacoes 184

• http://updatecenter-qa.alterdatasoftware.com.br/api/maiorversaoinstaller 185

4. Dicas Úteis para Diagnóstico

4.1. Detecção de Proxy

• Tentar acessar sites como: g1, facebook, globo.com186.

• Executar comando ping no CMD: ping + dominio (ex: updatecenter.alterdata.com.br / alterdata.com.br)187.

• Utilizar sites de detecção de IP/Proxy como:

• http://www.ipaddressloactnio.org/ 188

• http://www.find-ip-address.org/ 189

• Computador com proxy: Exibe "Proxy Server Detection Real IP Address X.X.X.X Transparent Proxy detected Y.Y.Y.Y"190.

• Computador sem proxy: Exibe "Proxy Server Detection No Proxy detected or you use High Anonymous Proxy"191.

4.2. Detecção de Firewall Externo

• Localizar o gateway da estação pelo comando ipconfig192.

• Digitar o gateway no navegador e verificar se abre uma página de firewall ou do roteador193.

4.3. Detecção de Domínio (Workgroup)

• Acesse: Meu computador -> Propriedades -> "Computer name, domain, and workgroup settings". A informação estará em "Workgroup"194.

4.4. Desconectar um Usuário em Edição de Versão

• Antes de qualquer procedimento, o analista deve tentar resolver a situação via aplicação, verificando se a versão realmente não está em edição em alguma estação195.

• Através da URL {{host}}/api/aplicativo_versao/id da versão/lock é possível recuperar e desconectar um usuário que está em edição em uma versão196.

• Exemplo:

• Para saber o ID da versão que está sendo editada197.

• GET {{host}}/api/aplicativo_versao/5286/lock retorna o usuário editando a versão (ex: "usuario": "renan.dsn.cir", "blocked": true)198.

• DELETE {{host}}/api/aplicativo_versao/5286/lock remove o usuário da edição, e ele só poderá retornar à fila de edição 30 segundos após ser desconectado199.

• Este recurso deve ser usado quando a versão estiver com uma sessão "presa". Em caso de recorrência, deve-se averiguar a causa200.

4.5. Configuração do Updater (No Update Manager)

• Para configurações no Update Manager (como parar o serviço para realizar alterações):

1. Parar o serviço201.

2. Pressionar Win+R202.

3. Digitar regedit203.

4. Acessar: HKEY_LOCAL_MACHINE > SOFTWARE > ALTERDATA > UPDATER204.

5. No campo em branco ao lado, clique com o botão direito do mouse, selecione Novo -> Valor da Cadeia de Caracteres205.

4.6. Como descobrir a versão do .NET Framework

• Opção 1 - Windows Explorer: 206
  

1. Pressione Win+R para abrir o Executar, digite windir%\Microsoft.NET\Framework\ e pressione Enter, ou navegue até C:\Windows\Microsoft.NET\Framework207.

2. Você verá pastas com as versões do .NET Framework instaladas208.

3. Para Windows de 64 bits, verifique também a pasta C:\Windows\Microsoft.NET\Framework64209.

• Opção 2 - Linha de comando (PowerShell ou Prompt de Comando): 210
  

1. Pesquise por "PowerShell" no menu iniciar e abra o "Windows Powershell"211.

2. Cole o comando wmic product get description | findstr /C:.NET e pressione Enter212.

3. Aguarde a lista de versões instaladas213.

4. No Prompt de Comando, use: wmic product where "Name like 'Microsoft .Net%" get Name, Version214.

• Opção 3 - Editor de Registro: 215
  

1. Pressione Win+R, digite regedit e Enter216.

2. Navegue até a chave HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP. Você verá chaves para cada versão instalada217.

• Opção 4 - Programa (.NET Version Detector): 218
  

1. Baixe o .NET Version Detector (clique na seta verde para baixo ao lado do nome)219.

2. Extraia o conteúdo do arquivo ZIP para uma pasta e execute o arquivo dotnet.exe220.

3. Clique em "OK" para aceitar os termos de uso e ele exibirá as versões do .NET Framework no seu PC221