Documentation – PDF 파일 서명 클래스

Python-Net: PDF 문서에 서명

Wed, 10 Jun 2026 00:00:00 +0000

.NET을 통한 파이썬용 Aspose.PDF 는 다음을 제공합니다. PDF 파일 서명 기존 PDF 문서에 디지털 서명을 적용하기 위한 외관.인증서 파일을 사용하여 프로그래밍 방식으로 문서에 서명하고, 페이지에 서명을 배치하고, 서명 메타데이터를 할당하고, 서명이 표시되는 방식을 사용자 지정할 수 있습니다.

이 문서에서는 몇 가지 일반적인 서명 워크플로를 보여줍니다.

a 생성 및 바인딩 PdfFileSignature 입력 PDF의 대상입니다.
서명 인증서를 구성합니다.
대상 페이지에 디지털 서명을 적용합니다.
선택적으로 서명 이름과 눈에 보이는 모양을 지정할 수 있습니다.
서명된 PDF를 저장합니다.

재사용 가능한 서명 도우미 준비

PDF에 디지털 서명을 적용하기 전에 재사용 가능한 도우미 함수를 소그룹으로 설정하는 것이 좋습니다.이러한 도우미는 서명 핸들러를 초기화하고, 가시적인 서명 영역을 정의하고, 인증서를 구성하고, 재사용 가능한 PKCS #7 서명 객체를 만들어 아래의 서명 예제가 독립적이고 쉽게 따라할 수 있도록 합니다.

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd


DEFAULT_CERTIFICATE_PASSWORD = "Aspose2021"
DEFAULT_SIGNATURE_NAME = "Signature1"


def create_pdf_file_signature(infile):
    pdf_signature = pdf_facades.PdfFileSignature()
    pdf_signature.bind_pdf(infile)
    return pdf_signature


def create_signature_rectangle():
    return apd.Rectangle(10, 10, 200, 60)


def configure_signature_certificate(
    pdf_signature, certificate_path, certificate_password=DEFAULT_CERTIFICATE_PASSWORD
):
    pdf_signature.set_certificate(certificate_path, certificate_password)


def create_pkcs7_signature(
    certificate_path, certificate_password=DEFAULT_CERTIFICATE_PASSWORD
):
    signature = ap.forms.PKCS7(certificate_path, certificate_password)
    signature.reason = "Document approval"
    signature.contact_info = "qa@example.com"
    signature.location = "New York, USA"
    signature.authority = "Aspose.PDF Example"
    return signature


def create_custom_signature_appearance():
    appearance = ap.forms.SignatureCustomAppearance()
    appearance.font_family_name = "Arial"
    appearance.font_size = 10
    appearance.show_contact_info = True
    appearance.show_location = True
    appearance.show_reason = True
    return appearance

기본 인증서 매개 변수로 PDF에 서명

이 접근 방식은 에서 직접 인증서를 구성합니다. PdfFileSignature 목적.표준 서명 메타데이터를 사용하고 별도의 서명 객체 관리 없이 간단한 서명 흐름을 원할 때 유용합니다.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def sign_pdf_with_basic_parameters(infile, outfile, certificate_path):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        configure_signature_certificate(pdf_signature, certificate_path)
        pdf_signature.sign(
            1,
            "Document approval",
            "qa@example.com",
            "New York, USA",
            False,
            create_signature_rectangle(),
        )
        pdf_signature.save(outfile)
    finally:
        pdf_signature.close()

PKCS7 개체가 포함된 PDF에 서명

a를 사용하세요 PKCS7 먼저 서명을 준비한 다음 서명 호출에 전달해야 하는 경우 객체를 지정합니다.이 패턴을 사용하면 서명 설정을 더 세밀하게 제어할 수 있으며 고급 워크플로를 위한 좋은 기반이 됩니다.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def sign_pdf_with_certificate_object(infile, outfile, certificate_path):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        signature = create_pkcs7_signature(certificate_path)
        pdf_signature.sign(1, False, create_signature_rectangle(), signature)
        pdf_signature.save(outfile)
    finally:
        pdf_signature.close()

이름이 지정된 서명으로 PDF에 서명

