GroupDocs.Signature для Python 26.1 – последние обновления и исправления (январь 2026)

Что нового в GroupDocs.Signature для Python 26.1 (Январь 2026)

ID	Категория	Краткое описание
SIGNATURENET‑5528	✨ Функция	Поддержка цифровой подписи изображения и её проверка (стеганографическое внедрение младших битов (LSB) для PNG & JPG).
SIGNATURENET‑5445	✨ Функция	Адаптивный рендеринг превью подписи штрих‑кода и QR‑кода – полный контроль ширины/высоты.
SIGNATURENET‑5479	✨ Функция	Поддержка вращения превью штрих‑кода и QR‑кода.
SIGNATURENET‑5478	✨ Функция	Добавлена обработка форматов изображений APNG и TGA для подписи на основе изображения.
SIGNATURENET‑5500	⚡ Улучшение	Оптимизация запросов в стиле LINQ для поиска и проверки подписей (фильтрация предикатом).
SIGNATURENET‑5480	⚡ Улучшение	Поддержка прозрачного фона для превью штрих‑кода/QR‑кода.
SIGNATURENET‑5477	⚡ Улучшение	Поддержка наложения изображения для цифровых подписей с фоновым цветом (флаг foreground‑image).
SIGNATURENET‑5422	⚡ Улучшение	Удаление небезопасных алгоритмов шифрования (RC2, DES, TripleDES и слабых режимов AES).
SIGNATURENET‑5555	🐞 Исправление	Исправлено исключение `GeneratePreview()` при инициализации типа для DOC‑файлов в Linux.

Ниже представлено краткое техническое руководство по наиболее значимым изменениям.

1. Цифровая подпись изображения (стеганография)

Подписи скрываются в наименее значимых битах пикселей PNG/JPG.
Защищено паролем, совместимо с потоками и работает с изображениями любого размера ≥ 8 × 8 px.

Подпись изображения

import groupdocs.signature as gs
import groupdocs.signature.options as gso

input_file  = "image.png"
output_file = "signed_image.png"
password    = "MySecurePassword123"

# Sign the image
with gs.Signature(input_file) as signature:
    sign_options = gso.ImageDigitalSignOptions()
    sign_options.password = password

    sign_result = signature.sign(output_file, sign_options)

    if sign_result.succeeded and len(sign_result.succeeded) > 0:
        print("Image signed successfully!")
        print(f"Signatures added: {len(sign_result.succeeded)}")

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

import groupdocs.signature as gs
import groupdocs.signature.options as gso

signed_file = "signed_image.png"
password    = "MySecurePassword123"

with gs.Signature(signed_file) as signature:
    verify_options = gso.ImageDigitalVerifyOptions()
    verify_options.password = password
    verify_options.detection_threshold_percent = 75  # optional 0‑100%

    verify_result = signature.verify(verify_options)

    if verify_result.is_valid:
        print("Digital signature is valid!")
        print(f"Verified signatures: {len(verify_result.succeeded)}")
    else:
        print("Digital signature is invalid or not found.")

Расширенная проверка (полное извлечение данных)

with gs.Signature("signed_image.png") as signature:
    verify_options = gso.ImageDigitalVerifyOptions()
    verify_options.password = "MySecurePassword123"
    verify_options.use_full_data_extraction = True
    verify_options.detection_threshold_percent = 85

    verify_result = signature.verify(verify_options)

    if verify_result.is_valid and verify_options.detected_probability is not None:
        print(f"Signature detected with {verify_options.detected_probability}% probability")

2. Адаптивный рендеринг превью штрих‑кода и QR‑кода

Разработчики теперь могут задавать точные width и height при генерации превью, устраняя прежние несоответствия «авто‑размера».

import groupdocs.signature as gs
import groupdocs.signature.options as gso
import uuid

# QR code options
qr_sign_options = gso.QrCodeSignOptions("GROUP DOCS", gs.QrCodeTypes.QR)
qr_sign_options.width  = 250
qr_sign_options.height = 270
qr_sign_options.fore_color = gs.Color.red
qr_sign_options.code_text_alignment = gs.CodeTextAlignment.BELOW
qr_sign_options.text = "GROUP DOCS"

# Preview generation
preview_options = gso.PreviewSignatureOptions(
    qr_sign_options,
    create_signature_stream,   # user‑provided delegate
    release_signature_stream   # user‑provided delegate
)
preview_options.signature_id   = str(uuid.uuid4())
preview_options.preview_format = gso.PreviewSignatureOptions.PreviewFormats.PNG

gs.Signature.generate_signature_preview(preview_options)

3. Поддержка вращения превью штрих‑кода и QR‑кода

Укажите rotation_angle (в градусах) в параметрах штрих‑кода/QR‑кода для рендеринга повернутых превью.

import groupdocs.signature as gs
import groupdocs.signature.options as gso
import uuid

barcode_sign_options = gso.BarcodeSignOptions("GROUP DOCS", gs.BarcodeTypes.MaxiCode)
barcode_sign_options.width          = 400
barcode_sign_options.height         = 400
barcode_sign_options.fore_color     = gs.Color.red
barcode_sign_options.code_text_alignment = gs.CodeTextAlignment.BELOW
barcode_sign_options.text           = "GROUP DOCS"
barcode_sign_options.rotation_angle = 45   # rotate 45°

preview_options = gso.PreviewSignatureOptions(
    barcode_sign_options,
    create_signature_stream,
    release_signature_stream
)
preview_options.signature_id   = str(uuid.uuid4())
preview_options.preview_format = gso.PreviewSignatureOptions.PreviewFormats.PNG

gs.Signature.generate_signature_preview(preview_options)

4. Новая поддержка форматов изображений – APNG & TGA

