mirror/curl
2
0
Fork 0
mirror of https://github.com/curl/curl.git synced 2024-12-09 06:30:06 +08:00
Code Issues Packages Projects Releases Wiki Activity

CURLOPT_UNRESTRICTED_AUTH.3: extended explanation

Browse Source 
Include details about Authentication headers.

Reported-by: Brad Spencer
Fixes #8724
Closes #8726
This commit is contained in:
Daniel Stenberg 2022-04-19 18:15:02 +02:00
parent c3b27c3141
commit 774dbd520a
No known key found for this signature in database
GPG Key ID: 5CC908FDB71E12C2
1 changed files with 14 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
docs/libcurl/opts/CURLOPT_UNRESTRICTED_AUTH.3
View File

@ -5,7 +5,7 @@
.\" * | (__| |_| | _ <| |___ .\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____| .\" * \___|\___/|_| \_\_____|
.\" * .\" *
.\" * Copyright (C) 1998 - 2017, Daniel Stenberg, <daniel@haxx.se>, et al. .\" * Copyright (C) 1998 - 2022, Daniel Stenberg, <daniel@haxx.se>, et al.
.\" * .\" *
.\" * This software is licensed as described in the file COPYING, which .\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms .\" * you should have received as part of this distribution. The terms
@ -35,9 +35,19 @@ authentication (user+password) credentials when following locations, even when
hostname changed. This option is meaningful only when setting hostname changed. This option is meaningful only when setting
\fICURLOPT_FOLLOWLOCATION(3)\fP. \fICURLOPT_FOLLOWLOCATION(3)\fP.
By default, libcurl will only send given credentials to the initial host name Further, when this option is not used or set to \fB0L\fP, libcurl will not
as given in the original URL, to avoid leaking username + password to other send custom set nor internally generated Authentication: headers on requests
sites. done to other hosts than the one used for the initial URL.
By default, libcurl will only send credentials and Authentication headers to
the initial host name as given in the original URL, to avoid leaking username
+ password to other sites.
This option should be used with caution: when curl follows redirects it
blindly fetches the next URL as instructed by the server. Setting
\fICURLOPT_UNRESTRICTED_AUTH(3)\fP to 1L will therefore also make curl trust
the server and send possibly sensitive credentials to a host the server points
out.
.SH DEFAULT .SH DEFAULT
0 0
.SH PROTOCOLS .SH PROTOCOLS