Ashin Walpola
d107534eb2
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.
34 lines
1.8 KiB
Markdown
34 lines
1.8 KiB
Markdown
# Security
|
|
|
|
This is the security module of Vanetza. It implements the ETSI C-ITS security extension of the GeoNetworking protocol based on:
|
|
- `vanetza::security::v2` namespace: [ETSI TS 103 097 v1.2.1](http://www.etsi.org/deliver/etsi_ts/103000_103099/103097/01.02.01_60/ts_103097v010201p.pdf)
|
|
- `vanetza::security::v3` namespace: [ETSI TS 103 097 v1.3.1](https://www.etsi.org/deliver/etsi_ts/103000_103099/103097/01.03.01_60/ts_103097v010301p.pdf)
|
|
|
|
|
|
## Implemented Features
|
|
|
|
Most features are implemented, including:
|
|
|
|
- Security profiles including the CAM and DENM profile
|
|
- Certificate requests for unknown certificates of other stations
|
|
- Certificate validation for incoming messages
|
|
|
|
## Missing Features
|
|
|
|
There are a few missing features, but the overall implementation is in a working state to send and receive secured messages.
|
|
It has been verified to work correctly by interoperability tests with other implementations.
|
|
|
|
- Revocation checks for certificate authorities<br>
|
|
Certificates of CAs can be revoked via CRLs. There will be a new standard for the corresponding protocol in May 2018. It will be a new version of [ETSI TS 102 941](http://www.etsi.org/deliver/etsi_ts/102900_102999/102941/01.01.01_60/ts_102941v010101p.pdf).
|
|
|
|
- v2: region checks for polygonal and identified regions<br>
|
|
There are `TODO` notes in the code of `region.cpp` within the `is_within()` functions. Implementing these checks is non-trivial.
|
|
|
|
- v2: region consistency checks for regions other than circular and none region restrictions<br>
|
|
There are `TODO` notes in the code of `region.cpp` within the `is_within()` functions. Implementing these checks is non-trivial.
|
|
|
|
- v3: region checks for identified regions
|
|
|
|
- Certificate requests<br>
|
|
Currently there's no support to request authorization tickets from an authorization authority or to do an enrolment.
|