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

FreeBSD Manual Pages

  
 
  

home | help
CURLOPT_PR...LCERT_BLOB(3) Library Functions Manual CURLOPT_PR...LCERT_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 filename as input.

DEFAULT
       NULL

PROTOCOLS
       This functionality affects all TLS based	protocols: HTTPS, FTPS,	IMAPS,
       POP3S, SMTPS etc.

       This option works only with the following TLS backends: OpenSSL,	Schan-
       nel and Secure Transport

EXAMPLE
       extern char *certificateData; /*	point to data */
       extern size_t filesize; /* size of the data */

       int main(void)
       {
	 CURL *curl = curl_easy_init();
	 if(curl) {
	   CURLcode res;
	   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);
	   res = curl_easy_perform(curl);
	   curl_easy_cleanup(curl);
	 }
       }

AVAILABILITY
       Added in	curl 7.71.0

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).

SEE ALSO
       CURLOPT_PROXY_SSLCERT(3),      CURLOPT_PROXY_SSLCERTTYPE(3),	  CUR-
       LOPT_PROXY_SSLKEY(3), CURLOPT_SSLCERT_BLOB(3)

libcurl				  2025-06-03	    CURLOPT_PR...LCERT_BLOB(3)

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

home | help