Documentation – Класс PdfFileSignature

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

Tue, 14 Apr 2026 00:00:00 +0000

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

В этой статье демонстрируются несколько типичных рабочих процессов подписи:

Создайте и привязать a PdfFileSignature объект во входном PDF.
Настройте сертификат подписи.
Примените цифровую подпись к целевой странице.
При необходимости задайте имя подписи и её видимый вид.
Сохраните подписанный PDF.

Подготовьте переиспользуемые вспомогательные функции подписания

Прежде чем применять цифровую подпись к PDF, полезно создать небольшую группу переиспользуемых вспомогательных функций. Эти функции инициализируют обработчик подписи, определяют видимую область подписи, настраивают сертификат и создают переиспользуемые объекты подписи PKCS#7, чтобы примеры подписания ниже оставались автономными и их было проще понять.

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd


DEFAULT_CERTIFICATE_PASSWORD = "Aspose2021"
DEFAULT_SIGNATURE_NAME = "Signature1"


def create_pdf_file_signature(infile):
    pdf_signature = pdf_facades.PdfFileSignature()
    pdf_signature.bind_pdf(infile)
    return pdf_signature


def create_signature_rectangle():
    return apd.Rectangle(10, 10, 200, 60)


def configure_signature_certificate(
    pdf_signature, certificate_path, certificate_password=DEFAULT_CERTIFICATE_PASSWORD
):
    pdf_signature.set_certificate(certificate_path, certificate_password)


def create_pkcs7_signature(
    certificate_path, certificate_password=DEFAULT_CERTIFICATE_PASSWORD
):
    signature = ap.forms.PKCS7(certificate_path, certificate_password)
    signature.reason = "Document approval"
    signature.contact_info = "qa@example.com"
    signature.location = "New York, USA"
    signature.authority = "Aspose.PDF Example"
    return signature


def create_custom_signature_appearance():
    appearance = ap.forms.SignatureCustomAppearance()
    appearance.font_family_name = "Arial"
    appearance.font_size = 10
    appearance.show_contact_info = True
    appearance.show_location = True
    appearance.show_reason = True
    return appearance

Подписание PDF с базовыми параметрами сертификата

Этот подход настраивает сертификат напрямую на PdfFileSignature объект. Это полезно, когда вам нужен простой процесс подписи со стандартными метаданными подписи и без отдельного управления объектом подписи.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def sign_pdf_with_basic_parameters(infile, outfile, certificate_path):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        configure_signature_certificate(pdf_signature, certificate_path)
        pdf_signature.sign(
            1,
            "Document approval",
            "qa@example.com",
            "New York, USA",
            False,
            create_signature_rectangle(),
        )
        pdf_signature.save(outfile)
    finally:
        pdf_signature.close()

Подписание PDF с объектом PKCS7

Использовать PKCS7 объект, когда вам нужно сначала подготовить подпись, а затем передать её в вызов подписи. Этот шаблон даёт вам больший контроль над настройками подписи и является хорошей основой для более сложных рабочих процессов.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def sign_pdf_with_certificate_object(infile, outfile, certificate_path):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        signature = create_pkcs7_signature(certificate_path)
        pdf_signature.sign(1, False, create_signature_rectangle(), signature)
        pdf_signature.save(outfile)
    finally:
        pdf_signature.close()

Подписание PDF с именованной подписью

Если ваш рабочий процесс с документом зависит от заранее определенного имени поля подписи, передайте это имя в sign(). Это упрощает последующее обращение к подписи для проверки, обработки или интеграции с процессом утверждения.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def sign_pdf_with_named_signature(infile, outfile, certificate_path):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        signature = create_pkcs7_signature(certificate_path)
        signature.reason = "Approved by signing workflow"
        pdf_signature.sign(
            1,
            DEFAULT_SIGNATURE_NAME,
            "Approved by signing workflow",
            "qa@example.com",
            "New York, USA",
            True,
            create_signature_rectangle(),
            signature,
        )
        pdf_signature.save(outfile)
    finally:
        pdf_signature.close()

Применить видимую подпись

Вы можете сделать подпись видимой на странице PDF, присвоив ей пользовательский внешний вид PKCS7 объекта. Это полезно, когда выходной документ должен отображать детали одобрения, такие как причина, место и контактная информация для конечных пользователей.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def apply_visible_signature(infile, outfile, certificate_path):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        signature = create_pkcs7_signature(certificate_path)
        signature.reason = "Visible approval signature"
        signature.custom_appearance = create_custom_signature_appearance()
        pdf_signature.sign(
            1,
            "Visible approval signature",
            "qa@example.com",
            "New York, USA",
            True,
            create_signature_rectangle(),
            signature,
        )
        pdf_signature.save(outfile)
    finally:
        pdf_signature.close()

Python-Net: Сертификация PDF

Thu, 02 Apr 2026 00:00:00 +0000

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

В этой статье демонстрируются два типичных рабочего процесса сертификации:

Сертифицировать PDF и разрешить заполнение форм после сертификации.
Сертифицировать PDF и предотвратить любые дальнейшие изменения.

