Firma di più hash in Postman con un SAD
Questa guida utilizza il metodo di autenticazione con flusso di credenziali client. Spiega quali richiami API devono essere eseguiti e il numero di volte in cui è necessaria l’esecuzione per firmare più hash con un SAD (dati di attivazione firma).
Nota
In questo metodo, devi precalcolare il numero di hash che desideri con i richiami API "3 - PDF Service: Registra documento" e "4 – PDF Service Crea hash" prima di eseguire "6 - DTM: extendTransaction" e "7 - DTM: CSC Signatures SignHash".
La firma nella risposta "7 - DTM: CSC Signatures SignHash" corrisponde all’ordine degli hash inviati nella sua richiesta di richiamo API.
Puoi eseguire il richiamo API "8 - PDF Service: Embed Signature" ripetutamente fino a 200 volte per ciclo per nidificare le firme nei documenti.
Per firmare un hash, esegui i singoli richiami API di seguito:
Nota
Il token di accesso è valido per un’ora ma può essere esteso da DigiCert® fino a 24 ore.
Nella finestra Postman, seleziona Collections (Raccolte) (menu a sinistra) > PDF Service 2.0 (PDF Service 2.0) > DTM CSC Credential List (Elenco credenziali DTM CSC).
Nella finestra destra, passa alla scheda Authorization (Autorizzazione).
Seleziona Get New Access Token (Ottieni nuovo token d’accesso).
Nella nuova finestra a comparsa, seleziona Proceed (Procedi).
Per applicare il token di accesso, seleziona Use Token (Usa token).
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.
Ripeti la Fase 3. Registra documento e la Fase 4. Crea hash consecutivamente fino a raggiungere il numero di hash che desideri calcolare.
Riceverai DocumentID e i loro hash corrispondenti.
Suggerimento
Carica diversi documenti PDF dopo ciascuna esecuzioni della "Fase 3. Registra documento" per calcolare gli hash e testare con diversi documenti.
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.
Ricevi una firma per hash inviato.
Per firmare un nuovo hash:
Seleziona 8 - PDF Service Nidifica firma:.
Il SAD creato nella fase Autorizza credenziali saranno aggiornati automaticamente.
Seleziona Invia.
Ripetere questa procedura per ciascuna firma singolarmente nell’ordine in cui le hai ricevute in "4 - PDF Service: Crea hash”.
Per scaricare il PDF e controllare la validità della firma:
Seleziona Salva come esempio (in basso a destra) > Salva risposta su file.