Digital Green Certificate SDK PHP
Indice
Contesto
Attenzione, questo repository è derivato dalle specifiche presenti in ministero-salute/it-dgc-verificac19-sdk-android!
L'elenco le librerie utilizzabili è presente in questa lista. La pagina contiene anche informazioni sulle policy di accettazione e rimozione dalla lista stessa. Fate riferimento ad essa prima di utilizzo in ambienti di produzione.
Questo repository contiene un Software Development Kit (SDK), che consente di integrare nei sistemi le funzionalità di verifica della Certificazione verde COVID-19, mediante la lettura del QR code.
Trattamento dati personali
Il trattamento dei dati personali svolto dalle soluzioni applicative sviluppate a partire dalla presente SDK deve essere effettuato limitatamente alle informazioni pertinenti e alle operazioni strettamente necessarie alla verifica della validità delle Certificazioni verdi COVID-19. Inoltre è fatto esplicito divieto di conservare il codice a barre bidimensionale (QR code) delle Certificazioni verdi COVID-19 sottoposte a verifica, nonché di estrarre, consultare, registrare o comunque trattare per finalità ulteriori rispetto a quelle previste per la verifica della Certificazione verde COVID-19 o le informazioni rilevate dalla lettura dei QR code e le informazioni fornite in esito ai controlli, come indicato nel DPCM 12 ottobre 2021
Requisiti
- PHP >= 7.4
Installazione
E' necessario clonare questo progetto, nel seguente modo:
your_project_folder
|___sdk_repo_folder
a questo punto lanciare all'interno della cartella sdk_repo_folder il comando
composer install
e settare i permessi della cartella sdk_repo_folder\assets in modo tale che il webserver possa leggere, creare ed editare i file contenuti in essa.
Uso
L'applicazione di verifica dovrà importare la cartella vendor dell'SDK.
require __DIR__ . '/sdk_repo_folder/vendor/autoload.php';
A questo punto è possibile utilizzare una libreria di scansione di QR Code a scelta che, dopo aver letto un QR Code di un EU DCC, passi la stringa estratta al validatore Herald\GreenPass\Utils\CertificateValidator.
Esempio:
...
require __DIR__ . '/sdk_repo_folder/vendor/autoload.php';
use Herald\GreenPass\Utils\CertificateValidator;
$gp_string = 'HC1:6BF.......';
$gp_reader = new CertificateValidator($gp_string);
$gp_info = $gp_reader->getCertificateSimple();
// Mostro la struttura dell'esito validazione
echo "<pre>" . print_r($gp_info, true) . "</pre>";
...
Osservando la risposta del metodo è restituito un oggetto Herald\GreenPass\Model\CertificateSimple che contiene il risultato della verifica. Il data model contiene i dati relativi alla persona, la data di nascita, il timestamp di verifica e lo stato della verifica.
Basandosi su questi dati è possibile disegnare la UI e fornire all'operatore lo stato della verifica del DCC.
Contributori
Qui c'è una lista di contributori. Grazie per essere partecipi nel miglioramento del progetto giorno dopo giorno!
Licenza
Dettaglio Licenza
La licenza per questo repository è una Apache License 2.0. All'interno del file LICENSE sono presenti le informazioni specifiche.
81 Nov 4, 2022
12 Dec 26, 2022
0 Aug 10, 2022
1.9k Jan 3, 2023
43 Nov 29, 2022
17 Nov 7, 2022
74 Nov 15, 2022
7 May 8, 2022
1.5k Dec 28, 2022
77 Nov 29, 2022
4 Sep 15, 2022
3 Dec 30, 2021
5 Dec 2, 2021
462 Jan 2, 2023
3.1k Dec 30, 2022
7 Nov 23, 2022
493 Dec 16, 2022
804 Dec 19, 2022