Documentazione Vercert

Questa sezione contiene la documentazione tecnica di Vercert, la piattaforma per la creazione e verifica di certificati digitali tramite QR code.

La documentazione è pensata per sviluppatori e aziende che vogliono integrare la verifica dei certificati digitali nei propri sistemi, applicazioni o processi aziendali.

Guida rapida per usare VeriCert: template, certificati, verifica e revoca.

Home
Indice
Getting started Ruoli e permessi Template Certificati Verifica Revoca ed eliminazione Piani e limiti Sicurezza FAQ

Getting started

  1. Registrati sulla piattaforma: il primo utente creato diventa ADMIN del tenant.
  2. Accedi alla sezione di amministrazione per configurare template, ruoli e impostazioni.
  3. Crea uno o più template di attestato.
  4. Emetti certificati compilando il form dinamico associato al template.
  5. Distribuisci il PDF firmato e il QR code di verifica.

Ruoli e permessi

Vercert è una piattaforma multi-tenant basata su ruoli applicativi. Ogni utente appartiene a un tenant e opera secondo i permessi assegnati.

  • ADMIN: pieno controllo del tenant (utenti, template, certificati, impostazioni).
  • MANAGER: gestione operativa (template e certificati), esclusa la gestione utenti.
  • ISSUER: può emettere certificati utilizzando i template disponibili.
  • VIEWER: accesso in sola lettura ai certificati e allo stato.

Il primo utente che si registra per un tenant viene automaticamente assegnato al ruolo ADMIN. Gli utenti successivi sono creati con ruolo VIEWER e possono essere promossi dall’ADMIN.

Template

I template definiscono struttura, layout e contenuto degli attestati. Ogni template è basato su un HTML personalizzabile e su una definizione JSON dei campi.

  • Layout HTML completamente personalizzabile (branding, stili, contenuti).
  • Form di emissione generato dinamicamente da un file JSON.
  • Supporto a campi testuali, date, selezioni e attributi custom.
  • Template attivabili/disattivabili senza perdere lo storico.

Certificati digitali

Ogni certificato viene generato come PDF firmato digitalmente utilizzando l’algoritmo PAdES.

  • Firma digitale applicata al PDF al momento dell’emissione.
  • Qualsiasi modifica successiva rende il documento non valido.
  • Associazione univoca tra PDF, QR code e codice di verifica.
  • Conservazione dei PDF fino a revoca o cancellazione.

Verifica

La verifica consente di controllare l’autenticità del certificato tramite link/QR.

  • Usa il link di verifica presente nel certificato o associato al QR.
  • La pagina di verifica mostra stato (valido/revocato/scaduto) e dettagli essenziali.

Revoca ed eliminazione

La revoca marca il certificato come non valido. L’eliminazione rimuove definitivamente i dati e il PDF, se richiesta dall’utente.

  • Revoca: il certificato risulta non valido in verifica.
  • Elimina: cancella record e file PDF (azione a discrezione dell’utente).

Piani e limiti

Il piano determina eventuali limiti (es. numero certificati / chiamate API).

  • In prossimità dei limiti, l’app può mostrare avvisi nella dashboard.
  • In scadenza o scaduto, alcune funzionalità possono essere bloccate.

Sicurezza e firma digitale

  • Firma PAdES con certificato dedicato al tenant.
  • Il certificato di firma può essere scaricato dall’area amministrativa.
  • L’amministratore può importare il certificato in Adobe Reader/Acrobat per renderlo attendibile nel proprio ambiente.
  • Verifica server-side sempre disponibile come fonte di verità.

FAQ

Posso eliminare un certificato revocato?
Sì. La revoca cambia lo stato, mentre l’eliminazione rimuove definitivamente dati e PDF.
Serve un banner cookie?
Se vengono usati solo cookie tecnici, non è richiesto consenso, ma l’informativa è disponibile.
Come contatto il supporto?
Vai su Contatti e invia un messaggio.

Utilizzo aziendale

Se stai valutando Vercert per un utilizzo aziendale o per volumi elevati, consulta i piani disponibili o leggi le domande frequenti.