Documentation – Защищать и подписывать PDF‑файлы в Python

Python-Net: Добавить цифровую подпись или подписать PDF в Python

Wed, 15 Apr 2026 00:00:00 +0000

Подписать PDF с помощью цифровых подписей

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def sign_document(infile: str, outfile: str, pfxfile: str) -> None:
    """Sign a PDF document with a PKCS#7 certificate."""
    with ap.Document(infile) as document:
        with ap.facades.PdfFileSignature(document) as signature:
            pkcs = ap.forms.PKCS7(pfxfile, "12345")
            signature.sign(1, True, drawing.Rectangle(300, 100, 400, 200), pkcs)
            signature.save(outfile)

Подпись PKCS#7 detached signature добавляет цифровую подпись к документу, не встраивая содержимое в блок подписи.

Используйте эти примеры, когда вам нужно применять подписи на основе сертификата к PDF‑файлам, проверять действительность подписи или добавлять доверенные временные метки к подписанным документам.

Следующий пример подписывает PDF‑документ, используя отдельную цифровую подпись PKCS#7, применяя подпись к первой странице в указанной прямоугольной области.

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def sign_document_PKCS7_detached(
    infile: str,
    outfile: str,
    pfxfile: str,
    password: str,
) -> None:
    """Sign a PDF document with a detached PKCS#7 certificate."""
    with ap.Document(infile) as document:
        with ap.facades.PdfFileSignature(document) as signature:
            pkcs = ap.forms.PKCS7Detached(
                pfxfile,
                password,
                ap.DigestHashAlgorithm.SHA256,
            )
            signature.sign(1, True, drawing.Rectangle(300, 100, 400, 200), pkcs)
            signature.save(outfile)

Проверьте все цифровые подписи в PDF‑документе

Создает экземпляр PdfFileSignature, который позволяет взаимодействовать с подписями в PDF.
Получите список имен подписей get_signature_names(True).
Проверяет первую подпись в списке verify_signature для соответствия указанному сертификату.

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def verify(infile: str) -> None:
    """Verify all digital signatures in a PDF document."""
    with ap.Document(infile) as document:
        with ap.facades.PdfFileSignature(document) as signature:
            for signature_name in signature.get_signature_names(True):
                if not signature.verify_signature(signature_name):
                    raise Exception("Not verified")

Проверить подпись с использованием файла сертификата открытого ключа

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def verify_with_public_key_certificate1(certificate: str, infile: str) -> None:
    """Verify a signature with a public key certificate file."""
    with ap.facades.PdfFileSignature(infile) as file_sign:
        signature_names = file_sign.get_signature_names(True)
        with open(certificate, "rb") as file_stream:
            certificate_bytes = file_stream.read()
        print(file_sign.verify_signature(signature_names[0], certificate_bytes))

Проверьте подпись с сертификатом, извлечённым из файла

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def verify_with_public_key_certificate_from_signature(infile: str) -> None:
    """Verify a signature with the certificate extracted from the file."""
    with ap.facades.PdfFileSignature(infile) as file_sign:
        signature_names = file_sign.get_signature_names(True)
        certificate = []
        if file_sign.try_extract_certificate(signature_names[0], certificate):
            print(file_sign.verify_signature(signature_names[0], certificate[0]))
        else:
            print(False)

Проверка подписей с включённой проверкой цепочки сертификатов

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def verify_signature_with_certificate_check(infile: str) -> None:
    """Verify signatures with certificate-chain validation enabled."""
    with ap.Document(infile) as document:
        with ap.facades.PdfFileSignature(document) as signature:
            for signature_name in signature.get_signature_names(True):
                options = ap.security.ValidationOptions()
                options.validation_mode = ap.security.ValidationMode.STRICT
                options.validation_method = ap.security.ValidationMethod.AUTO
                options.check_certificate_chain = True
                options.request_timeout = 20000
                validation_result = []
                verified = signature.verify_signature(
                    signature_name,
                    options,
                    validation_result,
                )
                print(f"Certificate validation result: {validation_result[0].status}")
                print(f"Is verified: {verified}")

