Python library to decode the EU Covid-19 vaccine certificate

Last update: Mar 11, 2022

Related tags

Overview

DCC Utils

Python library to decode the EU Covid-19 vaccine certificate, as specified by the EU.

Setup

pip install dcc-utils

Make sure zbar is installed in your system

For Mac OS X, it can be installed via brew install zbar
Debian systems via apt install libzbar0. Source
Fedora / Red Hat dnf install zbar

Usage

Parse DCC

This library takes an image with a QR code or a raw repr. of a vaccine certificate as the parameter and will show the certificate's content.

from dcc_utils import dcc

dcc_from_img = dcc.from_image("/my/certificate/path")
dcc_from_raw = dcc.from_raw("HC1:6BF...FTPQ3C3F")

Then you can access to payload and kid

assert dcc_from_img.kid == "53FOjX/4aJs="
assert dcc_from_img.payload["v"][0]["ci"] == "URN:UVCI:01:FR:W7V2BE46QSBJ#L"

👉🏻 payload follows EU Digital COVID Certificates JSON Schema Specification

from_image and from_raw methods may rise DCCParsingError

from dcc_utils.exceptions import DCCParsingError

Validate DCC digital signature

signature = b"""
-----BEGIN CERTIFICATE-----
MIIIAjCCBeqgAwIBAgIQAnq8g/T
-----END CERTIFICATE-----
"""
assert my_dcc.check_signature(signature)

check_signature method may rise DCCSignatureError

from dcc_utils.exceptions import DCCSignatureError

Evaluate CertLogic business rules

With dcc-utils you can evaluate business rules against a DCC

from dcc_utils import rule, dcc

my_dcc = dcc.from_image("/my/certificate/path")
my_rule = rule.from_file("/my/rule.json")
print(my_rule.description["en"])
my_rule.evaluate_dcc(my_dcc) # True or False

evaluate_dcc accepts extra variables as a second parameter, e.g. validationClock

import datetime
clock = datetime.datetime(2022, 10, 10, 0, 0, tzinfo=datetime.timezone.utc)
my_rule.evaluate_dcc(
    my_dcc,
    {
        "validationClock": clock,
    },
)

you can also load rules from JSON (from_json), useful to evaluate rules exposed on a server

my_rule = rule.from_json({...})

from_file and from_json method may rise DCCRuleError

from dcc_utils.exceptions import DCCRuleError

Dev setup

Install dependencies using pip:

pip install -r requirements-dev.txt

Run tests

make test

EU Digital COVID Certificate Specifications

What's in a EU Digital COVID/Green Certificate?

Value Sets for Digital Green Certificates https://ec.europa.eu/health/sites/default/files/ehealth/docs/digital-green-certificates_dt-specifications_en.pdf
JSON schema: https://github.com/ehn-dcc-development/ehn-dcc-schema

Sample data

Digital Green Certificate Gateway (DGCG) samples for all participating countries: https://github.com/eu-digital-green-certificates/dgc-testdata

Credits

Parts of this code are adapted from vacdec project.

License

This library is available under the MIT license.

A Tool to validate domestic New Zealand vaccine passes

Vaccine Validator Tool to validate domestic New Zealand vaccine passes Create a new virtual environment: python3 -m venv ./venv Activate virtual envi

8 May 1, 2022

Vaccine for STOP/DJVU ransomware, prevents encryption

STOP/DJVU Ransomware Vaccine Prevents STOP/DJVU Ransomware from encrypting your files. This tool does not prevent the infection itself. STOP ransomwar

16 May 31, 2022

A Python3 script to decode an encoded VBScript file, often seen with a .vbe file extension

vbe-decoder.py Decode one or multiple encoded VBScript files, often seen with a .vbe file extension. Usage usage: vbe-decoder.py [-h] [-o output] file

147 Nov 15, 2022

Encode and decode cancro lang files to and from brainfuck

cancrolang Encode and decode cancro lang files to and from brainfuck. examples python3 main.py -f hello.cancro --run Hello World! the interpreter is n

1 Dec 20, 2021

Telop - Encode and decode messages using an interpretation of the telegraphic code devised by José María Mathé

telop Telop (TELégrafoÓPtico) - Utilidad para codificar y descodificar mensajes de texto empleando una interpretación del código telegráfico ideado po

4 Nov 1, 2022

With the initiation of the COVID vaccination drive across India for all individuals above the age of 18, I wrote a python script which alerts the user regarding open slots in the vicinity!

cowin_notifier With the initiation of the COVID vaccination drive across India for all individuals above the age of 18, I wrote a python script which

13 Aug 1, 2021

Simple and easy to use python API for the COVID registration booking system of the math department @ unipd (torre archimede)

Simple and easy to use python API for the COVID registration booking system of the math department @ unipd (torre archimede). This API creates an interface with the official browser, with more useful functionalities.

4 Dec 24, 2021

Python NZ COVID Pass Verifier/Generator

Python NZ COVID Pass Verifier/Generator This is quick proof of concept verifier I coded up in a few hours using various libraries to parse and generat

12 Jan 3, 2023

Vaksina - Vaksina COVID QR Validation Checker With Python

Vaksina COVID QR Validation Checker Vaksina is a general purpose library intende

33 Aug 20, 2022

Python library to decode the EU Covid-19 vaccine certificate

Related tags

Overview

DCC Utils

Setup

Usage

Parse DCC

Validate DCC digital signature

Evaluate CertLogic business rules

Dev setup

EU Digital COVID Certificate Specifications

Sample data

Credits

License

You might also like...

A Tool to validate domestic New Zealand vaccine passes

Vaccine for STOP/DJVU ransomware, prevents encryption

A Python3 script to decode an encoded VBScript file, often seen with a .vbe file extension

Encode and decode cancro lang files to and from brainfuck

Telop - Encode and decode messages using an interpretation of the telegraphic code devised by José María Mathé

With the initiation of the COVID vaccination drive across India for all individuals above the age of 18, I wrote a python script which alerts the user regarding open slots in the vicinity!

Simple and easy to use python API for the COVID registration booking system of the math department @ unipd (torre archimede)

Python NZ COVID Pass Verifier/Generator

Vaksina - Vaksina COVID QR Validation Checker With Python

Releases(v0.2.1)

v0.2.1(Jan 4, 2022)

v0.2.0(Dec 21, 2021)

v0.1.0(Dec 14, 2021)

Owner

Developers Italia

Ikaros is a free financial library built in pure python that can be used to get information for single stocks, generate signals and build prortfolios

Keyboard Layout Change - Extension for Ulauncher

This is a survey of python's async concurrency features by example.

DSG - Source code for Digital Scholarship Grant project.

Material de apoio da oficina de SAST apresentada pelo CAIS no Webinar de 28/05/21.

Pyhexdmp - Python hex dump module

A clock widget for linux ez to use no need for cmd line ;)

About A python based Apple Quicktime protocol，you can record audio and video from real iOS devices

Simple Python API for the Ergo Platform Explorer

TextColor - An easy to use Python library which allows you to make your terminal outputs more colorful and therefore easier to read and understand

Python package for reference counting native pointers

Automated rop chain generation

WordlistPasswordGenerator - Shuhfab Basheer

jonny is a stack based programming language

Pre-crisis Risk Management for Personal Finance

pybind11 — Seamless operability between C++11 and Python

Customizable-menu-python - User customizable menu in Python

A collection of resources on neural rendering.

Streamlit component to display topics from Streamlit's community forum related to any exception.

Simple AoC helper program you can use to develop your own solutions in python.