Keep vanetza-idf in obu-firmware, so a plain clone builds the firmware

obu-firmware builds against the vanetza-idf C-ITS library, which until now
came from the colleague's microbu-esp32c5 tree beside the repository and was
not tracked here, so a clone of this repository could not build the firmware
it ships. The library alone is now part of obu-firmware, as
obu-firmware/external/vanetza-idf: their external/vanetza-idf at commit
cf4b99f, unchanged (9775 files; see its PROVENANCE.md). CMake takes it from
there by default; -DVANETZA_IDF_DIR still points the build elsewhere.

The rest of the colleague's tree (their own VAM firmware, PKI tooling,
station-link Python tools, the V2X2MAP bridge) stays out of this repository
and gitignored; nothing is pushed to their repository. NOTES.md, docs/06,
TODO.md and the pcap verifier's usage line point at the new location.

obu-firmware/external/vanetza-idf/tools/pki/security_module.hpp

@@ -0,0 +1,90 @@
+#pragma once
+
+#include "keys.hpp"
+#include "sha.hpp"
+#include <vanetza/common/byte_buffer.hpp>
+#include <boost/optional/optional.hpp>
+#include <memory>
+
+namespace vanetza
+{
+namespace pki
+{
+
+class SecurityModule
+{
+public:
+    class EciesContext
+    {
+    public:
+        virtual ~EciesContext() = default;
+        virtual PublicKey ephemeral_public_key() const = 0;
+        virtual PublicKey recipient_public_key() const = 0;
+        virtual ByteBuffer shared_secret() const = 0;
+        virtual ByteBuffer encrypted_key() const = 0;
+        virtual ByteBuffer authentication_tag() const = 0;
+        virtual ByteBuffer nonce() const = 0;
+        virtual void nonce(const ByteBuffer&) = 0;
+
+        virtual ByteBuffer encrypt(const ByteBuffer& plaintext) = 0;
+        virtual ByteBuffer decrypt(const std::uint8_t* buffer, std::size_t length) = 0;
+    };
+
+    virtual ~SecurityModule() = default;
+    virtual Sha256Hash calculate_sha256_hash(const std::uint8_t* buffer, std::size_t length) = 0;
+    virtual Sha384Hash calculate_sha384_hash(const std::uint8_t* buffer, std::size_t length) = 0;
+    virtual bool verify(const Sha256Hash&, const Signature&, const PublicKey&) = 0;
+    virtual bool verify(const Sha384Hash&, const Signature&, const PublicKey&) = 0;
+
+    virtual boost::optional<Signature> sign(const ByteBuffer& digest, const PublicKey&) = 0;
+
+    // True if the private key matching `key` is available for signing.
+    virtual bool can_sign(const PublicKey& key);
+
+    virtual PublicKey create_key(KeyType) = 0;
+    virtual bool discard_key(const PublicKey&) = 0;
+
+    virtual ByteBuffer generate_nonce(std::size_t length) = 0;
+    virtual std::unique_ptr<EciesContext> create_ecies_context(const PublicKey& receiver, const Sha256Hash& info) = 0;
+    virtual ByteBuffer calculate_hmac_sha256(const ByteBuffer& key, const ByteBuffer& data) = 0;
+};
+
+class ScopedKeyPair
+{
+public:
+    ScopedKeyPair(SecurityModule& sm, KeyType type) : m_security(&sm), m_public_key(sm.create_key(type))
+    {
+    }
+
+    // no copy
+    ScopedKeyPair(const ScopedKeyPair&) = delete;
+    ScopedKeyPair& operator=(const ScopedKeyPair&) = delete;
+    // no move
+    ScopedKeyPair(ScopedKeyPair&&) = delete;
+    ScopedKeyPair& operator=(ScopedKeyPair&&) = delete;
+
+    ~ScopedKeyPair()
+    {
+        if (m_security) {
+            m_security->discard_key(m_public_key);
+        }
+    }
+
+    const PublicKey& public_key() const
+    {
+        return m_public_key;
+    }
+
+    void commit()
+    {
+        // will no longer discard created key
+        m_security = nullptr;
+    }
+
+private:
+    SecurityModule* m_security = nullptr;
+    PublicKey m_public_key;
+};
+
+} // namespace pki
+} // namespace vanetza