Добавить метку времени к цифровой подписи

Как подписать цифровой подписью PDF с отметкой времени

Aspose.PDF for Python поддерживает цифровую подпись PDF с использованием сервера меток времени или веб‑сервиса.

Для выполнения этого требования, TimestampSettings класс был добавлен в пространство имен Aspose.PDF. Пожалуйста, посмотрите следующий фрагмент кода, который получает метку времени и добавляет её в PDF‑документ:

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def sign_with_time_stamp_server(
    infile: str,
    outfile: str,
    pfxfile: str,
    password: str,
) -> None:
    """Sign a PDF document and apply a timestamp from an external server."""
    with ap.Document(infile) as document:
        with ap.facades.PdfFileSignature(document) as signature:
            pkcs = ap.forms.PKCS7(pfxfile, password)
            pkcs.timestamp_settings = ap.TimestampSettings(
                "https://freetsa.org/tsr",
                "",
                ap.DigestHashAlgorithm.SHA256,
            )
            rect = drawing.Rectangle(100, 100, 200, 100)
            signature.sign(
                1, "Signature Reason", "Contact", "Location", True, rect, pkcs
            )
            signature.save(outfile)

Подписание PDF‑документов с использованием ECDSA

Подписание PDF‑документов с использованием ECDSA (Эллиптический алгоритм цифровой подписи) подразумевает применение криптографии эллиптических кривых для создания цифровых подписей.

Приведённый выше фрагмент кода демонстрирует, как применить отдельную (detached) цифровую подпись PKCS#7 к документу PDF с использованием Aspose.PDF for Python. Загрузив документ, настроив внешний вид подписи и параметры безопасности, а затем сохранив результат, данный пример показывает полный, надёжный процесс цифровой подписи PDF‑файлов.

Этот метод обеспечивает подлинность и целостность документа, внедряя безопасную, проверяемую подпись на первой странице. Использование SHA-256 в качестве алгоритма хеширования соответствует современным криптографическим стандартам, а возможность управлять размещением подписи предоставляет гибкость для видимых отметок одобрения.

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def sign_ecdsa(infile: str, outfile: str, pfxfile: str, password: str) -> None:
    """Sign a PDF document with an ECDSA signature."""
    with ap.Document(infile) as document:
        with ap.facades.PdfFileSignature(document) as signature:
            pkcs = ap.forms.PKCS7Detached(
                pfxfile,
                password,
                ap.DigestHashAlgorithm.SHA256,
            )
            signature.sign(1, True, drawing.Rectangle(300, 100, 400, 200), pkcs)
            signature.save(outfile)

Проверить подписи ECDSA в PDF‑документе

def verify_ecdsa(infile: str) -> None:
    """Verify ECDSA signatures in a PDF document."""
    with ap.Document(infile) as document:
        with ap.facades.PdfFileSignature(document) as signature:
            if not signature.contains_signature():
                raise Exception("Not contains signature")

            for signature_name in signature.get_signature_names(True):
                if not signature.verify_signature(signature_name):
                    raise Exception("Not verified")

Связанные темы безопасности

Python-Net: Извлечь информацию о подписи из PDF на Python

Wed, 15 Apr 2026 00:00:00 +0000

Извлечь изображение из поля подписи

Aspose.PDF for Python via .NET позволяет вам извлечь визуальное изображение, встроенное в Поле подписи. Это полезно, когда нужно отображать или архивировать внешний вид подписи без рендеринга полного PDF.

Пример ниже перебирает все поля формы, находя каждое SignatureField, и сохраняет его изображение в файл JPEG:

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def extract_images_from_signature_field(infile: str, outfile: str) -> None:
    """Extract the image stored in a signature field."""
    with ap.Document(infile) as document:
        for field in document.form:
            if not isinstance(field, ap.forms.SignatureField):
                continue

            image_stream = field.extract_image()
            if image_stream is None:
                continue

            image = drawing.Bitmap.from_stream(image_stream)
            image.save(outfile, drawing.imaging.ImageFormat.jpeg)

