How to Redact Text in C# PDF with IronSecureDoc

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

W tym artykułe omówimy redagowanie tekstu w PDF-ie za pomocą IronSecureDoc. Umożliwia to usłudze lub procesowi szybkie i łatwe redagowanie poufnych informacji poprzez wysłanie prostego żądania POST z plikiem PDF do uruchomionego serwera IronSecureDoc. Pokażemy to wizualnie poprzez użycie dokumentacji Swagger. Żądanie POST przyjmuje zarówno parametry wymagane, jak i opcjonalne i jest wysoce konfigurowalne; odpowiedź zwraca PDF z zredagowanym tekstem.

Pobierz i uruchom IronSecureDoc

Jeśli jeszcze nie uruchomiłeś IronSecureDoc, skorzystaj z poniższych linków, aby go skonfigurować:

Hostuj lokalnieWdrożenie w chmurze

API [POST] Redaction Tekstu

Punkt końcowy API [POST] Redaction Tekstu pozwala na ukrywanie poufnego tekstu w dokumencie PDF poprzez redagowanie. Ta funkcjonalność jest niezbędna dla aplikacji obsługujących poufne dokumenty, takie jak umowy prawne, dokumentacja medyczna czy raporty finansowe. Korzystając z tego API, zapewniamy, że określony tekst jest trwałe usunięty, co zwiększa bezpieczeństwo i zapewnia zgodność ze standardami ochrony danych.

Zwróć uwagęGdy tekst zostanie zredagowany, treść nie może być odzyskana.

Swagger

Swagger to potężne narzędzie, które umożliwia deweloperom interakcję z RESTful API poprzez przyjazny interfejs internetowy. Niezależnie od tego, czy używasz języków takich jak Python, Java czy innych, Swagger oferuje wygodny sposób testowania i wdrażania tego API.

Kroki do zaciemniania tekstu za pomocą Swagger

  1. Uzyskaj dostęp do Swagger UI:

    Jeśli serwer API działa lokalnie, dostęp do Swaggera można uzyskać, przechodząc do http://localhost:8080/swagger/index.html w przeglądarce internetowej.

    Dokumentacja Swagger

  2. Zlokalizuj API [POST] Redaction Tekstu:

    W interfejsie Swagger UI znajdź punkt końcowy POST /v1/document-services/pdfs/redact-text.

    Ukryj tekst

  3. Określ Konfiguracje:

    W tym przykładzie dostarczam zarówno plik PDF, jak i słowa do ocenzurowania w żądaniu POST. Ocenzurujemy słowo "we" i nałożymy na nie czarne pole. Do tej demonstracji użyjemy pliku 'sample.pdf' z następującymi konfiguracjami:

    • draw_black_box: true
    • match_whole_word: true
    • words_to_redact: my
  4. Prześlij przykładowy PDF:

    W ciele żądania, prześlij przykładowy plik PDF, gdzie chcesz zastosować zaciemnienie. Upewnij się, że plik został dodany jako pdf_file.

  5. Uruchom żądanie:

Kliknij "Wykonaj", aby uruchomić zapytanie. Odpowiedź będzie zawierać zredagowany PDF. Interakcja z Swagger UI umożliwia łatwe przetestowanie procesu redagowania, dostarczając natychmiastową informację zwrotną.


Użyj zapytania CURL przez wiersz poleceń

Alternatywnie możemy użyć wiersza poleceń z żądaniem curl POST, aby osiągnąć ten sam rezultat.

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'
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

Zwróć uwagę
Domyślnie PowerShell może interpretować curl jako alias dla Invoke-WebRequest, wbudowanego polecenia cmdlet PowerShell. Spróbuj użyć curl.exe zamiast curl.

curl.exe --version
curl.exe --version
SHELL

)}]

Obowiązkowe Parametry Treści Żądania

ImięTyp danychOpis
pdf_fileapplication/pdfPlik PDF, który chcesz zmodyfikować.
słowa_do_usunięciaarray[string]Ten parametr przyjmuje listę słów i redaguje tekst zgodny z wprowadzonymi danymi.

Opcjonalne Parametry Treści Żądania

ImięTyp danychOpis
user_passwordstringJest to wymagane, jeśli wejściowy PDF ma hasło użytkownika. Operacja zakończy się niepowodzeniem, jeśli nie zostanie podane hasło do pliku PDF zabezpieczonego hasłem.
owner_passwordstringJest to wymagane, jeśli wejściowy PDF ma hasło właściciela. Operacja zakończy się niepowodzeniem, jeśli nie zostanie podane hasło do pliku PDF zabezpieczonego hasłem.
specific_pagesarray[int]Pozwala określić, na których stronach zaciemnić tekst. Domyślnie wartość to null, co oznacza, że podane słowo zostanie zaciemnione na wszystkich stronach.
draw_black_boxbooleanPozwala określić, czy nad zaciemnionym tekstem ma zostać narysowana czarna ramka. Domyślnie, wartość ta jest ustawiona na True.
match_whole_wordbooleanOkreśla, czy częściowe dopasowania w słowach również mają być zaciemniane. Na przykład, jeśli podane słowo to "are," każde słowo zawierające "are," takie jak "hare," również będzie miało zaciemnione "are". Domyślnie, wartość ta jest ustawiona na True.
match_casebooleanOkreśla, czy podane słowo ma być idealnie dopasowane pod względem wielkości liter. Domyślnie wartość ta to null. Uwaga: Ustawienie tego na True oznacza, że ciągi małymi i dużymi literami nie będą się dopasowywać. Na przykład, jeśli podane słowo to "WE," wersja małymi literami "we" nie zostanie zaciemniona.
overlay_textstringOkreśla tekst nakładki, taki jak słowa lub symbole, nad zredagowanym tekstem. Domyślnie ten ciąg jest pusty.
save_as_pdfabooleanZapisuje zmodyfikowany PDF ze zgodnością z PDF/A-3. Domyślnie jest to ustawione na False.
save_as_pdfuabooleanZapisuje zmodyfikowany PDF ze zgodnością z PDF/UA. Domyślnie jest to ustawione na False.

