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. El API [POST] Encrypt/Add Password & Permissions de IronSecure Doc proporciona una forma eficiente de encriptar archivos PDF con contraseñas de usuario y propietario mientras configura permisos para impresión, llenado de formularios, anotaciones y más. Este 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
- Extraiga e inicie la imagen Docker de IronSecureDoc
- Prueba la API usando Swagger
- Especifique los parámetros de contraseña y permisos
- Ejecuta la llamada a la API para aplicar los cambios
- Exporta el documento PDF cifrado
Tire y arranque IronSecureDoc
Si aún no tienes IronSecureDoc funcionando, sigue los enlaces a continuación para configurarlo:
| Alojar localmente | Implementar en la nube |
|---|---|
La API [POST] para cifrar/agregar contraseñas y permisos
El [POST] Encrypt/Add Password & Permissions API te permite agregar capas de seguridad a documentos PDF encriptá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 te da control sobre cómo se acceden y modifican tus archivos PDF.
Pavonearse
Swagger ofrece una interfaz fácil de usar para probar esta API de manera interactiva. Puedes 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 redactar texto con Swagger
- Acceder a la interfaz Swagger:
Si tu servidor API está corriendo localmente, puedes acceder a Swagger navegando a http://localhost:8080/swagger/index.html en tu navegador web.

- Localizar la API:
Encuentre la API [POST] /v1/document-services/pdfs/encrypt, que corresponde a Cifrar/Agregar contraseña y permisos.

- Ingresar parámetros:
Proporciona los parámetros necesarios para la API. Puedes cargar un archivo PDF de muestra y especificar los permisos deseados.
- Subir archivo PDF:
En el cuerpo de la solicitud, cargue un archivo PDF como archivo_pdf y defina los permisos necesarios, como permitir o recadenair la impresión, el rellenado de formularios y la extracción de contenido.
- Ejecutar la solicitud:
Una vez que todos los parámetros están configurados, haz clic en "Ejecutar" para enviar la solicitud. La respuesta devolverá el PDF encriptado con los ajustes de seguridad especificados.
- Verificar el PDF de salida:
Ingresa 'contraseña' para ver el contenido del PDF.
Comprensión de los parámetros de entrada
La API requiere parámetros específicos para encriptar 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` | solicitud/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és familiarizado con los parámetros de entrada, puedes 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'), 'solicitud/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.')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'), 'solicitud/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 encriptar se carga desde el sistema de archivos local.
- Configurar parámetros de encriptación: Definir 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] Encrypt/Add Password & Permissions, pasando los parámetros necesarios.
- Guardar el resultado: El PDF cifrado se guarda como un archivo nuevo.
El archivo PDF se encripta como se muestra a continuación. Ingresa 'contraseña' para ver el contenido del PDF.
Preguntas Frecuentes
¿Cómo cifro un archivo PDF para proteger información sensible?
Para cifrar un archivo PDF, puedes usar la API de IronSecureDoc, que te permite establecer contraseñas de usuario y propietario. Estas contraseñas ayudan a controlar el acceso y los permisos, como la impresión y el relleno de formularios, asegurando la seguridad del documento.
¿Qué pasos están involucrados al usar la API de IronSecureDoc para el cifrado de PDF?
Primero, descarga la imagen de Docker de IronSecureDoc y configúrala según tu entorno de hospedaje. Luego, usa la API para especificar parámetros de cifrado, como establecer contraseñas y permisos, y ejecuta la llamada a la API para generar un PDF seguro.
¿Cómo puedo probar la API de IronSecureDoc sin escribir código?
Puedes probar la API de IronSecureDoc usando Swagger. Accede a la UI de Swagger, encuentra el endpoint de la API relevante, introduce los parámetros necesarios y ejecuta la solicitud para ver la respuesta y asegurarte de que la API funciona correctamente.
¿Qué son las contraseñas de usuario y propietario en la seguridad de PDF?
En la seguridad de PDF, la contraseña de usuario permite leer el documento, mientras que la contraseña del propietario otorga acceso completo, incluyendo cambiar permisos. Con IronSecureDoc, puedes establecer ambos tipos de contraseñas para mejorar la seguridad del documento.
¿Puedo configurar un PDF para que cumpla con PDF/A usando IronSecureDoc?
Sí, la API de IronSecureDoc incluye parámetros que te permiten guardar el PDF cifrado como compatible con PDF/A-3, que es un estándar para la preservación a largo plazo de documentos electrónicos.
¿Qué permisos se pueden controlar con la API de IronSecureDoc?
Usando la API de IronSecureDoc, puedes controlar permisos como impresión, relleno de formularios, extracción de contenido, anotaciones y modificaciones, asegurando que los PDFs se usen de manera consistente con tus políticas de seguridad.
¿Cómo puedo integrar la API de IronSecureDoc con una aplicación Python?
Para integrar la API de IronSecureDoc con Python, utiliza la biblioteca requests para enviar una solicitud POST al endpoint de la API. Incluye los encabezados necesarios, parámetros y datos de archivo en tu solicitud para cifrar y gestionar tus archivos PDF.
¿Qué parámetros son esenciales para cifrar un PDF usando IronSecureDoc?
Los parámetros esenciales incluyen el archivo PDF a cifrar, contraseñas de usuario y propietario, y permisos para acciones como imprimir y editar. Estos parámetros aseguran la seguridad del documento y control sobre su uso.
¿Es posible modificar metadatos en un PDF durante el cifrado con IronSecureDoc?
Sí, puedes modificar metadatos de PDF como autor, título y tema usando los parámetros opcionales de la API de IronSecureDoc, lo que te permite personalizar la información del documento durante el proceso de cifrado.
¿Cuáles son los requisitos de hospedaje para ejecutar IronSecureDoc localmente?
IronSecureDoc se puede hospedar localmente en sistemas Windows, Mac o Linux. Sigue los tutoriales de configuración específicos para tu sistema operativo para asegurar la correcta instalación y operación del servicio.





