Cómo agregar Firma a PDF a través de Cloud Python SDK
Para agregar firma a un PDF, usaremos Aspose.PDF Cloud Python SDK. Este Cloud SDK ayuda a los programadores de Python a desarrollar aplicaciones en la nube para crear, anotar, editar y convertir PDF usando el lenguaje de programación Python a través del Aspose.PDF REST API. Simplemente cree una cuenta en Aspose for Cloud y obtenga la información de su aplicación. Una vez que tenga el App SID y la clave, estará listo para usar el Aspose.PDF Cloud Python SDK. Si el paquete de Python está alojado en Github, puede instalarlo directamente desde Github:
Instalación desde Github
pip install git+https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-python.git
Comando de la Consola del Gestor de Paquetes
pip install asposepdfcloud
Pasos para agregar firma a PDF a través de Python SDK
Los desarrolladores de Aspose.PDF Cloud pueden cargar y agregar fácilmente firmas a PDF con solo unas pocas líneas de código.
- Instalar Python SDK.
- Subir documentos PDF a la nube y configurarlo para descargar documentos procesados.
- Añadir una nueva firma al documento PDF.
Agregar Firma a PDF usando Python
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()
Trabajar con Firma en PDF
Firmar digitalmente un PDF garantiza la autenticidad, integridad y legitimidad de un documento. Verifica que el contenido no ha sido alterado desde que se aplicó la firma y confirma la identidad del firmante. Esto es especialmente importante en entornos legales, financieros y profesionales donde la confianza y seguridad del documento son críticas. Las firmas digitales también ayudan a cumplir con los estándares de cumplimiento y a simplificar los flujos de trabajo de aprobación de manera segura y verificable. Agregue la Firma a documentos PDF con Aspose.PDF Cloud Python SDK.
Con nuestra biblioteca de Python puede:
- Combinar documentos PDF.
- Dividir archivos PDF.
- Convertir PDF a otros formatos, y viceversa.
- Manipular Anotaciones.
- Trabajar con Imágenes en PDF, etc.
- Puede probar nuestra App gratuita para probar la funcionalidad en línea.