Files
MicrOBU/microbu-esp32c5/external/vanetza-idf/vanetza/security/v3/sign_header_policy.hpp
T
Ashin Walpola 0e9525162d Keep the colleague's microbu-esp32c5 tree in this repository
obu-firmware builds against vanetza-idf from microbu-esp32c5/external, but
that tree was gitignored, so a clone of this repository could not build the
firmware it ships. It is now committed here as ordinary files in its own
folder, microbu-esp32c5/: the colleague's commit cf4b99f plus the V2X2MAP
bridge's signature verification (--trust) used on the bench. Nothing is
fetched from or pushed to the colleague's repository; this repository and
its remotes carry everything. The folder's own .gitignore keeps build output,
downloaded components and private key material out, as it did there; the
committed file set is identical to that repository's tracked files.

The ESP32-C5 is still flashed from obu-firmware/, which only takes
vanetza-idf from microbu-esp32c5/, so the two stay separate folders.
FLASHING.md says how to take a newer version of the colleague's tree (copy
it over the folder, rebuild, test, commit).
2026-09-23 17:46:40 +02:00

97 lines
2.6 KiB
C++

#pragma once
#include <vanetza/common/clock.hpp>
#include <vanetza/common/runtime.hpp>
#include <vanetza/security/hashed_id.hpp>
#include <vanetza/security/peer_request_tracker.hpp>
#include <boost/optional/optional.hpp>
namespace vanetza
{
// forward declaration
class PositionProvider;
namespace security
{
// forward declarations
class CertificateProvider;
struct SignRequest;
namespace v3
{
/**
* SignHeaderPolicy is used while signing messages
*
* SignHeaderPolicy determines the header fields to be included in the secured message.
* Other components can influence the policy's behaviour by calling one of its "report" methods.
*/
class SignHeaderPolicy
{
public:
/**
* Prepare header fields for next secured message.
*
* \param req signing request (including ITS-AID for example)
* \param secured_message output message
* \return header fields
*/
virtual void prepare_header(const SignRequest& req, SecuredMessage& secured_message) = 0;
/**
* Mark certificate as unrecognized in next secured message
* \param id hash of unknown certificate
*/
virtual void request_unrecognized_certificate(HashedId8 id) = 0;
/**
* Request a full certificate to be included in next secured message
*/
virtual void request_certificate() = 0;
/**
* Enqueue a certificate for P2P distribution.
* \param id hash of requested certificate
*/
virtual void enqueue_p2p_request(HashedId3 id) = 0;
/**
* Discard a P2P certificate request.
* \param id hash of requested certificate
*/
virtual void discard_p2p_request(HashedId3 id) = 0;
virtual ~SignHeaderPolicy() = default;
};
/**
* DefaultSignHeaderPolicy implements the default behaviour specified by ETSI TS 103 097 V2.1.1
*/
class DefaultSignHeaderPolicy : public SignHeaderPolicy
{
public:
DefaultSignHeaderPolicy(const Runtime&, PositionProvider& positioning, CertificateProvider&);
void prepare_header(const SignRequest& request, SecuredMessage& secured_message) override;
void request_unrecognized_certificate(HashedId8 id) override;
void request_certificate() override;
void enqueue_p2p_request(HashedId3) override;
void discard_p2p_request(HashedId3) override;
private:
const Runtime& m_runtime;
PositionProvider& m_positioning;
CertificateProvider& m_cert_provider;
Clock::time_point m_cam_next_certificate;
bool m_cert_requested;
PeerRequestTracker m_incoming_requests;
PeerRequestTracker m_outgoing_requests;
};
} // namespace v3
} // namespace security
} // namespace vanetza