Proposta di standardizzazione per naming e descrizione e-service PDND

[gianpaolo-tndigit]

Descrizione
Per favorire la massima interoperabilità sulla Misura 1.3.1, proponiamo di uniformare la pubblicazione degli e-service su PDND. Attualmente, l'inserimento del nome dell'Ente nei titoli (es. "Regione X") risulta ridondante, poiché tale dato è già esplicitato dalla piattaforma.

Obiettivo
In attesa dei template ufficiali del Credential Issuer, è fondamentale adottare fin da ora un approccio coerente per evitare frammentazione semantica nel Catalogo e facilitare le future integrazioni.

Soluzione proposta
Si suggerisce di adottare le seguenti buone pratiche per ogni nuova pubblicazione:

1. Seguire le linee guida nazionali per la nomenclatura e la descrizione degli e-service PDND.
2. Rimuovere il nome dell'Ente dai titoli, puntando esclusivamente sulla funzione (es: Consultazione badge dipendente - IT-Wallet).
3. Standardizzare le descrizioni per evidenziare il legame diretto con la generazione degli Attestati Elettronici.

[gaecapdtd]

Si suggerisce di seguire le linee guida PDND emanate da AgID, allegato 7, https://www.agid.gov.it/sites/agid/files/2025-06/Linee_guida_PDND_v2_allegato_7.pdf

@RosaliaGaleano @ChiaLeon

[rtlgentili]

@gaecapdtd @RosaliaGaleano @ChiaLeon
Buongiorno a tutti,
seguendo il manuale aggiornato che ci è stato notificato
https://github.com/italia/eid-wallet-it-docs/blob/versione-corrente/handbooks/it/authentic-sources/manuale-titolare-fonte-autentica.md
in merito alla nomenclatura dei servizi, non più modificale post pubblicazione, viene indicato:

_

Si consiglia di nominare l'e-service in "Creazione EAA [Nome / Nome tipologia EAA] – IT-Wallet" (es. "Creazione EAA Patente di guida – IT-Wallet" oppure "Creazione EAA Titoli di studio – IT-Wallet") e di predisporre una descrizione in linea con le Linee Guida sull’infrastruttura tecnologica della PDND per l’interoperabilità dei sistemi informativi e delle basi di dati (Allegato 7 - Regole di popolamento) emanate da AgID.

_

che non sarebbe del tutto conforme con le LG AGID:
https://www.agid.gov.it/sites/agid/files/2025-06/Linee_guida_PDND_v2_allegato_7.pdf

Come direttiva per la misura 1.3.1 IT-Wallet quindi seguiamo quanto "consigliato" nel Manuale Titolare Fonte Autentica o il "dovrebbe" delle LG Agid?
Grazie ancora.

[alessandrovolpi-puntozero]

Buongiorno,
noi avevamo letto dalle specifiche tecniche https://italia.github.io/eid-wallet-it-docs/versione-corrente/it/e-service-pdnd-template.html#parametri-del-template-per-fonte-autentica che il Fornitore di Attestati Elettronici avrebbe pubblicato il template dell'e-service nel portale PDND. Sempre nelle specifiche era riportato che il nome dell'e-service doveva rispettare questa proprietà:

Name: IT Wallet - Fonte Autentica - <Nome dell'Attestato Elettronico>

Attualmente però nel catalogo PDND di collaudo è presente solo un template , relativo ad attestazioni elettroniche di tipo badge, che nel nome presenta questa regola:

Creazione EAA Badge – IT-Wallet - <Parola identificativa dell'e-service>

Quest'ultima opzione di nomenclatura (in linea con il manuale delle fonti autentiche), ad una prima lettura, sembra rispettare le regole dell'allegato 7.

AZIONE	OGGETTO	PROGETTO/BASE DATO	CODICE identificativo
Creazione	EAA Badge	IT-Wallet	<Parola identificativa dell'e-service>

[rtlgentili]

@alessandrovolpi-puntozero Buongiorno, in realtà non esattamente, ma ci atterremo a quanto indicato nel manuale.

[alessandrovolpi-puntozero]

Anche noi come PuntoZero (per conto di Regione Umbria) ci atterremo alle indicazioni del manuale. A questo proposito, per confrontarci, quale punto specifico non vi sembra pienamente allineato all'allegato 7?

[RosaliaGaleano]

concordo con @alessandrovolpi-puntozero

[rtlgentili]

