Comment chiffrer/ajouter un mot de passe et des autorisations aux fichiers PDF en C#
La sécurisation des fichiers PDF par des mots de passe et des autorisations spécifiques est essentielle pour protéger les documents sensibles contre tout accès et manipulation non autorisés. L'API [POST] Encrypt/Add Password & Permissions d'IronSecure Doc offre un moyen efficace de chiffrer les fichiers PDF avec des mots de passe utilisateur et propriétaire tout en configurant les autorisations d'impression, de remplissage de formulaires, d'annotations, etc. Cette API garantit une protection complète du PDF et un contrôle d'accès, ce qui la rend idéale pour les documents juridiques, financiers ou personnels.
Comment chiffrer/ajouter un mot de passe et des autorisations aux fichiers PDF
- Téléchargez et démarrez l'image Docker IronSecureDoc
- Testez l'API en utilisant Swagger
- Spécifiez les paramètres du mot de passe et des autorisations.
- Exécutez l'appel API pour appliquer les modifications
- Exportez le document PDF chiffré
Téléchargez et démarrez IronSecureDoc
Si IronSecureDoc n'est pas encore installé, veuillez suivre les liens ci-dessous pour le configurer :
| Hébergez localement | Déploiement sur le cloud |
|---|---|
API [POST] de chiffrement/ajout de mot de passe et d'autorisations
L'API [POST] Encrypt/Add Password & 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 autorisations spécifiques pour diverses opérations. Que ce soit accorder un accès en lecture, permettre 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 accessibles 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 outil formidable pour les développeurs.
Étapes pour masquer du texte avec Swagger
- Accédez à l'interface utilisateur Swagger :
Si votre serveur d'API fonctionne localement, vous pouvez accéder à Swagger en naviguant vers http://localhost:8080/swagger/index.html dans votre navigateur web.

- Localisez 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éverser un fichier PDF d'exemple et spécifier les autorisations souhaitées.
- Téléverser le fichier PDF :
Dans le corps de la requête, téléversez un fichier PDF en tant que pdf_file et définissez les autorisations nécessaires, telles que l'autorisation ou la restriction de l'impression, le remplissage de formulaire et l'extraction de contenu.
- Exécuter la requête :
Une fois tous les paramètres définis, cliquez sur « Execute » pour envoyer la requête. La réponse renverra le PDF chiffré avec les paramètres de sécurité spécifiés.
- Vérifiez le PDF de sortie :
Saisissez « password » pour afficher le contenu du PDF.
Comprendre les paramètres d'entrée
L'API requiert des paramètres spécifiques pour chiffrer le PDF et attribuer des autorisations. Vous trouverez ci-dessous le détail des paramètres obligatoires et facultatifs :
Paramètres requis
| Nom | Type de données | Description |
|---|---|---|
pdf_file | application/pdf | Le fichier PDF que vous souhaitez chiffrer. |
allow_extracting_content | booléen | Indiquez si l'extraction de contenu est autorisée. |
allow_form_filling | booléen | Indiquez si le remplissage de formulaires est autorisé. |
allow_annotations | booléen | Indiquez si les annotations sont autorisées. |
allow_printing | booléen | Indiquez si l'impression est autorisée. |
allow_modifications | booléen | Indiquez si les modifications sont autorisées. |
new_owner_password | chaîne de caractères | Le nouveau mot de passe du propriétaire du fichier PDF, qui accorde un accès complet et la possibilité de modifier les autorisations. |
Paramètres optionnels
| Nom | Type de données | Description |
|---|---|---|
user_password | chaîne de caractères | Le mot de passe utilisateur actuel, requis si le fichier PDF possède un mot de passe utilisateur pour autoriser l'accès en lecture. |
owner_password | chaîne de caractères | Le mot de passe propriétaire actuel, requis si le fichier PDF possède un mot de passe de propriétaire pour accorder un accès complet. |
new_user_password | chaîne de caractères | Le nouveau mot de passe utilisateur pour l'accès en lecture. |
save_as_pdfa | booléen | Enregistrez le PDF conformément à la norme PDF/A-3. |
save_as_pdfua | booléen | Enregistrez le PDF conformément à la norme PDF/UA. |
author | chaîne de caractères | Définissez la propriété Auteur des métadonnées PDF. |
title | chaîne de caractères | Définissez la propriété Titre des métadonnées PDF. |
subject | chaîne de caractères | Définissez la propriété Sujet des métadonnées PDF. |
Intégration API : exemple Python
Une fois que vous vous serez familiarisé avec les paramètres d'entrée, vous pourrez appeler l'API en utilisant Python ou tout autre langage de votre choix. Vous trouverez ci-dessous un exemple d'intégration de cette API en utilisant Python.
import requests
# Endpoint URL
url = 'http://localhost:8080/v1/document-services/pdfs/encrypt'
# Headers with metadata information
headers = {
'accept': '*/*',
'author': 'Iron Software',
'title': 'ENCRYPTION DEMO 2024',
'subject': 'DEMO EXAMPLE'
}
# Files to be sent in the request
files = {
'pdf_file': ('sample.pdf', open('sample.pdf', 'rb'), 'application/pdf')
}
# Parameters for encryption and permissions
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'
}
# Send POST request with parameters
response = requests.post(url, headers=headers, files=files, data=data)
# Save the encrypted PDF to file system
with open('sample_encrypted.pdf', 'wb') as f:
f.write(response.content)
print('PDF encrypted successfully.')
Étapes expliquées :
- Charger le PDF : Le fichier PDF à chiffrer est chargé à partir du système de fichiers local.
- Définir les paramètres de chiffrement : Définir les autorisations comme autoriser l'impression, le remplissage de formulaire, et l'extraction de contenu, ainsi que la définition de nouveaux mots de passe.
- Appeler l'API : L'API [POST] Chiffrer/Ajouter un mot de passe et des autorisations est appelée, en passant les paramètres nécessaires.
- Enregistrer le résultat : Le PDF chiffré est enregistré comme un nouveau fichier.
Le fichier PDF est chiffré comme indiqué ci-dessous. Saisissez « password » pour afficher le contenu du PDF.
Questions fréquemment posées
Comment puis-je crypter un fichier PDF en utilisant IronSecureDoc?
Vous pouvez crypter un fichier PDF en utilisant IronSecureDoc en utilisant l'API [POST] Encrypt/Add Password & Permissions. Cela vous permet de définir des mots de passe utilisateur et propriétaire et de configurer des autorisations spécifiques pour le document PDF.
Quelles autorisations peuvent être configurées avec l'API IronSecureDoc?
L'API IronSecureDoc vous permet de configurer des autorisations pour l'impression, le remplissage de formulaires, les annotations, l'extraction de contenu et les modifications afin d'assurer le niveau d'accès et de sécurité souhaité pour vos documents PDF.
Est-il possible de tester l'API IronSecureDoc sans écrire de code?
Oui, vous pouvez tester l'API IronSecureDoc de manière interactive en utilisant Swagger, qui offre une interface conviviale pour envoyer et recevoir des requêtes et des réponses, offrant une expérience de test sans code.
Comment déployer IronSecureDoc sur une plateforme cloud?
IronSecureDoc peut être déployé sur des plateformes cloud telles qu'Azure et AWS. Les instructions pour déployer IronSecureDoc dans ces environnements sont disponibles sur le site web de Iron Software.
Quel est le rôle de l'image Docker dans l'utilisation d'IronSecureDoc?
L'image Docker d'IronSecureDoc est requise pour exécuter le service API. Vous pouvez tirer et démarrer l'image Docker pour héberger IronSecureDoc localement ou dans des environnements cloud.
Puis-je utiliser IronSecureDoc pour créer des fichiers conformes PDF/A ou PDF/UA?
Oui, IronSecureDoc offre des paramètres optionnels pour enregistrer des fichiers PDFs conformes à PDF/A-3 ou PDF/UA, assurant l'adhérence à des normes spécifiques et l'accessibilité.
Pourquoi est-il important d'utiliser des mots de passe propriétaire et utilisateur dans le cryptage PDF?
Les mots de passe propriétaire et utilisateur dans le cryptage PDF sont cruciaux pour contrôler les niveaux d'accès. Les mots de passe propriétaire donnent un accès complet au document, tandis que les mots de passe utilisateur permettent un accès plus limité, protégeant les informations sensibles.
Quels langages de programmation peuvent s'intégrer avec l'API IronSecureDoc?
L'API IronSecureDoc peut être intégrée avec plusieurs langages de programmation tels que Python, C# et Java, entre autres, permettant une flexibilité pour les développeurs travaillant dans divers environnements.
Quels sont les paramètres requis pour crypter un PDF avec IronSecureDoc?
Les paramètres requis incluent le fichier PDF lui-même et plusieurs paramètres d'autorisations telles que l'autorisation d'extraction de contenu, le remplissage de formulaires, les annotations, l'impression, les modifications et la définition du nouveau mot de passe propriétaire.
Quel avantage offre l'utilisation d'IronSecureDoc pour la sécurité des PDFs?
IronSecureDoc fournit une solution fiable pour la sécurité des PDFs en permettant un cryptage complet et une gestion des autorisations, ce qui le rend adapté pour protéger les documents juridiques, financiers ou personnels contre les accès non autorisés.
Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.