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. Les[POST]L'API Redact Region d'IronSecureDoc 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 caviardise. 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 :
| Accueillir localement | Déploiement dans le nuage |
|---|---|
L'API [POST]Région de rédaction
Les[POST]Le point de terminaison de l'API 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 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 le[POST]API de redaction de région :**
Dans l'interface Swagger UI, trouvez le [POST]/v1/document-services/pdfs/redact-region endpoint.
Spécifiez les coordonnées de rédaction :
Dans cet exemple, nous allons supprimer un tableau du PDF à l'index de page 1.(c.-à-d., 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(région_à_rédiger_x): 60
- Coordonnée Y(région_à_omettre_y): 270
- Largeur(région_à_rédiger_w): 470
- Hauteur(region_to_redact_h): 200
Définir les paramètres facultatifs :
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 échantillon 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 requête :
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 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 commençant par le coin inférieur gauche de la page).
- region_to_redact_y : Coordonnée Y de la région à masquer(en commençant par le coin inférieur gauche de la page).
- region_to_redact_w : Largeur de la région à masquer.
- region_to_redact_h: Hauteur de la région à censurer.
Paramètres optionnels
- user_password : Si le PDF est protégé par un mot de passe, fournissez le mot de passe utilisateur.
- owner_password : Fournissez le mot de passe propriétaire si les modifications sont restreintes.
- specific_pages : 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 à expurger est chargé à partir du système de fichiers local.
- Définir les paramètres de rédaction : Préciser les coordonnées(X, Y), largeur, hauteur et page spécifique à censurer.
- Appeler l'API : Le[POST]L'API Redact Region est appelée, en passant les paramètres nécessaires.
Enregistrer le résultat : Le PDF caviardé est enregistré comme un nouveau fichier.
La région donnée est expurgée comme indiqué ci-dessous.
