italia / cie-nis-python-sdk

SDK for reading the NIS code from an Italian Electronic Identity Card (CIE) using Python
BSD 3-Clause "New" or "Revised" License
31 stars 11 forks source link
cie pyscard smartcard

Python CIE3 SDK Build Status Open Source Love

Libreria leggera e portabile in Python per l'estrazione delle informazioni contenute nella CIE 3.0, con e senza autenticazione EAC.

Installazione

Per iniziare installa tutte le dipendenze tramite il gestore di pacchetti pip, con il comando:

pip install -r requirements.txt

Esempio

Il file main.py contiene un brevissimo esempio che mostra l'estrazione dei dati dalla CIE tramite autenticazione EAC.

Struttura

L'intera libreria è strutturata attorno alla classe CIEInterface che espone molti metodi utili per inviare comandi alla CIE.

Al momento della creazione di un'istanza di CIEInterface, il costruttore tenterà di aprire una connessione con un lettore NFC compatibile e si metterà in attesa di rilevare una carta. Il massimo tempo di attesa è attualmente di 3 secondi.

Una volta rilevata la carta il costruttore termina l'esecuzione.

I metodi a disposizione dell'utilizzatore sono i seguenti:

Supporto

La libreria è stata testata con successo su Python 2.7.16 e Python 3.8.2 su sistema macOS 10.15.7, ma vista la semplicità è molto probabile che funzioni nativamente anche su altre versioni.