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

Library to generate random strings from regular expressions.

A simple and easy to use Python's PIP configuration manager, similar to the Arch Linux's Java manager.

simple password manager.

nbsafety adds a layer of protection to computational notebooks by solving the stale dependency problem when executing cells out-of-order

Install packages with pip as if you were in the past!

This python script extracts all the video URLs from any youtube channel. Then it extracts all the information like the name of the youtube channel, published date, likes, dislikes, comments, views, etc for all the videos in that channel.

Custom component to calculate estimated power consumption of lights and other appliances

A script where you execute a script that generates a base project for your gdextension

RDFLib is a Python library for working with RDF, a simple yet powerful language for representing information.

Python Service for MISP Feed Management

Age of Empires II recorded game parsing and summarization in Python 3.

Org agenda in the console

Media Cloud Outlet Filtering

Python3 Interface to numa Linux library

Project for viewing the cheapest flight deals from Netherlands to other countries.

Data types specify the different sizes and values that can be stored in the variable. For example, Python stores numbers, strings, and a list of values using different data types. Learn different types of Python data types along with their respective in-built functions and methods.

HiQ - A Modern Observability System

program to store and update pokemons using SQL and Flask

Larvamatch - Find your larva or punk match.

A reminder for stand-up roster