Sigillo Elettronico Qualificato Automatico

Il Sigillo Elettronico Qualificato (QeSeal) via API è la soluzione innovativa che consente alle persone giuridiche di garantire l'autenticità e l'integrità di un gran numero di documenti in modo automatico, da server e senza canoni. Il tutto in modalità massiva o singola e in pochi secondi.

Si tratta di un servizio totalmente flessibile e personalizzabile, infatti consente di selezionare qualsiasi formato (CAdES, PAdES, XAdES e PKCS#1) e la procedura può avvenire in modalità sia sincrona sia asincrona.

Non sono previsti canoni annuali: si paga solamente per il costo di attivazione del certificato e per gli utilizzi effettivi.

Il Sigillo Elettronico Qualificato (QeSeal) è l’equivalente della Firma Elettronica Qualificata (QES), ma intestata a una persona giuridica (es. azienda, ente e organizzazione). Grazie al QeSeal è possibile conferire valore probatorio ai propri dati e documenti.

Conforme al Regolamento eIDAS, il Sigillo è legalmente riconosciuto in tutta Europa ed è valido anche per verificare le aziende su EPREL.

La soluzione dispone di 30 livelli di sicurezza customizzabili. Può essere integrata tramite API in gestionali, software e siti web, per rendere immediata e sicura la firma di grandi volumi di documenti.

Durante il processo di apposizione del Sigillo è possibile anche marcare il documento, utilizzando qualsiasi marca temporale di un Certificatore accreditato.

Prima dell’utilizzo del servizio QeSeal via API è necessario attivare il sigillo elettronico qualificato automatico, che può essere acquistato contattando il nostro supporto clienti.

Su Openapi sono disponibili anche i servizi di Firma Elettronica Qualificata automatica e massiva nelle varianti con OTP (EU-QES_otp) e senza (EU-QES_automatic).

Richiesta di Sigillo Elettronico Qualificato (EU-QES_eseal)

POST/EU-QES_eseal

L'endpoint POST/EU-QES_eseal permette di procedere all'apposizione del sigillo elettronico qualificato via API.

{
 "inputDocument":[
  {
  	"sourceType": "remote",
	  "url": "https://my-domain.com/remoteResource.pdf",
  },
  {
	  "sourceType": "remote",
	  "payload": "BASE64string",
  }
],
 "certificateUsername": "[email protected]",
 "certificatePassword": "password123",
 "title": "PAdES Signature",
 "description": "Firma PAdES di un file remoto e base64",
 "signatureType": "pades",
}

I campi obbligatori per poter eseguire l'operazione sono:

Se non viene specificato (nel campo signatureType), il sistema cercherà il formato (CAdES, PAdES, XAdES e PKCS#1) più adatto in base al mimeType del file caricato.

Come detto all'inizio, il servizio è estremamente flessibile e consente di configurare, tramite le varie opzioni, modalità di validazione e firma del documento (sincrono o asincrono), livello di firma, hash algoritmo, eventuale callback.

Alcune delle opzioni potrebbero essere disponibili solo per formati specifici di firma (es. posizionamento della firma nel documento pdf).

Il servizio consente anche di procedere alla marcatura del documento con qualsiasi tipologia di marca temporale.

Risposta di Sigillo Elettronico Qualificato (EU-QES_eseal)

POST/EU-QES_eseal

Il contenuto della risposta dipenderà dallo stato della richiesta e potrà essere:

Nel caso di completamento del processo di apposizione del sigillo la risposta conterrà dati come stato (DONE), le opzioni, la data:

{
 "data":{
   "id": "67af252164f60538280f70f9",
	 "updatedAt": "2025-02-14 11:12:53.699+00:00",
   "createdAt": "2025-02-14 11:12:34.218+00:00",
   "certificateType": "EU-QES_automatic",
   "state": "DONE",
   "signatureType": "pades",
   "options": {
     "asyncDocumentsValidation": false,
     "asyncSignature": false,
     "level": "B",
     "hashAlgorithm": "SHA256",
     "encryptInAnyCase": false,
     "page": 1,
     "withSignatureField": false,
  },
    "document": {
    "title": "B",
    "description": "",
    "inputDocuments": [
     {
      "sourceType": "base64",
      "createdAt": "2025-02-14 11:12:33.819+00:00",
      "mimetype": "application/pdf",
      "extension": "pdf",
      "size": 339,
      "id": "67af252164f60538280f70fb",
      "md5": "694be78a9eaa52d602bec92e211fa5dc",
      "name": "694be78a9eaa52d602bec92e211fa5dc.pdf",
    }  
  ],
   "validatedDocument": {,
     "mimetype": "application/pdf",
     "extension": "pdf",
     "size": "339",
     "createdAt": "2025-02-14 11:12:33.819+00:00",
     "id": "67af252164f60538280f70fb",
     "md5": "694be78a9eaa52d602bec92e211fa5dc",
     "name": "694be78a9eaa52d602bec92e211fa5dc.pdf"
}
  "signedDocument": {,
     "createdAt": "2025-02-14 11:12:34.229+00:00",
     "mimetype": "application/pdf",
     "extension": "pdf",
     "size": "50133",
     "id": "67af252264f60538280f70fe",
     "md5": "363cfdb141fe0e1a3f598e1d6377a4f5",
     "name": "67af252164f60538280f70f9.pdf"
    }
  }
}, 
"message": "Created",
"success": true,
"error": null,
}

Audit

GET /signatures/{id}/{actionType}

Alla fine della procedura sarà possibile richiedere il dettaglio del processo completato, il documento firmato, il documento validato o l'audit trail, il documento che contiene tutte le informazioni che hanno portato al buon esito dell'operazione. Nel caso di controversie, questo file permetterà di riprodurre tecnicamente ogni passaggio della procedura.

Verifica validità della firma

POST/verify

Openapi consente anche di verificare se un documento è stato effettivamente firmato, a chi è associata la firma e per quanto tempo è valida. L’endpoint di riferimento in questo caso è POST/verify.

ESEMPIO RICHIESTA

In fase di richiesta è necessario caricare il documento firmato.

{
  "inputDocument": "BASE64string",
  "detachedContent": "BASE64string",
  "pdfEncryptionPassword": "password123",
  "recursive": true,
  "verifyOnDate": "2025-02-14"
}

ESEMPIO RISPOSTA

Il sistema restituirà diverse informazioni sul documento. In primis, specifica se il documento è stato correttamente firmato, in quale formato, e se la firma è valida.

Inoltre indica:

{
  "data": {
    "checkDate": "2025-02-14 11:11:01.892+00:00",
    "verificationDate": "2025-02-14 11:11:01.892+00:00",
    "signatureFormat": "PAdES",
    "nrOfSignatures": 1,
    "overallVerified": true,
    "signatureReportList": [
      {
        "id": "0",
        "integrity": true,
        "signatureAlgorithmName": "SHA256withRSA",
        "subjectDN": "C=IT,SURNAME=ROSSI,GIVENNAME=MARIO,SERIALNUMBER=TINIT-RSSMRA73R02H501H,CN=ROSSI MARIO,DNQ=AUSL2023021972028357",
        "issuerDN": "C=IT,O=Namirial S.p.A./02046570426,OU=Certification Authority,CN=Namirial CA Firma Qualificata",
        "subjectCN": "ROSSI MARIO",
        "issuerCN": "Namirial CA Firma Qualificata",
        "serialNumber": "5557601230250214000",
        "signerCertificateStatus": "VALID",
        "signerCertificateNotBefore": "2025-02-14 11:11:01.892+00:00",
        "signerCertificateNotAfter": "2025-02-14 11:11:01.892+00:00",
        "signerCertificateRevocationDate": "2025-02-14 11:11:01.892+00:00",
        "issuerCertificateStatus": "VALID",
        "issuerCertificateRevocationDate": "2025-02-14 11:11:01.892+00:00",
        "trustedSignatureDate": false,
        "signatureDate": "2025-02-14 11:11:01.892+00:00",
        "issuerTrustedList": true,
        "keySize": 2048,
        "qcComplianceStatus": "VALID",
        "qcSSCDStatus": "VALID",
        "derEncodedSignerCert": "BASE64string"
      }
    ],
    "noteReportList": [
      {
        "policy": 3,
        "about": 2,
        "type": 1,
        "synopsis": "Certified qualified in conformity",
        "description": "The qualified certificate of ROSSI MARIO complies with European Directive 1999/93/EC"
      }
    ],
    "plainDocument": "BASE64string"
  },
  "message": "Signature is valid",
  "error": null,
  "success": true
}

Il sigillo elettronico qualificato automatico è pensato per coloro che necessitano di certificare la validità di un gran numero di documenti quotidianamente e in modalità massiva (es. studi legali, enti pubblici, banche e compagnie assicurative). I principali benefici di questo servizio includono il risparmio di tempo e costi, l'ottimizzazione dei workflow documentali e la digitalizzazione dei processi.