Artifactspublic-v0

curl

master
ply4 git calls215 ms288 KiB2 cachedprotocol v2
89 lines2.5 KiBRaw

NAME

CURLOPT_UNRESTRICTED_AUTH - send credentials to other hosts too

SYNOPSIS

c
#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_UNRESTRICTED_AUTH,
                          long goahead);

DESCRIPTION

Set the long gohead parameter to 1L to make libcurl continue to send authentication (user+password) credentials or explicitly set cookie headers when following locations, even when the host changes. This option is meaningful only when setting CURLOPT_FOLLOWLOCATION(3).

Further, when this option is not used or set to 0L, libcurl does not send custom nor internally generated Authorization: or Cookie: headers on requests done to other hosts than the one used for the initial URL. Another host means that one or more of hostname, protocol scheme or port number changed.

By default, libcurl only sends Authorization: or explicitly set Cookie: headers to the initial host 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 CURLOPT_UNRESTRICTED_AUTH(3) to 1L makes curl trust the server and sends possibly sensitive credentials to any host the server points to, possibly again and again as the following hosts can keep redirecting to new hosts.

Due to the way HTTP works, almost any header can be made to contain data a client may not want to pass on to other servers than the initially intended host and for all other headers than the two mentioned above, there is no protection from this happening when libcurl is told to follow redirects.

DEFAULT

0

%PROTOCOLS%

EXAMPLE

c
int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode result;
    curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
    curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
    curl_easy_setopt(curl, CURLOPT_UNRESTRICTED_AUTH, 1L);
    result = curl_easy_perform(curl);
    curl_easy_cleanup(curl);
  }
}

%AVAILABILITY%

RETURN VALUE

curl_easy_setopt(3) returns a CURLcode indicating success or error.

CURLE_OK (0) means everything was OK, non-zero means an error occurred, see libcurl-errors(3).

1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Title: CURLOPT_UNRESTRICTED_AUTH
5Section: 3
6Source: libcurl
7See-also:
8 - CURLINFO_REDIRECT_COUNT (3)
9 - CURLOPT_FOLLOWLOCATION (3)
10 - CURLOPT_MAXREDIRS (3)
11 - CURLOPT_REDIR_PROTOCOLS_STR (3)
12 - CURLOPT_USERPWD (3)
13Protocol:
14 - HTTP
15Added-in: 7.10.4
16---
18# NAME
20CURLOPT_UNRESTRICTED_AUTH - send credentials to other hosts too
22# SYNOPSIS
24~~~c
25#include <curl/curl.h>
27CURLcode curl_easy_setopt(CURL *handle, CURLOPT_UNRESTRICTED_AUTH,
28 long goahead);
29~~~
31# DESCRIPTION
33Set the long *gohead* parameter to 1L to make libcurl continue to send
34authentication (user+password) credentials or explicitly set cookie headers
35when following locations, even when the host changes. This option is
36meaningful only when setting CURLOPT_FOLLOWLOCATION(3).
38Further, when this option is not used or set to **0L**, libcurl does not send
39custom nor internally generated `Authorization:` or `Cookie:` headers on
40requests done to other hosts than the one used for the initial URL. Another
41host means that one or more of hostname, protocol scheme or port number
42changed.
44By default, libcurl only sends `Authorization:` or explicitly set `Cookie:`
45headers to the initial host as given in the original URL, to avoid leaking
46username + password to other sites.
48This option should be used with caution: when curl follows redirects it
49blindly fetches the next URL as instructed by the server. Setting
50CURLOPT_UNRESTRICTED_AUTH(3) to 1L makes curl trust the server and sends
51possibly sensitive credentials to any host the server points to, possibly
52again and again as the following hosts can keep redirecting to new hosts.
54Due to the way HTTP works, almost any header can be made to contain data a
55client may not want to pass on to other servers than the initially intended
56host and for all other headers than the two mentioned above, there is no
57protection from this happening when libcurl is told to follow redirects.
59# DEFAULT
63# %PROTOCOLS%
65# EXAMPLE
67~~~c
68int main(void)
70 CURL *curl = curl_easy_init();
71 if(curl) {
72 CURLcode result;
73 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
74 curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
75 curl_easy_setopt(curl, CURLOPT_UNRESTRICTED_AUTH, 1L);
76 result = curl_easy_perform(curl);
77 curl_easy_cleanup(curl);
78 }
80~~~
82# %AVAILABILITY%
84# RETURN VALUE
86curl_easy_setopt(3) returns a CURLcode indicating success or error.
88CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
89libcurl-errors(3).
Diagnostics4 git calls · 215 ms
CallStatusSizeTime0215 ms
discover200152 B2 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=2
git.response.bytes=152
git.server.agent=gitty/1.0
git.server.object_format=sha1
git.server.caps=agent ls-refs fetch object-format
git.server.fetch=shallow filter sideband-all
git.protocol.version=2
git.pkt.frames=8
git.pkt.data=6
git.pkt.flush=2
git.pkt.delim=0
git.pkt.bytes=152
git.pkt.payload.max=34
ls-refs200149 B · hit2 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=2
git.response.bytes=149
git.response.cache=HIT
git.response.duration_ms=2
git.protocol.version=2
git.pkt.frames=3
git.pkt.data=2
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=149
git.pkt.payload.max=78
git.ls_refs.count=2
git.ls_refs.head=refs/heads/master
fetchblob:none · deepen 10200287 KiB · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=211
git.response.bytes=293470
git.response.cache=HIT
git.response.duration_ms=2
git.fetch.filter=blob:none
git.fetch.filter.requested=tree:0
git.fetch.filter.fallback=blob:none
git.fetch.filter.learned=false
git.fetch.wants=31c911efe5652725e930f4d2e60c9060e5f6646d
git.fetch.haves.count=0
git.fetch.deepen=10
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=10
git.pkt.data=8
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=293470
git.pkt.payload.max=65516
git.sideband.band1.bytes=293354
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=87
git.pack.bytes=293354
git.pack.ofs_delta=0
git.pack.ref_delta=1
git.pack.chain.max=1
git.pack.trailer=6a646bcda6740bab42e321b51998b52ea15146c0
git.pack.full=86
Open pack map
fetch2001.3 KiB211 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1356
git.response.cache=MISS
git.response.duration_ms=211
git.fetch.wants=37a9fe56110db1468ee89c05572ab0e1a294b9d2
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=3
git.pkt.data=2
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=1356
git.pkt.payload.max=1335
git.sideband.band1.bytes=1334
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0

Each row is one HTTP round trip ply made to the git server for this page, on one timeline. discover asks what the server speaks, ls-refs lists branch tips, fetch brings objects by id. A hit was served by Workers Cache. Tap a row for its wire details.

Remote
https://5ad2236b39de4c8bd8f6270ea63f3ea9.artifacts.cloudflare.net/git/public-v0/curl.git
Ref
refs/heads/master
Commit
31c911efe5652725e930f4d2e60c9060e5f6646d
cf-ray
a5e397b7c8b01e9f
Request
140c2960…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format