Source code
Revision control
Copy as Markdown
Other Tools
/*
* PKCS#12 PBE (RFC 7292 Appendix B)
* (C) 2026 Damiano Mazzella
*
* Botan is released under the Simplified BSD License (see license.txt)
*/
#ifndef BOTAN_PKCS12_PBE_H_
#define BOTAN_PKCS12_PBE_H_
#include <botan/asn1_obj.h>
#include <botan/secmem.h>
#include <span>
#include <string_view>
#include <utility>
#include <vector>
namespace Botan {
class RandomNumberGenerator;
/// Maximum allowed iteration count for PKCS#12 KDF/PBE/MAC operations
///
/// This matches the limit used by NSS, AWS-LC and BoringSSL for PKCS12 files
inline constexpr size_t PKCS12_MAX_ITERATIONS = 100'000'000;
/**
* Decrypt data protected by PKCS#12 PBE (RFC 7292 Appendix B) or PBES2.
* @param ciphertext the encrypted data
* @param password the decryption password
* @param pbe_algo the AlgorithmIdentifier from the EncryptedData structure
* @param openssl_empty_pwd_compat if @c true and @p password is empty, the
* password is fed to the PKCS#12 KDF as an empty byte string (matching
* OpenSSL's non-conforming behavior) instead of the RFC 7292 form
* (a two-byte {0x00,0x00} terminator). Has no effect on PBES2 or when
* the password is non-empty.
*/
secure_vector<uint8_t> pkcs12_pbe_decrypt(std::span<const uint8_t> ciphertext,
std::string_view password,
const AlgorithmIdentifier& pbe_algo,
bool openssl_empty_pwd_compat = false);
/**
* Encrypt data using PKCS#12 PBE (RFC 7292 Appendix B) or PBES2.
* @param plaintext the data to encrypt
* @param password the encryption password
* @param algo algorithm name: "PBES2-SHA256-AES256", "PBES2-SHA256-AES128",
* "PBE-SHA1-3DES" (legacy), "PBE-SHA1-2DES" (legacy).
* Higher-level APIs default to "PBES2-SHA256-AES256" via PKCS12_Options.
* @param iterations PBKDF iteration count
* @param rng a random number generator
* @return the AlgorithmIdentifier and encrypted data
*/
std::pair<AlgorithmIdentifier, std::vector<uint8_t>> pkcs12_pbe_encrypt(std::span<const uint8_t> plaintext,
std::string_view password,
std::string_view algo,
size_t iterations,
RandomNumberGenerator& rng);
} // namespace Botan
#endif