Comment expurger du texte dans un PDF en C# avec IronSecureDoc

Curtis Chau
Curtis Chau
Mis à jour : 21 juillet 2026

Dans cet article, nous aborderons la rédaction de texte dans un PDF à l'aide d'IronSecureDoc. Cela permet au service ou au processus de rédiger rapidement et facilement des informations sensibles en effectuant une simple demande POST avec le PDF au serveur IronSecureDoc en cours d'exécution. Nous allons le démontrer visuellement à l'aide de la documentation Swagger. La demande POST accepte à la fois des paramètres requis et optionnels et est hautement personnalisable ; La réponse renvoie le PDF contenant le texte expurgé.

Démarrez IronSecureDoc

Si IronSecureDoc n'est pas encore installé, veuillez suivre les liens ci-dessous pour le configurer :

L'API de rédaction de texte [POST]

Le point de terminaison [POST] de l'API Redact Text vous permet de masquer du texte sensible dans un document PDF à l'aide de la rédaction. Cette fonctionnalité est essentielle pour les applications qui traitent des documents confidentiels, tels que des contrats juridiques, des dossiers médicaux ou des rapports financiers. L'utilisation de cette API garantit la suppression définitive de textes spécifiques, ce qui renforce la sécurité et assure la conformité aux normes de protection des données.

Veuillez noter: Une fois qu'un texte est rédigé, le contenu ne peut pas être récupéré.

Fanfaronnade

Swagger est un outil puissant qui permet aux développeurs d'interagir avec les API RESTful via une interface web conviviale. Que vous utilisiez des langages comme Python, Java ou autres, Swagger offre un moyen pratique de tester et d'implémenter cette API.

Étapes pour masquer du texte avec Swagger

  1. Accédez à l'interface utilisateur 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.

    Docs Swagger

  2. Localisez l'API [POST] Redact Text :

    Au sein de l'interface Swagger, trouvez le point de terminaison POST /v1/document-services/pdfs/redact-text.

    Rédiger le texte

  3. Spécifier les configurations :

    Dans cet exemple, je fournis à la fois le fichier PDF et les mots à rédiger dans la demande POST. Nous rédigerons le mot « nous » et superposerons une boîte noire dessus. Pour cette démonstration, nous utiliserons le fichier 'sample.pdf' avec les configurations suivantes :

    • draw_black_box: true
    • match_whole_word: true
    • words_to_redact : nous
  4. Téléversez un exemple de PDF :

    Dans le corps de la requête, veuillez télécharger un exemple de fichier PDF où vous souhaitez appliquer la rédaction. Assurez-vous que le fichier est ajouté en tant que pdf_file.

  5. Exécuter la requête :

    Cliquez sur "Exécuter" pour exécuter la requête. La réponse inclura le PDF expurgé. Cette interaction Swagger UI vous permet de tester facilement le processus de rédaction, en fournissant un retour d'information immédiat.


Utiliser une requête CURL via l'invite de commandes

Alternativement, nous pouvons utiliser l'invite de commande avec une demande curl POST pour obtenir le même résultat.

curl -X POST 'http://localhost:8080/v1/document-services/pdfs/redact-text' \
 -H 'accept: */*' \
 -H 'Content-Type: multipart/form-data' \
 -F 'pdf_file=@sample.pdf;type=application/pdf' \
 -F 'words_to_redact="we"' \
 -F 'draw_black_box=true' \
 -F 'match_whole_word=true'
SHELL
Veuillez noter: Par défaut, PowerShell peut interpréter curl comme un alias pour Invoke-WebRequest, un cmdlet PowerShell intégré. Essayez d'utiliser curl.exe au lieu de curl.
curl.exe --version
SHELL

Paramètres obligatoires du corps de la requête

NomType de donnéesDescription du projet
pdf_fileapplication/pdfLe fichier PDF que vous souhaitez manipuler.
words_to_redactarray[string]Ce paramètre prend une liste de mots et supprime le texte correspondant à l'entrée.

Paramètres facultatifs du corps de la requête

