Cómo cifrar/agregar contraseña y permisos a archivos PDF
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.
Cómo cifrar/agregar contraseña y permisos a archivos PDF
- Extraer y iniciar la imagen de Docker de IronSecureDoc
- Prueba la API usando Swagger
- Especifique el parámetro para la contraseña y los permisos
- Ejecute la llamada de API para aplicar los cambios.
- Exporte el documento PDF cifrado
Extraer y Iniciar IronSecureDoc
Si aún no tienes IronSecureDoc en funcionamiento, sigue los enlaces a continuación para configurarlo:
Acoger localmente | Despliegue 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
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.
Ubicar la API:
Buscar el[POST]/v1/document-services/pdfs/encrypt API, que corresponde a Encriptar/Agregar Contraseña y Permisos.
Parámetros de entrada:
Proporcione los parámetros requeridos para la API. Puede 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 pdf_file y defina los permisos necesarios, como permitir o restringir la impresión, el relleno de formularios y la extracción de contenido.
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.
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
Nombre | Tipo de dato | Descripción |
---|---|---|
archivo_pdf | aplicación/pdf | El archivo PDF que deseas cifrar. |
permitir_extraer_contenido | boolean | Indique si se permite la extracción de contenido. |
permitir_rellenar_formularios | boolean | Indique si se permite el llenado de formularios. |
permitir_anotaciones | boolean | Indique si se permiten las anotaciones. |
permitir_impresión | boolean | Indique si se permite la impresión. |
permitir_modificaciones | boolean | Indique si se permiten modificaciones. |
nueva_contraseña_propietario | cadena | La nueva contraseña de propietario para el PDF, que otorga acceso completo y la capacidad de cambiar permisos. |
Parámetros Opcionales
Nombre | Tipo de dato | Descripción |
---|---|---|
contraseña_de_usuario | cadena | La contraseña de usuario actual, requerida 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, requerida si el PDF tiene una contraseña de propietario para otorgar acceso completo. |
nueva_contraseña_de_usuario | La nueva contraseña de usuario para acceso de lectura. | |
guardar_como_pdfa | boolean | Guarde el PDF cumpliendo con el estándar PDF/A-3. |
save_as_pdfua | boolean | Guardar el PDF como compatible con PDF/UA. |
autor | cadena | Establecer la propiedad Autor en los metadatos del PDF. |
título | cadena | Establecer la propiedad del Título de metadatos del PDF. |
asunto | cadena | Establecer 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.')
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.