📝 Hướng dẫn chi tiết về ký điện tử tài liệu với Python: Tạo chữ ký số cho PDF, Excel & nhiều hơn nữa

pip install groupdocs-signature-net

# Nhập thư viện GroupDocs.Signature chính
import groupdocs.signature as gs

# Nhập tùy chọn để cấu hình các thiết lập ký
import groupdocs.signature.options as gso

# Nhập các thiết lập hình thức để tùy chỉnh cách ký hiển thị
import groupdocs.signature.options.appearances as appearances

# Hàm này minh họa cách thêm chữ ký số vào tài liệu PDF
# Chữ ký bao gồm cả chứng chỉ số và các yếu tố hình ảnh
def sign_pdf_document():
    # Định nghĩa đường dẫn tệp
    sample_file_path = "sample.pdf"         # Tài liệu PDF nguồn của bạn
    certificate_pfx = "MrSmithSignature.pfx"  # Tệp chứng chỉ số
    image_handwrite = "signature_handwrite.jpg"  # Hình ảnh chữ ký viết tay tùy chọn
    output_file_path = "signed.pdf"         # Địa chỉ lưu tài liệu đã ký

    # Mở tài liệu để ký
    with gs.Signature(sample_file_path) as signature:
        # Cấu hình tùy chọn ký số
        options = gso.DigitalSignOptions(certificate_pfx)

        # Thiết lập thuộc tính hình thức hình ảnh
        options.image_file_path = image_handwrite  # Thêm hình ảnh chữ ký viết tay
        options.left = 450                         # Vị trí X trên trang
        options.top = 150                          # Vị trí Y trên trang
        options.page_number = 1                    # Trang nào để ký
        options.password = "1234567890"            # Mật khẩu chứng chỉ

        # Thêm metadata vào chữ ký
        options.appearance = appearances.DigitalSignatureAppearance(
            "John Smith",                          # Tên người ký
            "Title",                               # Chức vụ người ký
            "jonny@test.com"                       # Email người ký
        )
        options.reason = "Document Approval"       # Lý do tài liệu được ký
        options.contact = "JohnSmith"              # Thông tin liên lạc
        options.location = "Office1"               # Địa điểm ký

        # Áp dụng chữ ký và lưu tài liệu
        result = signature.sign(output_file_path, options)

        # Hiển thị tin nhắn thành công với hai mục nhật ký riêng biệt
        print(f"\nTài liệu nguồn đã ký thành công.")
        print(f"Tổng số chữ ký áp dụng: {len(result.succeeded)}")
        print(f"Tệp lưu tại {output_file_path}.")

# Hàm này minh họa cách ký số bảng tính Excel
# Được thiết kế cho tài liệu tài chính, báo cáo và dữ liệu nhạy cảm khác
def sign_excel_document():
    # Định nghĩa đường dẫn tệp
    sample_file_path = "sample.xlsx"        # Tài liệu Excel nguồn của bạn
    certificate_pfx = "MrSmithSignature.pfx"  # Tệp chứng chỉ số
    output_file_path = "signed.xlsx"        # Địa chỉ lưu tài liệu đã ký

    # Mở tài liệu Excel để ký
    with gs.Signature(sample_file_path) as signature:
        # Cấu hình tùy chọn ký số với chứng chỉ
        options = gso.DigitalSignOptions(certificate_pfx)

        # Thiết lập vị trí của chữ ký trong tài liệu Excel
        options.left = 450                  # Vị trí X trên trang
        options.top = 150                   # Vị trí Y trên trang
        options.page_number = 1             # Bảng nào để ký (bảng đầu tiên)
        options.password = "1234567890"     # Mật khẩu chứng chỉ

        # Thêm thông tin người ký vào metadata chữ ký
        options.appearance = appearances.DigitalSignatureAppearance(
            "John Smith",                   # Tên người ký
            "Title",                        # Chức vụ người ký
            "jonny@test.com"                # Email người ký
        )

        # Áp dụng chữ ký và lưu tài liệu
        result = signature.sign(output_file_path, options)

        # Hiển thị tin nhắn thành công với hai mục nhật ký riêng biệt
        print(f"\nTài liệu Excel đã ký thành công.")
        print(f"Tổng số chữ ký áp dụng: {len(result.succeeded)}")
        print(f"Tệp Excel đã ký lưu tại {output_file_path}.")

