Python을 사용한 전자 서명 문서 완전 가이드: 스탬프, 이미지 및 양식 필드 디지털 서명 쉽게 만들기

pip install groupdocs-signature-net

# Import the core GroupDocs.Signature library
import groupdocs.signature as gs

# Import options for configuring signature settings
import groupdocs.signature.options as gso

# Import domain classes for signature customization
import groupdocs.signature.domain as gsd

# This function demonstrates how to add a text form field signature to a PDF
# Form fields create interactive areas where users can input signature information
def add_form_field_signature():
    # Define file paths for source and output documents
    sample_pdf = "sample.pdf"               # Your source PDF document
    output_file_path = "form_signed.pdf"    # Where to save the signed document
    
    # Open the document for signing
    with gs.Signature(sample_pdf) as signature:
        # Create a text form field signature with field name and default value
        # The field name is the identifier, while the value is the default text
        text_signature = gs.domain.TextFormFieldSignature("SignatureField", "Sign here")
        
        # Configure form field options based on the text signature
        options = gso.FormFieldSignOptions(text_signature)
        
        # Set position and size of the form field
        options.top = 150                   # Y-position on page
        options.left = 50                   # X-position on page
        options.height = 50                 # Height of field
        options.width = 200                 # Width of field

        # Sign document (add form field) and save to file
        result = signature.sign(output_file_path, options)

        # Display success message with separate log entries
        print(f"\nForm field signature added successfully.")
        print(f"Total form fields added: {len(result.succeeded)}")
        print(f"File saved at {output_file_path}.")

# This function shows how to add an image-based signature to documents
# Perfect for adding handwritten signatures, company logos, or official seals
def add_image_signature():
    # Define file paths
    sample_file_path = "sample.pdf"         # Your source document
    image_signature = "signature.png"       # Your signature image file
    output_file_path = "image_signed.pdf"   # Where to save the signed document
    
    # Open the document for signing
    with gs.Signature(sample_file_path) as signature:
        # Configure image signature options with the path to signature image
        options = gso.ImageSignOptions(image_signature)
        
        # Set position of the image signature
        options.left = 50                   # X-position on page  
        options.top = 50                    # Y-position on page
        
        # Apply to all pages in the document
        options.all_pages = True
        
        # Sign document with image and save to file
        result = signature.sign(output_file_path, options)

        # Display success message with separate log entries
        print(f"\nImage signature applied successfully.")
        print(f"Total signatures applied: {len(result.succeeded)}")
        print(f"Signed document saved at {output_file_path}.")

# This function demonstrates how to add an official-looking stamp signature
# Ideal for creating notary-style seals, company stamps, or approval marks
def add_stamp_signature():
    # Import required libraries
    import groupdocs.signature as gs
    import groupdocs.signature.domain as gsd
    import groupdocs.signature.options as gso

    # Define file paths
    sample_file_path = "sample.pdf"         # Your source document
    output_file_path = "stamp_signed.pdf"   # Where to save the signed document
    
    # Open the document for signing
    with gs.Signature(sample_file_path) as signature:
        # Define stamp signature options
        options = gso.StampSignOptions()
        
        # Set position and size of the stamp
        options.left = 50                   # X-position on page
        options.top = 150                   # Y-position on page
        options.width = 200                 # Width of stamp
        options.height = 200                # Height of stamp

        # Create outer circular line of text for the stamp
        # This creates the ring of text around the outside of the stamp
        outer_line = gsd.StampLine()
        outer_line.text = " * Official Document * "  # Text with stars for decoration
        outer_line.text_repeat_type = gsd.StampTextRepeatType.FULL_TEXT_REPEAT  # Repeat text around circle
        outer_line.font = gsd.SignatureFont()         # Configure font
        outer_line.height = 22                        # Height of text line
        outer_line.text_bottom_intent = 6             # Spacing from bottom
        options.outer_lines.append(outer_line)        # Add to stamp options

        # Create inner line of text for the stamp (center text)
        # This creates the content in the middle of the stamp
        inner_line = gsd.StampLine()
        inner_line.text = "APPROVED"                  # Center text of stamp
        inner_line.font = gsd.SignatureFont()         # Configure font
        inner_line.font.bold = True                   # Make text bold
        inner_line.height = 40                        # Height of text line
        options.inner_lines.append(inner_line)        # Add to stamp options
        
        # Optional: Add more inner lines with additional information
        date_line = gsd.StampLine()
        date_line.text = "May 13, 2025"               # Date of approval
        date_line.height = 20                         # Height of text line
        options.inner_lines.append(date_line)         # Add to stamp options

        # Apply the signature and save document
        result = signature.sign(output_file_path, options)

        # Display success message with separate log entries
        print(f"\nStamp signature applied successfully.")
        print(f"Total signatures applied: {len(result.succeeded)}")
        print(f"File saved at {output_file_path}.")