문서 워크플로에서 사전 정의된 서명 필드 이름을 사용하는 경우 해당 이름을 에 전달하십시오. sign().이렇게 하면 나중에 서명을 참조하여 검증, 처리 또는 승인 워크플로우와의 통합을 쉽게 수행할 수 있습니다.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def sign_pdf_with_named_signature(infile, outfile, certificate_path):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        signature = create_pkcs7_signature(certificate_path)
        signature.reason = "Approved by signing workflow"
        pdf_signature.sign(
            1,
            DEFAULT_SIGNATURE_NAME,
            "Approved by signing workflow",
            "qa@example.com",
            "New York, USA",
            True,
            create_signature_rectangle(),
            signature,
        )
        pdf_signature.save(outfile)
    finally:
        pdf_signature.close()

눈에 보이는 서명 적용

에 사용자 정의 모양을 지정하여 PDF 페이지에 서명이 표시되도록 할 수 있습니다. PKCS7 목적.이는 출력 문서에서 최종 사용자에게 이유, 위치 및 연락처 정보와 같은 승인 세부 정보를 표시해야 할 때 유용합니다.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def apply_visible_signature(infile, outfile, certificate_path):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        signature = create_pkcs7_signature(certificate_path)
        signature.reason = "Visible approval signature"
        signature.custom_appearance = create_custom_signature_appearance()
        pdf_signature.sign(
            1,
            "Visible approval signature",
            "qa@example.com",
            "New York, USA",
            True,
            create_signature_rectangle(),
            signature,
        )
        pdf_signature.save(outfile)
    finally:
        pdf_signature.close()

Python-Net: PDF 인증

Wed, 10 Jun 2026 00:00:00 +0000

.NET을 통한 Python용 Aspose.PDF 를 사용하면 다음과 같이 문서 수준 서명을 적용하여 PDF 문서를 인증할 수 있습니다. PDF 파일 서명.인증은 문서가 인증된 후 허용되는 변경 사항이 있을 경우 이를 정의한다는 점에서 표준 승인 서명과 다릅니다.

이 문서에서는 두 가지 일반적인 인증 워크플로를 보여줍니다.

PDF를 인증하고 인증 후 양식 작성을 허용합니다.
PDF를 인증하고 추가 변경을 방지하세요.

양식 작성을 위한 PDF 인증

문서를 인증된 상태로 유지해야 하지만 사용자가 여전히 대화형 양식을 작성하거나 파일에 계속 서명해야 하는 경우 이 방법을 사용하십시오. FILLING_IN_FORMS 권한 수준은 인증을 유효하게 유지하면서 이러한 통제된 변경을 허용합니다.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def certify_pdf_with_mdp_signature(infile, outfile, certificate_path):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        doc_mdp_signature = create_doc_mdp_signature(
            certificate_path,
            ap.forms.DocMDPAccessPermissions.FILLING_IN_FORMS,
            reason="Certified for form filling and signing",
        )
        pdf_signature.certify(
            1,
            "Certified for form filling and signing",
            "security@example.com",
            "New York, USA",
            True,
            create_signature_rectangle(),
            doc_mdp_signature,
        )
        pdf_signature.save(outfile)
    finally:
        pdf_signature.close()

변경이 허용되지 않는 문서 수준 인증 적용

인증 후에도 인증된 문서가 변경되지 않은 상태로 남아 있어야 하는 경우 이 모드를 사용하십시오. NO_CHANGES 권한 수준은 나중에 수정하면 인증 상태가 무효화되는 최종 PDF에 적합합니다.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def apply_document_level_certification(infile, outfile, certificate_path):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        doc_mdp_signature = create_doc_mdp_signature(
            certificate_path,
            ap.forms.DocMDPAccessPermissions.NO_CHANGES,
            reason="Certified with no further changes allowed",
        )
        pdf_signature.certify(
            1,
            "Certified with no further changes allowed",
            "security@example.com",
            "New York, USA",
            True,
            create_signature_rectangle(),
            doc_mdp_signature,
        )
        pdf_signature.save(outfile)
    finally:
        pdf_signature.close()

Python-Net: 개정 및 사용 권한

Wed, 10 Jun 2026 00:00:00 +0000

.NET을 통한 파이썬용 Aspose.PDF 는 다음을 제공합니다. PDF 파일 서명 서명되고 인증된 PDF 문서 작업을 위한 외관.서명을 추가하는 것 외에도 서명 메타데이터를 검사하여 문서에 포함된 수정 버전 수와 인증 후 허용되는 변경 사항을 파악할 수 있습니다.

이 예에서는 세 가지 일반적인 검사 작업을 보여줍니다.

