Cómo cifrar/agregar contraseña y permisos a archivos PDF

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

por Mehr Muhammad Hamza

Asegurar archivos PDF con contraseñas y permisos específicos es vital para proteger documentos sensibles contra el acceso no autorizado y la manipulación. En[POST]La API de Encriptación/Agregar Contraseña y Permisos de IronSecure Doc ofrece una manera eficiente de cifrar archivos PDF con contraseñas de usuario y propietario, al mismo tiempo que configura permisos para impresión, relleno de formularios, anotaciones y más. Esta API garantiza que el PDF esté completamente protegido y el acceso esté controlado, lo que la hace ideal para documentos legales, financieros o personales.

Extraer y Iniciar IronSecureDoc

Si aún no tienes IronSecureDoc en funcionamiento, sigue los enlaces a continuación para configurarlo:

Acoger localmenteDespliegue en la nube

La API [POST] Cifrar/Añadir Contraseña y Permisos

En[POST]La API de Encriptación/Agregar Contraseña y Permisos permite añadir capas de seguridad a los documentos PDF encriptándolos con contraseñas y estableciendo permisos específicos para diversas operaciones. Ya sea otorgando acceso de lectura, permitiendo el llenado de formularios o deshabilitando la impresión, esta API le proporciona control sobre cómo se acceden y modifican sus archivos PDF.

Swagger

Swagger ofrece una interfaz fácil de usar para probar esta API de forma 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 redactar texto con Swagger

  1. Acceder a Swagger UI:

    Si su servidor API está ejecutándose localmente, puede acceder a Swagger navegando a http://localhost:8080/swagger/index.html en su navegador web.

    Documentación de Swagger

  2. Ubicar la API:

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

    Redactar texto

  3. Parámetros de entrada:

    Proporcione los parámetros requeridos para la API. Puede cargar un archivo PDF de muestra y especificar los permisos deseados.

  4. Subir archivo PDF:

    En el cuerpo de la solicitud, cargue un archivo PDF como pdf_file y defina los permisos necesarios, como permitir o restringir la impresión, el relleno de formularios y la extracción de contenido.

  5. Ejecutar la solicitud:

    Una vez que se establezcan todos los parámetros, haga clic en "Ejecutar" para enviar la solicitud. La respuesta devolverá el PDF encriptado con los ajustes de seguridad especificados.

  6. Verifique el PDF de salida:

    Escriba 'password' para ver el contenido del PDF.


Comprender los parámetros de entrada

La API requiere parámetros específicos para cifrar el PDF y asignar permisos. A continuación se presenta un desglose de los parámetros requeridos y opcionales:

Parámetros Requeridos

NombreTipo de datoDescripción
archivo_pdfaplicación/pdfEl archivo PDF que deseas cifrar.
permitir_extraer_contenidobooleanIndique si se permite la extracción de contenido.
permitir_rellenar_formulariosbooleanIndique si se permite el llenado de formularios.
permitir_anotacionesbooleanIndique si se permiten las anotaciones.
permitir_impresiónbooleanIndique si se permite la impresión.
permitir_modificacionesbooleanIndique si se permiten modificaciones.
nueva_contraseña_propietariocadenaLa nueva contraseña de propietario para el PDF, que otorga acceso completo y la capacidad de cambiar permisos.

Parámetros Opcionales

NombreTipo de datoDescripción
contraseña_de_usuariocadenaLa contraseña de usuario actual, requerida si el PDF tiene una contraseña de usuario para otorgar acceso de lectura.
contraseña_del_propietariocadenaLa contraseña del propietario actual, requerida si el PDF tiene una contraseña de propietario para otorgar acceso completo.
nueva_contraseña_de_usuarioLa nueva contraseña de usuario para acceso de lectura.
guardar_como_pdfabooleanGuarde el PDF cumpliendo con el estándar PDF/A-3.
save_as_pdfuabooleanGuardar el PDF como compatible con PDF/UA.
autorcadenaEstablecer la propiedad Autor en los metadatos del PDF.
títulocadenaEstablecer la propiedad del Título de metadatos del PDF.
asuntocadenaEstablecer la propiedad de asunto de los metadatos del PDF.

Integración de API: Ejemplo en Python

Una vez que esté familiarizado con los parámetros de entrada, puede llamar a la API utilizando Python o cualquier otro lenguaje de preferencia. A continuación se muestra un ejemplo de cómo integrar esta API utilizando Python.

import requests

url = 'http://localhost:8080/v1/document-services/pdfs/encrypt'
headers = {
    'accept': '*/*',
    'author': 'IronSoftware',
    'title': 'ENCRYPTION DEMO 2024',
    'subject': 'DEMO EXAMPLE'
}

files = {
    'pdf_file': ('sample.pdf', open('sample.pdf', 'rb'), 'application/pdf')
}

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'
}

response = requests.post(url, headers=headers, files=files, data=data)

# Save the encrypted PDF
with open('sample.pdf', 'wb') as f:
    f.write(response.content)

print('PDF encrypted successfully.')
PYTHON

Pasos Explicados:

  • Cargar el PDF: El archivo PDF a cifrar se carga desde el sistema de archivos local.
  • Establecer parámetros de encriptación: Define permisos como permitir la impresión, el llenado de formularios y la extracción de contenido, así como configurar nuevas contraseñas.
  • Llamar a la API: El [POST]La API Encrypt/Add Password & Permissions se llama pasando los parámetros necesarios.
  • Guardar el Resultado: El PDF encriptado se guarda como un nuevo archivo.

    El archivo PDF está encriptado como se muestra a continuación. Escriba 'password' para ver el contenido del PDF.