Repository navigation
docs: cover proxy precedence, proxy auth and corporate CAs per OS - #276
Merged
Merged
Conversation
Extend the networking section of the README: hosts to allow (including the daily update check), variable precedence and NO_PROXY syntax, authentication in the proxy URL, installing a corporate CA on Linux, macOS and Windows, and a table of common errors with their fix. A custom CA only changes TLS trust; it does not affect checksum or signature verification of downloads. Refs #25 Signed-off-by: d0ubl3g <48954024+d0ubl3g@users.noreply.github.com>
Signed-off-by: d0ubl3g <48954024+d0ubl3g@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Extends the README section "Networking: proxies and TLS inspection":
ALL_PROXYfallback,NO_PROXYsyntax (domains, IPs, CIDR), proxy URL form and Basic authentication in the URL (percent-encoding), and the hosts to allow, includingapi.github.comfor the daily update check.SSL_CERT_FILE/SSL_CERT_DIRwithout admin rights), macOS and Windows. A custom CA affects TLS trust only, never checksum or signature verification.--verboseand a table of common errors with their fix.No code change: all HTTP clients already honour the proxy variables and use the platform verifier, and certificate verification is never disabled. The behaviour is covered by the existing
proxy-tlsworkflow (mitmproxy on Linux, macOS and Windows).Refs #25: the real-macOS check behind a proxy is still open, so this PR does not close the issue.