기존 서명의 수정 번호를 가져옵니다.
서명된 문서의 총 수정 횟수를 가져옵니다.
인증된 PDF에서 액세스 권한을 읽어 보십시오.

서명의 수정 번호 가져오기

PDF에 이미 하나 이상의 서명이 포함되어 있고 특정 서명과 관련된 수정 버전을 식별해야 하는 경우 이 방법을 사용하십시오.이 예제에서는 사용 가능한 첫 번째 서명 이름을 확인한 다음 호출합니다. get_revision().

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def get_signature_revision(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        signature_revision = pdf_signature.get_revision(sign_name)
        print(f"Signature Revision for '{sign_name}': {signature_revision}")
    finally:
        pdf_signature.close()

전체 문서 수정 횟수 가져오기

용도 get_total_revision() 서명된 PDF에 얼마나 많은 수정이 저장되어 있는지 알아야 할 때.이는 원본 서명이 적용된 후 문서가 여러 번 업데이트되었는지 여부를 확인하는 데 유용합니다.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def get_total_document_revisions(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        total_revisions = pdf_signature.get_total_revision()
        print(f"Total Document Revisions: {total_revisions}")
    finally:
        pdf_signature.close()

인증된 PDF에서 액세스 권한 받기

인증 문서는 인증 후 허용되는 변경 사항을 정의할 수 있습니다.용도 get_access_permissions() 해당 권한 수준을 검사하여 문서에 변경, 양식 작성 또는 기타 통제된 수정이 허용되지 않는지 확인합니다.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def get_access_permissions(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        access_permissions = pdf_signature.get_access_permissions()
        print(f"Access Permissions: {access_permissions}")
    finally:
        pdf_signature.close()

Python-Net: 시그니처 추출

Wed, 10 Jun 2026 00:00:00 +0000

.NET을 통한 파이썬용 Aspose.PDF 는 다음을 제공합니다. PDF 파일 서명 서명된 PDF 문서에서 데이터를 검사하고 추출하기 위한 외관.PDF에 서명이 완료되면 이를 사용하여 시각적 서명 이미지 및 서명과 관련된 인증서와 같은 서명 리소스를 내보낼 수 있습니다.

이 예에서는 두 가지 일반적인 추출 작업을 보여줍니다.

서명과 관련된 시각적 이미지를 추출합니다.
서명된 PDF에서 서명 인증서를 추출합니다.

서명 이미지 추출

PDF에 눈에 보이는 서명이 포함되어 있고 해당 이미지 데이터를 내보내려는 경우 이 방법을 사용하십시오.이 예제에서는 서명된 문서를 열고, 사용 가능한 첫 번째 서명 이름을 가져오고, 이미지 스트림을 추출하고, 이를 파일에 씁니다.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def extract_signature_image(infile, outfile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        signature_image = pdf_signature.extract_image(sign_name)
        write_stream_data(signature_image, outfile)
    finally:
        pdf_signature.close()

서명 인증서 추출

용도 extract_certificate() 서명에 인증서 데이터를 첨부해야 하는 경우이는 검사, 검증 워크플로우 또는 서명자 인증서를 PDF 문서와 별도로 저장하는 데 유용합니다.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def extract_signature_certificate(infile, outfile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        signature_certificate = pdf_signature.extract_certificate(sign_name)
        write_stream_data(signature_certificate, outfile)
    finally:
        pdf_signature.close()

Python-Net: 시그니처 정보

Wed, 10 Jun 2026 00:00:00 +0000

.NET을 통한 파이썬용 Aspose.PDF 는 다음을 제공합니다. PDF 파일 서명 PDF 문서의 디지털 서명을 검사하기 위한 외관.문서에 서명이 완료되면 이를 사용하여 서명 이름을 읽고 서명자 이름, 연락처 정보, 서명 시간, 이유 및 위치와 같은 메타데이터를 검색할 수 있습니다.

이 예에서는 네 가지 일반적인 서명 정보 작업을 보여 줍니다.

서명된 PDF의 모든 서명 이름을 나열합니다.
선택한 서명에 대한 서명자 세부 정보를 읽습니다.
서명 날짜 및 시간을 확인하세요.
서명 이유와 위치를 읽어 보십시오.

서명 이름 가져오기

PDF에 하나 이상의 서명이 포함되어 있고 사용 가능한 서명 항목을 검사하려는 경우 이 방법을 사용하십시오.이 예제에서는 문서를 열고 에서 반환한 목록을 인쇄합니다. get_sign_names().

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def get_signature_names(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        signature_names = list_signature_names(pdf_signature)
        print(f"Signature Names: {signature_names}")
    finally:
        pdf_signature.close()

서명자 세부 정보 가져오기

서명 이름을 알면 서명자별 메타데이터를 검색할 수 있습니다.이 예제에서는 문서에서 사용 가능한 첫 번째 서명에 대한 서명자 이름과 연락처 정보를 읽습니다.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def get_signer_details(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        signer_name = pdf_signature.get_signer_name(sign_name)
        contact_info = pdf_signature.get_contact_info(sign_name)
        print(
            f"Signer Details for '{sign_name}': "
            f"signer_name={signer_name}, contact_info={contact_info}"
        )
    finally:
        pdf_signature.close()

서명 날짜 및 시간 가져오기

용도 get_date_time() 특정 서명이 적용된 시기를 결정합니다.이는 문서 워크플로우에서 서명 기록을 감사하고 표시하는 데 유용합니다.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def get_signature_date_and_time(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        signature_date = pdf_signature.get_date_time(sign_name)
        print(f"Signature Date and Time for '{sign_name}': {signature_date}")
    finally:
        pdf_signature.close()

서명 이유 및 위치 가져오기

디지털 서명에는 서명 이유 및 위치와 같은 설명 메타데이터도 저장할 수 있습니다.이 예제에서는 선택한 서명의 두 값을 모두 검색하여 함께 인쇄합니다.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def get_signature_reason_and_location(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        signature_reason = pdf_signature.get_reason(sign_name)
        signature_location = pdf_signature.get_location(sign_name)
        print(
            f"Signature Reason and Location for '{sign_name}': "
            f"reason={signature_reason}, location={signature_location}"
        )
    finally:
        pdf_signature.close()

Python-Net: 서명 무결성 검사

Wed, 10 Jun 2026 00:00:00 +0000

.NET을 통한 파이썬용 Aspose.PDF 는 다음을 제공합니다. PDF 파일 서명 서명된 PDF 문서의 유효성을 검사하기 위한 외관.파일에 서명이 완료되면 이를 사용하여 서명이 전체 문서에 적용되는지 여부와 서명된 내용이 여전히 유효한지 확인할 수 있습니다.

이 예제는 두 가지 일반적인 무결성 검사를 보여줍니다.

서명이 문서 전체를 덮는지 확인합니다.
서명된 PDF 콘텐츠의 무결성을 검증합니다.

서명이 문서 전체를 덮는지 확인

용도 covers_whole_document() 서명이 내용 일부에만 적용되는 것이 아니라 전체 PDF에 적용되는지 확인해야 하는 경우이 예제에서는 사용 가능한 첫 번째 서명 이름을 읽고 적용 범위를 확인합니다.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def check_signature_coverage(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        covers_document = pdf_signature.covers_whole_document(sign_name)
        print(f"Signature '{sign_name}' covers the whole document: {covers_document}")
    finally:
        pdf_signature.close()

문서 무결성 검증

용도 verify_signed() 서명이 적용된 후 서명된 문서 내용이 변경되지 않았는지 확인합니다.이 방법을 사용하면 선택한 서명에 대해 문서가 유효한지 확인할 수 있습니다.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def validate_document_integrity(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        is_valid = pdf_signature.verify_signed(sign_name)
        print(f"Document integrity for '{sign_name}' is valid: {is_valid}")
    finally:
        pdf_signature.close()

Python-Net: 시그니처 매니지먼트

Wed, 10 Jun 2026 00:00:00 +0000

.NET을 통한 파이썬용 Aspose.PDF 는 다음을 제공합니다. PDF 파일 서명 PDF 문서의 기존 디지털 서명 작업을 위한 외관서명을 읽고 유효성을 검사하는 것 외에도 워크플로우에서 서명된 내용을 업데이트하거나 서명 필드를 지워야 하는 경우 서명을 제거할 수도 있습니다.

이 예에서는 두 가지 일반적인 서명 관리 작업을 보여 줍니다.

PDF 문서에서 서명을 제거합니다.
서명을 제거하고 관련 서명 필드를 정리합니다.

PDF에서 서명 제거

용도 remove_signature() 기본 서명 필드 구조를 그대로 유지하면서 문서에서 선택한 서명을 삭제하려는 경우이 예제에서는 서명된 PDF를 열고, 서명 이름을 확인하고, 제거하고, 업데이트된 출력 파일을 저장합니다.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def remove_signature_from_pdf(infile, outfile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        pdf_signature.remove_signature(sign_name)
        pdf_signature.save(outfile)
    finally:
        pdf_signature.close()

서명 제거 및 필드 정리

추가 기능과 함께 오버로드 사용 True 서명을 제거하고 관련 서명 필드를 정리하려는 경우 플래그를 지정합니다.이는 서명이 삭제된 후 필드가 문서에 남아 있지 않아야 하는 경우에 유용합니다.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def remove_signature_with_field_cleanup(infile, outfile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        pdf_signature.remove_signature(sign_name, True)
        pdf_signature.save(outfile)
    finally:
        pdf_signature.close()

Python-Net: 시그니처 검증

Wed, 10 Jun 2026 00:00:00 +0000

.NET을 통한 파이썬용 Aspose.PDF 는 다음을 제공합니다. PDF 파일 서명 서명된 PDF 문서의 유효성을 검사하기 위한 외관.PDF에 서명이 완료되면 이를 사용하여 서명이 유효한지 확인하고 문서에 서명 항목이 포함되어 있는지 확인할 수 있습니다.

이 예에서는 두 가지 일반적인 확인 작업을 보여줍니다.

기존 PDF 서명이 유효한지 확인합니다.
PDF에 서명이 포함되어 있는지 확인합니다.

PDF 서명 확인

용도 verify_signature() 문서의 특정 서명의 유효성을 검사해야 할 때.이 예제에서는 사용 가능한 첫 번째 서명 이름을 확인하고 해당 서명이 유효한지 여부를 확인합니다.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def verify_pdf_signature(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        sign_name = require_signature_name(pdf_signature)
        is_valid = pdf_signature.verify_signature(sign_name)
        print(f"Signature '{sign_name}' is valid: {is_valid}")
    finally:
        pdf_signature.close()

PDF에 서명이 포함되어 있는지 확인

용도 contains_signature() PDF에 서명이 포함되어 있는지 여부만 알면 됩니다.이는 보다 상세한 검증 또는 추출 로직을 실행하기 전에 빠르게 확인하는 데 유용합니다.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def check_if_pdf_contains_signatures(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        contains_signatures = pdf_signature.contains_signature()
        print(f"PDF contains signatures: {contains_signatures}")
    finally:
        pdf_signature.close()

Python-Net: 사용 권한 관리

Wed, 10 Jun 2026 00:00:00 +0000

.NET을 통한 파이썬용 Aspose.PDF 는 다음을 제공합니다. PDF 파일 서명 서명된 PDF 및 관련 사용 권한 설정 작업을 위한 외관일부 워크플로에서는 파일의 업데이트된 버전을 저장하기 전에 문서에 사용 권한이 있는지 여부를 검사하고 사용 권한을 제거해야 할 수 있습니다.

이 예에서는 일반적인 사용 권한 관리 작업 하나를 보여 줍니다.

PDF에 사용 권한이 있는지 확인합니다.
문서에서 사용 권한을 제거합니다.
업데이트된 PDF 파일을 저장합니다.

PDF에 사용 권한이 있는지 확인

사용 권한을 제거하기 전에 예제에서는 를 호출하여 문서의 현재 상태를 확인합니다. contains_usage_rights().이를 통해 변경하기 전에 사용 권한이 있는지 확인할 수 있습니다.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def check_usage_rights(infile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        had_usage_rights = pdf_signature.contains_usage_rights()
        print(f"PDF contains usage rights: {had_usage_rights}")
    finally:
        pdf_signature.close()

PDF에서 사용 권한 제거

용도 remove_usage_rights() 문서가 기존 사용 권한 설정을 더 이상 유지하지 않아야 하는 경우이 예제에서는 초기 상태를 확인하고 권한을 제거한 다음 업데이트된 PDF를 새 파일에 저장합니다.

import aspose.pdf.facades as pdf_facades
import sys
from os import path


def remove_usage_rights(infile, outfile):
    pdf_signature = create_pdf_file_signature(infile)
    try:
        had_usage_rights = pdf_signature.contains_usage_rights()
        print(f"PDF contains usage rights before removal: {had_usage_rights}")
        pdf_signature.remove_usage_rights()
        pdf_signature.save(outfile)
    finally:
        pdf_signature.close()