🛠️
Opencity Italia
Sviluppatori e partner tecnologici
Sviluppatori e partner tecnologici
  • Introduzione
  • Architettura
    • Pattern: microservizi
    • Pattern: event sourcing
    • Vista generale
  • Standard e convenzioni
    • Standard della piattaforma
    • Microservizi
  • Roadmap
  • Integrazioni
    • Integrazione Widget servizio (FormIO)
    • Integrazioni con il flusso delle pratiche
      • API ReST
      • Webhooks
    • Modello di integrazione con l'area personale
    • Integrazione con Intermediari di pagamento PagoPA
      • Requisiti per l'integrazione
      • Il Pagamento
        • Versione 1.0
        • Versione 2.0
      • Schema di Funzionamento
      • Configurazione dei pagamenti
        • API v1
        • API v2
      • Un pagamento in dettaglio
      • Gli stati di un pagamento
      • Processo di sviluppo
      • Implementazione di un proxy
    • Integrazione con Protocollo Informatico
      • Requisiti per l'integrazione
      • Documento digitale
        • Esempio documento con allegati non protocollato
        • Esempio documento con allegati protocollato
        • Esempio documento con campo retry_meta prodotto dal protocol proxy
        • Esempio documento con campo retry_meta modificato dal sistema di retry
        • Usecase: Il Documento originato dalle pratiche dai servizi digitali
        • Stati del documento
      • Architettura del sistema di protocollazione
      • WorkFlow sistema di protocollazione
        • Configurazione tenant e servizi
      • Protocol Proxy: Specifiche Implementative
      • Processo di sviluppo
    • Integrazione con PDND
      • Introduzione
      • Integrazione tecnica tra OpenCity, PDND Connector e PDND
      • Definizione API PDND Connector
    • Integrazioni con il Sito Istituzionale
    • Single Sign-On
      • SSO mediante oAuth2
      • SSO mediante JWT
    • Processi asincroni (job)
      • Importazione dovuti
    • Integrazione di un servizio di terze parti protetto da autenticazione
      • Esempio con GovWay
  • 👩‍💻Sviluppo
    • Multilingua
    • Temi grafici
Powered by GitBook
LogoLogo

Opencity Labs

  • Sito web
  • Product page

Developers Italia

  • Sito web
  • Area personale e Servizi Digitali

Documentazione Opencity Italia

On this page
  • Contesto Generale e Obiettivi
  • Cos'è la PDND e a Cosa Serve:
  • Attori Principali Coinvolti:
  • Requisiti per l'integrazione
  • E-service
  • Client
  • Finalità
  • Voucher
  • Nested Form
  • ID Chiave (KID), ID Client (Client ID), ID Finalità (Purpose ID / ParID)

Was this helpful?

Export as PDF
  1. Integrazioni
  2. Integrazione con PDND

Introduzione

PreviousIntegrazione con PDNDNextIntegrazione tecnica tra OpenCity, PDND Connector e PDND

Last updated 1 day ago

Was this helpful?

Contesto Generale e Obiettivi

Cos'è la PDND e a Cosa Serve:

  • E’ l'infrastruttura digitale italiana che facilita l'interoperabilità tra sistemi informativi delle Pubbliche Amministrazioni.

  • Il suo scopo primario è condividere dati in modo sicuro, standard e trasparente.

  • E' uno dei due approcci adottati da Opencity Italia per implementare il principio del (o one-time entry), evitando di chiedere al cittadino dati già in possesso di altre PA (es. residenza, stato famiglia da ANPR).

Attori Principali Coinvolti:

  • PDND: La piattaforma centrale che gestisce le interazioni e la sicurezza.

  • Erogatori: Gli enti che mettono a disposizione i dati tramite e-service (es. ANPR, INPS).

  • Fruitori: Gli enti (come i Comuni, che usano OpenCity) che hanno bisogno di accedere a questi dati.

  • La Piattaforma (OpenCity): L'interfaccia lato ente e cittadino dove i dati vengono visualizzati e usati.

  • PDND Connector: Il microservizio chiave che funge da ponte tra OpenCity e l’ecosistema PDND (compresi gli enti erogatori). Ha il compito di:

    • Gestire le configurazioni e il materiale crittografico degli enti fruitori;

    • Interagire con la PDND, per conto dei fruitori, al fine di ottenere i voucher di sicurezza;

    • Utilizzare i voucher per accedere in modo sicuro agli e-service esposti via API dagli enti erogatori, garantendo che ogni cittadino acceda a tutti e soli i dati di sua pertinenza.

    • Garantire la conservazione dei voucher secondo le .

    In sintesi, il PDND Connector centralizza la logica di integrazione e sicurezza, permettendo a OpenCity di comunicare con la PDND in modo trasparente, conforme e scalabile.

Requisiti per l'integrazione

E-service

Non sono generici servizi API, ma specifici servizi erogati dagli enti che forniscono dati ben definiti (es. "C021 - Accertamento Stato Famiglia" da ANPR). Possono avere diverse versioni, per poter essere utilizzati bisogna farne richiesta e in seguito associarli ad una finalità.

Client

Un oggetto di configurazione fondamentale sulla PDND e su OpenCity. Raggruppa le informazioni necessarie per gestire e amministrare gli e-service che un ente (fruitore) vuole usare. L'ente, configurando il client di Opencity Italia, può accedere a tutti gli e-service che si vogliono integrare nei servizi digitale. Per poter utilizzare gli e-service, il client deve essere associato alle relative finalità.

Finalità

Il motivo (anche legale) per cui un ente richiede l'accesso a un determinato e-service. È strettamente legata a uno o più e-service e richiede una specifica "Analisi del rischio". Per ampliare l'adozione della PDND, la piattaforma consente di creare tanti servizi digitali utilizzando una singola finalità.

Voucher

Un token di sicurezza temporaneo che il PDND Connector ottiene dalla PDND. Questo voucher è essenziale perché funge da credenziale per autenticarsi e autorizzarsi direttamente presso l'ente erogatore quando si chiede il dato tramite l'e-service. Il voucher è relativo ad uno specifico client, una specifica finalità e una specifica coppia chiavi di crittografia.

Nested Form

Il componente sulla nostra piattaforma che riceve e visualizza i dati ottenuti tramite la PDND. Alcune proprietà nel suo codice definiscono quale e-service utilizzare e quali campi specifici riceveranno i dati PDND certificati.

ID Chiave (KID), ID Client (Client ID), ID Finalità (Purpose ID / ParID)

Sono gli identificativi cruciali ottenuti dalla piattaforma PDND dopo aver configurato Client, Chiave Pubblica e Finalità. Vanno copiati dalla PDND e inseriti nella configurazione del Client corrispondente sulla nostra piattaforma.

linee guida
once-only