Что нового в этой версии

  • [Feature] Поддержка цифровой подписи изображений и её проверка (SIGNATURENET‑5528)
    Внедряет стеганографическое встраивание цифровых подписей в PNG и JPG изображения. Поддерживает подписи, защищённые паролем, работу со стримами/файлами и полную верификацию с опциональными порогами обнаружения.

  • [Enhancement] Оптимизация LINQ‑запросов для операций с подписями (SIGNATURENET‑5500)
    Переписана логика LINQ по всей библиотеке для снижения количества аллокаций памяти и повышения скорости выполнения. Добавлена фильтрация на основе предикатов для методов Search и Verify, позволяющая разработчикам предварительно отфильтровать подписи перед затратными операциями.

Исправления и улучшения

  • [Bug Fix] Исправлена ошибка инициализатора типа в GeneratePreview() для формата DOC в Linux (SIGNATURENET‑5555)
    Исключение больше не выбрасывается при создании превью для документов Microsoft Word в средах Linux.

Как использовать новые возможности

Подписание изображения (стеганография)

using GroupDocs.Signature;
using GroupDocs.Signature.Options;

string inputFile  = "image.png";
string outputFile = "signed_image.png";
string password   = "MySecurePassword123";

using (Signature signature = new Signature(inputFile))
{
    ImageDigitalSignOptions signOptions = new ImageDigitalSignOptions
    {
        Password = password
    };

    SignResult signResult = signature.Sign(outputFile, signOptions);

    if (signResult.Succeeded?.Count > 0)
    {
        Console.WriteLine("Image signed successfully!");
        Console.WriteLine($"Signatures added: {signResult.Succeeded.Count}");
    }
}

Проверка подписанного изображения

using GroupDocs.Signature;
using GroupDocs.Signature.Options;

string signedFile = "signed_image.png";
string password   = "MySecurePassword123";

using (Signature signature = new Signature(signedFile))
{
    ImageDigitalVerifyOptions verifyOptions = new ImageDigitalVerifyOptions
    {
        Password = password,
        DetectionThresholdPercent = 75   // optional, 0‑100%
    };

    VerificationResult verifyResult = signature.Verify(verifyOptions);

    if (verifyResult.IsValid)
    {
        Console.WriteLine("Digital signature is valid!");
        Console.WriteLine($"Verified signatures: {verifyResult.Succeeded.Count}");
    }
    else
    {
        Console.WriteLine("Digital signature is invalid or not found.");
    }
}

Расширенная верификация с полным извлечением данных

using (Signature signature = new Signature("signed_image.png"))
{
    ImageDigitalVerifyOptions verifyOptions = new ImageDigitalVerifyOptions
    {
        Password = "MySecurePassword123",
        UseFullDataExtraction = true,          // maximum accuracy
        DetectionThresholdPercent = 85
    };

    VerificationResult verifyResult = signature.Verify(verifyOptions);

    if (verifyResult.IsValid && verifyOptions.DetectedProbability.HasValue)
    {
        Console.WriteLine($"Signature detected with {verifyOptions.DetectedProbability.Value}% probability");
    }
}

Поиск, оптимизированный LINQ, с предикатом

using GroupDocs.Signature;
using GroupDocs.Signature.Options;
using GroupDocs.Signature.Domain;

using (Signature signature = new Signature("document.pdf"))
{
    List<SearchOptions> searchOptions = new List<SearchOptions>
    {
        new TextSearchOptions()
    };

    // Filter only text signatures containing "Approved"
    SearchResult result = signature.Search(searchOptions,
        sig => sig is TextSignature txt && txt.Text.Contains("Approved"));

    foreach (BaseSignature sig in result.Signatures)
    {
        Console.WriteLine($"Found: {((TextSignature)sig).Text}");
    }
}

Верификация, оптимизированная LINQ, с предикатом

using (Signature signature = new Signature("signed_document.pdf"))
{
    TextVerifyOptions verifyOptions = new TextVerifyOptions("John Smith");

    // Verify only signatures on page 1
    List<BaseSignature> result = signature.Verify(verifyOptions,
        sig => sig.PageNumber == 1);

    Console.WriteLine($"Found {result.Count} verified signatures on page 1");
}

Как получить обновление

  • NuGet – Обновите до последней версии пакета GroupDocs.Signature: 
    dotnet add package GroupDocs.Signature --version 25.12
  • Прямая загрузка – Скачайте собранные сборки для .NET со страницы официального релиза:
    GroupDocs.Signature for .NET 25.12 DLLs

Ресурсы