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. La API [POST] Encrypt/Add Password & Permissions de IronSecure Doc proporciona una manera eficiente de encriptar archivos PDF con contraseñas de usuario y propietario a la vez que configura permisos para impresión, llenado 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.
How to Encrypt/Add Password & Permissions to PDF Files
- Extraer y comenzar la Imagen 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:
| Alojar localmente | Desplegar en la nube |
|---|---|
La API [POST] Cifrar/Añadir Contraseña y Permisos
La API [POST] Encrypt/Add Password & Permissions permite agregar capas de seguridad a los documentos PDF al encriptarlos con contraseñas y establecer 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 la interfaz de Swagger:
Si su servidor API está ejecutándose localmente, puede acceder a Swagger navegando a http://localhost:8080/swagger/index.html en su navegador web.
Localizar la API:
Encuentra la API [POST] /v1/document-services/pdfs/encrypt, que corresponde a Cifrar/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.
Cargar 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.
Compruebe 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
Parámetros opcionales
| Name | Data Type | Description |
|---|---|---|
| user_password | string | The current user password, required if the PDF has a user password to grant read access. |
| owner_password | string | The current owner password, required if the PDF has an owner password to grant full access. |
| new_user_password | The new user password for read access. | |
| save_as_pdfa | boolean | Save the PDF as PDF/A-3 compliant. |
| save_as_pdfua | boolean | Save the PDF as PDF/UA compliant. |
| author | string | Set the PDF metadata Author property. |
| title | string | Set the PDF metadata Title property. |
| subject | string | Set the PDF metadata Subject property. |
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 que se va a encriptar 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 de [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 está encriptado como se muestra a continuación. Escriba 'password' para ver el contenido del PDF.