# Hàm này thêm chữ ký mã vạch có thể quét vào tài liệu
# Tốt cho tài liệu tồn kho, chứng chỉ hoặc tài liệu theo dõi
def add_barcode_signature():
    # Nhập các thư viện cần thiết
    import groupdocs.signature as gs
    import groupdocs.signature.domain as gsd
    import groupdocs.signature.options as gso

    # Định nghĩa đường dẫn tệp
    sample_file_path = "sample.xlsx"        # Tài liệu nguồn của bạn
    output_file_path = "barcode_signed.xlsx"  # Địa chỉ lưu tài liệu đã ký

    # Mở tài liệu để ký
    with gs.Signature(sample_file_path) as signature:
        # Tạo tùy chọn ký mã vạch với văn bản để mã hóa
        options = gso.BarcodeSignOptions("GroupDocs.Signature")

        # Thiết lập loại mã vạch - CODE128 được sử dụng rộng rãi và đáng tin cậy
        options.encode_type = gsd.BarcodeTypes.CODE128

        # Cấu hình hình thức và vị trí mã vạch
        options.left = 50                   # Vị trí X trên trang
        options.top = 150                   # Vị trí Y trên trang
        options.width = 100                 # Chiều rộng mã vạch
        options.height = 50                 # Chiều cao mã vạch

        # Áp dụng chữ ký và lưu tài liệu
        result = signature.sign(output_file_path, options)

        # Hiển thị tin nhắn thành công với hai mục nhật ký riêng biệt
        print(f"\nTài liệu đã ký với mã vạch thành công!")
        print(f"Tổng số chữ ký áp dụng: {len(result.succeeded)}")
        print(f"Tệp lưu tại {output_file_path}.")

# Hàm này thêm chữ ký mã QR vào tài liệu
# Được thiết kế cho xác minh di động và liên kết đến tài nguyên trực tuyến
def add_qrcode_signature():
    # Nhập các thư viện cần thiết
    import groupdocs.signature as gs
    import groupdocs.signature.domain as gsd
    import groupdocs.signature.options as gso

    # Định nghĩa đường dẫn tệp
    sample_file_path = "sample.pdf"        # Tài liệu nguồn của bạn
    output_file_path = "qrcode_signed.pdf"  # Địa chỉ lưu tài liệu đã ký

    # Mở tài liệu để ký
    with gs.Signature(sample_file_path) as signature:
        # Tạo tùy chọn mã QR với dữ liệu để mã hóa
        # Đây có thể là URL xác minh, ID tài liệu hoặc dữ liệu khác
        options = gso.QrCodeSignOptions("GroupDocs.Signature")

        # Thiết lập loại mã QR - mã QR tiêu chuẩn được hỗ trợ rộng rãi nhất
        options.encode_type = gsd.QrCodeTypes.QR

        # Cấu hình hình thức và vị trí mã QR
        options.left = 50                   # Vị trí X trên trang
        options.top = 150                   # Vị trí Y trên trang
        options.width = 100                 # Chiều rộng mã QR
        options.height = 100                # Chiều cao mã QR
        options.rotation_angle = 45         # Tùy chọn: xoay mã QR

        # Áp dụng chữ ký và lưu tài liệu
        result = signature.sign(output_file_path, options)

        # Hiển thị tin nhắn thành công với hai mục nhật ký riêng biệt
        print(f"\nTài liệu đã ký với mã QR thành công!")
        print(f"Tổng số chữ ký áp dụng: {len(result.succeeded)}")
        print(f"Tệp lưu tại {output_file_path}.")