/* * 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 #include #include #include #include #include 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 pkcs12_pbe_decrypt(std::span 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> pkcs12_pbe_encrypt(std::span plaintext, std::string_view password, std::string_view algo, size_t iterations, RandomNumberGenerator& rng); } // namespace Botan #endif