PNG JPG BMP TIFF PDF
Aspose.PDF  for Python

在 Python SDK 中签署 PDF

使用云端 Python SDK 向 PDF 文档添加签名。

Get Started

如何通过云端 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 添加签名。

  1. 安装 Python SDK
  2. 将 PDF 文档上传到云端,并设置下载处理后的文档。
  3. 向 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 中的图像等。
  • 您可以试用我们的免费应用在线测试功能。