Opcjonalne Parametry Nagłówka

ImięTyp danychOpis
autorstringPrzydatne do identyfikacji Ciebie jako autora dokumentu PDF. Domyślnie to pole jest puste.
tytułstringWyświetla tytuł dokumentu PDF. Domyślnie to pole jest puste.
tematstringPrzydatne do szybkiej identyfikacji zawartości dokumentu PDF. Domyślnie to pole jest puste.

Często Zadawane Pytania

Jak mogę zredagować tekst w PDF za pomocą żądania POST?

Możesz zredagować tekst w PDF, wysyłając żądanie POST do serwera IronSecureDoc z plikiem PDF i słowami, które chcesz zredagować. Serwer przetwarza żądanie i zwraca PDF ze zredagowanym tekstem.

Jakie są kroki używania API IronSecureDoc do redagowania PDF?

Aby używać API IronSecureDoc do redagowania PDF, najpierw należy pobrać i uruchomić obraz Docker IronSecureDoc, przetestować API za pomocą Swagger, określić tekst do redagowania, wykonać wywołanie API, a na końcu wyeksportować zredagowany dokument PDF.

Jak mogę przetestować API IronSecureDoc przed użyciem go w produkcji?

Możesz przetestować API IronSecureDoc przy użyciu Swagger, uzyskując dostęp do Swagger UI, co pozwala na użycie dostarczonych punktów końcowych do symulacji procesu redagowania.

Jakie parametry można dostosować w żądaniu redagowania PDF?

W żądaniu redagowania PDF można dostosować parametry takie jak user_password, owner_password, specific_pages, draw_black_box, match_whole_word, match_case, overlay_text, save_as_pdfa i save_as_pdfua, aby uzyskać dalsze dostosowania.

Jak wykonać żądanie redagowania PDF za pomocą curl?

Aby wykonać żądanie redagowania PDF za pomocą curl, możesz użyć polecenia curl POST, określając niezbędne parametry i ścieżkę pliku w wierszu poleceń.

Co powinnam zrobić, jeśli mój PDF jest zabezpieczony hasłem podczas redagowania?

Jeśli twój PDF jest zabezpieczony hasłem, musisz uwzględnić user_password lub owner_password w opcjonalnych parametrach, aby upewnić się, że proces redagowania może uzyskać dostęp do dokumentu i go zmodyfikować.

Jaki jest cel parametru 'draw_black_box' w redagowaniu tekstu?

Parametr 'draw_black_box' określa, czy zakrywać zredagowany tekst czarnym boksem. Ta opcja jest użyteczna do wizualizacji zredagowanych obszarów i jest domyślnie włączona.

Jak mogę lokalnie hostować IronSecureDoc do celów redagowania?

Możesz lokalnie hostować IronSecureDoc, postępując zgodnie z samouczkami dostarczonymi dla różnych systemów operacyjnych, takich jak Windows, Mac lub Linux, co pozwala na zarządzanie procesem redagowania na lokalnym serwerze.

Czy jest możliwe zredagowanie określonych stron w PDF?

Tak, możesz określić, które strony redagować, używając parametru 'specific_pages', który pozwala na ukierunkowanie redagowania na konkretne obszary dokumentu.

Czy mogę nałożyć tekst na zredagowane obszary w PDF?

Tak, możesz nałożyć tekst na zredagowane obszary, używając parametru 'overlay_text', który pozwala zastąpić zredagowany tekst niestandardową wiadomością lub zastępczym tekstem.

Czy IronSecureDoc jest kompatybilny z .NET 10 i jego bibliotekami klienckimi?

Tak, IronSecureDoc zapewnia klienta .NET za pośrednictwem pakietu NuGet IronSoftware.SecureDoc.Client i jest kompatybilny z .NET 10 oraz poprzednimi wersjami, takimi jak .NET 6–9. To zapewnia możliwość bezproblemowej integracji redagowania i powiązanych API w aplikacjach .NET 10.

Curtis Chau
Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podrę...

Czytaj więcej
Gotowy, aby rozpocząć?
Wersja: 2024.10 just released
Still Scrolling Icon

Wciąż przewijasz?

Czy chcesz szybko dowodu?
uruchom przykład zobacz, jak twój PDF staje się zaszyfrowany.