- Você vir “Failed to connect” ou erros de rede semelhantes
- O editor ou o painel Cascade exibir uma tela em branco e nunca carregar
- O Cascade ou outros recursos que dependem da nuvem não conseguirem carregar nem se conectar
- Os fluxos de login ou ativação falharem inesperadamente
- Os recursos funcionarem em um hotspot/rede doméstica, mas falharem na rede corporativa
- Você vir erros de certificado ou de handshake TLS nos logs/devtools
Se você também estiver enfrentando problemas relacionados a proxy, consulte Configuração de proxy.
- Verifique se a sua rede usa inspeção SSL
Antes de alterar qualquer coisa no editor, pergunte à sua equipe de TI / segurança / rede:
- Fazemos interceptação de TLS / inspeção SSL no tráfego HTTPS de saída?
- A inspeção SSL está ativada para as estações de trabalho dos desenvolvedores e as ferramentas de desenvolvimento (não apenas navegadores)?
- Qual cadeia de CA raiz / CA intermediária é usada para assinar o tráfego inspecionado?
- Essa cadeia de CA está implantada nos endpoints e é reconhecida como confiável pelos aplicativos/runtime usados no desenvolvimento?
- Capture o erro subjacente no Devin Desktop (Ferramentas do Desenvolvedor → Console)
O Editor do Devin Desktop (baseado no VS Code) disponibiliza Ferramentas do Desenvolvedor que podem mostrar as falhas reais de TLS/certificado.
- Abra Help → Dev Tools / Developer Tools
- Selecione a aba Console
- Procure por erros em vermelho
- Expanda cada entrada de erro para visualizar todos os detalhes (campos de erro aninhados / stack traces)
-
certificate signed by unknown authority -
unable to verify the first certificate -
self signed certificate in certificate chain -
UNABLE_TO_VERIFY_LEAF_SIGNATURE
-
unable to get local issuer certificate -
unable to get issuer certificate
-
handshake_failure -
wrong version number -
protocol negotiation failed -
ERR_SSL_PROTOCOL_ERROR
- O que causa isso em ambientes com inspeção SSL
Quando a inspeção SSL está ativada, o gateway encerra e restabelece conexões TLS. O cliente recebe um certificado de servidor sintético assinado por uma CA de inspeção corporativa (certificados CA raiz e, às vezes, CA intermediária).
As falhas de conectividade do Devin Desktop normalmente ocorrem quando:
- A CA raiz de inspeção corporativa não é confiável no endpoint, e/ou
- A cadeia do certificado de inspeção está incompleta (falta a CA intermediária), e/ou
- O IDE/runtime usa um repositório de confiança que não é do sistema operacional e que não inclui a cadeia da CA de inspeção corporativa, e/ou
- A política corporativa impõe restrições de TLS que interrompem a negociação (versão mínima/cifras de TLS, bloqueio de tráfego que não pode ser descriptografado etc.)
- Trabalhe com a equipe de TI/segurança para resolver isso
Como a inspeção SSL e a implantação de certificados são controladas pela sua organização, a solução normalmente exige alterações de TI/segurança.
A) Validar a política de inspeção SSL para o tráfego do Devin Desktop
Peça à equipe de TI/segurança que confirme:- Se a inspeção SSL se aplica ao tráfego HTTPS de saída relacionado ao Devin Desktop
- Se ocorre algum bloqueio/negação devido à validação de certificados, a motivos de política ou a restrições na negociação de TLS
B) Garanta que a cadeia de CAs da inspeção corporativa esteja implantada corretamente e seja reconhecida como confiável
Peça à equipe de TI/segurança para:- Implantar a CA raiz da inspeção SSL corporativa nos endpoints dos desenvolvedores
- Garantir que todos os certificados de CA intermediária necessários estejam presentes e que a cadeia esteja correta
- Validar a confiança usando o mesmo repositório de confiança usado pelo IDE/runtime (repositório do SO vs. repositório específico do runtime)
C) Configure um bypass de inspeção SSL com escopo restrito (fallback)
Se não for possível alinhar a confiança, peça à equipe de TI/segurança para:- Criar um bypass de inspeção SSL para os endpoints de serviço necessários do Devin Desktop (conforme o processo da sua organização para requisitos de rede/lista de permissões)
- Manter o bypass com escopo restrito e alinhado à sua política de segurança
- O que enviar para TI / segurança (copiar/colar)
Problema: o Devin Desktop Editor não consegue se conectar na rede corporativa; provavelmente há um problema de confiança no certificado ou na cadeia de certificados devido à inspeção SSL / interceptação TLS.
Evidência: Ajuda → Ferramentas do Desenvolvedor → Console mostra erros de TLS/certificado ou de handshake (há erros expandidos em vermelho disponíveis no console).
Solicitação:
- Confirmar se a inspeção SSL está ativada para o tráfego HTTPS de saída relacionado ao Devin Desktop.
- Confirmar se a CA raiz da inspeção SSL corporativa e quaisquer certificados intermediários estão implantados e são confiáveis neste endpoint (e em qualquer repositório de confiança específico do runtime usado pela IDE).
- Se esse alinhamento de confiança não for viável, configurar um bypass de inspeção SSL com escopo definido para os endpoints de serviço necessários do Devin Desktop.
- Data(s) e hora(s) da falha
- Versão do SO
- Se o Zscaler Client Connector (ou agente semelhante) está instalado/ativado
- Texto expandido do erro no console em Ferramentas do Desenvolvedor → Console
- Se funciona em um hotspot/rede doméstica, mas falha na rede corporativa
- Quando usar cada opção
Use correções de implantação ou de confiança de certificados se:
- Os erros indicarem “autoridade desconhecida”, “não foi possível verificar”, “emissor não encontrado” ou intermediários ausentes
- Você quiser a correção mais duradoura mantendo a inspeção SSL ativada
- O IDE/runtime não conseguir consumir, na prática, a cadeia de CAs da empresa
- O alinhamento do repositório de confiança não for confiável no seu ambiente
- A equipe de TI/segurança confirmar que a inspeção está causando falhas e aprovar uma exceção direcionada