Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
CURLOPT_PROXY_SSLCERT_BLOB(curl_easy_setopt optioCURLOPT_PROXY_SSLCERT_BLOB(3)

NAME
       CURLOPT_PROXY_SSLCERT_BLOB  -  SSL proxy	client certificate from	memory
       blob

SYNOPSIS
       #include	<curl/curl.h>

       CURLcode	 curl_easy_setopt(CURL	*handle,   CURLOPT_PROXY_SSLCERT_BLOB,
       struct curl_blob	*blob);

DESCRIPTION
       Pass  a	pointer	 to  a curl_blob structure, which contains information
       (pointer	and size) about	a memory block with binary data	 of  the  cer-
       tificate	 used  to connect to the HTTPS proxy. The format must be "P12"
       on Secure Transport or Schannel.	The format must	be "P12" or  "PEM"  on
       OpenSSL.	  The  string  "P12"  or  "PEM"	 must  be  specified with CUR-
       LOPT_PROXY_SSLCERTTYPE(3).

       If the blob is initialized with the flags member	 of  struct  curl_blob
       set to CURL_BLOB_COPY, the application does not have to keep the	buffer
       around after setting this.

       This option is an alternative to	CURLOPT_PROXY_SSLCERT(3) which instead
       expects a file name as input.

DEFAULT
       NULL

PROTOCOLS
       All TLS based protocols:	HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.

EXAMPLE
       CURL *curl = curl_easy_init();
       if(curl)	{
	 struct	curl_blob blob;
	 blob.data = certificateData;
	 blob.len = filesize;
	 blob.flags = CURL_BLOB_COPY;
	 curl_easy_setopt(curl,	CURLOPT_URL, "https://example.com/");
	 curl_easy_setopt(curl,	CURLOPT_PROXY, "https://proxy");
	 curl_easy_setopt(curl,	CURLOPT_PROXY_SSLKEY, "key.pem");
	 curl_easy_setopt(curl,	CURLOPT_PROXY_KEYPASSWD, "s3cret");
	 curl_easy_setopt(curl,	CURLOPT_PROXY_SSLCERT_BLOB, &blob);
	 ret = curl_easy_perform(curl);
	 curl_easy_cleanup(curl);
       }

AVAILABILITY
       Added  in  libcurl 7.71.0. This option is supported by the OpenSSL, Se-
       cure Transport and Schannel backends.

RETURN VALUE
       Returns CURLE_OK	 if  TLS  enabled,  CURLE_UNKNOWN_OPTION  if  not,  or
       CURLE_OUT_OF_MEMORY if there was	insufficient heap space.

SEE ALSO
       CURLOPT_PROXY_SSLCERTTYPE(3),	   CURLOPT_PROXY_SSLKEY(3),	  CUR-
       LOPT_PROXY_SSLCERT(3),

libcurl	7.71.0			  24 Jun 2020	 CURLOPT_PROXY_SSLCERT_BLOB(3)

NAME | SYNOPSIS | DESCRIPTION | DEFAULT | PROTOCOLS | EXAMPLE | AVAILABILITY | RETURN VALUE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=CURLOPT_PROXY_SSLCERT_BLOB&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help