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

management tool for systemd-nspawn containers

This program generates automatically new folders containing old version of program

A collection of existing KGQA datasets in the form of the huggingface datasets library, aiming to provide an easy-to-use access to them.

Code needed for hybrid land cover change analysis for NASA IDS project

Draw random mazes in python

A script to generate NFT art living on the Solana blockchain.

AdventOfCode 2021 solutions from the Devcord server

Este projeto se trata de uma análise de campanhas de marketing de uma empresa que vende acessórios para veículos.

A subleq VM/interpreter created by me for no reason

A simple countdown timer in eazy code to show timer with python

Headless chatbot that detects spam and posts links to it to chatrooms for quick deletion.

An audnexus client, providing rich author and audiobook data to Plex via it's legacy plugin agent system.

Kubernetes-native workflow automation platform for complex, mission-critical data and ML processes at scale. It has been battle-tested at Lyft, Spotify, Freenome, and others and is truly open-source.

For my Philips Airpurifier AC3259/10

Access Modbus RTU via API call to Sungrow WiNet-S

CNKD - Minimalistic Windows ransomware written in Python

Python Control Systems Library

E5自动续期

Xoroshiro-cairo - A xoroshiro128** pseudorandom number generator implementation in Cairo

This is Gaurav's IP Project Completed in the year session of 2021-2022.