Прочитать детали алгоритма подписи

Использовать PdfFileSignature.get_signatures_info() чтобы прочитать криптографические метаданные для каждой подписи в документе — включая алгоритм хеша, тип алгоритма, криптографический стандарт и имя подписи:

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def get_signatures_info(infile: str) -> None:
    """Print information about all signatures in a PDF document."""
    with ap.Document(infile) as document:
        with ap.facades.PdfFileSignature(document) as signature:
            for signature_info in signature.get_signatures_info():
                print(signature_info.DIGEST_HASH_ALGORITHM)
                print(signature_info.ALGORITHM_TYPE)
                print(signature_info.CRYPTOGRAPHIC_STANDARD)
                print(signature_info.signature_name)

Извлечь цифровой сертификат из поля подписи

Используйте extract_certificate метод на SignatureField получить встроенный сертификат в виде потока байтов и сохранить его на диск для внешней проверки:

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def extract_certificate(infile: str, outfile: str) -> None:
    """Extract a certificate from a signature field and save it to disk."""
    with ap.Document(infile, password="owner") as document:
        for field in document.form:
            if not isinstance(field, ap.forms.SignatureField):
                continue

            certificate_stream = field.extract_certificate()
            if certificate_stream is None:
                continue

            with certificate_stream:
                bytes_data = bytearray(certificate_stream.length)
                certificate_stream.read(bytes_data, 0, len(bytes_data))
                with open(outfile, "wb") as file_stream:
                    file_stream.write(bytes_data)
                return

Извлечение сертификатов с помощью фасада PdfFileSignature

PdfFileSignature.try_extract_certificate() предоставляет альтернативный способ получения сертификатов по имени подписи. В следующем примере происходит перебор всех имён подписей и попытка извлечения для каждого:

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def extract_certificate_try_extract_certificate_method(infile: str) -> None:
    """Extract certificates with the try_extract_certificate facade method."""
    with ap.Document(infile, password="owner") as document:
        with ap.facades.PdfFileSignature(document) as signature:
            for signature_name in signature.get_signature_names(True):
                certificate = []
                if signature.try_extract_certificate(signature_name, certificate):
                    print("The certificate extraction succeeded")

Проверить внешние цифровые подписи

Чтобы подтвердить, что документ не был изменён после подписания, проверьте каждую внешнюю подпись, используя PdfFileSignature.verify_signature(). Пример ниже вызывает исключение для любой подписи, которая не проходит проверку:

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def verify_external_signature(infile: str) -> None:
    """Verify an external signature in a PDF document."""
    with ap.Document(infile) as document:
        with ap.facades.PdfFileSignature(document) as pdf_signature:
            for signature_name in pdf_signature.get_signature_names(True):
                if not pdf_signature.verify_signature(signature_name):
                    raise Exception("Not verified")

Обнаружить компрометированные подписи

SignaturesCompromiseDetector проверяет, были ли какие-либо цифровые подписи в документе аннулированы последующими изменениями. Используйте это в юридических, финансовых или комплаенс‑процессах, где необходимо гарантировать целостность документа.

Пример ниже проверяет наличие скомпрометированных подписей и выводит их имена вместе с общим покрытием подписей в документе:

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def check(infile: str) -> None:
    """Check whether a PDF contains compromised signatures."""
    with ap.Document(infile) as document:
        detector = ap.SignaturesCompromiseDetector(document)
        result = []

        if detector.check(result):
            print("No signature compromise detected")
            return

        if result[0].has_compromised_signatures:
            print(
                f"Count of compromised signatures: {len(result[0].COMPROMISED_SIGNATURES)}"
            )
            for signature_name in result[0].COMPROMISED_SIGNATURES:
                print(f"Signature name: {signature_name.FULL_NAME}")

        print(result[0].signatures_coverage)

