A configuração de subdomínios traduzidos requer a configuração de DNS, SSL/TLS e de origem correta. Para facilitar a resolução de problemas, Linguise oferece agora um depurador de tradução de subdomínios que verifica a sua configuração e destaca problemas de configuração ou de conectividade.
O depurador ajuda-o a identificar o que está a causar a falha numa verificação de configuração e fornece as informações de erro relevantes para que possa corrigir o problema e verificar novamente a sua configuração.
O que verifica o depurador de tradução de subdomínios?
O depurador verifica a configuração DNS, as ligações SSL/TLS e o site original (origem). Verifica a propriedade do domínio, os registos CNAME de subdomínio traduzidos, os registos A/AAAA, os certificados e a disponibilidade de HTTPS.
Verifica também se a origem é publicamente acessível e devolve uma resposta HTTP utilizável. Cada verificação devolve um estado e, quando aplicável, um código de erro.
Compreender os resultados do diagnóstico
O depurador utiliza diferentes estados para mostrar o resultado de cada verificação.
Falhou
Um estado de Falha significa que o depurador detetou um problema de configuração ou de conectividade que necessita de ser corrigido. Verifique o código de erro e os detalhes do diagnóstico para identificar o componente afetado, como DNS, SSL/TLS ou o site de origem. Após corrigir o problema, execute novamente a verificação de configuração para confirmar o resultado.
Aviso
Um estado de Aviso significa que o site está acessível, mas a sua resposta pode impedir uma tradução fidedigna ou indicar um possível problema de configuração. Analise os detalhes do diagnóstico e verifique o local de origem, o servidor ou a configuração de rede, conforme indicado. Depois de resolver o problema, execute novamente a verificação de configuração.
Desconhecido
Um estado "Desconhecido" significa que o depurador não conseguiu obter um resultado fiável para a verificação. Tente novamente a verificação de configuração. Se o estado persistir, reveja as informações de diagnóstico e investigue se um problema subjacente de DNS, TLS ou conectividade está a causar o problema.
Ignorado
O estado "Ignorado" significa que a verificação não pôde ser executada porque uma verificação anterior obrigatória falhou. Por exemplo, uma verificação TLS pode ser ignorada quando o nome do host traduzido não pode ser resolvido pelo DNS. Corrija primeiro a verificação anterior que falhou e, em seguida, execute novamente a verificação de configuração.
erros de DNS
Os erros de DNS ocorrem quando os registos necessários para ligar os seus subdomínios traduzidos ou o site original estão em falta, incorretos ou não podem ser resolvidos.
CNAME de subdomínio incorreto ou ausente
Este erro significa que o nome do host num idioma traduzido não está a ser resolvido para o destino CNAME necessário Linguise .
Verifique a configuração DNS para o nome de host do idioma afetado e certifique-se de que o registo CNAME aponta para o Linguise fornecido durante a configuração. Se o registo estiver em falta ou apontar para o destino errado, atualize-o com o seu fornecedor de DNS. O depurador pode reportar os seguintes erros:
- DNS_CNAME_NXDOMAIN: o nome do host traduzido não pôde ser resolvido.
- DNS_CNAME_MISMATCH: o CNAME aponta para um destino incorreto.
Verificação da propriedade do domínio
Este erro significa que olinguise está em falta ou o seu valor não corresponde ao valor de verificação atual. O depurador pode reportar DNS_TXT_MISMATCH quando o registo TXT não contém o valor de verificação esperado.
Abra o seu fornecedor de DNS e verifique o _linguise.<domain> Registo TXT. Adicione o registo se estiver em falta ou atualize o seu valor para o valor de verificação fornecido pela Linguise.
Não remova registos TXT irrelevantes do seu domínio. Após a propagação da alteração de DNS, execute novamente a verificação de configuração.
Erro DNS do domínio original
Este erro significa que o domínio original não está a ser resolvido para um registo público A ou AAAA válido. Verifique os seus registos DNS e certifique-se de que o domínio está a ser resolvido para o endereço IP público correto.
Se o registo estiver em falta ou incorreto, atualize-o com o seu fornecedor de DNS. Aguarde a propagação das alterações de DNS e execute novamente a verificação de configuração.
Erros SSL/TLS
Os erros SSL/TLS ocorrem quando Linguise não consegue estabelecer uma ligação HTTPS segura válida com o subdomínio traduzido ou com o site original.
Erro SSL/TLS no subdomínio traduzido
Este erro significa que Linguise não conseguiu estabelecer uma ligação TLS válida com o nome de host traduzido.
Verifique se o nome do host tem um certificado SSL válido e não expirado que corresponda exatamente ao nome do host. Verifique também se a cadeia de certificados está completa e se o HTTPS está disponível na porta 443.
Se utilizar uma CDN, proxy reverso ou WAF, verifique a configuração TLS e certifique-se de que não está a bloquear a ligação. Após corrigir a configuração, execute novamente a verificação de configuração.
Erro SSL/TLS no site original
Este erro significa que Linguise não conseguiu estabelecer uma ligação HTTPS válida com o site original.
Verifique se o certificado de origem está expirado, se o nome do host não corresponde, se a cadeia de certificados está incompleta ou se existem outros problemas de configuração TLS. Se o seu site utilizar uma CDN ou um proxy reverso, verifique também se o certificado correto está a ser utilizado para a ligação de origem. Corrija o certificado ou a configuração TLS e execute novamente a verificação de configuração.
Erros no site de origem
Os erros de origem ocorrem quando Linguise não consegue aceder corretamente ao site original ou não recebe uma resposta utilizável do mesmo.
Erro de origem e destino
Este erro significa que a origem configurada resolve para um destino que Linguise não consegue aceder. Certifique-se de que o domínio resolve para um destino publicamente acessível.
Se a origem utilizar um endereço privado, de loopback ou local de ligação, atualize a configuração da origem para utilizar um destino acessível publicamente e execute novamente a verificação de configuração.
Erros HTTP de origem
Este erro significa que Linguise consegue aceder ao site original, mas recebe uma resposta HTTP que pode impedir uma tradução fidedigna.
As causas mais comuns incluem tempos limite de pedido, requisitos de autenticação, limitação de taxa, redireccionamentos ou erros do servidor. Verifique o site de origem diretamente e reveja a configuração do seu servidor, firewall, WAF, autenticação e limitação de taxa.
Certifique-se de que o site original pode devolver uma resposta válida aos pedidos do Linguisee, em seguida, execute novamente a verificação de configuração.
Erros de diagnóstico e de tempo de execução
Os erros de diagnóstico e de tempo de execução estão relacionados com o depurador ou com o seu processo de diagnóstico, e não indicam necessariamente um problema de configuração de DNS, TLS ou de origem.
VERIFICAÇÃO_DE_NÚCLEO_FALHOU
Este erro significa que a ferramenta principal de verificação de diagnóstico não conseguiu concluir a verificação com êxito. Tente novamente a verificação de configuração e reveja os detalhes do diagnóstico, se disponíveis. Se o erro persistir, verifique se algum problema de configuração ou de conectividade está a afetar o processo de diagnóstico.
DIAGNÓSTICO_CONFIG_ALTERADO
Este erro significa que a definição de diagnóstico foi alterada durante a execução da verificação, pelo que o resultado pode já não ser válido. Execute novamente o diagnóstico utilizando a configuração atual para garantir que a verificação utiliza as definições mais recentes.
DIAGNÓSTICO_PRAZO_EXCEDIDO
Este erro significa que a operação de diagnóstico não foi concluída dentro do tempo permitido. Tente novamente a verificação de configuração e reveja os detalhes do diagnóstico para determinar se a verificação está a ser atrasada pela configuração atual ou pela conectividade.
DIAGNÓSTICO_DOMÍNIO_NÃO_ENCONTRADO
Este erro significa que o diagnóstico não conseguiu encontrar ou resolver o domínio configurado. Verifique se o domínio está configurado corretamente e se os seus registos DNS estão disponíveis publicamente. Após corrigir qualquer problema de configuração de DNS ou de domínio, execute novamente a verificação de configuração.
DIAGNÓSTICO_REQUERIMENTO_INVÁLIDO
Este erro significa que o pedido de diagnóstico não pôde ser processado porque era inválido. Tente novamente a verificação de configuração e certifique-se de que o diagnóstico está a ser executado com a configuração atual e os detalhes do pedido válidos.
FALHA_NA_SONDA_DE_DIAGNÓSTICO
Este erro significa que uma sonda de diagnóstico individual não foi concluída com êxito. Tente novamente o diagnóstico e reveja os detalhes disponíveis para identificar qual a sonda que falhou e se o problema está relacionado com a configuração atual ou com a conectividade.
DIAGNÓSTICO_FALHOU
Este erro significa que o processo de diagnóstico geral não conseguiu produzir um resultado válido. Tente novamente a verificação de configuração e reveja os detalhes de diagnóstico disponíveis, incluindo o nome do host afetado, o ID do pedido e o carimbo de data/hora, para ajudar a identificar a causa.
Se o erro persistir após novas tentativas e verificação da configuração relevante, forneça o código de erro e os detalhes do pedido de diagnóstico ao suporte Linguise para investigação adicional.
Como resolver o problema
Ao resolver problemas numa verificação de configuração com falha, corrija os problemas pela ordem indicada pelos resultados do diagnóstico:
- Propriedade do domínio e DNS: Certifique-se de que os registos TXT, CNAME e A/AAAA necessários estão configurados corretamente e são acessíveis publicamente.
- SSL/TLS: Verifique os certificados relevantes, a configuração do nome do host, a cadeia de certificados e a disponibilidade de HTTPS.
- Origem: Certifique-se de que o site original é acessível publicamente e que o seu servidor, firewall, WAF, autenticação e configuração de limitação de taxa permitem que Linguise aceda ao site.
- Execute novamente a verificação de configuração: Após aplicar as correções necessárias e aguardar a propagação das alterações de DNS, execute novamente a verificação de configuração.
A correção de um erro anterior de DNS ou de conectividade também pode resolver erros dependentes de TLS ou de origem, bem como verificações que foram previamente marcadas como Ignoradas.
O depurador de tradução de subdomínios facilita a identificação e a resolução de problemas de DNS, SSL/TLS e de origem que afetam os subdomínios traduzidos. Analise o erro reportado, aplique a correção recomendada e execute novamente a verificação de configuração para confirmar se a sua configuração está a funcionar corretamente.
Se o problema persistir após seguir os passos de resolução de problemas recomendados, contacte Linguise o suporte para obter mais assistência.
