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

This article was translated from English: Does it need improvement?
Translated
View the article in English

par Mehr Muhammad Hamza

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.

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 localementDé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

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

    Documentation Swagger

  2. Localiser l'API :

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

    Réviser 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 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.

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

NomType de donnéesDescription
pdf_fileapplication/pdfLe fichier PDF que vous souhaitez crypter.
autoriser_extraire_contenubooléenIndiquez si l'extraction de contenu est autorisée.
autoriser_le_remplissage_de_formulairesbooléenIndiquez si le remplissage de formulaire est autorisé.
autoriser_les_annotationsbooléenIndiquez si les annotations sont autorisées.
autoriser_impressionbooléenIndiquez si l'impression est autorisée.
autoriser_modificationsbooléenIndiquez si des modifications sont autorisées.
nouveau_mot_de_passe_propriétairechaîne de caractèresLe 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

NomType de donnéesDescription
mot_de_passe_utilisateurchaîne de caractèresLe mot de passe utilisateur actuel, requis si le PDF dispose d'un mot de passe utilisateur pour accorder l'accès en lecture.
owner_passwordchaîne de caractèresLe 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_utilisateurLe nouveau mot de passe utilisateur pour l'accès en lecture.
enregistrer_comme_pdfabooléenEnregistrer le PDF comme conforme à la norme PDF/A-3.
sauvegarder_comme_pdfuabooléenEnregistrez le PDF en tant que conforme à la norme PDF/UA.
auteurchaîne de caractèresDéfinir la propriété Auteur des métadonnées PDF.
titrechaîne de caractèresDéfinissez la propriété Titre des métadonnées PDF.
sujetchaîne de caractèresDé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.')
PYTHON

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