Сертифицировать PDF для заполнения форм

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

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def certify_pdf_with_mdp_signature(infile, outfile, certificate_path):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        doc_mdp_signature = create_doc_mdp_signature(
            certificate_path,
            ap.forms.DocMDPAccessPermissions.FILLING_IN_FORMS,
            reason="Certified for form filling and signing",
        )
        pdf_signature.certify(
            1,
            "Certified for form filling and signing",
            "security@example.com",
            "New York, USA",
            True,
            create_signature_rectangle(),
            doc_mdp_signature,
        )
        pdf_signature.save(outfile)
    finally:
        pdf_signature.close()

Применить сертификацию на уровне документа без разрешения на изменения

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

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def apply_document_level_certification(infile, outfile, certificate_path):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        doc_mdp_signature = create_doc_mdp_signature(
            certificate_path,
            ap.forms.DocMDPAccessPermissions.NO_CHANGES,
            reason="Certified with no further changes allowed",
        )
        pdf_signature.certify(
            1,
            "Certified with no further changes allowed",
            "security@example.com",
            "New York, USA",
            True,
            create_signature_rectangle(),
            doc_mdp_signature,
        )
        pdf_signature.save(outfile)
    finally:
        pdf_signature.close()

Python-Net: Ревизия и разрешения

Thu, 02 Apr 2026 00:00:00 +0000

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

В этом примере демонстрируются три типовых задачи инспекции:

Получить номер ревизии для существующей подписи.
Получить общее количество ревизий в подписанном документе.
Прочитать разрешения доступа из сертифицированного PDF.

Получение номер ревизии подписи

