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. Les[POST]L'API Encrypt/Add Password & Permissions d'IronSecure Doc offre un moyen efficace de chiffrer des fichiers PDF avec des mots de passe utilisateur et propriétaire tout en configurant les 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.
Comment crypter/ajouter un mot de passe et des autorisations aux fichiers PDF
- Extraire et démarrer l'image Docker IronSecureDoc
- Testez l'API en utilisant 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 :
Accueillir localement | Déploiement dans le nuage |
---|---|
L'API [POST] Chiffrer/Ajouter un mot de passe et des autorisations
Les[POST]L'API de chiffrement/ajout de mot de passe et de permissions vous permet d'ajouter des couches de sécurité aux documents PDF en les chiffrant avec des mots de passe et en définissant des permissions 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 UI :
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 :
Trouver le[POST]API /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 requête :
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 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
Nom | Type de données | Description |
---|---|---|
pdf_file | application/pdf | Le fichier PDF que vous souhaitez crypter. |
autoriser_extraire_contenu | booléen | Indiquez si l'extraction de contenu est autorisée. |
autoriser_le_remplissage_de_formulaires | booléen | Indiquez si le remplissage de formulaire est autorisé. |
autoriser_les_annotations | booléen | Indiquez si les annotations sont autorisées. |
autoriser_impression | booléen | Indiquez si l'impression est autorisée. |
autoriser_modifications | booléen | Indiquez si des modifications sont autorisées. |
nouveau_mot_de_passe_propriétaire | chaîne de caractères | Le nouveau mot de passe propriétaire pour le PDF, qui accorde un accès complet et la capacité de modifier les autorisations. |
Paramètres optionnels
Nom | Type de données | Description |
---|---|---|
mot_de_passe_utilisateur | chaîne de caractères | Le mot de passe utilisateur actuel, requis si le PDF dispose d'un mot de passe utilisateur pour accorder l'accès en lecture. |
owner_password | chaîne de caractères | Le mot de passe propriétaire actuel, requis si le PDF possède un mot de passe propriétaire pour accorder un accès complet. |
nouveau_mot_de_passe_utilisateur | Le nouveau mot de passe utilisateur pour l'accès en lecture. | |
enregistrer_comme_pdfa | booléen | Enregistrer le PDF comme conforme à la norme PDF/A-3. |
sauvegarder_comme_pdfua | booléen | Enregistrez le PDF en tant que conforme à la norme PDF/UA. |
auteur | chaîne de caractères | Définir la propriété Auteur des métadonnées PDF. |
titre | chaîne de caractères | Définissez la propriété Titre des métadonnées PDF. |
sujet | chaîne de caractères | Définir la propriété Sujet des métadonnées du PDF. |
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 à crypter 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'impression, de remplissage de formulaires et d'extraction de contenu, ainsi que la définition de nouveaux mots de passe.
- Appeler l'API : Le [POST]L'API Encrypt/Add Password & Permissions est appelée, en transmettant les paramètres nécessaires.
Enregistrez le Résultat : Le PDF crypté est enregistré en tant que nouveau fichier.
Le fichier PDF est chiffré comme indiqué ci-dessous. Tapez 'password' pour afficher le contenu du PDF.