/* * (C) 2014,2015,2016,2018 Jack Lloyd * (C) 2016 Daniel Neus, Rohde & Schwarz Cybersecurity * * Botan is released under the Simplified BSD License (see license.txt) */ #include "tests.h" #if defined(BOTAN_HAS_AEAD_MODES) #include #endif namespace Botan_Tests { namespace { #if defined(BOTAN_HAS_AEAD_MODES) class AEAD_Tests final : public Text_Based_Test { public: AEAD_Tests() : Text_Based_Test("aead", "Key,Nonce,In,Out", "AD") {} Test::Result test_enc(const std::vector& key, const std::vector& nonce, const std::vector& input, const std::vector& expected, const std::vector& ad, const std::string& algo) { const bool is_siv = algo.find("/SIV") != std::string::npos; Test::Result result(algo); std::unique_ptr enc(Botan::AEAD_Mode::create(algo, Botan::ENCRYPTION)); result.test_eq("AEAD encrypt output_length is correct", enc->output_length(input.size()), expected.size()); result.confirm("AEAD name is not empty", !enc->name().empty()); result.confirm("AEAD default nonce size is accepted", enc->valid_nonce_length(enc->default_nonce_length())); Botan::secure_vector garbage = Test::rng().random_vec(enc->update_granularity()); if(is_siv == false) { result.test_throws("Unkeyed object throws for encrypt", [&]() { enc->update(garbage); }); } result.test_throws("Unkeyed object throws for encrypt", [&]() { enc->finish(garbage); }); if(enc->associated_data_requires_key()) { result.test_throws("Unkeyed object throws for set AD", [&]() { enc->set_associated_data(ad.data(), ad.size()); }); } // Ensure that test resets AD and message state enc->set_key(key); if(is_siv == false) { result.test_throws("Cannot process data until nonce is set (enc)", [&]() { enc->update(garbage); }); } enc->set_ad(mutate_vec(ad)); enc->start(mutate_vec(nonce)); enc->update(garbage); // reset message specific state enc->reset(); /* Now try to set the AD *after* setting the nonce For some modes this works, for others it does not. */ enc->start(nonce); try { enc->set_ad(ad); } catch(Botan::Invalid_State&) { // ad after setting nonce rejected, in this case we need to reset enc->reset(); enc->set_ad(ad); enc->start(nonce); } Botan::secure_vector buf(input.begin(), input.end()); // have to check here first if input is empty if not we can test update() and eventually process() if(buf.empty()) { enc->finish(buf); result.test_eq("encrypt with empty input", buf, expected); } else { // test finish() with full input enc->finish(buf); result.test_eq("encrypt full", buf, expected); // additionally test update() if possible const size_t update_granularity = enc->update_granularity(); if(input.size() > update_granularity) { // reset state first enc->reset(); enc->set_ad(ad); enc->start(nonce); buf.assign(input.begin(), input.end()); size_t input_length = buf.size(); size_t offset = 0; uint8_t* p = buf.data(); Botan::secure_vector block(update_granularity); Botan::secure_vector ciphertext(enc->output_length(buf.size())); while(input_length > update_granularity && ((input_length - update_granularity) >= enc->minimum_final_size())) { block.assign(p, p + update_granularity); enc->update(block); p += update_granularity; input_length -= update_granularity; buffer_insert(ciphertext, 0 + offset, block); offset += block.size(); } // encrypt remaining bytes block.assign(p, p + input_length); enc->finish(block); buffer_insert(ciphertext, 0 + offset, block); result.test_eq("encrypt update", ciphertext, expected); } // additionally test process() if possible size_t min_final_bytes = enc->minimum_final_size(); if(input.size() > (update_granularity + min_final_bytes)) { // again reset state first enc->reset(); enc->set_ad(ad); enc->start(nonce); buf.assign(input.begin(), input.end()); // we can process at max input.size() const size_t max_blocks_to_process = (input.size() - min_final_bytes) / update_granularity; const size_t bytes_to_process = max_blocks_to_process * update_granularity; const size_t bytes_written = enc->process(buf.data(), bytes_to_process); if(bytes_written == 0) { // SIV case buf.erase(buf.begin(), buf.begin() + bytes_to_process); enc->finish(buf); } else { result.test_eq("correct number of bytes processed", bytes_written, bytes_to_process); enc->finish(buf, bytes_written); } result.test_eq("encrypt process", buf, expected); } } enc->clear(); result.test_throws("Unkeyed object throws for encrypt after clear", [&]() { enc->finish(buf); }); if(enc->associated_data_requires_key()) { result.test_throws("Unkeyed object throws for set AD after clear", [&]() { enc->set_associated_data(ad.data(), ad.size()); }); } return result; } Test::Result test_dec(const std::vector& key, const std::vector& nonce, const std::vector& input, const std::vector& expected, const std::vector& ad, const std::string& algo) { const bool is_siv = algo.find("/SIV") != std::string::npos; Test::Result result(algo); std::unique_ptr dec(Botan::AEAD_Mode::create(algo, Botan::DECRYPTION)); result.test_eq("AEAD decrypt output_length is correct", dec->output_length(input.size()), expected.size()); Botan::secure_vector garbage = Test::rng().random_vec(dec->update_granularity()); if(is_siv == false) { result.test_throws("Unkeyed object throws for decrypt", [&]() { dec->update(garbage); }); } result.test_throws("Unkeyed object throws for decrypt", [&]() { dec->finish(garbage); }); if(dec->associated_data_requires_key()) { result.test_throws("Unkeyed object throws for set AD", [&]() { dec->set_associated_data(ad.data(), ad.size()); }); } // First some tests for reset() to make sure it resets what we need it to // set garbage values dec->set_key(key); dec->set_ad(mutate_vec(ad)); if(is_siv == false) { result.test_throws("Cannot process data until nonce is set (dec)", [&]() { dec->update(garbage); }); } dec->start(mutate_vec(nonce)); dec->update(garbage); // reset message specific state dec->reset(); Botan::secure_vector buf(input.begin(), input.end()); try { // now try to decrypt with correct values try { dec->start(nonce); dec->set_ad(ad); } catch(Botan::Invalid_State&) { // ad after setting nonce rejected, in this case we need to reset dec->reset(); dec->set_ad(ad); dec->start(nonce); } // test finish() with full input dec->finish(buf); result.test_eq("decrypt full", buf, expected); // additionally test update() if possible const size_t update_granularity = dec->update_granularity(); if(input.size() > update_granularity) { // reset state first dec->reset(); dec->set_ad(ad); dec->start(nonce); buf.assign(input.begin(), input.end()); size_t input_length = buf.size(); size_t offset = 0; uint8_t* p = buf.data(); Botan::secure_vector block(update_granularity); Botan::secure_vector plaintext(dec->output_length(buf.size())); while((input_length > update_granularity) && ((input_length - update_granularity) >= dec->minimum_final_size())) { block.assign(p, p + update_granularity); dec->update(block); p += update_granularity; input_length -= update_granularity; buffer_insert(plaintext, 0 + offset, block); offset += block.size(); } // decrypt remaining bytes block.assign(p, p + input_length); dec->finish(block); buffer_insert(plaintext, 0 + offset, block); result.test_eq("decrypt update", plaintext, expected); } // additionally test process() if possible const size_t min_final_size = dec->minimum_final_size(); if(input.size() > (update_granularity + min_final_size)) { // again reset state first dec->reset(); dec->set_ad(ad); dec->start(nonce); buf.assign(input.begin(), input.end()); // we can process at max input.size() const size_t max_blocks_to_process = (input.size() - min_final_size) / update_granularity; const size_t bytes_to_process = max_blocks_to_process * update_granularity; const size_t bytes_written = dec->process(buf.data(), bytes_to_process); if(bytes_written == 0) { // SIV case buf.erase(buf.begin(), buf.begin() + bytes_to_process); dec->finish(buf); } else { result.test_eq("correct number of bytes processed", bytes_written, bytes_to_process); dec->finish(buf, bytes_to_process); } result.test_eq("decrypt process", buf, expected); } } catch(Botan::Exception& e) { result.test_failure("Failure processing AEAD ciphertext", e.what()); } // test decryption with modified ciphertext const std::vector mutated_input = mutate_vec(input, true); buf.assign(mutated_input.begin(), mutated_input.end()); dec->reset(); dec->set_ad(ad); dec->start(nonce); try { dec->finish(buf); result.test_failure("accepted modified message", mutated_input); } catch(Botan::Integrity_Failure&) { result.test_success("correctly rejected modified message"); } catch(std::exception& e) { result.test_failure("unexpected error while rejecting modified message", e.what()); } // test decryption with modified nonce if(nonce.size() > 0) { buf.assign(input.begin(), input.end()); std::vector bad_nonce = mutate_vec(nonce); dec->reset(); dec->set_ad(ad); dec->start(bad_nonce); try { dec->finish(buf); result.test_failure("accepted message with modified nonce", bad_nonce); } catch(Botan::Integrity_Failure&) { result.test_success("correctly rejected modified nonce"); } catch(std::exception& e) { result.test_failure("unexpected error while rejecting modified nonce", e.what()); } } // test decryption with modified associated_data const std::vector bad_ad = mutate_vec(ad, true); dec->reset(); dec->set_ad(bad_ad); dec->start(nonce); try { buf.assign(input.begin(), input.end()); dec->finish(buf); result.test_failure("accepted message with modified ad", bad_ad); } catch(Botan::Integrity_Failure&) { result.test_success("correctly rejected modified ad"); } catch(std::exception& e) { result.test_failure("unexpected error while rejecting modified nonce", e.what()); } dec->clear(); result.test_throws("Unkeyed object throws for decrypt", [&]() { dec->finish(buf); }); if(dec->associated_data_requires_key()) { result.test_throws("Unkeyed object throws for set AD", [&]() { dec->set_associated_data(ad.data(), ad.size()); }); } return result; } Test::Result run_one_test(const std::string& algo, const VarMap& vars) override { const std::vector key = vars.get_req_bin("Key"); const std::vector nonce = vars.get_opt_bin("Nonce"); const std::vector input = vars.get_req_bin("In"); const std::vector expected = vars.get_req_bin("Out"); const std::vector ad = vars.get_opt_bin("AD"); Test::Result result(algo); std::unique_ptr enc(Botan::AEAD_Mode::create(algo, Botan::ENCRYPTION)); std::unique_ptr dec(Botan::AEAD_Mode::create(algo, Botan::DECRYPTION)); if(!enc || !dec) { result.note_missing(algo); return result; } // must be authenticated result.test_eq("Encryption algo is an authenticated mode", enc->authenticated(), true); result.test_eq("Decryption algo is an authenticated mode", dec->authenticated(), true); const std::string enc_provider = enc->provider(); result.test_is_nonempty("enc provider", enc_provider); const std::string dec_provider = enc->provider(); result.test_is_nonempty("dec provider", dec_provider); result.test_eq("same provider", enc_provider, dec_provider); // FFI currently requires this, so assure it is true for all modes result.test_gte("enc buffer sizes ok", enc->update_granularity(), enc->minimum_final_size()); result.test_gte("dec buffer sizes ok", dec->update_granularity(), dec->minimum_final_size()); // test enc result.merge(test_enc(key, nonce, input, expected, ad, algo)); // test dec result.merge(test_dec(key, nonce, expected, input, ad, algo)); return result; } }; BOTAN_REGISTER_TEST("aead", AEAD_Tests); #endif } }