Como resolver erros de SSL ao instalar dependências com o pip em ambientes corporativos ?
Visão Geral
Ambientes corporativos costumam ter políticas de segurança rígidas que restringem o acesso a determinados recursos da internet. Por isso, é comum que ocorram falhas ao utilizar ferramentas como o pip (gerenciador de pacotes do Python) em máquinas dentro da rede da empresa.
Um dos problemas mais frequentes é a falha na verificação do certificado SSL ao tentar instalar dependências, seja durante a execução do Runner ou em instalações manuais.
Sintoma Comum
Um erro típico que pode aparecer nos logs ou no terminal é semelhante ao exemplo abaixo:
WARNING: Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None))
after connection broken by 'SSLError(SSLCertVerificationError(1, '[SSL: CERTIFICATE_VERIFY_FAILED]
certificate verify failed: unable to get local issuer certificate (_ssl.c:1000)'))': /simple/pip/
Could not fetch URL https://pypi.org/simple/pip/: There was a problem confirming the SSL certificate: HTTPSConnectionPool(host='pypi.org', port=443):
Max retries exceeded with url: /simple/pip/ (Caused by SSLError(SSLCertVerificationError(1, '[SSL: CERTIFICATE_VERIFY_FAILED]
certificate verify failed: unable to get local issuer certificate (_ssl.c:1000)'))) - skippingEsse erro indica que o Python não conseguiu validar o certificado SSL do repositório oficial de pacotes, o PyPI (Python Package Index).
Causa Provável
Esse tipo de falha normalmente acontece porque a rede da empresa bloqueia ou inspeciona conexões HTTPS, o que interfere na validação dos certificados SSL utilizados pelo pip.
Solução Proposta
Para contornar esse problema, é possível configurar o pip para confiar explicitamente nos domínios utilizados pelo PyPI.
Comando para configurar o pip com trusted-host:
pip config set global.trusted-host \
"pypi.org files.pythonhosted.org pypi.python.org" \
--trusted-host=pypi.python.org \
--trusted-host=pypi.org \
--trusted-host=files.pythonhosted.org
Essa configuração define uma lista de hosts confiáveis para o pip, permitindo que ele ignore erros de verificação SSL nesses domínios.
Importante
Essa é uma solução paliativa, recomendada somente em ambientes controlados.
Sempre valide com o time de TI da sua empresa se essa configuração é permitida conforme as políticas internas de segurança.
O time de TI também pode indicar configurações adicionais de proxy, certificados ou mirror interno para o uso do pip.
Saiba Mais
Para mais informações sobre bloqueios em ambientes corporativos, acesse a seção de Pré-requisitos da documentação oficial da BotCity.
Conclusão
Erros relacionados ao certificado SSL ao usar o pip são comuns em redes corporativas com restrições de segurança. Configurar os domínios do PyPI como trusted-host pode resolver temporariamente o problema, mas é essencial envolver o time de TI para garantir que a solução seja segura e definitiva.
Related Articles
Resolvendo problemas de verificação do certificado SSL ao executar comandos usando o 'pip'
Os bloqueios de acesso são bastante comuns em ambientes corporativos. Com isso, pode ser que você encontre alguns problemas ao tentar utilizar as ferramentas da BotCity e os recursos do Python em uma máquina que esteja no ambiente da sua empresa. Um ...Como resolver o problema de instalação travada em 0% no BotCity Studio ?
Visão Geral Se ao tentar instalar o BotCity Studio ou iniciar o BotCity Runner, a instalação permanece travada em 0%, ou ocorrem erros de autenticação e login, é muito provável que o ambiente corporativo esteja bloqueando as conexões necessárias para ...Como resolver o erro “ModuleNotFoundError” ao executar a automação ?
Visão Geral Se ao rodar sua automação você encontrar o erro: ModuleNotFoundError: No module named 'botcity' isso indica que o ambiente de execução não está encontrando o pacote necessário. Esse problema geralmente está relacionado à instalação ...Problemas com dependências ao executar uma automação
Esse tipo de problema costuma ocorrer quando a etapa de instalação das dependências não é feita da forma correta. Ao rodar o código, é lançada uma mensagem referente a instalação dos pacotes: ModuleNotFoundError: No module named 'botcity’ A primeira ...Problemas de Conectividade com as Ferramentas BotCity: Como Diagnosticar e Resolver
Descrição Esse tipo de problema é comum em ambientes corporativos com restrições de rede e pode afetar diretamente o uso das ferramentas BotCity. Entre os sintomas mais frequentes, estão: A instalação via Wizard travada em 0% Erro ao iniciar o runner ...