Signer un PDF dans Python SDK
Ajouter une signature à un document PDF en utilisant Cloud Python SDK.
Get StartedComment ajouter une signature au PDF via Cloud Python SDK
Pour ajouter une signature dans un PDF, nous utiliserons Aspose.PDF Cloud Python SDK. Ce SDK Cloud aide les programmeurs Python à développer des applications basées sur le cloud pour créer, annoter, éditer et convertir des PDF en utilisant le langage de programmation Python via l’API REST Aspose.PDF. Créez simplement un compte chez Aspose for Cloud et obtenez les informations de votre application. Une fois que vous avez le SID de l’application et la clé, vous êtes prêt à utiliser Aspose.PDF Cloud Python SDK. Si le package python est hébergé sur Github, vous pouvez l’installer directement depuis Github :
Installation depuis Github
pip install git+https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-python.git
Commande de la console du gestionnaire de packages
pip install asposepdfcloud
Étapes pour ajouter une signature dans un PDF via Python SDK
Les développeurs Aspose.PDF Cloud peuvent facilement charger et ajouter une signature à un PDF en seulement quelques lignes de code.
- Installer Python SDK.
- Télécharger les documents PDF sur le cloud, et est configuré pour télécharger les documents traités.
- Ajouter une nouvelle signature au document PDF.
Ajouter une signature au PDF en utilisant 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()
Travailler avec la signature dans un PDF
Signer numériquement un PDF garantit l’authenticité, l’intégrité et la légitimité d’un document. Cela vérifie que le contenu n’a pas été modifié depuis que la signature a été appliquée et confirme l’identité du signataire. Ceci est particulièrement important dans les contextes juridiques, financiers et professionnels où la confiance et la sécurité des documents sont essentielles. Les signatures numériques aident également à respecter les normes de conformité et à rationaliser les workflows d’approbation de manière sécurisée et vérifiable. Ajoutez la signature dans les documents PDF avec Aspose.PDF Cloud Python SDK.
Avec notre bibliothèque Python vous pouvez :
- Combiner des documents PDF.
- Diviser des fichiers PDF.
- Convertir des PDF vers d’autres formats, et vice versa.
- Manipuler les annotations.
- Travailler avec des images dans le PDF, etc.
- Vous pouvez essayer notre application gratuite pour tester la fonctionnalité en ligne.