Вступ

Додавання часового цифрового підпису до PDF не лише підтверджує авторство, а й гарантує, що підпис існував у певний момент часу. Це має вирішальне значення для юридичних, фінансових та нормативних сценаріїв, де потрібно продемонструвати довгострокову дійсність документа. У цьому підручнику ми покажемо, як здійснити підписання з часовою міткою в C# за допомогою Aspose.PDF for .NET. Ключове слово часові цифрові підписи з’являється на початку, щоб сигналізувати про релевантність статті для пошукових систем і розробників.

Чому важливі цифрові підписи з часовою міткою

Звичайний цифровий підпис прив’язує документ до сертифіката, але дійсність сертифіката може змінюватися — сертифікати закінчуються, відкликаються або орган, що підписує, може бути скомпрометований. Організація часових міток (Timestamp Authority, TSA) вставляє довірчу часову мітку у підпис, створюючи незмінний доказ того, що документ був підписаний до будь‑якої потенційної проблеми з сертифікатом. Це захищає від майбутніх спорів і відповідає таким нормативним актам, як eIDAS та американський закон ESIGN. Вбудовуючи часову мітку, надану TSA, ви забезпечуєте майбутню захищеність своїх PDF‑файлів без необхідності повторного підпису при зміні сертифікатів.

Чому використовувати Aspose.PDF for .NET

Aspose.PDF for .NET — це потужна бібліотека, яка дозволяє створювати, маніпулювати та підписувати PDF‑файли без потреби у Adobe Acrobat. Щоб розпочати, встановіть бібліотеку через NuGet:

Install-Package Aspose.PDF

Після встановлення ви можете звернутися до документації API на Aspose.PDF product page для детального опису класів. Ключові класи, які ми будемо використовувати, це:

  • Aspose.Pdf.Document – представляє PDF‑документ.
  • Aspose.Pdf.Facades.PdfFileSignature – забезпечує можливості підпису.
  • Aspose.Pdf.Forms.PKCS7 – інкапсулює підпис на основі сертифіката.
  • Aspose.Pdf.TimestampSettings – містить URL TSA та облікові дані.
  • System.Drawing.Rectangle – визначає візуальну область підпису на сторінці.

Покроковий посібник: Додати цифровий підпис з часовою міткою

1. Підготовка середовища та завантаження PDF

  1. Створіть новий проект C# типу console або Windows.
  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 Aspise.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 у disposable контексті, забезпечуючи вивільнення ресурсів.

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;

Explanation:

  • 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 reference.
  • Безкоштовні онлайн-додатки – Спробуйте підписання 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.

Читати далі