Используйте этот подход, когда PDF уже содержит одну или несколько подписей, и вам необходимо определить ревизию, связанную с конкретной подписью. Пример получает имя первой доступной подписи и затем вызывает get_revision().

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def get_signature_revision(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        signature_revision = pdf_signature.get_revision(sign_name)
        print(f"Signature Revision for '{sign_name}': {signature_revision}")
    finally:
        pdf_signature.close()

Получение общее количество ревизий документа

Использовать get_total_revision() когда вам нужно узнать, сколько ревизий хранится в подписанном PDF. Это полезно для проверки того, прошёл ли документ через несколько обновлений после применения оригинальной подписи.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def get_total_document_revisions(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        total_revisions = pdf_signature.get_total_revision()
        print(f"Total Document Revisions: {total_revisions}")
    finally:
        pdf_signature.close()

Получение разрешения доступа из сертифицированного PDF

Сертифицированные документы могут определять, какие изменения разрешены после сертификации. Использовать get_access_permissions() проверить этот уровень разрешений и определить, разрешает ли документ отсутствие изменений, заполнение форм или другие контролируемые модификации.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def get_access_permissions(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        access_permissions = pdf_signature.get_access_permissions()
        print(f"Access Permissions: {access_permissions}")
    finally:
        pdf_signature.close()

Python-Net: Извлечение подписи

Thu, 02 Apr 2026 00:00:00 +0000

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

В этом примере демонстрируются два распространённых задания по извлечению:

Извлечь визуальное изображение, связанное с подписью.
Извлечь сертификат подписи из подписанного PDF.

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

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

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def extract_signature_image(infile, outfile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        signature_image = pdf_signature.extract_image(sign_name)
        write_stream_data(signature_image, outfile)
    finally:
        pdf_signature.close()

Извлечение сертификат подписи

Используйте extract_certificate() когда вам нужны данные сертификата, прикреплённые к подписи. Это полезно для проверки, процессов валидации или отдельного хранения сертификата подписывающего от PDF‑документа.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def extract_signature_certificate(infile, outfile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        signature_certificate = pdf_signature.extract_certificate(sign_name)
        write_stream_data(signature_certificate, outfile)
    finally:
        pdf_signature.close()

Python-Net: Информация о подписи

Thu, 02 Apr 2026 00:00:00 +0000

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

Этот пример демонстрирует четыре распространённых задачи по работе с информацией о подписи:

Перечислите все имена подписей в подписанном PDF.
Прочитайте детали подписанта для выбранной подписи.
Получите дату и время подписи.
Прочитайте причину и место подписи.

Получение имена подписей

Используйте этот метод, когда PDF может содержать одну или несколько подписей, и вы хотите проверить, какие записи подписи доступны. Пример открывает документ и выводит список, возвращённый get_sign_names().

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def get_signature_names(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        signature_names = list_signature_names(pdf_signature)
        print(f"Signature Names: {signature_names}")
    finally:
        pdf_signature.close()

Получение сведения о подписанте

Как только вы узнаете название подписи, вы можете получить метаданные, специфичные для подписанта. В этом примере читаются имя подписанта и контактная информация для первой доступной подписи в документе.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def get_signer_details(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        signer_name = pdf_signature.get_signer_name(sign_name)
        contact_info = pdf_signature.get_contact_info(sign_name)
        print(
            f"Signer Details for '{sign_name}': "
            f"signer_name={signer_name}, contact_info={contact_info}"
        )
    finally:
        pdf_signature.close()

Получение дату и время подписи

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

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def get_signature_date_and_time(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        signature_date = pdf_signature.get_date_time(sign_name)
        print(f"Signature Date and Time for '{sign_name}': {signature_date}")
    finally:
        pdf_signature.close()

Получение причину подписи и местоположение

Цифровые подписи также могут хранить описательные метаданные, такие как причина подписи и место её создания. В этом примере оба значения извлекаются для выбранной подписи и выводятся вместе.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def get_signature_reason_and_location(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        signature_reason = pdf_signature.get_reason(sign_name)
        signature_location = pdf_signature.get_location(sign_name)
        print(
            f"Signature Reason and Location for '{sign_name}': "
            f"reason={signature_reason}, location={signature_location}"
        )
    finally:
        pdf_signature.close()

Python-Net: Проверки целостности подписи

Thu, 02 Apr 2026 00:00:00 +0000

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

В этом примере демонстрируются два распространённых контроля целостности:

Проверьте, покрывает ли подпись весь документ.
Проверьте целостность подписанного содержимого PDF.

Проверьте, покрывает ли подпись весь документ

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

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def check_signature_coverage(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        covers_document = pdf_signature.covers_whole_document(sign_name)
        print(f"Signature '{sign_name}' covers the whole document: {covers_document}")
    finally:
        pdf_signature.close()

Проверка целостности документа

Используйте verify_signed() чтобы подтвердить, что содержимое подписанного документа не было изменено после применения подписи. Этот метод помогает проверить, остается ли документ действительным для выбранной подписи.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def validate_document_integrity(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        is_valid = pdf_signature.verify_signed(sign_name)
        print(f"Document integrity for '{sign_name}' is valid: {is_valid}")
    finally:
        pdf_signature.close()

Python-Net: Управление подписями

Thu, 02 Apr 2026 00:00:00 +0000

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

Этот пример демонстрирует две распространённые задачи управления подписями:

Удалить подпись из PDF‑документа.
Удалить подпись и очистить связанное поле подписи.

Удаление подпись из PDF

Используйте remove_signature() когда вы хотите удалить выбранную подпись из документа, сохраняя при этом структуру поля подписи. В примере открывается подписанный PDF, определяется имя подписи, удаляется и сохраняется обновлённый выходной файл.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def remove_signature_from_pdf(infile, outfile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        pdf_signature.remove_signature(sign_name)
        pdf_signature.save(outfile)
    finally:
        pdf_signature.close()

Удаление подпись и очистить поле

Используйте перегрузку с дополнительным True флаг, когда вы хотите удалить подпись и также очистить связанное поле подписи. Это полезно, когда поле не должно оставаться в документе после удаления подписи.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def remove_signature_with_field_cleanup(infile, outfile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        pdf_signature.remove_signature(sign_name, True)
        pdf_signature.save(outfile)
    finally:
        pdf_signature.close()

Python-Net: Проверка подписи

Thu, 02 Apr 2026 00:00:00 +0000

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

В этом примере демонстрируются две распространённые задачи проверки:

Проверьте, действительна ли существующая подпись PDF.
Проверьте, содержит ли PDF какие-либо подписи.

Проверка подписи PDF

Используйте verify_signature() когда вам нужно проверить конкретную подпись в документе. Пример определяет первое доступное имя подписи и проверяет, действительна ли эта подпись.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def verify_pdf_signature(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        is_valid = pdf_signature.verify_signature(sign_name)
        print(f"Signature '{sign_name}' is valid: {is_valid}")
    finally:
        pdf_signature.close()

Проверьте, содержит ли PDF подписи

Используйте contains_signature() когда вам нужно лишь узнать, содержит ли PDF какие-либо подписи вообще. Это полезно как быстрая проверка перед запуском более детальной проверки или извлечения логики.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def check_if_pdf_contains_signatures(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        contains_signatures = pdf_signature.contains_signature()
        print(f"PDF contains signatures: {contains_signatures}")
    finally:
        pdf_signature.close()

Python-Net: Управление правами использования

Thu, 02 Apr 2026 00:00:00 +0000

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

Этот пример демонстрирует одну распространённую задачу управления правами использования:

Проверьте, содержит ли PDF права использования.
Удалите права использования из документа.
Сохраните обновлённый PDF‑файл.

Проверьте, содержит ли PDF права использования

Перед удалением прав использования пример проверяет текущее состояние документа, вызывая contains_usage_rights(). Это позволяет вам подтвердить, присутствуют ли права использования, прежде чем вносить изменения.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def check_usage_rights(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        had_usage_rights = pdf_signature.contains_usage_rights()
        print(f"PDF contains usage rights: {had_usage_rights}")
    finally:
        pdf_signature.close()

Удаление права использования из PDF

Используйте remove_usage_rights() когда документ больше не должен сохранять свои текущие настройки прав использования. Пример проверяет начальное состояние, удаляет права и сохраняет обновлённый PDF в новый файл.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def remove_usage_rights(infile, outfile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        had_usage_rights = pdf_signature.contains_usage_rights()
        print(f"PDF contains usage rights before removal: {had_usage_rights}")
        pdf_signature.remove_usage_rights()
        pdf_signature.save(outfile)
    finally:
        pdf_signature.close()