Файлы APNG (анимированный PNG) и TGA (Targa) теперь можно использовать в качестве изображений‑подписей, вставлять, просматривать и проверять так же, как PNG/JPG.

5. Прозрачный фон для превью штрих‑кода/QR‑кода

Установите свойство transparency (0 – 1) в параметрах штрих‑кода/QR‑кода, чтобы получать превью с прозрачным холстом.

barcode_sign_options = gso.BarcodeSignOptions("GROUP DOCS", gs.BarcodeTypes.Codabar)
barcode_sign_options.width  = 400
barcode_sign_options.height = 400
barcode_sign_options.fore_color = gs.Color.red
barcode_sign_options.code_text_alignment = gs.CodeTextAlignment.BELOW
barcode_sign_options.text = "GROUP DOCS"
barcode_sign_options.transparency = 0.5   # 50 % transparent background

preview_options = gso.PreviewSignatureOptions(
    barcode_sign_options,
    create_signature_stream,
    release_signature_stream
)
preview_options.signature_id = str(uuid.uuid4())
preview_options.preview_format = gso.PreviewSignatureOptions.PreviewFormats.PNG

gs.Signature.generate_signature_preview(preview_options)

6. Поддержка наложения изображения для цифровых подписей

PdfDigitalSignatureAppearance теперь учитывает наложенное изображение и фоновый цвет без скрытия изображения. Управляйте слоем через SignatureCustomAppearance.IsForegroundImage.

import groupdocs.signature as gs
import groupdocs.signature.options as gso

signature_image_path = "signature.png"
certificate_path      = "JohnSmithCertificate.pfx"

input_pdf  = "SampleDocument.pdf"
output_pdf = "SignedDocument.pdf"

with gs.Signature(input_pdf) as signature:
    sign_options = gso.DigitalSignOptions(certificate_path)
    sign_options.password = "1234567890"
    sign_options.reason   = "Document approval"
    sign_options.contact  = "John Smith"
    sign_options.location = "Head Office"

    # Visible signature placement
    sign_options.visible = True
    sign_options.left    = 350
    sign_options.top     = 100
    sign_options.width   = 200
    sign_options.height  = 70
    sign_options.image_file_path = signature_image_path

    appearance = gso.PdfDigitalSignatureAppearance()
    appearance.foreground = gs.Color.from_argb(50, gs.Color.brown)
    appearance.font_family_name = "Times New Roman"
    appearance.font_size = 12
    appearance.background = gs.Color.from_argb(50, gs.Color.light_gray)
    appearance.is_foreground_image = True   # image on top of text

    sign_options.appearance = appearance

    sign_result = signature.sign(output_pdf, sign_options)

    print(f"\nDocument signed successfully with {len(sign_result.succeeded)} signature(s).")
    print(f"Signed file saved at: {output_pdf}")

7. Усиление безопасности – удаление небезопасных алгоритмов

RC2, DES, TripleDES и слабые режимы AES удалены из криптографического стека. Доступны только современные алгоритмы, одобренные NIST, что повышает базовый уровень защиты подписанных документов.

8. Оптимизация запросов в стиле LINQ

Методы search и verify теперь принимают функции‑предикаты, которые фильтруют подписи до тяжёлых этапов обработки. Это сокращает потребление памяти и ускоряет пакетные операции.

Поиск с предикатом

import groupdocs.signature as gs
import groupdocs.signature.options as gso
import groupdocs.signature.domain as gsd

with gs.Signature("document.pdf") as signature:
    search_options = [gso.TextSearchOptions()]

    # Оставить только текстовые подписи, содержащие слово "Approved"
    result = signature.search(search_options,
        lambda sig: isinstance(sig, gsd.TextSignature) and "Approved" in sig.text)

    for sig in result.signatures:
        print(f"Found: {sig.text}")

Проверка с предикатом

with gs.Signature("signed_document.pdf") as signature:
    verify_options = gso.TextVerifyOptions("John Smith")

    # Проверять только подписи на странице 1
    result = signature.verify(verify_options,
        lambda sig: sig.page_number == 1)

    print(f"Found {len(result)} verified signatures on page 1")

9. Исправлен сбой превью DOC в Linux

GeneratePreview() больше не бросает TypeInitializerException при обработке файлов Microsoft Word (.doc) в Linux, что восстанавливает кросс‑платформенную функциональность превью.

Инструкции по обновлению

pip install --upgrade groupdocs-signature-net

Примечание: имя пакета groupdocs-signature-net используется для обёртки Python‑через‑.NET.

Ресурсы

Полные примечания к выпуску: (link to the official release notes page, if available)
Документация: https://docs.groupdocs.com/signature/python/
Сообщество и поддержка: https://forum.groupdocs.com/c/signature/10

Следите за будущими выпусками и держите глаз на официальном блоге, где публикуются советы по производительности и рекомендации по лучшим практикам.

Что нового в GroupDocs.Signature для Python 26.1 (Январь 2026)#

1. Цифровая подпись изображения (стеганография)#

Подпись изображения#

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

Расширенная проверка (полное извлечение данных)#

2. Адаптивный рендеринг превью штрих‑кода и QR‑кода#

3. Поддержка вращения превью штрих‑кода и QR‑кода#

4. Новая поддержка форматов изображений – APNG & TGA#

5. Прозрачный фон для превью штрих‑кода/QR‑кода#

6. Поддержка наложения изображения для цифровых подписей#

7. Усиление безопасности – удаление небезопасных алгоритмов#

8. Оптимизация запросов в стиле LINQ#

Поиск с предикатом#

Проверка с предикатом#

9. Исправлен сбой превью DOC в Linux#

Инструкции по обновлению#

Ресурсы#