Vérification de pass sanitaire
==============================

Ce script permet de contrôler la validité d'un pass sanitaire
européen, tel que le fait l'application TAC-Vérif lors de
la crise sanitaire de Covid-19 en 2021.


Dépendances
-----------

Le script requiert Python >= 3.6 avec les modules :

 * cbor2
 * cryptography


Usage
-----

.. code:: bash

   ./main.py [file] [--full] [--dontcheck]

Le script prend en entrée un QR code au format textuel, et affiche l'état
de validité du pass sanitaire.

Le QR code doit être donné dans sa version textuelle.
Il peut être combiné avec des outils tels que ``zbar``.
Si vous disposez d'une webcam :

.. code:: bash

   zbarcam -1 --raw | ./main.py

Ou en cas de QR code sur une image :

.. code:: bash

   zbarimg -1 --raw [file] | ./main.py


En mode normal, seuls le nom, le prénom et la date de naissance sont
affichés, sous réserve de pass valide. Avec l'option ``--full``,
les informations de vaccination ou de test sont affichées.

Enfin, l'option ``--dontcheck`` saute la vérification de la signature.
Cela peut être utile si vous ne disposez pas des certificats de signature.


Vérification de signature
-------------------------

Les certificats de signature n'étant pas publics, ils ne sont pas partagés
avec le code. De fait, si vous ne les possédez pas, vous ne pourrez pas
vérifier les signatures, et vous devrez utiliser l'option ``--dontcheck``.

Pour installer des certificats, placez-les dans le dossier ``certs`` avec
pour nom ``{{{KID}}.pem``, où ``{{KID}}`` est l'identifiant du certificat.
Si ``{{KID}}`` contient un ``/``, remplacez-le par un ``_``.


Modalités d'utilisation
-----------------------

Ce module peut être utilisé à des fins privés afin de mieux comprendre
la structure d'un pass sanitaire et des données stockées, mais ne peut pas
être utilisé pour contrôle tel que la loi n° 2021-1040 le précise.

Merci d'utiliser l'application officielle « TousAntiCovid - Vérif » sur
téléphone pour une utilisation normale de vérification de pass sanitaire,
si vous êtes autorisé⋅e à l'utiliser.