The United States Department of Transportation Joint Program Office (JPO) Connected Vehicle Data Privacy (CVDP) Project is developing a variety of methods to enhance the privacy of individuals who generated connected vehicle data.
Connected vehicle technology uses in-vehicle wireless transceivers to broadcast and receive basic safety messages (BSMs) that include accurate spatiotemporal information to enhance transportation safety. Integrated Global Positioning System (GPS) measurements are included in BSMs. Databases, some publicly available, of BSM sequences, called trajectories, are being used to develop safety and traffic management applications. BSMs do not contain explicit identifiers that link trajectories to individuals; however, the locations they expose may be sensitive and associated with a very small subset of the population; protecting these locations from unwanted disclosure is extremely important. Developing procedures that minimize the risk of associating trajectories with individuals is the objective of this project.
The PPM operates on streams of raw BSMs generated by the ODE. It determines whether individual BSMs should be retained or suppressed (deleted) based on the information in that BSM and auxiliary map information used to define a geofence. BSM geoposition (latitude and longitude) and speed are used to determine the disposition of each BSM processed. The PPM also redacts other BSM fields.
Protecting against inference-based privacy attacks on spatiotemporal trajectories (i.e., sequences of BSMs from a single vehicle) in general is a challenging task. An example of an inference-based privacy attack is identifying the driver that generated a sequence of BSMs using specific locations they visit during their trip, or other features discernable from the information in the BSM sequence. This PPM treats a specific use case: a geofenced area where residences do not exist, e.g., a highway corridor, with certain speed restrictions. Do not assume this strategy will work in general. There are alternative strategies that must be employed to handle cases where loitering locations can aid in learning the identity of the driver.
- Release Notes
- Documentation
- Development and Collaboration Tools
- Getting Started
- Installation
- Configuration and Operation
- Testing
- Development
- ODE-771: Fixed reported bug where the PPM exits when connections to Kafka brokers fail.
- ODE-369/ORNL-15: Logging
- Updated Identifier Redactor to include random assignment in lieu of fixed assignment.
- ORNL-17: USDOT Playbook
- ODE-290: Integration with the ODE.
- ODE-77: Complete documentation
- (Partial Complete) ODE-282 Implement a Module that Interfaces with the ODE.
- (Partially Complete) ODE-77 Implement a PPM that uses a Geofence to Filter BSMs.
The following document will help practitioners build, test, deploy, and understand the PPM's functions:
All stakeholders are invited to provide input to these documents. Stakeholders should direct all input on this document to the JPO Product Owner at DOT, FHWA, or JPO. To provide feedback, we recommend that you create an "issue" in this repository (https://github.com/usdot-jpo-ode/jpo-cvdp/issues). You will need a GitHub account to create an issue. If you don’t have an account, a dialog will be presented to you to create one at no cost.
Code documentation can be generated using Doxygen by following the commands below:
$ sudo apt install doxygen
$ cd <install root>/jpo-cvdp
$ doxygen
The documentation is in HTML and is written to the <install root>/jpo-cvdp/docs/html
directory. Open index.html
in a
browser.
- https://github.com/usdot-jpo-ode/jpo-cvdp
[email protected]:usdot-jpo-ode/jpo-cvdp.git
https://usdotjpoode.atlassian.net/secure/Dashboard.jspa
The PPM is tested using Travis Continuous Integration.
You will need Git to obtain the code and documents in this repository. Furthermore, we recommend using Docker to build the necessary containers to build, test, and experiment with the PPM. The Docker instructions can be found in that section.
You can find more information in our installation and setup directions.
See the installation and setup instructions unless you just want to examine the code.
Step 1. Disable Git core.autocrlf
(Only the First Time)
NOTE: If running on Windows, please make sure that your global git config is set up to not convert End-of-Line characters during checkout. This is important for building docker images correctly.
git config --global core.autocrlf false
Step 2. Clone the source code from GitHub repositories using Git commands:
git clone https://github.com/usdot-jpo-ode/jpo-cvdp.git