مقدمه

اضافه کردن یک امضای دیجیتال زمان‌دار به یک 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

  1. یک پروژه کنسول یا ویندوز جدید C# ایجاد کنید.
  2. اطمینان حاصل کنید که بسته NuGet ارجاع داده شده است.
  3. PDF مورد نظر برای امضا را در یک پوشه شناخته‌شده قرار دهید (مثلاً پوشه Data).
  4. گواهی امضای خود (.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.Document PDF را در یک زمینه‌ی قابل‌تخلیه باز می‌کند و اطمینان می‌دهد که منابع آزاد شوند.

2. ایجاد شیء امضای PKCS#7 و پیکربندی زمان‌سنج

  1. فایل .pfx و رمز عبور خود را بارگذاری کنید.
  2. PKCS7 را با آن اعتبارها نمونه‌سازی کنید.
  3. یک شیء TimestampSettings ایجاد کنید که به نقطه انتهایی TSA قابل دسترسی عمومی اشاره دارد (مثلاً https://freetsa.org/tsr). اگر احراز هویت لازم نیست، می‌توانید آرگومان دوم را خالی بگذارید.
  4. 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. اعمال امضا به سند

  1. یک نمونه از PdfFileSignature را با Document بارگذاری شده ایجاد کنید.
  2. متد Sign را با شماره صفحه، دلیل، تماس، مکان، یک مقدار بولی که نشان می‌دهد امضا باید قابل مشاهده باشد، مستطیل و شیء PKCS7 فراخوانی کنید.
  3. در نهایت، سند امضا شده را با استفاده از 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 را فراهم می‌سازد.

سوالات متداول

  1. مرجع زمان‌سنجی (TSA) چیست و چرا به آن نیاز دارم؟ یک TSA یک نشان زمان‌گذاری قابل اعتماد فراهم می‌کند که ثابت می‌کند یک امضا در لحظه‌ای خاص وجود داشته است، که برای اعتبارسنجی طولانی‌مدت زمانی که گواهی امضا منقضی یا لغو می‌شود، ضروری است.

  2. آیا می‌توانم از هر گواهی .pfx برای امضا استفاده کنم؟ بله، هر فایل معتبر PKCS#12 (.pfx) که شامل یک کلید خصوصی و گواهی مربوطه باشد می‌تواند استفاده شود، به شرط آنکه گواهی توسط طرف‌های اعتبارسنجی PDF مورد اعتماد باشد.

  3. آیا زمان‌ساز بر ظاهر بصری امضا تأثیر می‌گذارد؟ نه. زمان‌ساز در داده‌های رمزنگاری شده امضا جاسازی می‌شود، در حالی که ظاهر بصری (مستطیلی که تعریف می‌کنید) بدون تغییر می‌ماند.

  4. چگونه می‌توانم تأیید کنم که یک مهر زمان به‌درستی اعمال شده است؟ سند PDF امضا شده را در یک نمایشگر PDF که از اعتبارسنجی امضا پشتیبانی می‌کند (به عنوان مثال Adobe Acrobat) باز کنید. ویژگی‌های امضا منبع و زمان مهر زمان را نمایش می‌دهند.

  5. آیا امکان امضای چندین صفحه با همان امضای دارای زمان‌ساز وجود دارد؟ بله. می‌توانید برای هر صفحه‌ای که می‌خواهید امضا کنید، PdfFileSignature.Sign را فراخوانی کنید و از همان شیء PKCS#7 همراه با تنظیمات TimestampSettings آن استفاده کنید.

  6. آیا برای استفاده از TimestampSettings به یک لایسنس پولی نیاز دارم؟ TimestampSettings در مجموعه کامل ویژگی‌های Aspose.PDF موجود است. می‌توانید آن را با یک لایسنس موقت که از وب‌سایت Aspose دریافت می‌کنید، ارزیابی کنید.

بیشتر بخوانید