Intro

La Certificazione verde COVID-19 è una certificazione in formato digitale e stampabile, emessa dal Ministero della Salute, che contiene un codice a barre bidimensionale (QR Code) e un sigillo elettronico qualificato per verificarne autenticità e validità. L’autenticità e validità della certificazione sono verificate in Italia attraverso l’applicazione mobile ufficiale VerificaC19.

La Certificazione viene rilasciata a seguito dei seguenti eventi clinici:

• vaccinazione anti COVID-19 (in Italia viene emessa dopo ogni dose di vaccino)
• risultato negativo al test antigenico rapido nelle ultime 48 ore o al test molecolare nelle ultime 72 ore
• guarigione dal COVID-19 negli ultimi sei mesi
• esenzione dalla vaccinazione, certificato emesso a fronte di specifiche condizioni cliniche documentate.

I dati sulle certificazioni emesse in Italia sono disponibili in formato CSV e JSON su GitHub.

Maggiori informazioni sono reperibili consultando il sito https://www.dgc.gov.it.

Come contribuire

Codice della piattaforma

È possibile reperire il codice delle app di VerificaC19 per Android e iOS, del SDK ufficiale, dei vari microservizi backend, i dati sulle certificazioni emesse e la documentazione direttamente sull’organizzazione GitHub del Ministero della Salute. È possibile contribuire al codice aprendo una issue o una Pull Request per risolvere direttamente un problema.

Sviluppare e proporre un nuovo SDK

Per sviluppare un nuovo SDK basato sul SDK ufficiale VerificaC19 occorre:

1. Verificare le ultime modifiche sviluppate per il SDK ufficiale VerificaC19 consultando il CHANGELOG.
2. Consultare la checklist ufficiale per implementare le funzionalità richieste nel SDK.
3. Fare riferimento al repository della documentazione per avere informazioni dettagliate sull’implementazione del flusso di verifica e della Digital Covid Certificate Revocation List (DRL).

Si raccomanda di utilizzare il repository dgc-testdata o parte di esso, che contiene testcase utili per controllare la correttezza delle librerie. È possibile prendere spunto da uno dei SDK presenti nella lista ufficiale di SDK già aderenti alle specifiche tecniche e ai requisiti implementati dal Ministero della Salute all’interno dell’applicazione governativa VerificaC19.

Per proporre l’inserimento di una nuova libreria/SDK nella lista è necessario seguire i seguenti passi:

1. Andare sul repository it-dgc-verificac19-sdk-onboarding.
2. Scaricare dal presente repository il documento denominato autoDichiarazione.odt e compilarlo.
3. Inviare a dgsi@postacert.sanita.it l’autodichiarazione di cui al punto 1 opportunamente compilata e firmata digitalmente. Tale documento non dovrà essere incluso nel repository.
4. Pubblicare il codice sorgente della propria soluzione all’interno di un repository di titolarità del richiedente secondo le modalità indicate nel paragrafo dedicato.
5. Aprire una Pull Request all’interno del repository, fare i check delle feature richieste nel corpo della Pull Request e inserire una nuova riga nella lista inserendo le informazioni richieste.

A questo punto inizierà una fase di validazione di quanto sottoposto per verificare l’effettiva rispondenza delle specifiche tecniche e dei requisiti minimi. In caso di esito positivo, la Pull Request verrà consolidata entro pochi giorni e apparirà all’interno della lista. In caso di esito negativo, saranno fornite via email le opportune motivazioni ed eventuali suggerimenti per rendere la libreria aderente ai requisiti minimi. Eventuali aggiornamenti futuri delle librerie saranno oggetto di successive valutazioni che potrebbero portare alla rimozione della stessa dalla lista laddove non fossero rispettati i requisiti minimi.

Canali

Entra nel forum Canale Slack sviluppatori SDK (#dcc-sdk)

Risorse