Secondo https://www.agid.gov.it/sites/agid/files/2025-06/Linee_guida_PDND_v2_allegato_7.pdf
Pattern:

Le Azioni previste dovrebbero essere RICERCA, CONSULTAZIONE,VERIFICA,INVIO. Non indicata la Creazione.

Dunque l'esempio di applicazione della Regola di popolamento:
RICERCA_Attestato Qualifica Livello 3 EQF - IT-Wallet

Ad ogni modo come già detto prima, in Produzione seguiremo il suggerimento della versione del Manuale Enti pubblicato e quindi le API avranno titolo (ricordo non modificabile e che non può superare i 60 caratteri) come l'esempio seguente:
Creazione EAA Qualifica Livello 3 EQF - IT-Wallet

[sara-gasperetti]

Buongiorno,
IPZS ha pubblicato il template relativo al badge dei dipendenti definendo nome e descrizione.

Nome: Creazione EAA Badge – IT-Wallet
Descrizione: Il servizio consente la trasmissione dei dati per l'emissione e la gestione delle attestazioni elettroniche di tipo Badge all’interno di IT-Wallet.

Sebbene questi elementi non siano pienamente conformi alle Linee Guida (il nome contiene l'azione non prevista "Creazione" e la descrizione non segue la struttura standard "Dato x, l'e-service restituisce y"), ritengo opportuno adottare lo "stile" del template di IPZS per garantire l'allineamento futuro.

A partire da questo esempio noi andremo a definire gli altri servizi in questo modo.

Patenti di servizio

Nome: Creazione EAA Patenti di servizio – IT-Wallet
Descrizione: Il servizio consente la trasmissione dei dati per l'emissione e la gestione delle attestazioni elettroniche di tipo Patenti di servizio all’interno di IT-Wallet.

Abilitazione fitosanitaria (utilizzo professionale)

Nome: Creazione EAA Abilitazione fitosanitaria acquisto –IT-Wallet (Purtroppo la limitazione del nome di 60 caratteri non ci permette di essere precisi inserendo la dicitura "utilizzo professionale" anzichè "acquisto").
Descrizione: Il servizio consente la trasmissione dei dati per l'emissione e la gestione delle attestazioni elettroniche di tipo Abilitazione fitosanitaria per l'utilizzo professionale all’interno di IT-Wallet.

Abilitazione fitosanitaria (vendita)

Nome: Creazione EAA Patenti di servizio – IT-Wallet
Descrizione: Il servizio consente la trasmissione dei dati per l'emissione e la gestione delle attestazioni elettroniche di tipo Abilitazione fitosanitaria per la vendita all’interno di IT-Wallet.

API statistica

Per quanto riguarda l'API statistica ci atteremo al template del DTD.
Nome: Consultazione Statistiche "Entra con IT-Wallet"
Descrizione: Il servizio consente di consultare le statistiche di utilizzo del sistema "Entra con IT‑Wallet".

[sara-gasperetti]

Integro la mia precedente risposta per chiarire la necessità che ogni amministrazione denomini in modo univoco i propri e-service. Di seguito, illustro i due scenari possibili utilizzando l'esempio del badge dipendente.

Scenario 1: Erogazione E-service senza Template

In attesa di adeguamento al modello dati proposto e di implementazione del template, l'intenzione iniziale era di denominare il servizio allo stesso modo del template per mantenere coerenza. Ho provato a creare un nuovo e-service senza implementare il template pubblicato da IPZS. Tuttavia, non è stato possibile chiamare il servizio "Creazione EAA Badge – IT-Wallet" poiché la PDND ha restituito l'errore: "An EService template with name Creazione EAA Badge – IT-Wallet already exists". Questo conferma che non è permesso assegnare al servizio lo stesso nome di un template esistente.

Scenario 2: Erogazione E-service con Template

Ho quindi tentato di creare l'e-service implementando il template. In questo caso, il nome dell'e-service non è modificabile, ma è possibile aggiungere una parola che identifichi univocamente l'e-service. In pratica, viene aggiunto un suffisso al nome. Le opzioni sono due:

• aggiungere il nome (o l'acronimo) dell'ente erogatore, anche se non siamo del tutto convinti della correttezza di tale approccio, dato che l'ente erogatore è già identificabile tramite l'apposito campo;
• lasciare vuoto il campo in modo che il nome del servizio combaci con il nome del template: questa strada ci convince maggiormente per dare omogeneità ai servizi esposti.