PNG
JPG
BMP
TIFF
PDF
クラウドPython SDKでPDFに署名を追加する方法
PDFに署名を追加するために、私たちは使用します Aspose.PDF Cloud Python SDK。このクラウドSDKは、PythonプログラマーがAspose.PDF REST APIを使用して、クラウドベースのPDF作成、注釈、編集、変換アプリをPythonプログラミング言語で開発するのを支援します。Aspose for Cloudでアカウントを作成し、アプリケーション情報を取得してください。App SIDとキーを取得したら、Aspose.PDF Cloud Python SDKを試す準備ができています。PythonパッケージがGithubにホストされている場合、直接Githubからインストールすることができます:
Githubからのインストール
pip install git+https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-python.git
パッケージマネージャーコンソールコマンド
pip install asposepdfcloud
Python SDKを介してPDFに署名を追加する手順
Aspose.PDF Cloudの開発者は、わずか数行のコードでPDFに署名を簡単に読み込み、追加できます。
- Python SDKをインストールします。
- PDFドキュメントをクラウドにアップロードし、処理されたドキュメントをダウンロードするように設定します。
- PDFドキュメントに新しい署名を追加します。
Pythonを使用してPDFに署名を追加
import shutil
import json
import logging
from pathlib import Path
from asposepdfcloud import ApiClient, PdfApi, Signature, SignatureType, SignatureField, Rectangle
# Configure logging
logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s")
class Config:
"""Configuration parameters."""
CREDENTIALS_FILE = Path(r".../../../credentials.json")
LOCAL_FOLDER = Path(r"C:\Samples")
PDF_DOCUMENT_NAME = "sample.pdf"
LOCAL_RESULT_DOCUMENT_NAME = "output_sample.pdf"
LOCAL_SIGNATURE_PATH = Path(r"C:\Samples\Signatures\3")
SIGNATURE_PFX = "signature.pfx"
SIGNATURE_FORM_FIELD = 'Signature_1'
SIGNATURE_PASSWORD='Password'
SIGNATURE_CONTACT='Contact'
SIGNATURE_LOCATION='Location'
SIGNATURE_AUTHORITY='Issuer'
SIGNATURE_DATE='04/19/2025 12:15:00.000 PM'
SIGNATURE_RECT = Rectangle(100, 100, 500, 500)
class PdfSignatures:
"""Class for managing PDF signatures using Aspose PDF Cloud API."""
def __init__(self, credentials_file: Path = Config.CREDENTIALS_FILE):
self.pdf_api = None
self._init_api(credentials_file)
def _init_api(self, credentials_file: Path):
"""Initialize the API client."""
try:
with credentials_file.open("r", encoding="utf-8") as file:
credentials = json.load(file)
api_key, app_id = credentials.get("key"), credentials.get("id")
if not api_key or not app_id:
raise ValueError("init_api(): Error: Missing API keys in the credentials file.")
self.pdf_api = PdfApi(ApiClient(api_key, app_id))
except (FileNotFoundError, json.JSONDecodeError, ValueError) as e:
logging.error(f"init_api(): Failed to load credentials: {e}")
def upload_file(self, local_path: Path, fileName: str):
""" Upload a local fileName to the Aspose Cloud server. """
if self.pdf_api:
file_path = local_path / fileName
try:
self.pdf_api.upload_file(fileName, str(file_path))
logging.info(f"upload_file(): File '{fileName}' uploaded successfully.")
except Exception as e:
logging.error(f"upload_document(): Failed to upload file: {e}")
def upload_document(self):
""" Upload a PDF document to the Aspose Cloud server. """
self.upload_file(Config.LOCAL_FOLDER, Config.PDF_DOCUMENT_NAME)
def download_result(self):
"""Download the processed PDF document from the Aspose Cloud server."""
if self.pdf_api:
try:
temp_file = self.pdf_api.download_file(Config.PDF_DOCUMENT_NAME)
local_path = Config.LOCAL_FOLDER / Config.LOCAL_RESULT_DOCUMENT_NAME
shutil.move(temp_file, str(local_path))
logging.info(f"download_result(): File successfully downloaded: {local_path}")
except Exception as e:
logging.error(f"download_result(): Failed to download file: {e}")
def append_signature(self):
"""Append a new signature to the PDF document."""
if self.pdf_api:
signature = Signature(
signature_path=Config.SIGNATURE_PFX,
signature_type=SignatureType.PKCS7,
password=Config.SIGNATURE_PASSWORD,
contact=Config.SIGNATURE_CONTACT,
location=Config.SIGNATURE_LOCATION,
visible=True,
rectangle=Config.SIGNATURE_RECT,
form_field_name=Config.SIGNATURE_FORM_FIELD,
authority=Config.SIGNATURE_AUTHORITY,
date=Config.SIGNATURE_DATE,
show_properties=False)
field = SignatureField(page_index=1)
field.signature = signature
field.partial_name = 'sign1'
field.rect = Config.SIGNATURE_RECT
try:
response = self.pdf_api.post_signature_field(Config.PDF_DOCUMENT_NAME, field)
if response.code == 200:
logging.info(f"append_signature(): Signature '{Config.SIGNATURE_CONTACT}' successfully added to the document.")
else:
logging.error(f"append_signature(): Failed to add signature to the document. Response code: {response.code}")
except Exception as e:
logging.error(f"append_signature(): Error while adding signature: {e}")
if __name__ == "__main__":
pdf_sign = PdfSignatures()
pdf_sign.upload_document()
pdf_sign.upload_file(Config.LOCAL_SIGNATURE_PATH, Config.SIGNATURE_PFX)
pdf_sign.append_signature()
pdf_sign.download_result()
PDFの署名を操作する
PDFにデジタル署名をすることで、文書の真正性、完全性、および正当性が保証されます。これは、署名が適用された後で内容が変更されていないことを確認し、署名者の身元を確認します。これは、法的、財務的、および専門的な環境で文書の信頼性とセキュリティが重要な場合に特に重要です。デジタル署名は、コンプライアンス基準を満たし、安全で検証可能な方法で承認ワークフローを効率化するのにも役立ちます。 Aspose.PDF Cloud Python SDKを使用してPDFドキュメントに署名を追加します。
私たちのPythonライブラリを使用することで、以下が可能です:
- PDFドキュメントを結合します。
- PDFファイルを分割します。
- PDFを他の形式に変換し、逆も可能です。
- 注釈を操作します。
- PDF内の画像を操作します、など。
- 無料アプリを試して、機能をオンラインでテストできます。