مقدمه
اضافه کردن یک امضای دیجیتال زماندار به یک PDF نه تنها اثباتکنندهٔ نویسندگی است بلکه تضمین میکند که امضا در یک نقطهٔ خاص از زمان وجود داشته است. این برای سناریوهای قانونی، مالی و انطباقی که اعتبار طولانیمدت یک سند باید نشان داده شود، حیاتی است. در این آموزش نشان میدهیم چگونه امضای زماندار را در C# با استفاده از Aspose.PDF for .NET انجام دهید. کلمه کلیدی امضاهای دیجیتال زماندار زودتر ظاهر میشود تا مرتبط بودن مقاله برای موتورهای جستجو و توسعهدهندگان را نشان دهد.
چرا امضاهای دیجیتال دارای زمانمهر مهم هستند
یک امضای دیجیتال معمولی یک سند را به یک گواهی متصل میکند، اما اعتبار گواهی ممکن است تغییر کند — گواهیها منقضی میشوند، لغو میشوند یا مرجع امضاکننده ممکن است به خطر بیفتد. یک مرجع زمانسنجی (TSA) یک مهر زمان معتبر را به امضا وارد میکند و اثباتی غیرقابل تغییر ایجاد میکند که سند قبل از هر مشکل احتمالی گواهی امضا شده است. این امر از بروز اختلافات آینده جلوگیری میکند و مقرراتی مانند eIDAS و قانون ESIGN ایالات متحده را برآورده میسازد. با تعبیه یک مهر زمان ارائهشده توسط TSA، PDFهای خود را برای آینده ایمن میکنید بدون اینکه نیاز به امضای مجدد آنها هنگام تغییر گواهیها داشته باشید.
چرا استفاده از Aspose.PDF for .NET
Aspose.PDF for .NET یک کتابخانه قدرتمند است که امکان ایجاد، دستکاری و امضای فایلهای PDF را بدون نیاز به Adobe Acrobat فراهم میکند. برای شروع، کتابخانه را از طریق NuGet نصب کنید:
Install-Package Aspose.PDF
پس از نصب، میتوانید مستندات API را در صفحه محصول Aspose.PDF برای توصیفهای دقیق کلاسها مراجعه کنید. کلاسهای کلیدی که استفاده خواهیم کرد عبارتند از:
Aspose.Pdf.Document– نمایانگر سند PDF است.Aspose.Pdf.Facades.PdfFileSignature– قابلیتهای امضای دیجیتال را فراهم میکند.Aspose.Pdf.Forms.PKCS7– یک امضای مبتنی بر گواهینامه را در بر میگیرد.Aspose.Pdf.TimestampSettings– URL و اعتبارنامههای TSA را نگه میدارد.System.Drawing.Rectangle– ناحیهٔ بصری امضا را روی صفحه تعریف میکند.
آموزش گامبهگام: افزودن امضای دیجیتال زماندار
1. آمادهسازی محیط و بارگذاری PDF
- یک پروژه کنسول یا ویندوز جدید C# ایجاد کنید.
- اطمینان حاصل کنید که بسته NuGet ارجاع داده شده است.
- PDF مورد نظر برای امضا را در یک پوشه شناختهشده قرار دهید (مثلاً پوشه
Data). - گواهی امضای خود (
.pfx) و رمز عبور را بهصورت امن ذخیره کنید.
مثال زیر نشان میدهد که چگونه میتوان یک امضای دیجیتال با زمانمهر را به یک PDF با استفاده از C# و Aspose.PDF اضافه کرد.
// Load a PDF document from the file system
string dataDir = "./Data/"; // Adjust the path to your data folder
string pdfPath = Path.Combine(dataDir, "SimpleResume.pdf");
using (var document = new Aspose.Pdf.Document(pdfPath))
{
// PDF is now loaded and ready for signing
// Further steps will be performed inside this using block
}
توضیح:
dataDirبه پوشهای که حاوی فایلهای ورودی است اشاره میکند.Aspose.Pdf.DocumentPDF را در یک زمینهی قابلتخلیه باز میکند و اطمینان میدهد که منابع آزاد شوند.
2. ایجاد شیء امضای PKCS#7 و پیکربندی زمانسنج
- فایل
.pfxو رمز عبور خود را بارگذاری کنید. PKCS7را با آن اعتبارها نمونهسازی کنید.- یک شیء
TimestampSettingsایجاد کنید که به نقطه انتهایی TSA قابل دسترسی عمومی اشاره دارد (مثلاً https://freetsa.org/tsr). اگر احراز هویت لازم نیست، میتوانید آرگومان دوم را خالی بگذارید. TimestampSettingsرا به نمونهPKCS7اختصاص دهید.
مثال زیر نشان میدهد که چگونه میتوان یک امضای PKCS#7 را با استفاده از یک سرور TSA در C# پیکربندی کرد.
string pfxPath = Path.Combine(dataDir, "myCertificate.pfx");
string pfxPassword = "myPassword"; // Keep this secure!
// Create the PKCS#7 signature object using the certificate
var pkcs = new Aspose.Pdf.Forms.PKCS7(pfxPath, pfxPassword);
// Configure timestamp settings – replace URL with your TSA if needed
var timestampSettings = new Aspose.Pdf.TimestampSettings("https://freetsa.org/tsr", string.Empty);
pkcs.TimestampSettings = timestampSettings;
توضیح:
PKCS7گواهینامه و کلید خصوصی مورد نیاز برای یک امضای رمزنگاری را در بر میگیرد.TimestampSettingsبه Aspose.PDF میگوید که در طول فرآیند امضا، یک برچسب زمانی از URL مشخصشده TSA درخواست کند.- با اختصاص
TimestampSettingsبه نمونهPKCS7، هر امضایی که با این شیء ایجاد شود، زمان ارائهشده توسط TSA را شامل خواهد شد.
3. تعریف ظاهر بصری امضا
امضای PDF میتواند نمای قابل مشاهدهای (یک فیلد امضا) داشته باشد یا نامرئی باشد. در اینجا یک مستطیل قابل مشاهده در صفحه 1 ایجاد میکنیم:
مثال زیر نشان میدهد که چگونه یک مستطیل امضا را در صفحه اول تعریف کنید.
// Define a rectangle where the signature will appear (in points)
var rect = new System.Drawing.Rectangle(100, 100, 200, 100); // x, y, width, height
توضیح:
- مختصات مستطیل از سیستم نقطه PDF استفاده میکند (1 نقطه = 1/72 اینچ).
xوyرا تنظیم کنید تا فیلد امضا را در جایی که میخواهید در صفحه قرار دهید.
4. اعمال امضا به سند
- یک نمونه از
PdfFileSignatureرا باDocumentبارگذاری شده ایجاد کنید. - متد
Signرا با شماره صفحه، دلیل، تماس، مکان، یک مقدار بولی که نشان میدهد امضا باید قابل مشاهده باشد، مستطیل و شیءPKCS7فراخوانی کنید. - در نهایت، سند امضا شده را با استفاده از
PdfFileSignature.Saveذخیره کنید.
مثال زیر نشان میدهد که چگونه امضای دارای مهر زمان را اعمال کرده و PDF را با استفاده از C# ذخیره کنید.
using (var signature = new Aspose.Pdf.Facades.PdfFileSignature(document))
{
// Sign page 1 with the configured PKCS7 (which includes timestamp settings)
signature.Sign(
pageNumber: 1,
reason: "Approved by HR",
contact: "hr@example.com",
location: "New York, USA",
visible: true,
rect: rect,
pkcs: pkcs);
// Save the signed PDF to the output path
string outputPath = Path.Combine(dataDir, "DigitallySignWithTimeStamp_out.pdf");
signature.Save(outputPath);
}
توضیح:
PdfFileSignature.Signیک امضای مبتنی بر گواهی بر روی صفحه انتخاب شده ایجاد میکند.reason،contactوlocationفیلدهای متادیتای اختیاری هستند که در ویژگیهای امضا ظاهر میشوند.- تنظیم
visibleبهtrueباعث میشود امضا در مستطیلی که قبلاً تعریف کردیم ظاهر شود. - از آنجا که
pkcs.TimestampSettingsتنظیم شده بود، Aspose.PDF در هنگام امضا با TSA (https://freetsa.org/tsr) تماس میگیرد و توکن زمانسنجی بازگشتی را در امضا جاسازی میکند. - فایل امضاشده در
DigitallySignWithTimeStamp_out.pdfنوشته میشود.
5. تأیید امضا و زمانمهر (اختیاری)
پس از امضا، میتوانید PDF حاصل را در Adobe Acrobat Reader یا هر نمایشگر PDF دیگری که از اعتبارسنجی امضا پشتیبانی میکند، باز کنید. به پنل امضا بروید؛ باید منبع زمانسنج (به عنوان مثال، “freetsa.org”) و زمان دقیق اعمال امضا را مشاهده کنید. این گام تأیید میکند که تعامل TSA موفق بوده و امضا هم از نظر رمزنگاری صحیح است و هم زمانمهر شده است.
دریافت یک مجوز رایگان
Aspose یک مجوز ارزیابی موقت ارائه میدهد که واترمارک ارزیابی را حذف میکند و به شما امکان میدهد تمام ویژگیها، از جمله امضای زماندار، را بررسی کنید. بلافاصله یکی را از صفحه مجوز موقت دریافت کنید.
منابع اضافی رایگان
- مستندات – راهنماهای جامع و مثالهای استفاده از API در Aspose.PDF for .NET docs موجود است.
- مرجع API – امضای روشها و سلسلهمراتب کلاسها بهصورت دقیق میتوانند در مرجع API بررسی شوند.
- برنامههای آنلاین رایگان – بدون کد، امضای PDF را با استفاده از برنامههای وب رایگان در Aspose Apps امتحان کنید.
نتیجهگیری
امضاهای دیجیتال دارای زمانسنجی، اثبات قابل اعتمادی از زمان امضا ارائه میدهند که پس از انقضای گواهی و لغو آن نیز معتبر میمانند. با استفاده از Aspose.PDF for .NET، میتوانید به سرعت امضای مبتنی بر گواهی را با پشتیبانی TSA یکپارچه کنید، ناحیهٔ بصری امضا را تعریف کنید و یک PDF مطابق با استانداردها تولید کنید که برای بایگانی طولانیمدت آماده باشد. راهنمای گامبهگام بالا، شما را از نصب تا اجرای کد راهنمایی میکند و امکان ایمنسازی برنامهنویسی اسناد PDF را فراهم میسازد.
سوالات متداول
مرجع زمانسنجی (TSA) چیست و چرا به آن نیاز دارم؟ یک TSA یک نشان زمانگذاری قابل اعتماد فراهم میکند که ثابت میکند یک امضا در لحظهای خاص وجود داشته است، که برای اعتبارسنجی طولانیمدت زمانی که گواهی امضا منقضی یا لغو میشود، ضروری است.
آیا میتوانم از هر گواهی .pfx برای امضا استفاده کنم؟ بله، هر فایل معتبر PKCS#12 (.pfx) که شامل یک کلید خصوصی و گواهی مربوطه باشد میتواند استفاده شود، به شرط آنکه گواهی توسط طرفهای اعتبارسنجی PDF مورد اعتماد باشد.
آیا زمانساز بر ظاهر بصری امضا تأثیر میگذارد؟ نه. زمانساز در دادههای رمزنگاری شده امضا جاسازی میشود، در حالی که ظاهر بصری (مستطیلی که تعریف میکنید) بدون تغییر میماند.
چگونه میتوانم تأیید کنم که یک مهر زمان بهدرستی اعمال شده است؟ سند PDF امضا شده را در یک نمایشگر PDF که از اعتبارسنجی امضا پشتیبانی میکند (به عنوان مثال Adobe Acrobat) باز کنید. ویژگیهای امضا منبع و زمان مهر زمان را نمایش میدهند.
آیا امکان امضای چندین صفحه با همان امضای دارای زمانساز وجود دارد؟ بله. میتوانید برای هر صفحهای که میخواهید امضا کنید،
PdfFileSignature.Signرا فراخوانی کنید و از همان شیء PKCS#7 همراه با تنظیمات TimestampSettings آن استفاده کنید.آیا برای استفاده از TimestampSettings به یک لایسنس پولی نیاز دارم؟ TimestampSettings در مجموعه کامل ویژگیهای Aspose.PDF موجود است. میتوانید آن را با یک لایسنس موقت که از وبسایت Aspose دریافت میکنید، ارزیابی کنید.
