Documentation – PDF ファイル署名クラス

Python-Net: PDF ドキュメントへの署名

Tue, 09 Jun 2026 00:00:00 +0000

.NET 経由の Python 用 Aspose.PDF は PDF ファイル署名既存のPDF文書にデジタル署名を適用するためのファサード。証明書ファイルを使用すると、プログラムによる文書への署名、ページへの署名、署名メタデータの割り当て、署名の表示方法のカスタマイズを行うことができます。

この記事では、一般的な署名ワークフローをいくつか紹介します。

を作成してバインドする 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()

PKCS7 オブジェクトを使用して PDF に署名する

を使う 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 証明書

Tue, 09 Jun 2026 00:00:00 +0000

.NET 経由の Python 用 Aspose.PDF では、以下のようにドキュメントレベルの署名を適用して PDF ドキュメントを認証できます。 PDF ファイル署名。認証は、文書が認証された後にどのような変更が許可されるかを定義する点で、標準の承認署名とは異なります。

この記事では、次の 2 つの一般的な認定ワークフローについて説明します。

PDF を認証し、認証後にフォームへの入力を許可します。
PDF を認証し、それ以上変更されないようにします。

フォーム入力用の PDF の認証

この方法は、文書は認証されたままでも、ユーザーがインタラクティブフォームへの記入やファイルへの署名を続ける必要がある場合に使用します。は 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()

変更なしで文書レベルの認証を適用

このモードは、認証後に認証済み文書を変更しないでおく必要がある場合に使用します。は 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: 改訂と権限

Tue, 09 Jun 2026 00:00:00 +0000

.NET 経由の Python 用 Aspose.PDF は PDF ファイル署名署名および認証されたPDF文書を扱うためのファサード。署名を追加するだけでなく、署名メタデータを調べて、文書に含まれる改訂の数や、認証後にどのような変更が許可されるかを把握することもできます。

この例は、3 つの一般的な検査タスクを示しています。

既存の署名のリビジョン番号を取得します。
署名済み文書の改訂の合計数を取得します。
認証済み PDF のアクセス権限を読み取ります。

署名のリビジョン番号を取得

この方法は、PDF にすでに 1 つ以上の署名が含まれていて、特定の署名に関連付けられているリビジョンを識別する必要がある場合に使用します。この例では、最初に使用可能な署名名を解決してから呼び出します。 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: シグネチャ抽出

Tue, 09 Jun 2026 00:00:00 +0000

.NET 経由の Python 用 Aspose.PDF は PDF ファイル署名署名されたPDF文書からデータを検査および抽出するためのファサード。PDF に署名したら、その PDF を使用して、視覚的な署名画像や署名に関連する証明書などの署名リソースをエクスポートできます。

この例は、2 つの一般的な抽出タスクを示しています。

署名に関連するビジュアルイメージを抽出します。
署名済み 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: 署名情報

Tue, 09 Jun 2026 00:00:00 +0000

.NET 経由の Python 用 Aspose.PDF は PDF ファイル署名 PDF文書のデジタル署名を検査するためのファサード。文書に署名したら、その文書を使用して署名名を読み取り、署名者名、連絡先情報、署名時間、理由、場所などのメタデータを取得できます。

この例は、4 つの一般的な署名情報タスクを示しています。

署名済みの PDF にすべての署名名を一覧表示します。
選択した署名の署名者の詳細を読み取ります。
署名日時を取得します。
署名の理由と場所を読んでください。

署名名を取得

この方法は、PDF に 1 つ以上の署名が含まれている場合で、どの署名エントリが使用可能かを調べたい場合に使用します。この例では文書を開き、によって返されたリストを印刷します。 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()

署名の理由と場所を取得

デジタル署名には、署名の理由や場所などの説明的なメタデータも保存できます。この例では、選択した署名の 2 つの値を取得し、まとめて印刷します。

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: 署名整合性チェック

Tue, 09 Jun 2026 00:00:00 +0000

.NET 経由の Python 用 Aspose.PDF は PDF ファイル署名署名されたPDF文書を検証するためのファサード。ファイルに署名が済んだら、その署名が文書全体に適用されているかどうか、署名された内容がまだ有効かどうかを確認できます。

この例は、2 つの一般的な整合性チェックを示しています。

署名が文書全体をカバーしているかどうかを確認してください。
署名された 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: シグネチャ管理

Tue, 09 Jun 2026 00:00:00 +0000

.NET 経由の Python 用 Aspose.PDF は PDF ファイル署名 PDF文書内の既存のデジタル署名を操作するためのファサード。署名の読み取りと検証に加えて、ワークフローで署名済みコンテンツの更新や署名フィールドのクリアが必要な場合には、署名を削除することもできます。

この例は、2 つの一般的な署名管理タスクを示しています。

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: 署名検証

Tue, 09 Jun 2026 00:00:00 +0000

.NET 経由の Python 用 Aspose.PDF は PDF ファイル署名署名されたPDF文書を検証するためのファサード。PDF に署名したら、その署名を使用して署名が有効であることを確認したり、文書に署名エントリが含まれているかどうかを確認したりできます。

この例は、2 つの一般的な検証タスクを示しています。

既存の 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: 使用権管理

Tue, 09 Jun 2026 00:00:00 +0000

.NET 経由の Python 用 Aspose.PDF は PDF ファイル署名署名付きPDFおよび関連する使用権限設定を操作するためのファサード。ワークフローによっては、更新されたバージョンのファイルを保存する前に、文書に使用権限が含まれているかどうかを調べて削除する必要がある場合があります。

この例は、一般的な使用権限管理タスクの 1 つを示しています。

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()