Piattaforma abilitante
PDND
Piattaforma Digitale Nazionale Dati
Abilita l'interoperabilità dei sistemi informativi degli enti e dei gestori di servizi pubblici
Cos’è e quali vantaggi offre
La Piattaforma Digitale Nazionale Dati (PDND) è parte dell’ecosistema interoperabilità ed è lo strumento per gestire l’autenticazione, l’autorizzazione e il tracciamento dei soggetti abilitati per garantire la sicurezza delle informazioni. Fornisce un insieme di regole condivise per semplificare gli accordi di interoperabilità snellendo i processi di istruttoria, riducendo oneri e procedure amministrative.
PDND, inoltre, mette a disposizione il Catalogo API, che espone tutti gli e-service pubblicati dagli enti e tramite cui è possibile effettuare la richiesta di fruizione dati e successivamente integrare i propri servizi per i cittadini.
La finalità della piattaforma è la totale interoperabilità dei dataset e dei servizi chiave tra le PA centrali e locali, che consentirà di realizzare il principio “once-only” (la PA non deve chiedere a cittadini e imprese dati che già possiede) e di valorizzare il capitale informativo delle pubbliche amministrazioni.
La piattaforma offre numerosi vantaggi agli utenti:
- Gli erogatori, che rendono disponibili e-service per l’accesso ai loro dati, hanno garantita la sicurezza dello scambio di dati e una standardizzazione dei processi
- I fruitori accedono al catalogo degli e-service disponibili e possono integrare le API nei loro servizi a cittadini e imprese
- I tecnici sviluppatori, che implementano e gestiscono il ciclo di vita degli e-service di un’amministrazione, possono fare integrazioni standard grazie alla piattaforma
- I responsabili della protezione dei dati degli Enti aderenti possono accedere a documenti amministrativi standard e garantire un processo uniforme per tutti gli enti
- Imprese e cittadini possono veder realizzato il principio del once-only, evitando di dover fornire informazioni già comunicate in precedenza alla PA
Cosa trovi su PDND
- L’elenco dei soggetti aderenti a PDND
- Il catalogo degli e-service dei quali si può fare richiesta di fruizione agli enti
- Gli attributi necessari per poter accedere ai singoli e-service
- Le finalità per cui vengono inoltrate le richieste di fruizione
- Il meccanismo di rilascio dei token
- Le chiavi pubbliche
Come puoi aderire
- Effettua il login con SPID
- Seleziona il tuo ente e controlla i dati precompilati da IPA
- Indica il legale rappresentante
- Indica gli amministratori per la piattaforma PDND
- Ricevi la PEC e carica l’accordo di adesione firmato
Come funziona
-
L’Erogatore pubblica un e-service sul catalogo
-
Il Fruitore accede al catalogo e inoltra richiesta di fruizione per e-service
-
L’Erogatore attiva richiesta di fruizione per e-service
-
Il Fruitore crea le finalità con stima di carico per e-service
-
Il Fruitore carica una chiave pubblica e ottiene un voucher
-
Il Fruitore Completa l’integrazione e accede al dato dell’Erogatore
Canali
Se hai problemi di back office, puoi rivolgerti all’assistenza dedicata sulla piattaforma PDND.
Per tutte le altre problematiche di natura tecnica, come errori legati allo stacco del voucher (token JWT) oppure proposte di miglioramento, puoi utilizzare l’apposita repository Github.
Risorse
In questa sezione hai a disposizione una serie di risorse utili per approfondire le origini normative e tecniche della PDND e per sviluppare progetti che le utilizzano.
La Normativa ti permette di chiarire il contesto in cui è stata istituita e gli adempimenti necessari per gli enti coinvolti, mentre la Documentazione fornisce informazioni più dettagliate sui componenti e sulle modalità d’uso.
Se sei un developer in Strumenti ed Esempi, in parte sviluppati da Developers Italia, puoi trovare supporto tecnico.
Nell’Archivio puoi consultare materiale utile a ricostruire la storia di come è nata la PDND.
-
Manuale operativo PDND
Manuale della piattaforma PDND che comprende videotutorial
-
Linee guida modello interoperabilità (ModI)
Indicazioni, standard e tecnologie da rispettare per permettere l'interoperabilità
-
Guida all'utilizzo delle regole per il controllo automatico di specifiche OpenAPI secondo il ModI
Istruzioni per verificare automaticamente che le interfacce Open API degli e-service da pubblicare su PDND rispettino le principali regole del ModI
-
Guida alla pubblicazione di e-service per WaaS
Guida di INPS per supportare i comuni nella pubblicazione di e-service "Welfare as a Service", che alimentano il SIUSS
-
Esempio di API
Esempio di implementazione di un’API
-
Specifiche API per le Università
Specifiche API relative alla misura 1.3.1 per l’avviso Università e AFAM
-
API OAS Checker
Analizza le specifiche OpenAPI di un’API REST e individua eventuali difformità rispetto alle regole tecniche Agid
-
Regole per il controllo automatico di specifiche OpenAPI secondo il ModI
Regole Spectral per verificare automaticamente che le interfacce Open API degli e-service da pubblicare su PDND rispettino le principali regole del ModI
-
(2019) Using OpenAPI to standardize the Italian API ecosystem - slide (en)
Presentazione dello storico di API e Interoperabilità nel contesto italiano
-
(2020) Using OpenAPI to standardize the Italian API ecosystem - video (en)
Video dello storico di API e Interoperabilità nel contesto italiano
-
(2022) Design secure APIs - slide (en)
Presentazione utile per lo sviluppo di API
-
(2022) Videointervista e demo di API OAS Checker/Validatore sintattico - video (en)
Video intervista sul Validatore sintattico
-
(2022) Community lab su API design e API canvas - slide
Presentazione utile per lo sviluppo di API interoperabili nel rispetto delle Linee guida Agid
-
(2022) Community lab su API design e API canvas - video
Video utile per lo sviluppo di API interoperabili nel rispetto delle Linee guida Agid
-
(2022) Self-explaining APIs - slide (en)
Presentazione che racconta l'approccio semantico alla progettazione di API interoperabili
-
Validatore sintattico - articolo Medium
Articolo di presentazione del Validatore sintattico