Artifactspublic-v0

curl

master
ply4 git calls130 ms289 KiB2 cachedprotocol v2
132 lines4.1 KiBRaw

NAME

CURLOPT_PROXY_SSL_OPTIONS - HTTPS proxy SSL behavior options

SYNOPSIS

c
#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSL_OPTIONS,
                          long bitmask);

DESCRIPTION

Pass a long with a bitmask to tell libcurl about specific SSL behaviors. Available bits:

CURLSSLOPT_ALLOW_BEAST

Tells libcurl to not attempt to use any workarounds for a security flaw in the SSL3 and TLS1.0 protocols. If this option is not used or this bit is set to 0, the SSL layer libcurl uses may use a workaround for this flaw although it might cause interoperability problems with some (older) SSL implementations.

WARNING: avoiding this workaround lessens the security, and by setting this option to 1 you ask for exactly that. This option is only supported for Secure Transport and OpenSSL.

CURLSSLOPT_NO_REVOKE

Tells libcurl to disable certificate revocation checks for those SSL backends where such behavior is present. This option is only supported for Schannel (the native Windows SSL library), with an exception in the case of Windows' Untrusted Publishers block list which it seems cannot be bypassed.

CURLSSLOPT_NO_PARTIALCHAIN

Tells libcurl to not accept "partial" certificate chains, which it otherwise does by default. This option fails the certificate verification if the chain ends with an intermediate certificate and not with a root cert.

Works with OpenSSL and its forks (BoringSSL, LibreSSL, etc). (Added in 7.68.0)

Works with Schannel if the user specified certificates to verify the peer. (Added in 8.15.0)

CURLSSLOPT_REVOKE_BEST_EFFORT

Tells libcurl to ignore certificate revocation checks in case of missing or offline distribution points for those SSL backends where such behavior is present. This option is only supported for Schannel (the native Windows SSL library). If combined with CURLSSLOPT_NO_REVOKE, the latter takes precedence. (Added in 7.70.0)

CURLSSLOPT_NATIVE_CA

Tell libcurl to use the operating system's native CA store for certificate verification. This option is independent of other CA certificate locations set at run time or build time. Those locations are searched in addition to the native CA store.

Works with wolfSSL on Windows, Linux (Debian, Fedora, Gentoo, RHEL, Ubuntu), macOS, Android and iOS (added in 8.3.0); with GnuTLS (added in 8.5.0) and with OpenSSL and its forks (BoringSSL, LibreSSL, etc) on Windows (Added in 7.71.0).

CURLSSLOPT_AUTO_CLIENT_CERT

Tell libcurl to automatically locate and use a client certificate for authentication, when requested by the server. This option is only supported for Schannel (the native Windows SSL library). Prior to 7.77.0 this was the default behavior in libcurl with Schannel. Since the server can request any certificate that supports client authentication in the OS certificate store it could be a privacy violation and unexpected. (Added in 7.77.0)

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_PROXY, "https://proxy.example");
    /* weaken TLS only for use with silly proxies */
    curl_easy_setopt(curl, CURLOPT_PROXY_SSL_OPTIONS,
                     CURLSSLOPT_ALLOW_BEAST | CURLSSLOPT_NO_REVOKE);
    result = curl_easy_perform(curl);
    curl_easy_cleanup(curl);
  }
}

HISTORY

CURLSSLOPT_* macros became long types in 8.15.0, prior to this version a long cast was necessary when passed to curl_easy_setopt(3).

