Comment crypter/ajouter un mot de passe et des autorisations aux fichiers PDF

Chaknith Bin
Chaknith Bin
octobre 20, 2024
Mise à jour décembre 17, 2024
Partager:
This article was translated from English: Does it need improvement?
Translated
View the article in English

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.

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 LocallyDeploy 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

  1. 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.

    Documents Swagger

  2. Localiser l'API :

    Trouvez l'API [POST] /v1/document-services/pdfs/encrypt, qui correspond à Chiffrer/Ajouter un mot de passe et des autorisations.

    Rédiger le texte

  3. 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.

  4. 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.

  5. 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.

  6. 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

NameData TypeDescription
pdf_fileapplication/pdfThe PDF file you want to encrypt.
allow_extracting_contentbooleanIndicate whether content extraction is allowed.
allow_form_fillingbooleanIndicate whether form filling is allowed.
allow_annotationsbooleanIndicate whether annotations are allowed.
allow_printingbooleanIndicate whether printing is allowed.
allow_modificationsbooleanIndicate whether modifications are allowed.
new_owner_passwordstringThe new owner password for the PDF, which grants full access and the ability to change permissions.

Paramètres optionnels

NameData TypeDescription
user_passwordstringThe current user password, required if the PDF has a user password to grant read access.
owner_passwordstringThe current owner password, required if the PDF has an owner password to grant full access.
new_user_passwordThe new user password for read access.
save_as_pdfabooleanSave the PDF as PDF/A-3 compliant.
save_as_pdfuabooleanSave the PDF as PDF/UA compliant.
authorstringSet the PDF metadata Author property.
titlestringSet the PDF metadata Title property.
subjectstringSet 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.')
PYTHON

É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.

Chaknith Bin
Ingénieur logiciel
Chaknith travaille sur IronXL et IronBarcode. Il possède une expertise approfondie en C# et .NET, aidant à améliorer le logiciel et à soutenir les clients. Ses idées issues des interactions avec les utilisateurs contribuent à de meilleurs produits, une documentation améliorée et une expérience globale enrichie.