Per firmare un hash, esegui i singoli richiami API di seguito:
Per ottenere un elenco di credenziali (certificati) memorizzati nel tuo account DigiCert ONE:
Apri la raccolta PDFService-2-0-SealSign CADES - Flusso token API - Lavori di firma visibili.
Seleziona 1 - Elenco credenziali DTM CSC > Invia.
I tuoi DigiCert ONE CredentialIDs (certificati) utilizzati sono visualizzati nel corpo.
Per ottenere una panoramica delle funzioni usate in DigiCert ONE:
Seleziona 2 - Info credenziali DTM CSC > Invia.
Puoi vedere le funzioni usate in DigiCert ONE.
Per registrare un documento:
Seleziona 3 - PDF Service Registra documento:
Configura il valore variabile “tsa_url” inserendo l’URL dell'autorità di data e ora che utilizzerai per firmare i documenti.
Seleziona Invia.
Per cambiare l’aspetto della firma, usa le configurazioni di seguito:
Configurazione | Descrizione |
|---|---|
tipo (facoltativo) | In base al tipo, puoi creare un documento MDP (rilevamento e prevenzione modifica documento) certificato. L’impostazione predefinita è non certificato e mostra un segno di spunta verde. L’opzione certificata mostra un nastro con un sigillo. Esempi: NOT_CERTIFIED CERTIFIED_NO_CHANGES_ALLOWED CERTIFIED_FORM_FILLING CERTIFIED_FORM_FILLING_AND_ANNOTATIONS |
preservation_size (facoltativo) | Inserisci la dimensione dello spazio per la salvaguardia per nidificare la firma in byte. Il valore deve essere un multiplo di 1024. (Formato: int32). |
signature_rectangle (facoltativo) | Imposta la posizione e la dimensione dell’annotazione di firma digitale. L’impostazione predefinita è un firma invisibile. La posizione è definita da quattro valori per l’angolo inferiore sinistro (x, y) e le dimensioni (l, a) del rettangolo. Le unità sono dei punti PDF (1 punto = 1/72 pollici, A4 = 595 x 842 punti, Letter = 612 x 792 punti, 1 cm = 28.3465 punti) misurati dall’angolo inferiore sinistro della pagina. Se la larghezza o l’altezza è zero o un numero negativo, viene creata una firma invisibile, ad es. non viene creato un aspetto visibile per la firma. (Formato: int32). pagina: Inserisci la pagina su cui viene aggiunta la firma. x: Inserisci il valore x dell’angolo inferiore sinistro. y: Inserisci il valore y dell’angolo inferiore sinistro. l: Inserisci la dimensione della larghezza del rettangolo. a: Inserisci la dimensione dell’altezza del rettangolo. |
signature_text1 (facoltativo) | Inserisci un testo di firma specifica e non standard. (Esempio: nome del firmatario). |
motivo (opzionale) | Inserisci un motivo. |
contatto (opzionale) | Inserisci il contatto. |
font_text1 (facoltativo) | Inserisci il nome del font. |
font_size_text1 (facoltativo) | Inserisci la dimensione del font del testo di firma 1. Se l’attributo non è presente, si utilizza l’impostazione predefinita 16 pt. (Formato: int32). |
signature_text2 (facoltativo) | Inserisci un testo di firma specifica e non standard. (Esempio: nome del firmatario, motivo e/o ora di firma). |
font_text2 (facoltativo) | Inserisci il nome del font. |
font_size_text2 (facoltativo) | Inserisci la dimensione del font del testo di firma 2. Se l’attributo non è presente, si utilizza l’impostazione predefinita 8 pt. (Formato: int32). |
signature_fill_color (facoltativo) | Inserisci il colore dello sfondo in RGB. L’impostazione predefinita è 16761024 (rosso = 192, verde = 192, blu = 255). Il valore del colore viene calcolato come segue: colore rosso + verde * 256 + blu * 256 * 256. Per mantenere il rettangolo trasparente, impostare il valore su -1. (Formato: int32). |
signature_stroke_color (facoltativo) | Inserisci il colore della linea del bordo della firma come valore RGB. L’impostazione predefinita è 8405056 (rosso = 64, verde = 64, blu = 128). Il valore del colore viene calcolato come segue: colore rosso + verde * 256 + blu * 256 * 256. Per mantenerlo trasparente, impostare il valore su -1. (Formato: int32). |
signature_line_width (facoltativo) | Inserisci lo spessore della linea attorno alla firma visibile in punti. (Formato: int32). |
background_image (facoltativo) | Inserisci l’immagine da nidificare nel campo della firma. (con codifica Base64). (Esempio: "dGVzdA==”). |
Per creare un hash:
Allegare il documento.
Seleziona 4 - PDF Service Crea hash: > Invia.
Per generare un SAD (dati di attivazione firma) e avviare l’autorizzazione tramite l’applicazione Go>Sign Mobile:
Seleziona 5 - DTM Autorizza con credenziale CSC: > Invia.
Naviga fino all’applicazione Go>Sign Mobile > Richiesta autorizzazione > Autorizza.
Riceverà un SAD valido necessario per firmare l’hash. È necessario nella fase Nidifica firma.
Nota
Nell’ambiente demo DigiCert ONE, i valori predefiniti per la riautorizzazione tramite applicazione Go>Sign Mobile sono impostati su "250.000 hash o 30 giorni".
Nell’ambiente di produzione DigiCert ONE, i valori predefiniti per la riautorizzazione tramite applicazione Go>Sign Mobile sono impostati su "1 milione di hash o 95 giorni".
Per firmare l’hash:
Seleziona 7 - DTM CSC Signatures SignHash: > Invia.
Riceverai una firma valida nel corpo da nidificare nel documento.
Per firmare un nuovo hash:
Seleziona 8 - PDF Service Nidifica firma:.
Il SAD creato nella fase Autorizza credenziali saranno aggiornati automaticamente.
Seleziona Invia.
Riceverai il documento con la firma nidificata.
Per scaricare il PDF e controllare la validità della firma:
Seleziona Salva come esempio (in basso a destra) > Salva risposta su file.
Apri il PDF in Adobe Acrobat Reader per controllare la validità della firma.
Nota
I PDF creati tramite l’ambiente demo DigiCert ONE visualizzeranno una firma non valida, poiché il certificato usato è un certificato demo non attendibile. Tuttavia, puoi classificare il certificato radice come attendibile in Adobe Acrobat Reader per visualizzare un segno di spunta verde.