Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Document NODE_EXTRA_CA_CERTS for TLS-intercepting corporate proxies - #3

Merged
rattalur merged 2 commits into
mainfrom
copilot/fix-node-js-cert-trust-issue
Sep 3, 2026
Merged

rattalur merged 2 commits into
mainfrom
copilot/fix-node-js-cert-trust-issue

Conversation

Copilot AI commented Sep 3, 2026

Copy link
Copy Markdown

Users behind corporate proxies that perform TLS interception (MITM) with an internal root CA hit a confusing Could not reach the Codacy API error. Node.js doesn't read the OS certificate trust store the way curl does, so it rejects the proxy's intercepted certificate with UNABLE_TO_GET_LOCAL_ISSUER_CERT — even though curl -x "$HTTPS_PROXY" ... against the same host succeeds. This fix (NODE_EXTRA_CA_CERTS) was undocumented.

This is a docs-only change; no source behavior was modified.

  • README.md — new "TLS Interception (MITM) Proxies" subsection under "Proxy Support": explains the root cause, the fix, how to obtain the CA bundle, and the curl-vs-CLI diagnostic:
    export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca-bundle.pem
    codacy login
  • AGENTS.md — new row in the Environment Variables table for NODE_EXTRA_CA_CERTS, noting it's a standard Node.js env var (not implemented by this CLI).
  • SPECS/README.md — changelog entry documenting the addition.
  • .changeset/ — empty changeset added, since CI's changeset-check requires one on every PR regardless of whether it's a docs-only change.

Copilot AI changed the title [WIP] Fix Node.js certificate trust issue for corporate proxies Document NODE_EXTRA_CA_CERTS for TLS-intercepting corporate proxies Sep 3, 2026
Copilot AI requested a review from rattalur September 3, 2026 07:59
@rattalur
rattalur marked this pull request as ready for review September 3, 2026 07:59
@rattalur
rattalur merged commit 3c0d7ff into main Sep 3, 2026
@rattalur
rattalur deleted the copilot/fix-node-js-cert-trust-issue branch September 3, 2026 07:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants