Comment rédiger des régions dans les fichiers PDF
La rédaction d'informations sensibles dans les documents PDF est cruciale pour garantir la confidentialité et la conformité avec les règlements de protection des données. L'API [POST] Redact Region de IronSecure Doc offre un moyen efficace de masquer du texte et des informations sensibles dans des régions spécifiques d'un document PDF en utilisant une véritable expurgation. Cette API garantit que les données expurgées sont complètement supprimées et ne peuvent pas être récupérées, ce qui la rend idéale pour gérer des informations confidentielles dans des documents juridiques, financiers ou personnels.
Comment rédiger des régions dans les fichiers PDF
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] Redact Region
L'endpoint API [POST] Redact Region vous permet de masquer les informations sensibles dans des régions spécifiques d'un document PDF en utilisant une véritable rédaction. Cette fonctionnalité est cruciale pour les applications qui gèrent des documents confidentiels, tels que des contrats juridiques, des dossiers médicaux ou des états financiers. En exploitant cette API, vous pouvez vous assurer que le texte sensible dans les zones définies d'un PDF est supprimé de manière permanente, offrant ainsi sécurité et conformité.
A noter
Essayer dans Swagger
Swagger est un outil puissant qui permet aux développeurs d'interagir avec des API RESTful via une interface web conviviale. Que vous utilisiez des langages comme Python, Java ou d'autres, Swagger offre un moyen pratique de tester et d'implémenter cette API.
Étapes pour rédiger une région 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 Redact Region [POST] :
Dans l'interface Swagger UI, trouvez le point de terminaison [POST] /v1/document-services/pdfs/redact-region.
Spécifiez les coordonnées de la rédaction :
Dans cet exemple, nous allons supprimer un tableau du PDF à l'indice de page 1 (c'est-à-dire, Page n°2). Utilisez les coordonnées suivantes pour définir la région de rédaction :
- Index de la page (pages_spécifiques) : 1
- Coordonnée X (region_to_redact_x) : 60
- Coordonnée Y (region_to_redact_y) : 270
- Largeur (region_to_redact_w) : 470
- Hauteur (region_to_redact_h) : 200
Définir les paramètres optionnels :
Optionnellement, vous pouvez ajouter un mot de passe utilisateur ou propriétaire, spécifier des pages particulières, ou décider d'ajouter une boîte noire sur la zone caviardée et enregistrer le document en conformité avec PDF/A ou PDF/UA.
Téléchargez un exemple de PDF :
Dans le corps de la requête, téléchargez un fichier PDF d'exemple sur lequel vous souhaitez appliquer la caviardage. Assurez-vous que le fichier est ajouté en tant que pdf_file.
Exécuter la demande :
Cliquez sur "Exécuter" pour lancer la requête. La réponse inclura le PDF expurgé, avec le tableau supprimé de l'index de page 1 comme spécifié.
Cette interaction avec Swagger UI vous permet de tester facilement le processus de rédaction, fournissant un retour immédiat sur la manière dont les coordonnées affectent le contenu du PDF.
Vérifiez le fichier PDF de sortie :
La région expurgée sera à la page 2.
Comprendre les paramètres d'entrée
Avant d'utiliser cette API, il est essentiel de comprendre les paramètres d'entrée requis et optionnels pour masquer une région dans votre PDF. Ces paramètres aident à définir la zone spécifique à masquer.
Paramètres clés
- pdf_file : Le document PDF que vous souhaitez rédiger.
- region_to_redact_x : Coordonnée X de la région à masquer (en partant du coin inférieur gauche de la page).
- region_to_redact_y : Coordonnée Y de la région à rediger (en partant du bas-gauche de la page).
- region_to_redact_w : Largeur de la zone à masquer.
- region_to_redact_h : Hauteur de la région à masquer.
Paramètres optionnels
- user_password : Si le PDF est protégé par mot de passe, fournissez le mot de passe utilisateur.
- owner_password : Fournissez le mot de passe propriétaire si des modifications sont restreintes.
- pages_spécifiques : Spécifiez quelles pages censurer. Si non fourni, la rédaction s'applique à toutes les pages.
- save_as_pdfa : Enregistrer le PDF avec la conformité PDF/A-3.
- save_as_pdfua : Enregistrer le PDF avec la conformité PDF/UA.
Intégration de l'API : Exemple Python
Une fois que vous êtes familier avec les paramètres, vous pouvez appeler cette API en utilisant le langage de programmation 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/redact-region'
headers = {
'accept': '*/*',
'author': 'IronSoftware',
'title': 'REDACT REGION DEMO 2024',
'subject': 'DEMO EXAMPLE'
}
# Open the file
files = {
'pdf_file': ('sample_file.pdf', open('sample_file.pdf', 'rb'), 'application/pdf')
}
# Prepare the argument
data = {
'region_to_redact_x': '60',
'region_to_redact_y': '270',
'region_to_redact_w': '470',
'region_to_redact_h': '200',
'specific_pages':[1]
}
# Call the API
response = requests.post(url, headers=headers, files=files, data=data)
# Save the redacted PDF
with open('redacted_output.pdf', 'wb') as f:
f.write(response.content)
print('PDF redacted successfully.')Ce code effectue les étapes suivantes :
- Charger le PDF : Le fichier PDF à censurer est chargé depuis le système de fichiers local.
- Définir les paramètres de caviardage : Spécifiez les coordonnées (X, Y), la largeur, la hauteur et la page spécifique à caviarder.
- Appeler l'API : L'API [POST] Redact Region est appelée, en passant les paramètres nécessaires.
Enregistrer le résultat : Le PDF caviardé est enregistré en tant que nouveau fichier.
La région donnée est expurgée comme indiqué ci-dessous.
