Configurazione dei client PDND — approfondimento

Questa pagina descrive le procedure per creare su PDND i due client applicativi utilizzati da GovDesk e associarli alle chiavi pubbliche generate in piattaforma nella sezione Credenziali PDND:

  • Client E-Service, utilizzato per la fruizione degli E-Service PDND;

  • Client API Interop, utilizzato per le operazioni amministrative tramite le API di Interoperabilità PDND.

Le procedure sono simmetriche: cambia solo la sezione di gestione PDND in cui operare (API E-Service oppure API Interop).

Configurazione del client E-Service

Accedere al portale PDND selezionando l’ambiente di produzione.

Creazione del client

  1. Aprire la sezione Gestione dei client → API E-Service.

  2. Selezionare Crea nuovo.

  3. Nella sezione Informazioni generali:

    • inserire Client GovDesk sia nel campo Nome sia nel campo Descrizione.

  4. Nella sezione Membri del client:

    • selezionare il pulsante Aggiungi;

    • nel campo Utenti selezionati associare la propria utenza;

    • è consigliato associare anche gli altri amministratori PDND dell’ente, in modo che tutti abbiano visibilità del nuovo client E-Service;

    • concludere il procedimento cliccando su Aggiungi.

  5. Completare selezionando Crea.

Associazione della chiave pubblica

  1. Selezionare Chiavi pubbliche e Aggiungi.

  2. Inserire:

    • nel campo Nome della chiave: GovDesk;

    • nel campo Chiave pubblica: l’intero contenuto presente su GovDesk nella sezione Chiave pubblica.

  3. Completare selezionando Inserisci.

Importante

Al fine di una corretta configurazione, il testo della chiave pubblica non deve essere modificato in alcun modo.

Raccolta di kid e clientId

  1. Una volta creata la chiave, cliccare su Visualizza per raccogliere le informazioni necessarie alla configurazione.

  2. Annotare i codici:

    • ID della chiave (kid);

    • ID del client (clientId).

  3. Copiare i valori nei rispettivi campi su GovDesk nella sezione Client E-Service.

Suggerimento

Utilizzare il pulsante Copia accanto alla chiave pubblica per copiarla facilmente negli appunti.

Configurazione del client API Interop

Accedere al portale PDND selezionando l’ambiente di produzione.

Creazione del client

  1. Aprire la sezione Gestione dei client → API Interop.

  2. Selezionare Crea nuovo.

  3. Nella sezione Informazioni generali:

    • inserire Client GovDesk sia nel campo Nome sia nel campo Descrizione.

  4. Nella sezione Membri del client:

    • selezionare il pulsante Aggiungi;

    • nel campo Utenti selezionati associare la propria utenza;

    • è consigliato associare anche gli altri amministratori PDND dell’ente, in modo che tutti abbiano visibilità del nuovo client API Interop;

    • concludere il procedimento cliccando su Aggiungi.

  5. Completare selezionando Crea.

Associazione della chiave pubblica

  1. Selezionare Chiavi pubbliche e Aggiungi.

  2. Inserire:

    • nel campo Nome della chiave: GovDesk;

    • nel campo Chiave pubblica: l’intero contenuto presente su GovDesk nella sezione Chiave pubblica.

  3. Completare selezionando Inserisci.

Importante

Al fine di una corretta configurazione, il testo della chiave pubblica non deve essere modificato in alcun modo.

Raccolta di kid e clientId

  1. Una volta creata la chiave, cliccare su Visualizza per raccogliere le informazioni necessarie alla configurazione.

  2. Annotare i codici:

    • ID della chiave (kid);

    • ID del client (clientId).

  3. Copiare i valori nei rispettivi campi su GovDesk nella sezione Client API Interop.

Nota

Il client API Interop è utilizzato per le operazioni amministrative tramite le API di Interoperabilità PDND.

Suggerimento

Utilizzare il pulsante Copia accanto alla chiave pubblica per copiarla facilmente negli appunti.