Ottenere il permesso di accesso (token)

Prima di poter interrogare qualsiasi banca dati, il software dell’ente deve dimostrare la propria identità e ottenere un permesso temporaneo, chiamato tecnicamente token. Non è previsto l’uso di una semplice password o di una «chiave segreta» da conservare: il meccanismo usato è pensato per essere più sicuro.

Come funziona

Il client possiede una chiave privata, nota solo a lui, e ne ha registrata la controparte pubblica presso il sistema di autenticazione. Il client usa la propria chiave privata per firmare una dichiarazione che dice, in sostanza, «sono io»; chi riceve questa dichiarazione può verificarla con la chiave pubblica corrispondente, senza che la chiave privata debba mai essere condivisa o trasmessa.

Passaggi

I passaggi, in ordine:

  • il software dell’ente invia al sistema di autenticazione una dichiarazione d’identità firmata con la propria chiave privata;

  • il sistema di autenticazione verifica la firma usando la chiave pubblica registrata per quel client;

  • se la verifica ha successo, viene rilasciato un token di accesso valido per un tempo limitato;

  • il software invia la richiesta dati alle API GovDesk M2M allegando il token;

  • GovDesk verifica il token e riconosce l’organizzazione, il client e l’operatore per conto del quale la richiesta viene fatta;

  • GovDesk risponde con il dato richiesto o con un errore.

Cose da tenere presenti

  • il token non dura per sempre: ha una validità limitata nel tempo, dopo la quale il client deve richiederne uno nuovo ripetendo la stessa procedura;

  • nel token viaggia l’identità del client (cioè del software/organizzazione), mentre l’eventuale operatore che ha avviato l’azione all’interno del client viene indicato separatamente dal software stesso;

  • ogni richiesta fatta con un token viene registrata nell’audit di GovDesk, sia in caso di successo sia in caso di errore, ed è consultabile dalla sezione Audit del portale insieme alle richieste degli operatori;

  • ogni richiesta concorre alla soglia di chiamate giornaliere dichiarata in fase di richiesta del purpose: superata la soglia le richieste successive vengono rifiutate fino al giorno successivo.