Cómo cifrar, añadir contraseñas y permisos a archivos PDF en C

This article was translated from English: Does it need improvement?
Translated
View the article in English

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.

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

  1. 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.

Documentación de Swagger

  1. Localizar la API:

Encuentra el API [POST] /v1/document-services/pdfs/encrypt, que corresponde a Encriptar/Agregar Contraseña y Permisos.

Redactar texto

  1. Ingresar parámetros:

Proporciona los parámetros necesarios para la API. Puedes cargar un archivo PDF de muestra y especificar los permisos deseados.

  1. Subir archivo PDF:

En el cuerpo de la solicitud, sube un archivo PDF como archivo pdf y define los permisos necesarios, como permitir o recadenair la impresión, el llenado de formularios y la extracción de contenido.

  1. 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.

  1. 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
archivo pdf solicitud/pdf El archivo PDF que desea cifrar.
permitir_extraer_contenido booleano Indique si se permite la extracción de contenido.
permitir_rellenar_formularios booleano Indique si está permitido rellenar formularios.
permitir_anotaciones booleano Indique si se permiten anotaciones.
permitir_impresión booleano Indique si se permite la impresión.
permitir_modificaciones booleano Indique si se permiten modificaciones.
nueva_contraseña_de_propietario 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
contraseña de usuario cadena La contraseña de usuario actual, necesaria si el PDF tiene una contraseña de usuario para otorgar acceso de lectura.
contraseña del propietario cadena La contraseña del propietario actual, necesaria si el PDF tiene una contraseña de propietario para otorgar acceso completo.
nueva_contraseña_de_usuario cadena La nueva contraseña de usuario para acceso de lectura.
guardar como pdfa booleano Guarde el PDF como compatible con PDF/A-3.
guardar_como_pdfua booleano Guarde el PDF como compatible con PDF/UA.
autor cadena Establezca la propiedad Autor de metadatos PDF.
título cadena Establezca la propiedad Título de metadatos PDF.
sujeto 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': '*/*',
    'autor': 'Iron Software',
    'título': 'ENCRYPTION DEMO 2024',
    'sujeto': 'DEMO EXAMPLE'
}

# Files to be sent in the request
files = {
    'archivo pdf': ('sample.pdf', open('sample.pdf', 'rb'), 'solicitud/pdf')
}

# Parameters for encryption and permissions
data = {
    'permitir_extraer_contenido': 'true',
    'permitir_rellenar_formularios': 'true',
    'permitir_anotaciones': 'false',
    'permitir_impresión': 'false',
    'permitir_modificaciones': 'true',
    'nueva_contraseña_de_propietario': 'password',
    'nueva_contraseña_de_usuario': 'password',
    'guardar como pdfa': 'false',
    'guardar_como_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': '*/*',
    'autor': 'Iron Software',
    'título': 'ENCRYPTION DEMO 2024',
    'sujeto': 'DEMO EXAMPLE'
}

# Files to be sent in the request
files = {
    'archivo pdf': ('sample.pdf', open('sample.pdf', 'rb'), 'solicitud/pdf')
}

# Parameters for encryption and permissions
data = {
    'permitir_extraer_contenido': 'true',
    'permitir_rellenar_formularios': 'true',
    'permitir_anotaciones': 'false',
    'permitir_impresión': 'false',
    'permitir_modificaciones': 'true',
    'nueva_contraseña_de_propietario': 'password',
    'nueva_contraseña_de_usuario': 'password',
    'guardar como pdfa': 'false',
    'guardar_como_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.')
PYTHON

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 encriptado se guarda como un nuevo archivo.

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.

Curtis Chau
Escritor Técnico

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 ...

Leer más
¿Listo para empezar?
Version: 2024.10 recién lanzado