PNG
JPG
BMP
TIFF
PDF
如何通过云端 Python SDK 向 PDF 添加签名
要向 PDF 添加签名,我们将使用 Aspose.PDF Cloud Python SDK。这个云端 SDK 帮助 Python 程序员开发基于云的 PDF 创建、注释、编辑和转换应用程序,使用 Aspose.PDF REST API。只需在 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 中的图像等。
- 您可以试用我们的免费应用在线测试功能。