Cómo cifrar, añadir contraseñas y permisos a archivos PDF en C#
Proteger los archivos PDF con contraseñas y permisos específicos es vital para proteger documentos sensibles del acceso no autorizado y la manipulación. La API [POST] Encrypt/Add Password & Permissions de IronSecureDoc proporciona una forma eficiente de cifrar archivos PDF con contraseñas de usuario y propietario mientras configura permisos para impresión, llenado de formularios, anotaciones y más. Esta API asegura que el PDF esté completamente protegido y el acceso esté controlado, haciéndolo ideal para documentos legales, financieros o personales.
Cómo cifrar, añadir contraseñas y permisos a archivos PDF
- Descargar e iniciar la imagen Docker de IronSecureDoc
- Pruebe la API usando Swagger
- Especifique los parámetros de contraseña y permisos
- Ejecute la llamada a la API para aplicar los cambios
- Exporte el documento PDF cifrado
Descargue e inicie IronSecureDoc
Si aún no tiene IronSecureDoc funcionando, siga los enlaces a continuación para configurarlo:
| Alojar localmente | Implementar en la nube |
|---|---|
La API [POST] para cifrar/agregar contraseñas y permisos
La API [POST] Encrypt/Add Password & Permissions le permite agregar capas de seguridad a documentos PDF cifrándolos con contraseñas y estableciendo permisos específicos para varias operaciones. Ya sea para conceder acceso de lectura, permitir el llenado de formularios, o deshabilitar la impresión, esta API le da control sobre cómo se accede a sus archivos PDF y cómo se modifican.
Swagger
Swagger ofrece una interfaz fácil de usar para probar esta API de manera interactiva. Puede usarlo para enviar solicitudes de prueba y recibir respuestas sin escribir código, lo que lo convierte en una excelente herramienta para desarrolladores.
Pasos para censurar texto con Swagger
- Acceder a la interfaz Swagger:
Si su servidor de API se está ejecutando localmente, puede acceder a Swagger navegando a http://localhost:8080/swagger/index.html en su navegador web.

- Localizar la API:
Busque la API [POST] /v1/document-services/pdfs/encrypt, que corresponde a Cifrar/Agregar Contraseña y Permisos.

