Menandatangani Dokumen PDF dari Kartu Pintar dengan Python

Aspose.PDF menyediakan kemampuan kuat untuk mengintegrasikan komponen tanda tangan visual dan kriptografis, memastikan keaslian serta tampilan profesional dalam dokumen PDF yang ditandatangani secara digital.

Gunakan alur kerja ini ketika proses penandatanganan Anda bergantung pada sertifikat yang disimpan dalam perangkat berbasis perangkat keras seperti kartu pintar, token USB, atau penyimpanan sertifikat yang dikelola.

Menandatangani dengan Kartu Pintar Menggunakan Bidang Tanda Tangan

Contoh ini menunjukkan cara menandatangani dokumen PDF secara digital menggunakan sertifikat eksternal dengan Aspose.PDF for Python dan menerapkan gambar tampilan tanda tangan khusus:

  1. Membuka dokumen PDF.
  2. Membuat objek PdfFileSignature dan mengaitkannya ke dokumen.
  3. Mengambil sertifikat digital lokal menggunakan metode khusus get_local_certificate().
  4. Menyiapkan ExternalSignature berdasarkan sertifikat yang dipilih.
  5. Menerapkan gambar tampilan tanda tangan khusus (mis., logo perusahaan atau tanda tangan tulisan tangan).
  6. Menandatangani secara digital halaman pertama dokumen dengan metadata yang ditentukan (alasan, kontak, lokasi).
  7. Menyimpan dokumen yang ditandatangani ke file output baru.

Metode ini ideal untuk kasus di mana tanda tangan harus diterapkan secara programatis menggunakan sertifikat eksternal—seperti token perangkat keras, penyimpanan sertifikat, atau penyedia tepercaya—dan ditampilkan dengan tata letak visual yang dipersonalisasi.

Berikut adalah cuplikan kode untuk menandatangani dokumen PDF dari kartu pintar:

import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def sign_with_smart_card(infile: str, outfile: str, pngfile: str) -> None:
    """Sign a PDF document using a smart-card certificate."""
    with ap.Document(infile) as document:
        with ap.facades.PdfFileSignature() as pdf_signature:
            pdf_signature.bind_pdf(document)
            external_signature = ap.forms.ExternalSignature(get_local_certificate())
            pdf_signature.signature_appearance = pngfile
            pdf_signature.sign(
                1,
                "Reason",
                "Contact",
                "Location",
                True,
                drawing.Rectangle(100, 100, 200, 200),
                external_signature,
            )
            pdf_signature.save(outfile)

Verifikasi Tanda Tangan Digital

Potongan kode ini menunjukkan cara memverifikasi tanda tangan digital dalam dokumen PDF menggunakan Aspose.PDF for Python:

  1. Membuka file PDF.
  2. Membuat ‘PdfFileSignature object’ dan mengaitkannya ke dokumen.
  3. Mengambil daftar semua nama bidang tanda tangan menggunakan ‘get_signature_names()’.
  4. Melakukan iterasi melalui setiap tanda tangan dan memverifikasi keabsahannya dengan ‘verify_signature()’.
  5. Menaikkan pengecualian jika ada tanda tangan yang gagal verifikasi.
import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def verify_external_signature(infile: str) -> None:
    """Verify an external signature in a PDF document."""
    with ap.Document(infile) as document:
        with ap.facades.PdfFileSignature(document) as pdf_signature:
            for signature_name in pdf_signature.get_signature_names(True):
                if not pdf_signature.verify_signature(signature_name):
                    raise Exception("Not verified")

Tanda tangani dengan Sertifikat Eksternal

Potongan kode ini menunjukkan cara menambahkan dan menandatangani bidang tanda tangan digital dalam dokumen PDF menggunakan Aspose.PDF for Python dengan sertifikat eksternal:

  1. Membuka file PDF sebagai aliran biner.
  2. Membuat SignatureField dan menempatkannya pada halaman pertama dokumen pada posisi yang ditentukan.
  3. Mengambil sertifikat digital lokal menggunakan metode khusus get_local_certificate().
  4. Menyiapkan ExternalSignature dengan metadata seperti otoritas, alasan, dan informasi kontak.
  5. Menetapkan nama field unik ke bidang tanda tangan (partial_name = "sig1").
  6. Menambahkan bidang tanda tangan ke bidang formulir PDF.
  7. Menandatangani bidang dengan sertifikat eksternal.
  8. Menyimpan dokumen yang ditandatangani ke file output.
import sys
from os import path
import aspose.pdf as ap
import aspose.pydrawing as drawing

def get_signature_info_using_signature_field(infile: str, outfile: str) -> None:
    """Create a signature field and sign it with an external certificate."""
    with open(infile, "rb+") as file_stream:
        document = ap.Document(file_stream)
        signature_field = ap.forms.SignatureField(
            document.pages[1],
            ap.Rectangle(100, 400, 10, 10, True),
        )
        selected_certificate = get_local_certificate()
        external_signature = ap.forms.ExternalSignature(selected_certificate)
        external_signature.authority = "Me"
        external_signature.reason = "Reason"
        external_signature.contact_info = "Contact"
        signature_field.partial_name = "sig1"
        document.form.add(signature_field, 1)
        signature_field.sign(external_signature)
        document.save(outfile)

Topik Keamanan Terkait

Ekstrak Informasi Tanda Tangan dari PDF di Python Enkripsi dan Dekripsi File PDF di Python