Meerdere hashes ondertekenen in Postman met één SAD
Deze handleiding gebruikt de authenticatiemethode Clientreferentieproces. Er wordt uitgelegd welke API-aanroepen moeten worden uitgevoerd en hoe vaak dat moet gebeuren om verschillende hashes met één SAD (Signature Activation Data) te ondertekenen.
Opmerking
Bij deze methode moet u het aantal gewenste hashes vooraf berekenen met "3 - PDF Service: Register Document"- en "4 – PDF Service Create Hash"-API-aanroepen voordat u "6 - DTM: extendTransaction" en "7 - DTM: CSC Signatures SignHash" uitvoert.
De handtekening in de "7 - DTM: CSC Signatures SignHash"-reactie komt overeen met de volgorde van de hashes die zijn verzonden in de aanvraag van de bijbehorende API-aanroep.
U kunt de API-aanroep "8 - PDF Service: Embed Signature" tot 200 keer per cyclus uitvoeren om handtekeningen in de documenten in te sluiten.
Als u een hash wilt ondertekenen, voert u de afzonderlijke API--aanroepen hieronder uit:
Opmerking
Het toegangstoken is één uur geldig maar die tijd kan door DigiCert® tot 24 uur worden verlengd.
In het venster van Postman selecteert u Verzamelingen (Collections) (menu links) > PDF Service 2.0 > DTM CSC Credential List.
Open in het rechtervenster het tabblad Autorisatie (Authorization).
Selecteer Nieuw toegangstoken aanvragen (Get New Access Token).
Selecteer Doorgaan (Proceed) in het nieuwe pop-upvenster.
Selecteer Token gebruiken (Use Token) om het toegangstoken toe te passen.
U kunt als volgt een lijst met referenties (certificaten) ophalen die is opgeslagen in uw DigiCert ONE-account:
Open de verzameling PDFService-2-0-SealSign CADES - API-Token Flow - Visible Signature works.
Selecteer 1 - DTM CSC Credential List > Verzenden (Send).
De gebruikte CredentialIDs (certificaten) van DigiCert ONE worden weergegeven in het hoofdgedeelte.
Zo krijgt u een overzicht van de in DigiCert ONE gebruikte functies:
Selecteer 2 - DTM CSC Credential Info > Verzenden (Send).
U kunt zien welke functies in DigiCert ONE worden gebruikt.
Een document registreren:
Selecteer 3 - PDF Service: Document registreren (Register Document)
Configureer de waarde voor de "tsa_url"-variabele door de URL in te voeren van de tijdstempelautoriteit die u gebruikt voor het ondertekenen van documenten.
Selecteer Verzenden (Send).
Gebruik de configuraties hieronder om het uiterlijk van de ondertekening te wijzigen:
Configuratie | Beschrijving |
---|---|
type (optioneel) | Afhankelijk van het type kunt u een gecertificeerd MDP-document (Modification Detection and Prevention) maken. De standaardinstelling is "niet gecertificeerd", wat wordt aangegeven met een groen vinkje. "Gecertificeerd" wordt aangeven met een lintje met een zegel. Voorbeelden: NOT_CERTIFIED CERTIFIED_NO_CHANGES_ALLOWED CERTIFIED_FORM_FILLING CERTIFIED_FORM_FILLING_AND_ANNOTATIONS |
preservation_size (optioneel) | Voer de grootte in van de ruimte die wordt gereserveerd voor het insluiten van de handtekening in bytes. Waarde moet een meervoud zijn van 1024. (Indeling: int32). |
signature_rectangle (optioneel) | Stel de positie en grootte van de aan te brengen digitale handtekening in. De standaardinstelling is een onzichtbare handtekening. De positie wordt gedefinieerd door vier waarden voor de hoek linksonder (x, y) en afmetingen (b, h) van de rechthoek. De eenheden zijn PDF-punten (1 punt = 1/72 inch, A4 = 595 x 842 punten, Letter = 612 x 792 punten, 1 cm = 28,3465 punten) gemeten vanaf de linkeronderhoek van de pagina. Als de breedte of de hoogte nul of negatief is, wordt er een onzichtbare handtekening gemaakt. (Indeling: int32). pagina: Voer de pagina in waaraan de handtekening wordt toegevoegd. x: Voer de x-waarde voor de linkeronderhoek in. y: Voer de y-waarde voor de linkeronderhoek in. b: Voer de breedte in van de rechthoek. h: Voer de hoogte in van de rechthoek. |
signature_text1 (optioneel) | Voer in plaats van de standaardtekst specifieke tekst voor de handtekening in. (Voorbeeld: naam van de ondertekenaar). |
reden (optioneel) | Voer een reden in. |
contact (optioneel) | Voer contactinformatie in. |
font_text1 (optioneel) | Voer de naam van het lettertype in. |
font_size_text1 (optioneel) | Voer de lettergrootte van handtekeningtekst 1 in. Als er geen kenmerk wordt opgegeven, wordt de standaardwaarde van 16pt gebruikt. (Indeling: int32). |
signature_text2 (optioneel) | Voer in plaats van de standaardtekst specifieke tekst voor de handtekening in. (Voorbeeld: naam van de ondertekenaar, reden en/of tijd van de ondertekening). |
font_text2 (optioneel) | Voer de naam van het lettertype in. |
font_size_text2 (optioneel) | Voer de lettergrootte van handtekeningtekst 2 in. Als er geen kenmerk wordt opgegeven, wordt de standaardwaarde van 8pt gebruikt. (Indeling: int32). |
signature_fill_color (optioneel) | Voer de achtergrondkleur in RGB in. De standaardwaarde is 16761024 (rood = 192, groen = 192, blauw = 255). De kleurwaarde wordt als volgt berekend: rood + groen * 256 + blauw * 256 * 256. Als u de rechthoek doorzichtig wilt houden, stelt u de waarde in op -1. (Indeling: int32). |
signature_stroke_color (optioneel) | Voer de kleur van de rand van de handtekening in als een RGB-waarde. De standaardwaarde is 8405056 (rood = 64, groen = 64, blauw = 128). De kleurwaarde wordt als volgt berekend: rood + groen * 256 + blauw * 256 * 256. Als u de rand doorzichtig wilt houden, stelt u de waarde in op -1. (Indeling: int32). |
signature_line_width (optioneel) | Voer de dikte van de rand voor de zichtbare handtekening als punten in. (Indeling: int32). |
background_image (optioneel) | Voeg de afbeelding in voor het handtekeningveld. (Base64-gecodeerd). (Voorbeeld: "dGVzdA==”). |
Een hash maken:
Voeg een document bij.
Selecteer 4 - PDF Service: Hash maken (Create Hash) > Verzenden (Send).
Herhaal Stap 3. Document registreren en Stap 4. Hash maken totdat u het aantal hashes hebt bereikt dat u wilt berekenen.
U ontvangt DocumentIDs en de bijbehorende hashes.
Tip
Upload een PDF-document bij elke uitvoering van "Step 3. Document registreren" om hashes te berekenen en te testen met de verschillende documenten.
Een SAD (Signature Activation Data) genereren en autorisatie starten via Go>Sign Mobile:
Selecteer 5 - DTM: CSC Credential Authorize > Verzenden (Send).
Ga naar de Go>Sign Mobile-app (Go>Sign Mobile application) > Autorisatieaanvraag (Authorization request) en selecteer Autoriseren (Authorize).
U ontvangt een geldige SAD die vereist is voor het ondertekenen van de hash. Dit is vereist in de stap voor het insluiten van de handtekening.
Opmerking
In de DigiCert ONE-demo-omgeving worden de standaardwaarden voor het opnieuw autoriseren via Go>Sign Mobile ingesteld op "250.000 hashes of 30 dagen".
In de DigiCert ONE-productieomgeving worden de standaardwaarden voor het opnieuw autoriseren via Go>Sign Mobile ingesteld op "1 miljoen hashes of 95 dagen".
De hash ondertekenen:
Selecteer 7 - DTM: CSC Signatures SignHash > Verzenden (Send).
Je ontvangt één handtekening per verzonden hash.
Een nieuwe hash ondertekenen:
Selecteer 8 - PDF Service: Handtekening insluiten (Embed Signature).
De SAD die u hebt gemaakt in de stap Referentie autoriseren wordt automatisch bijgewerkt.
Selecteer Verzenden (Send).
Herhaal deze stap voor elke afzonderlijke handtekening in de volgorde waarin u ze hebt ontvangen in "4 - PDF Service: Create Hash".
De PDF downloaden en de geldigheid van de handtekening controleren:
Selecteer Opslaan als voorbeeld (Save as example) (rechtsonder) > Reactie opslaan in bestand (Save response to file).