Sign
El plugin de Seguridad PDF de Documentize para .NET permite a los usuarios firmar digitalmente documentos PDF. Ofrece un proceso simplificado para añadir firmas, asegurando autenticidad y asegurando el contenido PDF. El plugin admite tanto firmas visibles como invisibles y proporciona opciones para personalizar la posición de la firma, motivo, información de contacto y más.
Cómo Firmar Documentos PDF
Para firmar un documento PDF usando un archivo PFX, sigue estos pasos:
- Instancia la clase
SignOptionscon la ruta del archivo PFX y la contraseña. - Agrega el PDF de entrada y el archivo de salida a las opciones.
- Ejecuta el método
Signpara aplicar la firma.
1// Crear objeto SignOptions para establecer instrucciones
2var options = new SignOptions("ruta_a_tu_archivo_pfx.pfx", "contraseña_de_tu_archivo_pfx");
3// Agregar ruta del archivo de entrada
4options.AddInput(new FileDataSource("ruta_a_tu_archivo_pdf.pdf"));
5// Establecer ruta del archivo de salida
6options.AddOutput(new FileDataSource("ruta_al_archivo_pdf_resultante.pdf"));
7// Realizar el proceso
8PdfSecurity.Sign(options);Cómo Usar Flujo para el Archivo PFX
También puedes firmar un PDF utilizando un certificado PFX proporcionado como un flujo en lugar de una ruta de archivo. Esto permite un manejo más flexible del almacenamiento del certificado.
1using var pfxStream = File.OpenRead(@"ruta_a_tu_archivo_pfx.pfx");
2var options = new SignOptions(pfxStream, "contraseña_de_tu_archivo_pfx");
3options.AddInput(new FileDataSource("ruta_a_tu_archivo_pdf.pdf"));
4options.AddOutput(new FileDataSource("ruta_al_archivo_pdf_resultante.pdf"));
5// Realizar el proceso
6PdfSecurity.Sign(options);Cómo Aplicar Firmas Invisibles
Para agregar una firma invisible (una que asegura el documento sin mostrar la firma en el documento), simplemente establece la propiedad Visible en false.
- Crea una instancia de
SignOptions. - Establece
Visibleenfalse. - Agrega archivos de entrada y salida.
- Llama a
Signpara aplicar la firma invisible.
1var options = new SignOptions("ruta_a_tu_archivo_pfx.pfx", "contraseña_de_tu_archivo_pfx");
2options.AddInput(new FileDataSource("ruta_a_tu_archivo_pdf.pdf"));
3options.AddOutput(new FileDataSource("ruta_al_archivo_pdf_resultante.pdf"));
4// Configurar firma invisible
5signOptions.Visible = false;
6// Realizar el proceso
7PdfSecurity.Sign(options);Cómo usar opciones adicionales para la firma de documentos PDF
Puedes usar opciones adicionales al agregar una firma a un archivo PFX como Motivo, Contacto, Ubicación, Número de Página.
- Instancia la clase
SignOptionscon la ruta del archivo PFX y la contraseña. - Agrega el PDF de entrada y el archivo de salida a las opciones.
- Establece valores para tus opciones.
- Ejecuta el método
Signpara aplicar la firma.
1// Crear objeto SignOptions para establecer instrucciones
2var options = new SignOptions("ruta_a_tu_archivo_pfx.pfx", "contraseña_de_tu_archivo_pfx");
3// Agregar ruta del archivo de entrada
4options.AddInput(new FileDataSource("ruta_a_tu_archivo_pdf.pdf"));
5// Establecer ruta del archivo de salida
6options.AddOutput(new FileDataSource("ruta_al_archivo_pdf_resultante.pdf"));
7// Parámetros opcionales
8options.Reason = "mi Motivo";
9options.Contact = "mi Contacto";
10options.Location = "mi Ubicación";
11options.PageNumber = 3;
12// Realizar el proceso
13PdfSecurity.Sign(options);Cómo Agregar un Sello de Tiempo a un PDF
Para agregar un sello de tiempo seguro a un documento PDF, sigue estos pasos:
- Crea una instancia de
AddTimestampOptionspara configurar el proceso de sellado de tiempo. - Agrega el archivo PDF de entrada usando el método
AddInput. - Establece la ruta del archivo de salida usando
AddOutput. - Ejecuta el sellado de tiempo usando el método
Sign.
1// Crear objeto SignOptions para establecer instrucciones
2var options = new SignOptions("ruta_a_tu_archivo_pfx.pfx", "contraseña_de_tu_archivo_pfx");
3options.TimestampOptions = new TimestampOptions("url_del_servidor");
4// Agregar ruta del archivo de entrada
5options.AddInput(new FileDataSource("ruta_a_tu_archivo_pdf.pdf"));
6// Establecer ruta del archivo de salida
7options.AddOutput(new FileDataSource("ruta_al_archivo_pdf_resultante.pdf"));
8// Realizar el proceso
9PdfSecurity.Sign(options);Cómo Usar Autenticación Personalizada con el Servidor de Sello de Tiempo
Puedes proporcionar credenciales de autenticación básica al conectarte al servidor de sellado de tiempo. Esto te permite autenticarte con servidores que requieren un nombre de usuario y una contraseña.
1// Configurar las opciones de sellado de tiempo con autenticación
2options.TimestampOptions = new TimestampOptions("url_del_servidor_de_sello_de_tiempo", "usuario:contraseña");Características Clave:
- Firmar Digitalmente Documentos PDF: Asegura tus documentos con firmas digitales visibles o invisibles.
- Soporte para PFX: Firma archivos PDF utilizando un certificado PFX.
- Opciones Personalizables: Configura ajustes de firma como motivo, ubicación y detalles de contacto.
- Firmas Visibles e Invisibles: Elige si la firma es visible en el documento.
- Servidores de Sello de Tiempo Personalizables: Usa URL de servidores de sello de tiempo personalizados y credenciales de autenticación.