Связанные темы безопасности

Python-Net: Подписать PDF‑документы со смарт‑карты на Python

Wed, 15 Apr 2026 00:00:00 +0000

Aspose.PDF предоставляет надёжные возможности для интеграции визуальных и криптографических компонентов подписи, обеспечивая как подлинность, так и профессиональное представление в цифрово подписанных PDF‑документах.

Используйте этот рабочий процесс, когда ваш процесс подписи зависит от сертификатов, хранящихся в аппаратно‑защищённых устройствах, таких как смарт‑карты, USB‑токены или управляемые хранилища сертификатов.

Подписать с помощью смарт‑карты, используя поле подписи

Этот пример демонстрирует, как цифрово подписать PDF‑документ с использованием внешнего сертификата с помощью Aspose.PDF for Python и применить пользовательское изображение внешнего вида подписи:

Открытие PDF‑документа.
Создание объекта PdfFileSignature и привязка его к документу.
Получение локального цифрового сертификата с использованием пользовательского метода get_local_certificate().
Настройка ExternalSignature на основе выбранного сертификата.
Применение пользовательского изображения внешнего вида подписи (например, логотип компании или рукописная подпись).
Цифровая подпись первой страницы документа с указанными метаданными (причина, контакт, местоположение).
Сохранение подписанного документа в новый выходной файл.

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

Ниже приведены фрагменты кода для подписи PDF‑документа с помощью смарт‑карты:

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def sign_with_smart_card(infile: str, outfile: str, pngfile: str) -> None:
    """Sign a PDF document using a smart-card certificate."""
    with ap.Document(infile) as document:
        with ap.facades.PdfFileSignature() as pdf_signature:
            pdf_signature.bind_pdf(document)
            external_signature = ap.forms.ExternalSignature(get_local_certificate())
            pdf_signature.signature_appearance = pngfile
            pdf_signature.sign(
                1,
                "Reason",
                "Contact",
                "Location",
                True,
                drawing.Rectangle(100, 100, 200, 200),
                external_signature,
            )
            pdf_signature.save(outfile)

Проверка цифровых подписей

Этот фрагмент кода демонстрирует, как проверить цифровые подписи в PDF‑документе с использованием Aspose.PDF for Python:

Открытие PDF‑файла.
Создание объекта ‘PdfFileSignature’ и привязка его к документу.
Получение списка всех имен полей подписи с помощью ‘get_signature_names()’.
Перебор каждой подписи и проверка её действительности с помощью ‘verify_signature()’.
Выброс исключения, если какая‑либо подпись не проходит проверку.

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def verify_external_signature(infile: str) -> None:
    """Verify an external signature in a PDF document."""
    with ap.Document(infile) as document:
        with ap.facades.PdfFileSignature(document) as pdf_signature:
            for signature_name in pdf_signature.get_signature_names(True):
                if not pdf_signature.verify_signature(signature_name):
                    raise Exception("Not verified")

Подписать с использованием внешнего сертификата

Этот фрагмент кода демонстрирует, как добавить и подписать поле цифровой подписи в документе PDF с помощью Aspose.PDF for Python с внешним сертификатом:

Открытие PDF‑файла как бинарного потока.
Создание SignatureField и размещение его на первой странице документа в указанной позиции.
Получение локального цифрового сертификата с использованием пользовательского метода get_local_certificate().
Настройка ExternalSignature с метаданными, такими как authority, reason и контактная информация.
Назначение уникального имени полю подписи (partial_name = “sig1”).
Добавление поля подписи к полям формы PDF.
Подписание поля с использованием внешнего сертификата.
Сохранение подписанного документа в выходной файл.

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def get_signature_info_using_signature_field(infile: str, outfile: str) -> None:
    """Create a signature field and sign it with an external certificate."""
    with open(infile, "rb+") as file_stream:
        document = ap.Document(file_stream)
        signature_field = ap.forms.SignatureField(
            document.pages[1],
            ap.Rectangle(100, 400, 10, 10, True),
        )
        selected_certificate = get_local_certificate()
        external_signature = ap.forms.ExternalSignature(selected_certificate)
        external_signature.authority = "Me"
        external_signature.reason = "Reason"
        external_signature.contact_info = "Contact"
        signature_field.partial_name = "sig1"
        document.form.add(signature_field, 1)
        signature_field.sign(external_signature)
        document.save(outfile)

