Em ambientes com proxy de inspeção SSL (SSL Inspection), as ferramentas Java e Python da BotCity podem rejeitar a conexão por não reconhecerem o certificado da empresa. Para resolver, é preciso registrar o certificado raiz da CA interna em cada tecnologia. Veja abaixo como identificar o problema e onde fazer a configuração.

1. Por que as ferramentas rejeitam a conexão com SSL Inspection?

Com a inspeção SSL, a empresa substitui o certificado original dos servidores por um certificado emitido por uma CA interna (a autoridade certificadora da própria empresa). As ferramentas Java e Python não reconhecem essa CA e rejeitam a conexão, com erros como:

• Java: PKIX path building failed
• Python: CERTIFICATE_VERIFY_FAILED

2. Configurar o trusted-host do pip resolve o problema?

Não por completo. O trusted-host do pip só afeta a instalação de pacotes. O Wizard, o Runner e o BotCity Studio continuam rejeitando o certificado.

Por exemplo, mesmo com o pip install funcionando, o Runner ainda pode exibir PKIX path building failed ao tentar se conectar ao Orquestrador.

3. Como registrar o certificado nas ferramentas Java?

Para o Wizard, o Runner e o BotCity Studio, importe o certificado raiz da CA interna no cacerts (o truststore, ou repositório de certificados confiáveis) da JVM usada pelas ferramentas, com o keytool.

4. Como registrar o certificado nas automações Python?

Para a biblioteca requests, crie um bundle customizado a partir do certifi, com o certificado da CA interna, e aponte a variável de ambiente REQUESTS_CA_BUNDLE para ele.

O passo a passo completo está no guia Configurar Certificado SSL Corporativo.

5. Onde conseguir o certificado raiz da CA interna?

O certificado normalmente é fornecido pelo time de infraestrutura ou de segurança da sua empresa. Solicite o arquivo (.crt, .cer ou .pem) antes de começar a configuração.

Ainda precisa de ajuda?

Se isso não resolver o seu caso ou sua pergunta não está listada aqui, abra um chamado com o time de suporte.