- IronPDF
- Cómo Hacer
- Firma de documentos PDF
Firmar digitalmente un documento PDF
View the article in
EnglishSu empresa gasta demasiado en suscripciones anuales para la seguridad y el cumplimiento de PDF. Considere
IronSecureDocque ofrece soluciones para gestionar servicios SaaS como la firma digital, la redacción, el cifrado y la protección, todo por un único pago.
Pruébelo ahoraDesambiguación importante: Firmar un PDF
Los desarrolladores suelen preguntar cómo pueden añadir mediante programación una firma a un documento PDF utilizando IronPDF. Por lo general, firmar significa cosas diferentes para distintos desarrolladores:
- Para firmar digitalmente un documento PDF con un certificado que garantice que no ha sido manipulado.
- Para añadir una imagen gráfica de firma manuscrita a un PDF existente desde un archivo de imagen.
- Para estampar la imagen de un certificado en un PDF.
Para añadir un campo de formulario de firma a un PDF que algunos visores pueden solicitar que se firme.
Instalar con NuGet
nuget.org/packages/IronPdf/
Firmar un PDF con un certificado digital
IronPDF admite muchas formas de firmar un PDF con un certificado de firma digital de los formatos .pfx
y .p12
. En esta guía práctica, se le guiará a través de los tres métodos principales utilizados para firmar digitalmente documentos PDF:
Método de firma | Descripción |
---|
Firme | Firme a PDF with a PdfFirmeature object |
FirmeWithFile | Firme PDF with a digital signature certificate(.pfx or .p12) on disk |
FirmeWithStore | Firmes the PDF with digital signature extracted from your computer's signature storage. Basado en una huella dactilar |
### Archivos de certificado de firma digital admitidos Cumplimos oficialmente la norma `X509Certificate2` y admitimos las firmas `.pfx` y `.p12`. Si su firma no puede aplicarse directamente en los métodos de firma de IronPDF, tendrá que crear un certificado `X509Certificate2` con las instrucciones que encontrará en [Documentación de Microsoft](https://learn.microsoft.com/en-us/dotnet/api/system.security.cryptography.x509certificates.x509certificate2.-ctor). ### Firmar: Crear FirmaPdf a partir de X509Certificado2 Los métodos de firma de IronPDF aceptarán el objeto `X509Certificate2` con **X509KeyStorageFlags** establecido en **Exportable**.- IronPDF sólo admite **X509KeyStorageFlags.Exportable**. Algunos certificados tienen KeyStorageFlags configurado como Exportable por defecto. Intentar usar diferentes KeyStorageFlags resultará en una excepción => Internal.Cryptography.CryptoThrowHelper.WindowsCryptographicException: 'La operación solicitada no está soportada'
```cs :path=/static-assets/pdf/content-code-examples/how-to/signing-X509Certificate2-with-privatekey.cs ``` ### Sign: Añadir detalles granulares a PdfSignature Al instanciar PdfSignature o una vez instanciado, se puede añadir información útil al objeto PdfSignature, incluida la fecha, el contacto de firma, la ubicación, el motivo de la firma, el timestampe y la adición de una imagen como apariencia visual en el documento PDF.Compatible con servidores de sellado de tiempo que requieren SHA256 y SHA512
```cs :path=/static-assets/pdf/content-code-examples/how-to/signing-add-granular-information.cs ``` ### DemostraciónEs posible que aparezca un signo de exclamación o de advertencia en lugar de una marca de verificación. Esto ocurre porque Adobe no puede confirmar la autenticidad e integridad del documento al no estar presente el certificado. Para obtener la marca de verificación, añada el certificado a Adobe y vuelva a abrir el documento. ### Diferentes formas de añadir imágenes La imagen puede incluirse de muchas maneras: - Establece la propiedad **SignatureImage** a un nuevo objeto PdfSignatureImage. - Utilice el método `LoadSignatureImageFromFile` para cargar una imagen desde un archivo. LoadSignatureImageFromFile admite varios formatos de imagen. - Utilice el método `LoadSignatureImageFromStream` para cargar la imagen desde el flujo. El flujo de imágenes puede generarse a partir de otra biblioteca siempre que tenga el formato de TGA, PBM, TIFF , BMP, GIF, PNG,JPEG, Webp. ```cs :path=/static-assets/pdf/content-code-examples/how-to/signing-add-image.cs ``` ### Permisos de firma Puede especificar explícitamente las condiciones de validez de su certificado. Si desea que su firma quede invalidada tras un cambio, o que sólo permita cambios en los campos del formulario, etc. Utilice la siguiente tabla para ver las opciones:PdfDocument.SignaturePermissions | Definición |
---|
NoChangesAllowed | No se permiten cambios |
FormFillingAllowed | Se permite cambiar los valores de los campos del formulario |
FormFillingAndAnnotationsAllowed | Se permite cambiar los valores de los campos del formulario y modificar las anotaciones |
Este parámetro es opcional y si no se establece se aplicará una firma que certifica una revisión específica y no puede ser invalidada. ### Guardar y firmar una iteración de revisión en PDF En el siguiente ejemplo abrimos un archivo PDF, realizamos varias ediciones y, antes de guardarlo, lo firmamos. Para los permisos de firma, sólo permitiremos rellenar formularios como futuras ediciones, de lo contrario la firma quedará invalidada de cualquier otra edición. A continuación, llamaremos a `SaveAsRevision` para guardar la revisión en el historial y luego guardar nuestro nuevo documento en el disco. ```cs :path=/static-assets/pdf/content-code-examples/how-to/signing-revision.cs ``` ### Comprender el ahorro incremental para las firmas Mientras que algunos visores, como el navegador Chrome, sólo muestran una versión, los archivos PDF tienen la capacidad de almacenar versiones anteriores del documento, de forma similar al historial de commits de Git. Lo verá en visores de PDF más avanzados, como Adobe Acrobat. Cuando se trata de firmas de PDF, es importante saber esto porque la acción de firmar un PDF se aplica a la iteración actual del PDF. Su PDF puede tener firmas de iteraciones anteriores, o puede tener algunas versiones sin firmar. Podemos visualizar un ejemplo como el siguiente:Iteración de documentos PDF | Certificado A | Certificado B | Certificado C | Certificado D |
---|
0 (primera parada) | ✅ | | | |
1 | | | | |
2 | | | | |
3 | ✅ (sólo edición de campos de formulario) | ✅ (sólo edición de campos de formulario) | | |
4 (sólo campos de formulario editados) | | | ✅ | |
5 | ✅ (no se permiten más ediciones) | ✅ (no se permiten más ediciones) | | ✅ (no se permiten más ediciones) |
Arriba tenemos un documento que ha pasado por 6 iteraciones diferentes. Este documento puede estar pasando por los departamentos de una empresa con aprobación hasta ser finalizado en la iteración 3. En esta iteración, tanto la Persona A como la Persona B firmaron el documento con el permiso "Sólo edición de campos de formulario". Esto significa que se permite rellenar los campos del formulario en el documento PDF, pero cualquier otro cambio en el documento invalidará sus firmas. En el ejemplo anterior podemos suponer que la Persona C es la que ha rellenado el formulario y lo ha enviado de vuelta a las Personas A, B y D, que han firmado el documento una última vez con el permiso "No se permiten ediciones". Dado que no se han realizado acciones de invalidación en este documento, cuando ejecutemos el método de firma de IronPDF, obtendremos **true**. ### Volver a una revisión anterior Para volver a una revisión anterior de un PDF, puede utilizar el método `GetRevision`. Esto olvidará cualquier cambio realizado desde esta revisión, incluidas las firmas más recientes. Para ello, utilice: ```cs :path=/static-assets/pdf/content-code-examples/how-to/signing-revert-revision.cs ``` ### Eliminar firmas IronPDF tiene un método `RemoveSignatures` que eliminará todas las firmas de todas las revisiones de un documento PDF. El uso es el siguiente: ```cs :path=/static-assets/pdf/content-code-examples/how-to/signing-remove-signature.cs ``` ### Verificar todas las firmas de un PDF Al llamar al método de verificación de firmas en un documento PDF, se examinarán todas las firmas de todas las iteraciones del documento y se comprobará que siguen siendo válidas. Esto devolverá un `bool` de `true` si todos son válidos. ```cs :path=/static-assets/pdf/content-code-examples/how-to/signing-verify-signatures.cs ``` ## Estampar una firma en un PDF En primer lugar, empezaré con un PDF que quiero firmar. Utilizaré esta factura de ejemplo:Aplicaremos una firma manuscrita en forma de imagen `.png` a nuestro PDF. Puede ser una firma manuscrita o la imagen que se utilizó en la creación de un archivo de certificado. Este es el ejemplo de firma que utilizaremos:
### Código Con esto usaremos el siguiente código para estampar la firma manuscrita al PDF como marca de agua: ```cs :path=/static-assets/pdf/content-code-examples/how-to/signing-handwritten.cs ``` ### Salida Resultado Después de ejecutar este código, tenemos este archivo de salida que tiene nuestra firma en la parte inferior derecha:## Añadir un campo de firma sin firmar a un PDF Esta opción aún no está disponible. Puede obtener más información sobre IronPDF y los formularios que admite en la página [Rellenar formularios PDF mediante programación en C#](/blog/using-ironpdf/programmatically-fill-pdf-form-csharp/) artículo.