Связанные темы безопасности

Python-Net: Шифрование и расшифровка PDF-файлов на Python

Wed, 15 Apr 2026 00:00:00 +0000

Управление безопасностью документа имеет решающее значение при работе с конфиденциальным или бизнес‑критически важным контентом. Aspose.PDF for Python via .NET предоставляет мощный API для программного применения шифрования, контроля доступа через права и расшифровки защищённых PDF‑файлов.

В этой статье разработчиков Python познакомят с практическими примерами по настройке привилегий, применению и снятию шифрования, изменению паролей и обнаружению состояний защиты — всё в рамках рабочего процесса с PDF.

Aspose.PDF for Python via .NET дает разработчикам полный контроль над безопасностью PDF:

Установить привилегии - Тонко настроенный контроль доступа с использованием разрешений. Зашифровать файл - Применить шифрование AES или RC4 с пользовательскими паролями. Расшифровать файл - Удалить защиту, используя пароль владельца. Изменить пароли - Смените или обновите учетные данные без изменения содержимого. Проверка безопасности - Обнаружить статус шифрования или требуемые типы паролей.

Используйте эту страницу, когда вам нужно защищать PDF‑документы паролями, ограничивать печать или копирование, менять учётные данные или проверять, зашифрован ли документ.

Установить привилегии для существующего PDF‑файла

Вы можете ограничить или разрешить определённые операции (например, печать, копирование, заполнение форм), назначая пользовательские и владелецкие пароли вместе с правами доступа.

import sys
from os import path

import aspose.pdf as ap
import aspose.pydrawing as drawing

def set_privileges_on_existing_pdf_file(infile: str, outfile: str) -> None:
    """Set restricted privileges on an existing PDF document."""
    with ap.Document(infile) as document:
        document_privilege = ap.facades.DocumentPrivilege.forbid_all
        document_privilege.allow_screen_readers = True
        document.encrypt(
            "user",
            "owner",
            document_privilege,
            ap.CryptoAlgorithm.AESx128,
            False,
        )
        document.save(outfile)

Шифрование PDF-файла с использованием различных типов шифрования и алгоритмов

Шифрование PDF гарантирует, что только пользователи с действительными учетными данными могут открыть или изменить файл.

Ключевые термины:

Пароль пользователя. Требуется для открытия документа.
Пароль владельца. Требуется для изменения разрешений или снятия шифрования.
KeySize. Используйте AE_SX128 для максимальной безопасности в современных процессах.

Следующий фрагмент кода показывает, как зашифровать PDF‑файлы.

import sys
from os import path

import aspose.pdf as ap
import aspose.pydrawing as drawing

def encrypt_pdf_file(infile: str, outfile: str) -> None:
    """Encrypt a PDF document with user and owner passwords."""
    with ap.Document(infile) as document:
        document.encrypt(
            "user",
            "owner",
            ap.Permissions.EXTRACT_CONTENT,
            ap.CryptoAlgorithm.AESx128,
        )
        document.save(outfile)

Расшифровать PDF-файл, используя пароль владельца

Чтобы удалить защиту паролем и восстановить полный доступ:

Загружает зашифрованный PDF, используя правильный пароль (‘password’ — это пароль пользователя или владельца).
Удаляет всю защиту паролем и настройки шифрования из документа.
Сохраняет теперь незащищённый PDF в указанный файл вывода.

