Agregar referencia a AutoFirma

Oct 13, 2025 by wbrum.org 39 views

Introducción

En este artículo, exploraremos cómo firmar documentos con AutoFirma desde un proyecto .NET. AutoFirma es una herramienta de firma digital que permite firmar documentos electrónicos de manera segura y confiable. En este caso, queremos firmar documentos en formato XML y PDF utilizando certificados de usuario en XAdES y PAdES.

Requisitos previos

Para seguir con este artículo, es necesario tener los siguientes requisitos previos:

.NET Framework 4.6.1 o superior
AutoFirma instalado en el equipo
Certificados de usuario en formato XAdES y PAdES

Configuración de AutoFirma

Antes de empezar a firmar documentos, debemos configurar AutoFirma en nuestro proyecto .NET. Para ello, debemos agregar la referencia a la biblioteca de AutoFirma en nuestro proyecto.

Agregar referencia a AutoFirma

Para agregar la referencia a AutoFirma, debemos seguir los siguientes pasos:

Abrir el proyecto .NET en Visual Studio
Ir a "Herramientas" > "Administrador de paquetes NuGet"
Buscar "AutoFirma" y seleccionar la versión que deseamos utilizar
Seleccionar la opción "Instalar"

Crear un objeto de firma

Una vez que hayamos agregado la referencia a AutoFirma, debemos crear un objeto de firma que nos permita firmar documentos. Para ello, debemos crear una clase que herede de la clase Firma de AutoFirma.

Crear la clase de firma

using System;
using System.IO;
using System.Security.Cryptography.X509Certificates;
using AutoFirma;
public class Firma : AutoFirma.Firma

public Firma(X509Certificate2 certificado, string clavePrivada)
 base(certificado, clavePrivada)
{

}

Crear un objeto de firma

Una vez que hayamos creado la clase de firma, debemos crear un objeto de firma que nos permita firmar documentos. Para ello, debemos crear una instancia de la clase Firma y pasarle el certificado y la clave privada.

Crear el objeto de firma

X509Certificate2 certificado = new X509Certificate2("ruta/certificado.pfx", "clave");
Firma firma = new Firma(certificado, "clavePrivada");

Firmar un documento

Una vez que hayamos creado el objeto de firma, debemos firmar el documento que deseamos. Para ello, debemos utilizar el método Firmar de la clase Firma.

Firmar el documento

string rutaDocumento = "ruta/documento.xml";
firma.Firmar(rutaDocumento);

Firmar un documento PDF

Si deseamos firmar un documento PDF, debemos utilizar el método FirmarPdf de la clase Firma.

Firmar el documento PDF

string rutaDocumentoPdf = "ruta/documento.pdf";
firma.FirmarPdf(rutaDocumentoPdf);

Verificar la firma

Una vez que hayamos firmado el documento, debemos verificar la firma para asegurarnos de que es válida. Para ello, debemos utilizar el método VerificarFirma de la clase Firma.

Verificar la firma

bool esValida = firma.VerificarFirma(rutaDocumento);

Conclusión

En este artículo, hemos visto cómo firmar documentos con AutoFirma desde un proyecto .NET. Hemos creado un objeto de firma que nos permite firmar documentos en formato XML y PDF utilizando certificados de usuario en XAdES y PAdES. También hemos visto cómo verificar la firma para asegurarnos de que es válida.

Referencias

Código fuente

El código fuente de este artículo se puede encontrar en el siguiente enlace:

Código fuente

Licencia

¿Qué es AutoFirma?

AutoFirma es una herramienta de firma digital que permite firmar documentos electrónicos de manera segura y confiable. Permite firmar documentos en formato XML y PDF utilizando certificados de usuario en XAdES y PAdES.

¿Qué es XAdES?

XAdES (XML Advanced Electronic Signatures) es un estándar de firma digital que permite firmar documentos electrónicos en formato XML. Permite agregar una firma digital a un documento XML, lo que garantiza la autenticidad y la integridad del documento.

¿Qué es PAdES?

PAdES (PDF Advanced Electronic Signatures) es un estándar de firma digital que permite firmar documentos electrónicos en formato PDF. Permite agregar una firma digital a un documento PDF, lo que garantiza la autenticidad y la integridad del documento.

¿Cómo puedo firmar un documento con AutoFirma?

Para firmar un documento con AutoFirma, debes seguir los siguientes pasos:

Crear un objeto de firma utilizando la clase Firma de AutoFirma.
Pasar el certificado y la clave privada al objeto de firma.
Utilizar el método Firmar para firmar el documento.

¿Cómo puedo verificar la firma de un documento?

Para verificar la firma de un documento, debes utilizar el método VerificarFirma de la clase Firma. Este método devuelve un valor booleano que indica si la firma es válida o no.

¿Qué pasa si el certificado o la clave privada no son válidos?

Si el certificado o la clave privada no son válidos, el método Firmar o VerificarFirma puede lanzar una excepción. Debes asegurarte de que el certificado y la clave privada sean válidos antes de intentar firmar o verificar un documento.

¿Puedo firmar un documento PDF con AutoFirma?

Sí, puedes firmar un documento PDF con AutoFirma utilizando el método FirmarPdf de la clase Firma.

¿Puedo firmar un documento XML con AutoFirma?

Sí, puedes firmar un documento XML con AutoFirma utilizando el método Firmar de la clase Firma.

¿Qué es la clave privada?

La clave privada es un valor secreto que se utiliza para firmar un documento. Debe ser protegida para evitar que terceros firmen documentos en tu nombre.

¿Qué es el certificado?

El certificado es un documento que contiene información sobre la identidad de la persona que firmó un documento. Debe ser válido y emitido por una autoridad de certificación confiable.

¿Puedo utilizar AutoFirma en un proyecto .NET?

Sí, puedes utilizar AutoFirma en un proyecto .NET. Debes agregar la referencia a la biblioteca de AutoFirma en tu proyecto y utilizar la clase Firma para firmar y verificar documentos.

¿Puedo utilizar AutoFirma en un proyecto Java?

Sí, puedes utilizar AutoFirma en un proyecto Java. Debes agregar la referencia a la biblioteca de AutoFirma en tu proyecto y utilizar la clase Firma para firmar y verificar documentos.

¿Dónde puedo obtener más información sobre AutoFirma?

Puedes obtener más información sobre AutoFirma en la siguiente página web:

AutoFirma

¿Dónde puedo obtener más información sobre firmas digitales?

Puedes obtener más información sobre firmas digitales en la siguiente página web:

Wikipedia: Firma digital

¿Dónde puedo obtener más información sobre XAdES y PAdES?

Puedes obtener más información sobre XAdES y PAdES en la siguiente página web: