Digitaal ondertekenen met tijdstempel in PDF-bestand
Invoering
Heb je ooit een PDF digitaal moeten ondertekenen en een tijdstempel moeten toevoegen voor extra beveiliging? Of je nu werkt aan juridische documenten, contracten of iets anders waarvoor veilige authenticatie vereist is, een digitale handtekening met een tijdstempel voegt een extra laag geloofwaardigheid toe. In deze tutorial leggen we uit hoe je Aspose.PDF voor .NET kunt gebruiken om een digitale handtekening samen met een tijdstempel toe te voegen aan je PDF-documenten. Maak je geen zorgen, we nemen het stap voor stap door!
Vereisten
Voordat we in de code duiken, zijn er een paar dingen die je moet instellen om te kunnen volgen. Hier is een snelle checklist van de vereisten om je op weg te helpen:
- Aspose.PDF voor .NET-bibliotheek: U hebt de Aspose.PDF voor .NET-bibliotheek nodig die in uw project is geïnstalleerd. U kuntDownload hier de nieuwste versie of voeg het toe aan uw project via NuGet.
- Een PDF-document: U hebt een voorbeeld-PDF-bestand nodig om mee te werken. Zorg ervoor dat u een bestand in de map van uw project hebt dat u wilt ondertekenen.
- Digitaal certificaat (PFX-bestand): Zorg ervoor dat u een digitaal certificaat (een
.pfx
bestand) om het document digitaal te ondertekenen. - Tijdstempel-URL: Dit is een online tijdstempelservice die wordt gebruikt om een tijdstempel aan de digitale handtekening toe te voegen.
- Basiskennis van C#: u hoeft geen expert te zijn, maar als u de basisbeginselen van C# kent, kunt u de code beter begrijpen en aanpassen.
Zodra je al deze vakjes hebt aangevinkt, ben je klaar om te beginnen met coderen!
Pakketten importeren
Om te beginnen moet u de volgende namespaces importeren in uw C#-project. Dit zorgt ervoor dat u toegang hebt tot de relevante Aspose.PDF-klassen en -functies.
using System.IO;
using System;
using Aspose.Pdf;
using Aspose.Pdf.Facades;
using Aspose.Pdf.Forms;
using System.Collections;
Stap 1: Laad het PDF-document
Het eerste wat we moeten doen is het PDF-document laden dat we willen ondertekenen. Dit is hoe je dat doet:
// Definieer het pad naar uw documentmap
string dataDir = "YOUR DOCUMENTS DIRECTORY";
// Laad het PDF-document
Document document = new Document(dataDir + @"DigitallySign.pdf");
Deze stap is vrij eenvoudig. We definiëren gewoon het pad naar het document dat we willen ondertekenen.Document
klasse van Aspose.PDF zorgt voor het laden van het bestand.
Stap 2: Stel de digitale handtekening in
Vervolgens maken we de digitale handtekening met behulp van de PKCS7-klasse en laden we het PFX-bestand. Dit PFX-bestand bevat uw certificaat en privésleutel, die nodig zijn om het document te ondertekenen.
// Pad naar uw .pfx-bestand
string pfxFile = "YOUR DOCUMENTS DIRECTORY\\certificate.pfx";
// Initialiseer het handtekeningobject
PdfFileSignature signature = new PdfFileSignature(document);
// Laad het PFX-bestand met een wachtwoord
PKCS7 pkcs = new PKCS7(pfxFile, "pfx_password");
Op dit punt vertelt u Aspose om uw digitale certificaat te gebruiken voor het ondertekenen van het document.PKCS7
object regelt al het cryptografische werk voor u, zodat u zich geen zorgen hoeft te maken over de kleine details.
Stap 3: Voeg de tijdstempelinstellingen toe
Een van de belangrijkste onderdelen van een robuuste digitale handtekening is de tijdstempel. Dit zorgt ervoor dat de handtekening van het document kan worden geverifieerd, zelfs nadat het certificaat is verlopen. Laten we de tijdstempel instellen met behulp van een online tijdstempelautoriteit.
// Tijdstempelinstellingen definiëren
TimestampSettings timestampSettings = new TimestampSettings("https://uw_tijdstempel_url", "gebruiker:wachtwoord");
// Tijdstempelinstellingen toevoegen aan het PKCS7-object
pkcs.TimestampSettings = timestampSettings;
Hier specificeert u de URL voor de timestamping service, die automatisch een tijd en datum aan uw handtekening zal verstrekken. Dit kan met of zonder authenticatie.
Stap 4: Definieer de locatie en het uiterlijk van de handtekening
Nu gaan we definiëren waar de handtekening in de PDF zal verschijnen en wat de afmetingen ervan zijn. U kunt de positie van het handtekeningvak op de pagina aanpassen, evenals de grootte.
//Definieer het uiterlijk en de locatie van de handtekening (pagina 1, met opgegeven rechthoek)
System.Drawing.Rectangle rect = new System.Drawing.Rectangle(100, 100, 200, 100);
Hier definiëren we een rechthoek die de handtekening op de coördinaten (100, 100) op de eerste pagina van de PDF plaatst, met een breedte van 200 en een hoogte van 100. U kunt deze waarden aanpassen aan uw ontwerp.
Stap 5: Onderteken het PDF-document
Nu alles is ingesteld, is het tijd om de digitale handtekening daadwerkelijk toe te passen op de PDF. Deze stap combineert het certificaat, de tijdstempel en de positionering in één eenvoudige opdracht.
// Onderteken het document op de eerste pagina
signature.Sign(1, "Signature Reason", "Contact", "Location", true, rect, pkcs);
Dit is wat er gebeurt:
- 1: Dit geeft aan dat de handtekening op de eerste pagina moet worden geplaatst.
- ‘Reden voor handtekening’: Hier kunt u aangeven waarom u het document ondertekent.
- “Contact”: Voer de contactgegevens van de ondertekenaar in.
- “Locatie”: Geef de locatie van de ondertekenaar op.
- true: Deze Booleaanse waarde geeft aan of de handtekening zichtbaar is in het document.
- rect: De rechthoek die we eerder hebben gedefinieerd, specificeert de grootte en positie van de handtekening.
- pkcs: Het PKCS7-object bevat de instellingen voor het digitale certificaat en de tijdstempel.
Stap 6: Sla de ondertekende PDF op
Zodra het document is ondertekend, hoeft u het alleen nog maar op te slaan. U kunt een nieuwe bestandsnaam kiezen om zowel de originele als de ondertekende versies te behouden.
// Sla het ondertekende PDF-document op
signature.Save(dataDir + "DigitallySignWithTimeStamp_out.pdf");
Uw nieuw ondertekende en van een tijdstempel voorziene PDF is nu opgeslagen in de opgegeven map!
Conclusie
En daar heb je het! Je hebt succesvol een PDF digitaal ondertekend met een tijdstempel met Aspose.PDF voor .NET. Dit proces zorgt voor de authenticiteit en integriteit van je documenten, waardoor zowel jij als de ontvanger gemoedsrust hebben. Digitale handtekeningen worden steeds belangrijker in de digitale wereld van vandaag, dus het beheersen van dit proces is absoluut een vaardigheid die de moeite waard is.
Veelgestelde vragen
Kan ik een ander bestandsformaat gebruiken voor het certificaat?
Ja, maar de tutorial richt zich op het gebruik van een PFX-bestand, het meestgebruikte formaat voor digitale certificaten.
Heb ik een internetverbinding nodig om het tijdstempel toe te passen?
Ja, aangezien de tijdstempel wordt opgehaald bij een online tijdstempelautoriteit, hebt u internettoegang nodig.
Kan ik meerdere pagina’s in een PDF ondertekenen?
Absoluut! Je kunt designature.Sign()
Methode om meerdere pagina’s te targeten of door alle pagina’s te lussen.
Wat gebeurt er als het wachtwoord van het PFX-bestand onjuist is?
Als het wachtwoord onjuist is, ontvangt u een uitzondering. Zorg er dus voor dat u het juiste wachtwoord invoert.
Kan ik de handtekening onzichtbaar maken?
Ja, je mag passerenfalse
naar deSign
zichtbaarheidsparameter van de methode om de handtekening onzichtbaar te maken.