%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_PROXY_SSL_OPTIONS
5Section: 3
6Source: libcurl
7See-also:
8 - CURLOPT_PROXY_SSLVERSION (3)
9 - CURLOPT_PROXY_SSL_CIPHER_LIST (3)
10 - CURLOPT_SSLVERSION (3)
11 - CURLOPT_SSL_CIPHER_LIST (3)
12Protocol:
13 - TLS
14TLS-backend:
15 - All
16Added-in: 7.52.0
17---
19# NAME
21CURLOPT_PROXY_SSL_OPTIONS - HTTPS proxy SSL behavior options
23# SYNOPSIS
25~~~c
26#include <curl/curl.h>
28CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSL_OPTIONS,
29 long bitmask);
30~~~
32# DESCRIPTION
34Pass a long with a bitmask to tell libcurl about specific SSL
35behaviors. Available bits:
37## CURLSSLOPT_ALLOW_BEAST
39Tells libcurl to not attempt to use any workarounds for a security flaw in the
40SSL3 and TLS1.0 protocols. If this option is not used or this bit is set to 0,
41the SSL layer libcurl uses may use a workaround for this flaw although it
42might cause interoperability problems with some (older) SSL implementations.
44**WARNING:** avoiding this workaround lessens the security, and by setting
45this option to 1 you ask for exactly that. This option is only supported for
46Secure Transport and OpenSSL.
48## CURLSSLOPT_NO_REVOKE
50Tells libcurl to disable certificate revocation checks for those SSL backends
51where such behavior is present. This option is only supported for Schannel
52(the native Windows SSL library), with an exception in the case of Windows'
53Untrusted Publishers block list which it seems cannot be bypassed.
55## CURLSSLOPT_NO_PARTIALCHAIN
57Tells libcurl to not accept "partial" certificate chains, which it otherwise
58does by default. This option fails the certificate verification if the chain
59ends with an intermediate certificate and not with a root cert.
61Works with OpenSSL and its forks (BoringSSL, LibreSSL, etc). (Added in 7.68.0)
63Works with Schannel if the user specified certificates to verify the peer.
64(Added in 8.15.0)
66## CURLSSLOPT_REVOKE_BEST_EFFORT
68Tells libcurl to ignore certificate revocation checks in case of missing or
69offline distribution points for those SSL backends where such behavior is
70present. This option is only supported for Schannel (the native Windows SSL
71library). If combined with *CURLSSLOPT_NO_REVOKE*, the latter takes
72precedence. (Added in 7.70.0)
74## CURLSSLOPT_NATIVE_CA
76Tell libcurl to use the operating system's native CA store for certificate
77verification. This option is independent of other CA certificate locations set
78at run time or build time. Those locations are searched in addition to the
79native CA store.
81Works with wolfSSL on Windows, Linux (Debian, Fedora, Gentoo, RHEL, Ubuntu),
82macOS, Android and iOS (added in 8.3.0); with GnuTLS (added in 8.5.0) and with
83OpenSSL and its forks (BoringSSL, LibreSSL, etc) on Windows (Added in 7.71.0).
85## CURLSSLOPT_AUTO_CLIENT_CERT
87Tell libcurl to automatically locate and use a client certificate for
88authentication, when requested by the server. This option is only supported
89for Schannel (the native Windows SSL library). Prior to 7.77.0 this was the
90default behavior in libcurl with Schannel. Since the server can request any
91certificate that supports client authentication in the OS certificate store it
92could be a privacy violation and unexpected.
93(Added in 7.77.0)
95# DEFAULT
99# %PROTOCOLS%
101# EXAMPLE
103~~~c
104int main(void)
106 CURL *curl = curl_easy_init();
107 if(curl) {
108 CURLcode result;
109 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
110 curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy.example");
111 /* weaken TLS only for use with silly proxies */
112 curl_easy_setopt(curl, CURLOPT_PROXY_SSL_OPTIONS,
113 CURLSSLOPT_ALLOW_BEAST | CURLSSLOPT_NO_REVOKE);
114 result = curl_easy_perform(curl);
115 curl_easy_cleanup(curl);
116 }
118~~~
120# HISTORY
122**CURLSSLOPT_*** macros became `long` types in 8.15.0, prior to this version
123a `long` cast was necessary when passed to curl_easy_setopt(3).
125# %AVAILABILITY%
127# RETURN VALUE
129curl_easy_setopt(3) returns a CURLcode indicating success or error.
131CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
132libcurl-errors(3).
Diagnostics4 git calls · 130 ms
CallStatusSizeTime0130 ms
discover200152 B2 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
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 · hit3 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=3
git.response.bytes=293470
git.response.cache=HIT
git.response.duration_ms=3
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.9 KiB125 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=125
git.response.bytes=1958
git.response.cache=MISS
git.response.duration_ms=125
git.fetch.wants=0b491eeff653f49d7c9ab48b104e387f7aa45865
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=1958
git.pkt.payload.max=1937
git.sideband.band1.bytes=1936
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
a5e34969fcb14652
Request
6a8e655a…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format