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.
79 lines
2.2 KiB
C++
79 lines
2.2 KiB
C++
#pragma once
|
|
|
|
#include "keys.hpp"
|
|
#include <boost/optional/optional.hpp>
|
|
#include <boost/range/any_range.hpp>
|
|
#include <string>
|
|
|
|
namespace vanetza
|
|
{
|
|
namespace pki
|
|
{
|
|
|
|
/// \brief Lazy, single-pass view over canonical-hex credential names.
|
|
using CredentialNameRange =
|
|
boost::any_range<std::string, boost::single_pass_traversal_tag, std::string, std::ptrdiff_t>;
|
|
|
|
class CredentialStorage
|
|
{
|
|
public:
|
|
virtual ~CredentialStorage() = default;
|
|
virtual void store(const PublicKey&, const PrivateKey&) = 0;
|
|
virtual boost::optional<PrivateKey> fetch(const PublicKey&) = 0;
|
|
virtual bool discard(const PublicKey&) = 0;
|
|
|
|
/// \brief Lazy iteration over the canonical-hex name of every stored credential.
|
|
virtual CredentialNameRange list() const = 0;
|
|
|
|
/// \brief Discard a credential by its canonical-hex name; returns true iff one was removed.
|
|
virtual bool discard(const std::string& canonical_hex) = 0;
|
|
|
|
/// \brief Existence check by canonical-hex name; cheap, no key parsing.
|
|
virtual bool contains(const std::string& canonical_hex) const = 0;
|
|
};
|
|
|
|
/**
|
|
* \brief RAII handle that discards a credential on destruction unless commit() was called.
|
|
*
|
|
* Use to bind a freshly generated key to the lifetime of a protocol step:
|
|
* store now, drop the key if anything throws before the step succeeds.
|
|
*/
|
|
class ScopedCredential
|
|
{
|
|
public:
|
|
ScopedCredential(CredentialStorage& storage, PublicKey pub) : m_storage(&storage), m_public_key(std::move(pub))
|
|
{
|
|
}
|
|
|
|
ScopedCredential(CredentialStorage& storage, PublicKey pub, const PrivateKey& priv) : ScopedCredential(storage, pub)
|
|
{
|
|
m_storage->store(m_public_key, priv);
|
|
}
|
|
|
|
~ScopedCredential()
|
|
{
|
|
if (m_storage) {
|
|
m_storage->discard(m_public_key);
|
|
}
|
|
}
|
|
|
|
// no copy
|
|
ScopedCredential(const ScopedCredential&) = delete;
|
|
ScopedCredential& operator=(const ScopedCredential&) = delete;
|
|
// no move
|
|
ScopedCredential(ScopedCredential&&) = delete;
|
|
ScopedCredential& operator=(ScopedCredential&&) = delete;
|
|
|
|
void commit()
|
|
{
|
|
m_storage = nullptr;
|
|
}
|
|
|
|
private:
|
|
CredentialStorage* m_storage = nullptr;
|
|
PublicKey m_public_key;
|
|
};
|
|
|
|
} // namespace pki
|
|
} // namespace vanetza
|