🛠� 设置您的 Python 环境#
电å�文档ç¾å��简介#
电å�ç¾å��彻底改å�˜äº†ä¼�业和个人处ç�†æ–‡æ¡£å·¥ä½œæµ�程的方å¼�。ä¸�å†�需è¦�打å�°ã€�ç¾ç½²å’Œæ‰«æ�� - 现在您å�¯ä»¥å�ªéœ€å‡ 行 Python 代ç �å�³å�¯æ•°å—ç¾ç½²æ–‡æ¡£ï¼�
本全é�¢æŒ‡å�—将指导您使用 GroupDocs.Signature for Python via .NET 为 PDFã€�Word å’Œ Excel 文档创建电å�ç¾å��ã€‚æ— è®ºæ‚¨æ˜¯æž„å»ºæ–‡æ¡£ç®¡ç�†ç³»ç»Ÿã€�自动化业务æµ�程,还是创建安全ç¾å��å¹³å�°ï¼Œæœ¬æ•™ç¨‹éƒ½èƒ½æ»¡è¶³æ‚¨çš„需求。
了解电å�ç¾å��å�Šå…¶å¥½å¤„#
电å�ç¾å��ä¸�仅仅是手写ç¾å��的数å—表示。它是一ç§�安全的方法,用于验è¯�文档的真实性和ç¾ç½²è€…的身份。主è¦�好处包括:
法律有效性:在世界上大多数国家得到认�
å®‰å…¨æ€§ï¼šåŠ å¯†ä¿�护,防æ¢ç¯¡æ”¹
效率:å�¯ä»¥ä»Žä»»ä½•地方立å�³åœ¨çº¿ç¾ç½²æ–‡æ¡£
å�¯è¿½æº¯æ€§ï¼šè¯¦ç»†çš„ç¾ç½²è¿‡ç¨‹å®¡è®¡æ—¥å¿—
ç»�æµŽæ€§ï¼šæ¶ˆé™¤çº¸å¼ ã€�打å�°å’Œé‚®å¯„æˆ�本
集æˆ�性:å�¯ä»¥è½»æ�¾é›†æˆ�到现有的文档工作æµ�程ä¸
🛠� 设置您的 Python 环境#
在开始ç¾ç½²æ–‡æ¡£ä¹‹å‰�,您需è¦�æ£ç¡®è®¾ç½® Python 环境。按照以下简å�•æ¥éª¤å‡†å¤‡ï¼š
安装 GroupDocs.Signature for Python via .NET
pip install groupdocs-signature-net
导入所需模�
# å¯¼å…¥æ ¸å¿ƒ GroupDocs.Signature 库
import groupdocs.signature as gs
# 导入用于é…�ç½®ç¾å��设置的选项
import groupdocs.signature.options as gso
# 导入外观设置以自定义ç¾å��的外观
import groupdocs.signature.options.appearances as appearances
ðŸ“� 如何使用 Python 电å�ç¾ç½² PDF 文档#
PDF 是最常è§�的需è¦�æ•°å—ç¾å��çš„æ–‡æ¡£æ ¼å¼�之一。以下是一个完整示例,展示了如何使用完整的自定义选项为您的 PDF æ–‡ä»¶æ·»åŠ ä¸“ä¸šçš„ç”µå�ç¾å��。
# æ¤å‡½æ•°æ¼”示如何å�‘ PDF æ–‡æ¡£æ·»åŠ æ•°å—ç¾å��
# ç¾å��包括数å—è¯�书和视觉元ç´
def sign_pdf_document():
# 定义文件路径
sample_file_path = "sample.pdf" # � PDF 文档
certificate_pfx = "MrSmithSignature.pfx" # æ•°å—è¯�书文件
image_handwrite = "signature_handwrite.jpg" # å�¯é€‰çš„æ‰‹å†™ç¾å��图åƒ�
output_file_path = "signed.pdf" # ä¿�å˜ç¾ç½²æ–‡æ¡£çš„ä½�ç½®
# 打开文档以进行ç¾ç½²
with gs.Signature(sample_file_path) as signature:
# é…�置数å—ç¾å��选项
options = gso.DigitalSignOptions(certificate_pfx)
# 设置视觉外观属性
options.image_file_path = image_handwrite # æ·»åŠ æ‰‹å†™ç¾å��图åƒ�
options.left = 450 # 页�上的 X �置
options.top = 150 # 页�上的 Y �置
options.page_number = 1 # è¦�ç¾ç½²çš„页é�¢
options.password = "1234567890" # è¯�书密ç �
# å�‘ç¾å��æ·»åŠ å…ƒæ•°æ�®
options.appearance = appearances.DigitalSignatureAppearance(
"John Smith", # ç¾ç½²è€…å§“å��
"Title", # ç¾ç½²è€…è�Œä½�
"jonny@test.com" # ç¾ç½²è€…电å�邮件
)
options.reason = "Document Approval" # ç¾ç½²æ–‡æ¡£çš„原å›
options.contact = "JohnSmith" # �系信�
options.location = "Office1" # ç¾ç½²åœ°ç‚¹
# 应用ç¾å��å¹¶ä¿�å˜æ–‡æ¡£
result = signature.sign(output_file_path, options)
# 显示�功消�,分两个�独的日志�目
print(f"\næº�文档ç¾ç½²æˆ�功。")
print(f"总ç¾å��应用: {len(result.succeeded)}")
print(f"文件ä¿�å˜äºŽ {output_file_path}。")
结果输出:
å�‘ Excel æ–‡ä»¶æ·»åŠ æ•°å—ç¾å��#
Excel 电å�è¡¨æ ¼é€šå¸¸åŒ…å�«éœ€è¦�验è¯�çš„é‡�è¦�财务数æ�®ã€‚以下是如何使用 Python 安全ç¾ç½² Excel 文件以验è¯�å…¶çœŸå®žæ€§å¹¶é˜²æ¢æœªç»�授æ�ƒçš„æ›´æ”¹ã€‚
# æ¤å‡½æ•°æ¼”示如何数å—ç¾ç½² Excel 电å�è¡¨æ ¼
# 适用于财务文档�报告和其他�感数�
def sign_excel_document():
# 定义文件路径
sample_file_path = "sample.xlsx" # � Excel 文档
certificate_pfx = "MrSmithSignature.pfx" # æ•°å—è¯�书文件
output_file_path = "signed.xlsx" # ä¿�å˜ç¾ç½²æ–‡æ¡£çš„ä½�ç½®
# 打开 Excel 文档以进行ç¾ç½²
with gs.Signature(sample_file_path) as signature:
# 使用è¯�书é…�置数å—ç¾å��选项
options = gso.DigitalSignOptions(certificate_pfx)
# 设置 Excel 文档ä¸çš„ç¾å��ä½�ç½®
options.left = 450 # 页�上的 X �置
options.top = 150 # 页�上的 Y �置
options.page_number = 1 # è¦�ç¾ç½²çš„工作表(第一个工作表)
options.password = "1234567890" # è¯�书密ç �
# å�‘ç¾å��元数æ�®æ·»åŠ ç¾ç½²è€…ä¿¡æ�¯
options.appearance = appearances.DigitalSignatureAppearance(
"John Smith", # ç¾ç½²è€…å§“å��
"Title", # ç¾ç½²è€…è�Œä½�
"jonny@test.com" # ç¾ç½²è€…电å�邮件
)
# 应用ç¾å��å¹¶ä¿�å˜æ–‡æ¡£
result = signature.sign(output_file_path, options)
# 显示�功消�,分两个�独的日志�目
print(f"\nExcel 文档ç¾ç½²æˆ�功。")
print(f"总ç¾å��应用: {len(result.succeeded)}")
print(f"ç¾ç½²å�Žçš„ Excel 文件ä¿�å˜äºŽ {output_file_path}。")
实现æ�¡å½¢ç �ç¾å��以增强文档安全性#
æ�¡å½¢ç �ç¾å��æ��供了é¢�外的文档验è¯�层,å…�许快速扫æ��和验è¯�。这ç§�方法特别适用于需è¦�在物ç�†çŽ¯å¢ƒä¸éªŒè¯�的文档。
# æ¤å‡½æ•°å�‘æ–‡æ¡£æ·»åŠ å�¯æ‰«æ��çš„æ�¡å½¢ç �ç¾å��
# é€‚ç”¨äºŽåº“å˜æ–‡æ¡£ã€�è¯�书或跟踪文档
def add_barcode_signature():
# 导入所需库
import groupdocs.signature as gs
import groupdocs.signature.domain as gsd
import groupdocs.signature.options as gso
# 定义文件路径
sample_file_path = "sample.xlsx" # �文档
output_file_path = "barcode_signed.xlsx" # ä¿�å˜ç¾ç½²æ–‡æ¡£çš„ä½�ç½®
# 打开文档以进行ç¾ç½²
with gs.Signature(sample_file_path) as signature:
# 使用è¦�ç¼–ç �的文本创建æ�¡å½¢ç �ç¾å��选项
options = gso.BarcodeSignOptions("GroupDocs.Signature")
# 设置æ�¡å½¢ç �类型 - CODE128 广泛使用且å�¯é�
options.encode_type = gsd.BarcodeTypes.CODE128
# é…�ç½®æ�¡å½¢ç �外观和ä½�ç½®
options.left = 50 # 页�上的 X �置
options.top = 150 # 页�上的 Y �置
options.width = 100 # æ�¡å½¢ç �宽度
options.height = 50 # æ�¡å½¢ç �高度
# 应用ç¾å��å¹¶ä¿�å˜æ–‡æ¡£
result = signature.sign(output_file_path, options)
# 显示�功消�,分两个�独的日志�目
print(f"\n文档ç¾ç½²æ�¡å½¢ç �æˆ�功ï¼�")
print(f"总ç¾å��应用: {len(result.succeeded)}")
print(f"文件ä¿�å˜äºŽ {output_file_path}。")
结果输出:
创建用于移动验è¯�çš„ QR ç �ç¾å��#
QR ç �适用于移动验è¯�场景,å…�许任何拥有智能手机的人快速验è¯�文档的真实性或访问与文档相关è�”的其他信æ�¯ã€‚
# æ¤å‡½æ•°å�‘æ–‡æ¡£æ·»åŠ QR ç �ç¾å��
# 适用于移动验�和链接到在线资�
def add_qrcode_signature():
# 导入所需库
import groupdocs.signature as gs
import groupdocs.signature.domain as gsd
import groupdocs.signature.options as gso
# 定义文件路径
sample_file_path = "sample.pdf" # �文档
output_file_path = "qrcode_signed.pdf" # ä¿�å˜ç¾ç½²æ–‡æ¡£çš„ä½�ç½®
# 打开文档以进行ç¾ç½²
with gs.Signature(sample_file_path) as signature:
# 使用è¦�ç¼–ç �的数æ�®åˆ›å»º QR ç �选项
# 这�以是验� URL�文档 ID 或其他数�
options = gso.QrCodeSignOptions("GroupDocs.Signature")
# 设置 QR ç �类型 - æ ‡å‡† QR ç �最广泛支æŒ�
options.encode_type = gsd.QrCodeTypes.QR
# é…�ç½® QR ç �外观和ä½�ç½®
options.left = 50 # 页�上的 X �置
options.top = 150 # 页�上的 Y �置
options.width = 100 # QR ç �宽度
options.height = 100 # QR ç �高度
options.rotation_angle = 45 # å�¯é€‰ï¼šæ—‹è½¬ QR ç �
# 应用ç¾å��å¹¶ä¿�å˜æ–‡æ¡£
result = signature.sign(output_file_path, options)
# 显示�功消�,分两个�独的日志�目
print(f"\n文档ç¾ç½² QR ç �æˆ�功ï¼�")
print(f"总ç¾å��应用: {len(result.succeeded)}")
print(f"文件ä¿�å˜äºŽ {output_file_path}。")
结果输出:
电å�ç¾å��的安全最佳实践#
在应用程åº�ä¸å®žçŽ°ç”µå�ç¾å��时,请考虑以下安全最佳实践:
è¯�书管ç�†ï¼šå®‰å…¨å˜å‚¨è¯�书,并具有适当的访问控制
密ç �ä¿�护:使用强密ç �访问è¯�书
时间戳:包括时间戳æœ�务以è¯�明文档何时ç¾ç½²
审计日志:维护所有ç¾å��活动的日志
验è¯�:实施定期ç¾å��验è¯�检查
å¤šå› ç´ è®¤è¯�:在ç¾ç½²ä¹‹å‰�è¦�求é¢�外验è¯�
å�ˆè§„性:确ä¿�您的实现符å�ˆè¡Œä¸šæ³•规(ESIGNã€�eIDAS ç‰ï¼‰
📑 结论与下一æ¥#
使用 Python å’Œ GroupDocs.Signature 的电å�ç¾å��æ��供:
快速的文档ç¾ç½²å’Œå¤„ç�†
高安全性验�和防篡改
适用于所有�作系统的跨平�兼容性
支æŒ�多ç§�æ–‡æ¡£æ ¼å¼�(PDFã€�Wordã€�Excel ç‰ï¼‰
移动å�‹å¥½çš„ QR ç �验è¯�选项
�线型的文档工作�程和批准�程
今天开始通过实现安全ã€�高效的电å�ç¾å��æ�¥è½¬å�˜æ‚¨çš„æ–‡æ¡£å·¥ä½œæµ�程ï¼�
�费试用#
准备好深入了解�?获� GroupDocs.Signature for Python via .NET 的�费试用:
�费试用:GroupDocs Releases
临时许��:获�临时许��
在线应用:在线ç¾ç½²æ–‡æ¡£
é™„åŠ èµ„æº�和文档#
GroupDocs.Signature 文档
Python via .NET 示例
API �考
支�论