NomType de donnéesDescription du projet
user_passwordstringCette étape est nécessaire si le fichier PDF d'entrée est protégé par un mot de passe utilisateur. L'opération échouera si aucun mot de passe n'est fourni pour le fichier PDF protégé.
owner_passwordstringCette étape est nécessaire si le fichier PDF d'entrée est protégé par un mot de passe. L'opération échouera si aucun mot de passe n'est fourni pour le fichier PDF protégé.
specific_pagesarray[int]Vous permet de spécifier sur quelles pages réduire le texte. Par défaut, la valeur est null, ce qui signifie que le mot fourni sera réduit sur toutes les pages.
draw_black_boxbooleanVous permet de spécifier s'il faut dessiner une boîte noire sur le texte réduit. Par défaut, cette valeur est définie sur True.
match_whole_wordbooleanSpécifie si des correspondances partielles au sein des mots doivent également être réduites. Par exemple, si le mot fourni est " sont ", tous les mots contenant " sont ", comme " paroles ", auront également le " sont " réduit. Par défaut, ceci est défini sur True.
match_casebooleanSpécifie si le mot fourni doit être une correspondance exacte en termes de casse. Par défaut, cette valeur est null. Remarque : Définir cela sur True signifie que les chaînes minuscules et majuscules ne seront pas appariées. Par exemple, si le mot fourni est " NOUS ", la version en minuscule " nous " ne serait pas réduite.
overlay_textstringIl spécifie le texte de superposition, comme des mots ou des symboles, sur le texte expurgé. Par défaut, cette chaîne est vide.
save_as_pdfabooleanEnregistre le PDF modifié avec conformité PDF/A-3. Par défaut, ceci est défini sur False.
save_as_pdfuabooleanEnregistre le PDF modifié avec conformité PDF/UA. Par défaut, ceci est défini sur False.

Paramètres d'en-tête optionnels

NomType de donnéesDescription du projet
authorstringCe champ permet de vous identifier comme auteur du document PDF. Par défaut, il est vide.
titlestringAffiche le titre du document PDF. Par défaut, ce champ est vide.
subjectstringPermet d'identifier rapidement le contenu d'un document PDF. Par défaut, ce champ est vide.

Questions fréquemment posées

Comment puis-je expurger le texte dans un PDF en utilisant IronSecureDoc?

Vous pouvez utiliser IronSecureDoc pour caviarder du texte en envoyant une requête POST au serveur IronSecureDoc avec le fichier PDF. L'API permet un caviardage de texte facile et personnalisable et renvoie le PDF caviardé.

Quelles sont les étapes pour caviarder du texte en utilisant Swagger avec IronSecureDoc ?

Pour caviarder du texte en utilisant Swagger avec IronSecureDoc, vous devez accéder à l'interface Swagger, localiser l'API Redact Text POST, spécifier les configurations telles que les mots à caviarder, télécharger un échantillon de PDF et exécuter la requête pour recevoir le PDF caviardé.

Est-il possible d'utiliser l'invite de commande pour caviarder du texte avec IronSecureDoc ?

Oui, vous pouvez utiliser une requête POST curl via l'invite de commande pour réaliser un caviardage de texte avec IronSecureDoc. Assurez-vous que les paramètres appropriés, tels que pdf_file et words_to_redact, sont inclus dans la requête.

Quels sont certains paramètres optionnels disponibles pour l'API de caviardage de texte IronSecureDoc ?

Les paramètres optionnels pour l'API IronSecureDoc incluent draw_black_box, match_whole_word, overlay_text, save_as_pdfa et save_as_pdfua, vous permettant de personnaliser la façon dont le texte est caviardé.

IronSecureDoc peut-il caviarder des pages spécifiques d'un document PDF ?

Oui, IronSecureDoc permet de spécifier specific_pages où le caviardage de texte doit se produire, offrant une flexibilité pour cibler des zones précises d'un document.

Quelle est l'importance d'utiliser IronSecureDoc pour le caviardage de texte dans les PDF ?

IronSecureDoc garantit que les textes caviardés sont supprimés de façon permanente des PDFs. Cela améliore la sécurité et la conformité avec les normes de protection des données pour les documents confidentiels tels que les dossiers juridiques ou financiers.

Puis-je héberger IronSecureDoc localement ou le déployer sur le cloud ?

IronSecureDoc peut être hébergé localement sur des plateformes comme Windows, Mac et Linux, ou déployé sur des services cloud tels qu'Azure et AWS pour une intégration flexible.

Quelle est la fonction de l'option `draw_black_box` dans IronSecureDoc ?

L'option draw_black_box dans IronSecureDoc vous permet de placer une boîte noire sur le texte caviardé pour un masquage visuel, et elle est activée par défaut.

Comment IronSecureDoc gère-t-il les PDFs protégés par mot de passe ?

Pour les PDFs protégés par mot de passe, IronSecureDoc nécessite les paramètres user_password ou owner_password pour effectuer des caviardages, assurant un accès et une manipulation autorisés.

Quels outils peuvent être utilisés pour interagir avec l'API d'IronSecureDoc ?

Des outils comme Swagger UI et des outils en ligne de commande, tels que curl, peuvent être utilisés pour interagir avec l'API d'IronSecureDoc pour tester et mettre en œuvre la fonctionnalité de caviardage de texte.

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.

Lire la suite

Prêt à commencer ?

Version :2024.10tout juste publié