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

pip install groupdocs-signature-net

# GroupDocs.Signature 핵심 라이브러리 가져오기
import groupdocs.signature as gs

# 서명 설정 구성에 사용되는 옵션 가져오기
import groupdocs.signature.options as gso

# 서명 맞춤화에 사용되는 도메인 클래스 가져오기
import groupdocs.signature.domain as gsd

# 이 함수는 PDF에 텍스트 양식 필드 서명을 추가하는 방법을 보여줍니다
# 양식 필드는 사용자가 서명 정보를 입력할 수 있는 상호작용 영역을 만듭니다
def add_form_field_signature():
    # 소스 및 출력 문서에 대한 파일 경로 정의
    sample_pdf = "sample.pdf"               # 소스 PDF 문서
    output_file_path = "form_signed.pdf"    # 서명된 문서를 저장할 위치

    # 서명할 문서 열기
    with gs.Signature(sample_pdf) as signature:
        # 필드 이름 및 기본 값으로 텍스트 양식 필드 서명 생성
        # 필드 이름은 식별자이며 값은 기본 텍스트입니다
        text_signature = gs.domain.TextFormFieldSignature("SignatureField", "여기 서명")

        # 텍스트 서명에 따라 양식 필드 옵션 구성
        options = gso.FormFieldSignOptions(text_signature)

        # 양식 필드의 위치 및 크기 설정
        options.top = 150                   # 페이지의 Y 위치
        options.left = 50                   # 페이지의 X 위치
        options.height = 50                 # 필드 높이
        options.width = 200                 # 필드 너비

        # 문서에 서명(양식 필드 추가)하고 파일에 저장
        result = signature.sign(output_file_path, options)

        # 별도의 로그 항목으로 성공 메시지 표시
        print(f"\n양식 필드 서명 성공적으로 추가됨.")
        print(f"총 추가된 양식 필드: {len(result.succeeded)}")
        print(f"파일 {output_file_path}에 저장됨.")

# 이 함수는 문서에 이미지 기반 서명을 추가하는 방법을 보여줍니다
# 수서식 서명, 회사 로고 또는 공식 인장 추가에 적합
def add_image_signature():
    # 파일 경로 정의
    sample_file_path = "sample.pdf"         # 소스 문서
    image_signature = "signature.png"       # 서명 이미지 파일
    output_file_path = "image_signed.pdf"   # 서명된 문서를 저장할 위치

    # 서명할 문서 열기
    with gs.Signature(sample_file_path) as signature:
        # 서명 이미지 경로로 이미지 서명 옵션 구성
        options = gso.ImageSignOptions(image_signature)

        # 이미지 서명 위치 설정
        options.left = 50                   # 페이지의 X 위치
        options.top = 50                    # 페이지의 Y 위치

        # 문서의 모든 페이지에 적용
        options.all_pages = True

        # 이미지로 문서에 서명하고 파일에 저장
        result = signature.sign(output_file_path, options)

        # 별도의 로그 항목으로 성공 메시지 표시
        print(f"\n이미지 서명 성공적으로 적용됨.")
        print(f"총 적용된 서명: {len(result.succeeded)}")
        print(f"서명된 문서 {output_file_path}에 저장됨.")

# 이 함수는 공식적인 스탬프 서명을 추가하는 방법을 보여줍니다
# 공증식 인장, 회사 스탬프 또는 승인 표시 생성에 적합
def add_stamp_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 = "stamp_signed.pdf"   # 서명된 문서를 저장할 위치

    # 서명할 문서 열기
    with gs.Signature(sample_file_path) as signature:
        # 스탬프 서명 옵션 정의
        options = gso.StampSignOptions()

        # 스탬프 위치 및 크기 설정
        options.left = 50                   # 페이지의 X 위치
        options.top = 150                   # 페이지의 Y 위치
        options.width = 200                 # 스탬프 너비
        options.height = 200                # 스탬프 높이

        # 스탬프의 외부 원형 텍스트 줄 생성
        # 이 작업은 스탬프 외곽의 텍스트 고리를 만듭니다
        outer_line = gsd.StampLine()
        outer_line.text = " * 공식 문서 * "  # 장식용 별표 텍스트
        outer_line.text_repeat_type = gsd.StampTextRepeatType.FULL_TEXT_REPEAT  # 원형 텍스트 반복
        outer_line.font = gsd.SignatureFont()         # 폰트 구성
        outer_line.height = 22                        # 텍스트 줄 높이
        outer_line.text_bottom_intent = 6             # 하단 간격
        options.outer_lines.append(outer_line)        # 스탬프 옵션에 추가

        # 스탬프의 내부 텍스트 줄 생성(중앙 텍스트)
        # 이 작업은 스탬프 중앙의 콘텐츠를 만듭니다
        inner_line = gsd.StampLine()
        inner_line.text = "승인됨"                  # 스탬프 중앙 텍스트
        inner_line.font = gsd.SignatureFont()         # 폰트 구성
        inner_line.font.bold = True                   # 텍스트 굵게
        inner_line.height = 40                        # 텍스트 줄 높이
        options.inner_lines.append(inner_line)        # 스탬프 옵션에 추가

        # 선택 사항: 추가 정보가 있는 더 많은 내부 줄 추가
        date_line = gsd.StampLine()
        date_line.text = "2025년 5월 13일"               # 승인 날짜
        date_line.height = 20                         # 텍스트 줄 높이
        options.inner_lines.append(date_line)         # 스탬프 옵션에 추가

        # 서명 적용하고 문서 저장
        result = signature.sign(output_file_path, options)

        # 별도의 로그 항목으로 성공 메시지 표시
        print(f"\n스탬프 서명 성공적으로 적용됨.")
        print(f"총 적용된 서명: {len(result.succeeded)}")
        print(f"파일 {output_file_path}에 저장됨.")