- Ingresar parámetros:
Proporcione los parámetros necesarios para la API. Puede cargar un archivo PDF de muestra y especificar los permisos deseados.
- Subir archivo PDF:
En el cuerpo de la solicitud, suba un archivo PDF como pdf_file y defina los permisos necesarios, como permitir o restringir la impresión, el llenado de formularios y la extracción de contenido.
- Ejecutar la solicitud:
Una vez que todos los parámetros están configurados, haga clic en "Ejecutar" para enviar la solicitud. La respuesta devolverá el PDF cifrado con los ajustes de seguridad especificados.
- Verificar el PDF de salida:
Ingrese 'password' para ver el contenido del PDF.
Comprensión de los parámetros de entrada
La API requiere parámetros específicos para cifrar el PDF y asignar permisos. A continuación se detallan los parámetros obligatorios y opcionales:
Parámetros obligatorios
| Nombre | Tipo de datos | Descripción |
|---|---|---|
pdf_file | application/pdf | El archivo PDF que desea cifrar. |
allow_extracting_content | booleano | Indique si se permite la extracción de contenido. |
allow_form_filling | booleano | Indique si está permitido rellenar formularios. |
allow_annotations | booleano | Indique si se permiten anotaciones. |
allow_printing | booleano | Indique si se permite la impresión. |
allow_modifications | booleano | Indique si se permiten modificaciones. |
new_owner_password | cadena | La nueva contraseña del propietario del PDF, que otorga acceso completo y la capacidad de cambiar permisos. |
Parámetros opcionales
| Nombre | Tipo de datos | Descripción |
|---|---|---|
user_password | cadena | La contraseña de usuario actual, necesaria si el PDF tiene una contraseña de usuario para otorgar acceso de lectura. |
owner_password | cadena | La contraseña del propietario actual, necesaria si el PDF tiene una contraseña de propietario para otorgar acceso completo. |
new_user_password | cadena | La nueva contraseña de usuario para acceso de lectura. |
save_as_pdfa | booleano | Guarde el PDF como compatible con PDF/A-3. |
save_as_pdfua | booleano | Guarde el PDF como compatible con PDF/UA. |
author | cadena | Establezca la propiedad Autor de metadatos PDF. |
title | cadena | Establezca la propiedad Título de metadatos PDF. |
subject | cadena | Establezca la propiedad Asunto de los metadatos PDF. |
Integración de API: ejemplo de Python
Una vez que esté familiarizado con los parámetros de entrada, puede llamar a la API usando Python o cualquier otro lenguaje preferido. A continuación presentamos un ejemplo de cómo integrar esta API utilizando Python.
import requests
# Endpoint URL
url = 'http://localhost:8080/v1/document-services/pdfs/encrypt'
# Headers with metadata information
headers = {
'accept': '*/*',
'author': 'Iron Software',
'title': 'ENCRYPTION DEMO 2024',
'subject': 'DEMO EXAMPLE'
}
# Files to be sent in the request
files = {
'pdf_file': ('sample.pdf', open('sample.pdf', 'rb'), 'application/pdf')
}
# Parameters for encryption and permissions
data = {
'allow_extracting_content': 'true',
'allow_form_filling': 'true',
'allow_annotations': 'false',
'allow_printing': 'false',
'allow_modifications': 'true',
'new_owner_password': 'password',
'new_user_password': 'password',
'save_as_pdfa': 'false',
'save_as_pdfua': 'false'
}
# Send POST request with parameters
response = requests.post(url, headers=headers, files=files, data=data)
# Save the encrypted PDF to file system
with open('sample_encrypted.pdf', 'wb') as f:
f.write(response.content)
print('PDF encrypted successfully.')
Pasos explicados:
- Cargar el PDF: El archivo PDF a cifrar se carga desde el sistema de archivos local.
- Establecer Parámetros de Cifrado: Defina permisos como permitir la impresión, el llenado de formularios y la extracción de contenido, así como establecer nuevas contraseñas.
- Llamar a la API: Se llama a la API [POST] Cifrar/Agregar Contraseña y Permisos, pasando los parámetros necesarios.
- Guardar el Resultado: El PDF cifrado se guarda como un nuevo archivo.
El archivo PDF se cifra como se muestra a continuación. Ingrese 'password' para ver el contenido del PDF.
Preguntas frecuentes
¿Cómo puedo cifrar un archivo PDF usando IronSecureDoc?
Puede cifrar un archivo PDF utilizando IronSecureDoc utilizando la API [POST] Encrypt/Add Password & Permissions. Esto le permite establecer contraseñas de usuario y propietario y configurar permisos específicos para el documento PDF.
¿Qué permisos se pueden configurar con la API de IronSecureDoc?
La API de IronSecureDoc permite configurar permisos para impresión, relleno de formularios, anotaciones, extracción de contenido y modificaciones para asegurar el nivel de acceso y seguridad deseados para sus documentos PDF.
¿Es posible probar la API de IronSecureDoc sin escribir código?
Sí, puede probar la API de IronSecureDoc de manera interactiva usando Swagger, que proporciona una interfaz fácil de usar para enviar y recibir solicitudes y respuestas, ofreciendo una experiencia de prueba sin código.
¿Cómo despliego IronSecureDoc en una plataforma en la nube?
IronSecureDoc se puede desplegar en plataformas en la nube como Azure y AWS. Las instrucciones para desplegar IronSecureDoc en estos entornos están disponibles en el sitio web de Iron Software.
¿Cuál es el papel de la imagen de Docker al usar IronSecureDoc?
La imagen de Docker de IronSecureDoc es necesaria para ejecutar el servicio API. Puede descargar e iniciar la imagen de Docker para hospedar IronSecureDoc localmente o en entornos en la nube.
¿Puedo usar IronSecureDoc para crear archivos compatibles con PDF/A o PDF/UA?
Sí, IronSecureDoc ofrece parámetros opcionales para guardar archivos PDF como compatibles con PDF/A-3 o PDF/UA, asegurando la adherencia a estándares específicos y accesibilidad.
¿Por qué es importante usar contraseñas de propietario y usuario en el cifrado de PDF?
Las contraseñas de propietario y usuario en el cifrado de PDF son cruciales para controlar los niveles de acceso. Las contraseñas de propietario otorgan acceso completo al documento, mientras que las contraseñas de usuario proporcionan un acceso más limitado, protegiendo la información sensible.
¿Qué lenguajes de programación pueden integrarse con la API de IronSecureDoc?
La API de IronSecureDoc se puede integrar con múltiples lenguajes de programación como Python, C# y Java, entre otros, permitiendo flexibilidad para los desarrolladores que trabajan en diversos entornos.
¿Cuáles son los parámetros requeridos para cifrar un PDF con IronSecureDoc?
Los parámetros requeridos incluyen el propio archivo PDF y varias configuraciones de permisos, como permitir la extracción de contenido, el relleno de formularios, las anotaciones, la impresión, las modificaciones y establecer la nueva contraseña de propietario.
¿Qué ventaja ofrece usar IronSecureDoc para la seguridad de PDF?
IronSecureDoc proporciona una solución confiable para la seguridad de PDF al permitir un completo manejo de cifrado y permisos, haciéndolo adecuado para proteger documentos legales, financieros o personales del acceso no autorizado.
Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.