import sys
from os import path

import aspose.pdf as ap
import aspose.pydrawing as drawing

def decrypt_pdf_file(infile: str, outfile: str) -> None:
    """Decrypt a password-protected PDF document."""
    with ap.Document(infile, "password") as document:
        document.decrypt()
        document.save(outfile)

Шифрование и дешифрование PDF с сертификатами открытого ключа

import sys
from os import path

import aspose.pdf as ap
import aspose.pydrawing as drawing

def pub_sec_encryption(
    crypto_algorithm,
    pub_cert: str,
    in_pfx: str,
    outfile: str,
) -> None:
    """Demonstrate public-key encryption and decryption."""
    pfx_password = "12345"

    with ap.Document() as document:
        document.info.title = "TestTitle"
        document.info.author = "TestAuthor"
        page = document.pages.add()
        page.paragraphs.add(ap.text.TextFragment("Hello World!"))

        with open(pub_cert, "rb") as file_stream:
            byte_content = file_stream.read()

        document.encrypt(
            ap.Permissions.PRINT_DOCUMENT,
            crypto_algorithm,
            [byte_content],
        )
        document.save(outfile)

    with ap.Document(
        outfile,
        ap.security.CertificateEncryptionOptions(pub_cert, in_pfx, pfx_password),
    ) as document:
        print(document.info.title)
        print(document.info.author)

        text_absorber = ap.text.TextAbsorber()
        document.pages[1].accept(text_absorber)
        print(text_absorber.text)

        document.decrypt()
        document.save(path.join(path.dirname(outfile), "pubsec_decrypted_out.pdf"))

Изменить пароль PDF‑файла

Обновить учетные данные безопасности (пароли пользователя и владельца) PDF‑документа, сохранив его содержимое и структуру.

Открывает PDF, используя существующий пароль владельца (‘owner’), который предоставляет полный доступ, включая возможность изменять настройки безопасности.
Заменяет старые пароли новым паролем пользователя (’newuser’) и новым паролем владельца (’newowner’).
Сохраняет PDF с обновлёнными настройками пароля.

import sys
from os import path

import aspose.pdf as ap
import aspose.pydrawing as drawing

def change_password(infile: str, outfile: str) -> None:
    """Change the passwords of a password-protected PDF document."""
    with ap.Document(infile, "owner") as document:
        document.change_passwords("owner", "newuser", "newowner")
        document.save(outfile)

Как определить, защищён ли исходный PDF паролем

Определить правильный пароль из массива

В некоторых сценариях вам может потребоваться определить правильный пароль из списка потенциальных вариантов, чтобы получить доступ к защищённому PDF. Приведённый ниже фрагмент кода демонстрирует, как проверить, защищён ли файл PDF паролем, а затем попытаться разблокировать его, перебирая заранее определённый список паролей с помощью Aspose.PDF for Python via .NET.

Процесс включает:

Использование PdfFileInfo для определения, зашифрован ли PDF.
Пытается открыть PDF с каждым паролем, используя ap.Document().
Если успешно, он выводит количество страниц.
Если нет, он перехватывает исключение и сообщает о неправильном пароле.

import sys
from os import path

import aspose.pdf as ap
import aspose.pydrawing as drawing

def determine_correct_password_from_array(infile: str) -> None:
    """Try a list of passwords until the document opens successfully."""
    with ap.facades.PdfFileInfo() as pdf_file_info:
        pdf_file_info.bind_pdf(infile)
        print(f"File is password protected {pdf_file_info.is_encrypted}")

    passwords = ["test", "test1", "test2", "test3", "sample"]

    for password in passwords:
        try:
            with ap.Document(infile, password) as document:
                if len(document.pages) > 0:
                    print(f"Password = {password} is correct")
                    print(f"Number of pages in document = {len(document.pages)}")
                    break
        except Exception:
            print(f"Password = {password} is not correct")