Firma Visual¶

El modulo app/signature_inserter.py implementa la firma visual de documentos PDF usando ReportLab para generar el overlay y PyPDF2 para combinarlo con el PDF original.

Uso actual

La firma visual se usa como fallback en ambiente test cuando no hay certificado disponible. En produccion, se usa la firma combinada PAdES + visual.

Diseno de la firma¶

+-------------------------------------------+
| Juan Perez                     (Bold 10pt) |
| Director                    (Regular 10pt) |
| Administracion              (Regular 10pt) |
| Municipalidad del Futuro    (Regular 10pt) |
|                                            |
| Digitally Signed by TEST SERVER | fecha  7pt |
+-------------------------------------------+
  200 pts ancho x 80 pts alto

Rectangulo invisible (borde blanco)
Nombre en negrita (Helvetica-Bold 10pt)
Cargo, departamento, entidad en regular (Helvetica 10pt)
Footer con identificador y fecha UTC (Helvetica 7pt)

Funcion principal: sign_pdf_document¶

def sign_pdf_document(
    pdf_content: bytes,
    signature_params: Dict[str, str],
    x: float,
    y: float
) -> bytes:

Parametros requeridos en signature_params:

Clave	Descripcion
`name`	Nombre del firmante
`seal`	Cargo o sello
`department`	Departamento
`entity`	Entidad

Proceso¶

Validar que todos los parametros requeridos esten presentes
Leer el PDF original con PdfReader
Crear overlay con la firma visual
Combinar overlay con la ultima pagina del PDF
Retornar el PDF resultante

# Solo firma la ultima pagina
for page_num, page in enumerate(pdf_reader.pages):
    if page_num == len(pdf_reader.pages) - 1:
        page.merge_page(signature_overlay)
    pdf_writer.add_page(page)

Creacion del overlay¶

def create_signature_overlay(signature_params: Dict, x: float, y: float):
    overlay_buffer = io.BytesIO()
    c = canvas.Canvas(overlay_buffer, pagesize=letter)

    # Rectangulo invisible
    c.setStrokeColor(white)
    c.setLineWidth(0.5)
    c.rect(x, y, SIGNATURE_WIDTH, SIGNATURE_HEIGHT)

    # Nombre (Bold)
    text_y = y + SIGNATURE_HEIGHT - 15
    c.setFont("Helvetica-Bold", 10)
    c.drawString(x + 5, text_y, signature_params["name"])

    # Cargo, departamento, entidad (Regular)
    text_y -= 12
    c.setFont("Helvetica", 10)
    c.drawString(x + 5, text_y, signature_params["seal"])

    text_y -= 11
    c.drawString(x + 5, text_y, signature_params["department"])

    text_y -= 11
    c.drawString(x + 5, text_y, signature_params["entity"])

    # Footer
    text_y -= 14
    c.setFont("Helvetica", 7)
    current_time = datetime.utcnow().strftime("%Y-%m-%d %H:%M:%S UTC")
    footer_text = f"Digitally Signed by TEST SERVER | {current_time}"
    c.drawString(x + 5, text_y, footer_text)

    c.save()
    overlay_buffer.seek(0)
    overlay_reader = PdfReader(overlay_buffer)
    return overlay_reader.pages[0]

Diferencias con firma PAdES¶

Aspecto	Firma Visual	Firma PAdES
Criptografia	No	Si (SHA256 + certificado)
Verificable en Adobe	No	Si (clic en la firma)
Timestamp	Solo visual	TSA criptografico
Footer	"Digitally Signed by TEST SERVER"	Sin footer (datos en metadatos)
Nombre	Normal	MAYUSCULAS
Fecha visible	Si (en footer)	No (en metadatos)
Libreria	ReportLab + PyPDF2	pyHanko

Excepciones¶

Excepcion	Causa
`SignatureError`	Parametro faltante o error al procesar PDF