CURLOPT_PROXY_SSLKEY(3)

1CURLOPT_PROXY_SSLKEY(3)    curl_easy_setopt options    CURLOPT_PROXY_SSLKEY(3)
2
3
4

NAME

6       CURLOPT_PROXY_SSLKEY  -  specify  private keyfile for TLS and SSL proxy
7       client cert
8

SYNOPSIS

10       #include <curl/curl.h>
11
12       CURLcode  curl_easy_setopt(CURL  *handle,  CURLOPT_PROXY_SSLKEY,   char
13       *keyfile);
14

DESCRIPTION

16       Pass  a  pointer  to  a null-terminated string as parameter. The string
17       should be the file name of your private key used for connecting to  the
18       HTTPS  proxy.  The default format is "PEM" and can be changed with CUR‐
19       LOPT_PROXY_SSLKEYTYPE(3).
20
21       (iOS and Mac OS X only) This  option  is  ignored  if  curl  was  built
22       against  Secure  Transport. Secure Transport expects the private key to
23       be already present in the keychain or PKCS#12 file containing the  cer‐
24       tificate.
25
26       The  application  does not have to keep the string around after setting
27       this option.
28

DEFAULT

30       NULL
31

PROTOCOLS

33       All
34

EXAMPLE

36       CURL *curl = curl_easy_init();
37       if(curl) {
38         curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
39         curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy");
40         curl_easy_setopt(curl, CURLOPT_PROXY_SSLCERT, "client.pem");
41         curl_easy_setopt(curl, CURLOPT_PROXY_SSLKEY, "key.pem");
42         curl_easy_setopt(curl, CURLOPT_PROXY_KEYPASSWD, "s3cret");
43         ret = curl_easy_perform(curl);
44         curl_easy_cleanup(curl);
45       }
46

AVAILABILITY

48       Added in 7.52.0
49
50       If built TLS enabled.
51

RETURN VALUE

53       Returns CURLE_OK if TLS is supported, CURLE_UNKNOWN_OPTION if  not,  or
54       CURLE_OUT_OF_MEMORY if there was insufficient heap space.
55