GNURLOPT_P...SLKEY_BLOB(3)

📦 version 7.72.0, in nixos 26.05, nixpkgs unstable

🎀 NAME 🎀

CURLOPT_PROXY_SSLKEY_BLOB - private key for proxy cert from memory blob

okay so bestie, this is the GNURLOPT_P...SLKEY_BLOB(3) page from the curl_easy_setopt options manual, and it's literally all about handing curl a private key for your proxy cert straight out of a memory blob. iconic behavior, no cap. 💅

✨ SYNOPSIS ✨

#include <gnurl/curl.h>

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

💖 DESCRIPTION 💖

Pass a pointer to a curl_blob structure that contains information — pointer and size — about the private key for connecting to the HTTPS proxy. It's compatible with OpenSSL, periodt. The format (like "PEM") must be specified with CURLOPT_PROXY_SSLKEYTYPE(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. The way that copy flag saves you from lifetime drama is highkey iconic. 🦋

🌸 DEFAULT 🌸

The default is literally NULL, bestie. That's the whole vibe. 🎀

🦋 PROTOCOLS 🦋

It's giving all TLS based protocols energy: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. So yeah, the secure-protocol girlies. ✨

🍓 EXAMPLE 🍓

CURL *curl = curl_easy_init();
if(curl) {
  struct curl_blob blob;
  curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
  curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy");
  blob.data = certificateData;
  blob.len = filesize;
  blob.flags = CURL_BLOB_COPY;
  curl_easy_setopt(curl, CURLOPT_PROXY_SSLCERT_BLOB, &blob);
  curl_easy_setopt(curl, CURLOPT_PROXY_SSLCERTTYPE, "PEM");

  blob.data = privateKeyData;
  blob.len = privateKeySize;
  curl_easy_setopt(curl, CURLOPT_PROXY_SSLKEY_BLOB, &blob);
  curl_easy_setopt(curl, CURLOPT_PROXY_KEYPASSWD, "s3cret");
  ret = curl_easy_perform(curl);
  curl_easy_cleanup(curl);
}

⭐ AVAILABILITY ⭐

Added in libcurl 7.71.0. This option is supported by the OpenSSL backends, iykyk. 🔥

🔥 RETURN VALUE 🔥

Returns CURLE_OK if TLS enabled, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. That's the whole vibe check, fr fr. 😭

👑 SEE ALSO 👑

later bestie 🫶 this page is libcurl 7.71.0, dated 24 Jun 2020, and it's the GNURLOPT_P...SLKEY_BLOB(3) manual — mwah 💋

📦 where this page comes from