Comment crypter/ajouter un mot de passe et des autorisations aux fichiers PDF
Protéger les fichiers PDF avec des mots de passe et des autorisations spécifiques est essentiel pour protéger les documents sensibles contre tout accès non autorisé et manipulation. L'API [POST] Encrypt/Add Password & Permissions d'IronSecure Doc offre un moyen efficace d'encrypter des fichiers PDF avec des mots de passe utilisateur et propriétaire tout en configurant des autorisations pour l'impression, le remplissage de formulaires, les annotations, et plus encore. Cette API garantit que le PDF est entièrement protégé et que l'accès est contrôlé, ce qui la rend idéale pour les documents juridiques, financiers ou personnels.
How to Encrypt/Add Password & Permissions to PDF Files
- Extraire et démarrer l'image Docker IronSecureDoc
- Tester l'API avec Swagger
- Spécifiez le paramètre pour le mot de passe et les permissions.
- Exécuter l'appel API pour appliquer les modifications
- Exporter le document PDF chiffré
Extraire et démarrer IronSecureDoc
Si vous n'avez pas encore IronSecureDoc en cours d'exécution, veuillez suivre les liens ci-dessous pour l'installer :
Host Locally | Deploy to Cloud |
---|---|
L'API [POST] Chiffrer/Ajouter un mot de passe et des autorisations
L'API [POST] Encrypt/Add Password & Permissions vous permet d'ajouter des couches de sécurité aux documents PDF en les cryptant avec des mots de passe et en définissant des autorisations spécifiques pour diverses opérations. Que ce soit pour accorder l'accès en lecture, autoriser le remplissage de formulaires ou désactiver l'impression, cette API vous donne le contrôle sur la manière dont vos fichiers PDF sont consultés et modifiés.
Swagger
Swagger offre une interface conviviale pour tester cette API de manière interactive. Vous pouvez l'utiliser pour envoyer des requêtes de test et recevoir des réponses sans écrire de code, ce qui en fait un excellent outil pour les développeurs.
Étapes pour rédiger du texte avec Swagger
Accéder à l'interface Swagger :
Si votre serveur API fonctionne localement, vous pouvez accéder à Swagger en naviguant vers http://localhost:8080/swagger/index.html dans votre navigateur web.
Localiser l'API :
Trouvez l'API [POST] /v1/document-services/pdfs/encrypt, qui correspond à Chiffrer/Ajouter un mot de passe et des autorisations.
Paramètres d'entrée :
Fournissez les paramètres requis pour l'API. Vous pouvez télécharger un fichier PDF d'échantillon et spécifier les autorisations souhaitées.
Télécharger le fichier PDF :
Dans le corps de la requête, téléchargez un fichier PDF sous pdf_file et définissez les autorisations nécessaires, telles que l'autorisation ou la restriction de l'impression, du remplissage de formulaire et de l'extraction de contenu.
Exécuter la demande :
Une fois tous les paramètres définis, cliquez sur "Exécuter" pour envoyer la requête. La réponse retournera le PDF chiffré avec les paramètres de sécurité spécifiés.
Vérifiez le fichier PDF de sortie :
Tapez 'password' pour afficher le contenu du PDF.
Comprendre les paramètres d'entrée
L'API nécessite des paramètres spécifiques pour crypter le PDF et attribuer des autorisations. Voici une répartition des paramètres requis et optionnels :
Paramètres requis
Name | Data Type | Description |
---|---|---|
pdf_file | application/pdf | The PDF file you want to encrypt. |
allow_extracting_content | boolean | Indicate whether content extraction is allowed. |
allow_form_filling | boolean | Indicate whether form filling is allowed. |
allow_annotations | boolean | Indicate whether annotations are allowed. |
allow_printing | boolean | Indicate whether printing is allowed. |
allow_modifications | boolean | Indicate whether modifications are allowed. |
new_owner_password | string | The new owner password for the PDF, which grants full access and the ability to change permissions. |
Paramètres optionnels
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. |
Intégration de l'API : Exemple Python
Une fois que vous êtes familiarisé avec les paramètres d'entrée, vous pouvez appeler l'API en utilisant Python ou tout autre langage de votre choix. Voici un exemple d'intégration de cette API en utilisant 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.')
Étapes expliquées :
- Charger le PDF : Le fichier PDF à chiffrer est chargé depuis le système de fichiers local.
- Définir les paramètres de chiffrement : Définissez des autorisations telles que l'autorisation d'imprimer, de remplir des formulaires et d'extraire du contenu, ainsi que la définition de nouveaux mots de passe.
- Appeler l'API : L'API [POST] Encrypt/Add Password & Permissions est appelée en passant les paramètres nécessaires.
Enregistrez le résultat : Le PDF chiffré est enregistré en tant que nouveau fichier.
Le fichier PDF est chiffré comme indiqué ci-dessous. Tapez 'password' pour afficher le contenu du PDF.