Skip to content

docs: mention possible auth option conflicts - #22648

Closed
bagder wants to merge 3 commits into
masterfrom
bagder/docs-auth-custom-headers
Closed

bagder wants to merge 3 commits into
masterfrom
bagder/docs-auth-custom-headers

Conversation

@bagder

@bagder bagder commented Aug 23, 2026

Copy link
Copy Markdown
Member

Do not mix HTTP auth options with custom Authorization headers.

Do not mix HTTP auth options with custom Authorization headers.
@bagder
bagder marked this pull request as ready for review August 23, 2026 21:06
@bagder
bagder requested a lite review from Copilot August 23, 2026 21:14

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates libcurl option documentation to warn that manually setting Authorization: / Proxy-Authorization: headers can conflict with libcurl’s built-in HTTP/proxy authentication options.

Changes:

  • Add warning to CURLOPT_HTTPAUTH(3) docs about conflicts with custom Authorization: headers.
  • Add warning to CURLOPT_HTTPHEADER(3) docs about conflicts with CURLOPT_HTTPAUTH(3) / CURLOPT_PROXYAUTH(3).
  • Add warning to CURLOPT_PROXYAUTH(3) docs about conflicts with custom Proxy-Authorization: headers (but with one incorrect cross-reference that needs fixing).

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File Description
docs/libcurl/opts/CURLOPT_PROXYAUTH.md Adds a warning about custom Proxy-Authorization: headers; contains a wrong reference to CURLOPT_HTTPAUTH(3) that should be CURLOPT_PROXYAUTH(3).
docs/libcurl/opts/CURLOPT_HTTPHEADER.md Adds dedicated sections warning about Authorization: / Proxy-Authorization: header interactions with auth options.
docs/libcurl/opts/CURLOPT_HTTPAUTH.md Adds a warning about conflicts when mixing CURLOPT_HTTPAUTH(3) with custom Authorization: headers.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread docs/libcurl/opts/CURLOPT_PROXYAUTH.md Outdated
oops

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@bagder bagder closed this in 740d952 Aug 23, 2026
@bagder
bagder deleted the bagder/docs-auth-custom-headers branch August 23, 2026 21:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Development

Successfully merging this pull request may close these issues.

2 participants