PKCS12_ADD_CERT(3ossl)

🎀 NAME 🎀

okay so bestie, welcome to the PKCS12_ADD_CERT(3ossl) manual 💖 This is the group chat for PKCS12_add_cert, PKCS12_add_key, PKCS12_add_key_ex, and PKCS12_add_secret — their whole thing is adding an object to a set of PKCS#12 safeBags. iconic. periodt.

✨ SYNOPSIS ✨

        #include <openssl/pkcs12.h>

        PKCS12_SAFEBAG *PKCS12_add_cert(STACK_OF(PKCS12_SAFEBAG) **pbags, X509 *cert);
        PKCS12_SAFEBAG *PKCS12_add_key(STACK_OF(PKCS12_SAFEBAG) **pbags,
                                      EVP_PKEY *key, int key_usage, int iter,
                                      int key_nid, const char *pass);
        PKCS12_SAFEBAG *PKCS12_add_key_ex(STACK_OF(PKCS12_SAFEBAG) **pbags,
                                          EVP_PKEY *key, int key_usage, int iter,
                                          int key_nid, const char *pass,
                                          OSSL_LIB_CTX *ctx, const char *propq);

        PKCS12_SAFEBAG *PKCS12_add_secret(STACK_OF(PKCS12_SAFEBAG) **pbags,
                                         int nid_type, const unsigned char *value, int len);

🌸 DESCRIPTION 🌸

These functions create a brand-new PKCS12_SAFEBAG and add it to the set of safeBags in pbags. it's giving build-the-bag-set energy, fr fr.

• PKCS12_add_cert() — creates a PKCS#12 certBag containing the supplied certificate, then adds it to the set of PKCS#12 safeBags. slay.
• PKCS12_add_key() — creates a PKCS#12 keyBag (unencrypted) or a pkcs8shroudedKeyBag (encrypted) containing the supplied EVP_PKEY, then adds it to the set of PKCS#12 safeBags. If key_nid is not -1, the key is encrypted with the supplied algorithm, using pass as the passphrase and iter as the iteration count. If iter is zero, a default value for iteration count of 2048 is used. no cap.
• PKCS12_add_key_ex() — literally identical to PKCS12_add_key(), but it allows a library context ctx and property query propq to be used to select algorithm implementations. obsessed.
• PKCS12_add_secret() — creates a PKCS#12 secretBag with an OID corresponding to the supplied nid_type, containing the supplied value as an ASN1 octet string. Then it's added to the set of PKCS#12 safeBags. 💜

🫶 NOTES 🫶

If a certificate contains an alias or a keyid, then this will be used for the corresponding friendlyName or localKeyID in the PKCS12 structure. iykyk.

PKCS12_add_key() makes assumptions regarding the encoding of the given pass phrase. See passphrase-encoding(7) for more information. tea time 🫖.

⭐ RETURN VALUES ⭐

A valid PKCS12_SAFEBAG structure or NULL if an error occurred. that's the vibe check.

🌈 CONFORMING TO 🌈

IETF RFC 7292 (https://tools.ietf.org/html/rfc7292) — we love standards, bestie.

🦋 SEE ALSO 🦋

PKCS12_create(3)

👑 HISTORY 👑

PKCS12_add_secret() and PKCS12_add_key_ex() were added in OpenSSL 3.0. glow-up era.

💖 COPYRIGHT 💖

Copyright 2020-2021 The OpenSSL Project Authors. All Rights Reserved.

Licensed under the Apache License 2.0 (the "License"). You may not use this file except in compliance with the License. You can obtain a copy in the file LICENSE in the source distribution or at https://www.openssl.org/source/license.html.

---

signing off with source/version 3.5.6, dated 2026-04-07, from the PKCS12_ADD_CERT(3ossl) manual 💅✨ bye bestie