Questa è una vecchia versione del documento!
Introduzione
In questa pagina viene descritta la libreria per l'utilizzo della firma grafometrica dei documenti. Attualmente, l'unico provider configurato è Namirial, cui ci si interfaccia utilizzando la apposita SDK, integrata all'interno dello SmartAgent.
Prerequisiti
* Il dispositivo deve essere collegato alla postazione tramite cavo USB * Il software di Namirial con i driver deve essere installato * Deve essere importato il certificato fornito da Namirial nella postazione * Deve essere registrata la licenza fornita da Namirial nella postazione * Elenco puntatoLo SmartAgent deve essere attivo nella postazione in cui è collegato il dispositivo.
Configurazione
I parametri che si possono impostare sono i seguenti:
- FGRAFOM_DEFAULT_DEVICE: Dispositivo di default utilizzato per la firma
- FGRAFOM_BIOMETRIC_DATA: Instruct the process to capture biometrica data (pressure, speed, acceleration, graphic stroke)
- FGRAFOM_NO_PDF_SIGN_INFO: Force the process to not require additional signature info after signature process
- FGRAFOM_MAKE_PDF_ORIGINAL: Specify the Pades signature
- FGRAFOM_SAVE_IN_SAME_FOLDER: Specify to save the signed file in same folder of the original file
- FGRAFOM_FORCE_OVERWRITE: Specify to save the signed file in same folder of the original file: use this option if you want to overwrite the original file with signed file
Utilizzo
Firma
$path = "D:/Works/FirmaCerta_SDK/PDF Test/test1.pdf"; $device = "tdWacomSTU530"; $certificate = "Firma GrafoCerta (FEA) Demo_TRUST"; $objFirma = itaFirmaGrafometrica::getFirmaGrafometrica(); $objFirma->sign($path, $device, $certificate, array( 'returnForm' => 'cwbZzzNamirialSignatureTest', 'returnId' => 'signature', 'returnEvent' => 'onSignatureCallback' )); if ($objFirma->getErrorCode() !== 0) { Out::msgStop("ERRORE", $objFirma->getErrorDescription()); }
Occorre passare al metodo i seguenti parametri:
- Il path del documento da firmare
- Il dispositivo (alias) utilizzato per la firma
- Il certificato (alias) utilizzato per la firma
- Un array dove specificare l'evento di ritorno (returnForm, returnId, returnEvent).
Nell'evento di ritorno verranno restituiti:
- Il path del documento firmato
- Esito (True/False)
- Messaggio di errore (se esito=False)
Verifica
$path = "D:/Works/PhpDev/dati/itaEngine/tmp/uploads/20170517144428144.pdf"; $objFirma = itaFirmaGrafometrica::getFirmaGrafometrica(); $objFirma->verify($path, array( 'returnForm' => 'cwbZzzNamirialSignatureTest', 'returnId' => 'verify', 'returnEvent' => 'onVerifySignatureCallback' )); if ($objFirma->getErrorCode() !== 0) { Out::msgStop("ERRORE", $objFirma->getErrorDescription()); }
Occorre passare al metodo i seguenti parametri:
- Il path del documento da verificare
- Un array dove specificare l'evento di ritorno (returnForm, returnId, returnEvent).
Nell'evento di ritorno verrà restituito solamente l'esito (True/False).