Skip to content

mh-/diagnosis-keys

master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.

diagnosis-keys

Tools for working with Diagnosis Keys from the COVID-19 Exposure Notification / Corona-Warn-App system

Copyright (C) 2020  Michael Huebler and other contributors

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published
by the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.

Installation

% git clone https://github.com/mh-/diagnosis-keys
% cd diagnosis-keys
% pip3 install -r requirements.txt

Use

% ./parse_keys.py -d testExport-2-records-1-of-1.zip                              
Exposure Notification Diagnosis Key Parser
This script parses published Diagnosis Keys.

File 'testExport-2-records-1-of-1.zip' read.
- Time window: 2020-05-22 15:00:00 UTC - 2020-05-23 15:00:00 UTC
- Region: US
- Batch: 1 of 1
- Signature Info:
verification_key_version: "1"
verification_key_id: "some_id"
signature_algorithm: "1.2.840.10045.4.3.2"

Diagnosis Keys:
  1: TEK: 172fc480e598490c34177604339b1543, Transmission Risk Level: 8, Validity: 2020-05-20 15:20:00 UTC - 2020-05-20 15:30:00 UTC (2649980, 1)
  2: TEK: 2b63053ac483238de176169e861f3dcd, Transmission Risk Level: 1, Validity: 2020-05-19 20:20:00 UTC - 2020-05-20 15:20:00 UTC (2649866, 114)

You can download an example Diagnosis Keys file here: https://github.com/google/exposure-notifications-server/blob/master/examples/export/testExport-2-records-1-of-1.zip (This file was generated from https://github.com/google/exposure-notifications-server/blob/master/examples/export/keys.json, using Google's export-generate tool.)

Another example run:

% ./parse_keys.py -c app_contact-tracing-contact-record-db/ -d tekExport.zip -l -s
Exposure Notification Diagnosis Key Parser
This script parses published Diagnosis Keys.

File 'tekExport.zip' read.
- Time window: 2020-06-12 13:25:31 CEST - 2020-06-13 13:25:31 CEST
- Region: US
- Batch: 1 of 1
- Signature Info:
verification_key_version: "1"
verification_key_id: "some_id"
signature_algorithm: "1.2.840.10045.4.3.2"

Diagnosis Keys:
  1: TEK: b534b9654ba21dcd60a9b3e17d620443, Transmission Risk Level: 5, Validity: 2020-06-13 02:00:00 CEST - 2020-06-14 02:00:00 CEST (2653344, 144)
FOUND MATCH!
RPI Validity: 2020-06-13 12:40:00 CEST - 2020-06-13 12:50:00 CEST (Interval number: 2653408, RPI: 1b013a80678747f73b140e8e3e46a3aa)
2020-06-13 12:44:12 CEST Attenuation: 43dB (RSSI: -57dBm, AEM: 919c3296, Metadata: 40f20000)
(...)
FOUND MATCH!
RPI Validity: 2020-06-13 12:50:00 CEST - 2020-06-13 13:00:00 CEST (Interval number: 2653409, RPI: 99b8e671e0759ca9532a25ea3f992a8b)
2020-06-13 12:54:41 CEST Attenuation: 34dB (RSSI: -58dBm, AEM: 36563b98, Metadata: 40e80000)
(...)
FOUND MATCH!
RPI Validity: 2020-06-13 13:00:00 CEST - 2020-06-13 13:10:00 CEST (Interval number: 2653410, RPI: f357370f15be3f7ec06030ca34899223)
2020-06-13 13:07:20 CEST Attenuation: 34dB (RSSI: -58dBm, AEM: 9be98c37, Metadata: 40e80000)
(...)

Used by

This tool is used by a number of CWA diagnosis key visualisation projects such as:

About

Tools for working with Diagnosis Keys from the COVID-19 Exposure Notification / Corona-Warn-App system

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages