How to Redact Text in C# PDF with IronSecureDoc
이 글에서는 IronSecureDoc을 사용하여 PDF에서 텍스트를 수정하는 방법에 대해 설명합니다. 이를 통해 서비스 또는 프로세스는 실행 중인 IronSecureDoc 서버에 PDF 파일을 간단한 POST 요청으로 전송하여 민감한 정보를 신속하고 쉽게 삭제할 수 있습니다. 우리는 Swagger 문서를 사용하여 이를 시각적으로 보여드리겠습니다. POST 요청은 필수 및 선택적 매개변수를 모두 수용하며, 매우 유연하게 맞춤 설정할 수 있습니다. 응답은 텍스트가 삭제된 PDF 파일을 반환합니다.
- IronSecureDoc Docker 이미지를 다운로드하고 시작하세요.
- Swagger를 사용하여 API를 테스트하세요
- 삭제할 텍스트를 지정하세요.
- 제공된 세부 정보를 사용하여 API 호출을 실행합니다.
- 수정된 PDF 문서를 내보내기
IronSecureDoc을 풀고 시작하세요
IronSecureDoc이 아직 실행되고 있지 않다면 아래 링크를 따라 설치하십시오.
| 로컬에서 호스팅하세요 | 클라우드에 배포 |
|---|---|
[POST] 텍스트 수정 API
[POST] 텍스트 수정 API 엔드포인트를 사용하면 수정 기능을 통해 PDF 문서 내의 민감한 텍스트를 숨길 수 있습니다. 이 기능은 법률 계약서, 의료 기록 또는 재무 보고서와 같은 기밀 문서를 처리하는 애플리케이션에 필수적입니다. 이 API를 사용하면 특정 텍스트가 영구적으로 삭제되어 보안이 강화되고 데이터 보호 표준을 준수할 수 있습니다.
멋진
Swagger는 개발자가 사용자 친화적인 웹 인터페이스를 통해 RESTful API와 상호 작용할 수 있도록 해주는 강력한 도구입니다. Python, 자바 등 어떤 언어를 사용하든 Swagger는 이 API를 테스트하고 구현하는 편리한 방법을 제공합니다.
멋진를 사용하여 텍스트를 수정하는 단계
Swagger UI에 접속합니다.
API 서버가 로컬에서 실행 중인 경우, 웹 브라우저에서
http://localhost:8080/swagger/index.html으로 이동하여 Swagger에 액세스할 수 있습니다.
[POST] 텍스트 수정 API를 찾으세요:
Swagger UI 내에서 [POST]
/v1/document-services/pdfs/redact-text엔드포인트를 찾으세요.
구성 지정:
이 예시에서는 POST 요청에 PDF 파일과 삭제할 단어를 모두 제공합니다. "we"라는 단어를 삭제하고 그 위에 검은색 상자를 씌우겠습니다. 이번 시연에서는 다음과 같은 설정으로 ' sample.pdf ' 파일을 사용하겠습니다.
draw_black_box: truematch_whole_word: truewords_to_redact: we
샘플 PDF 파일을 업로드하세요:
요청 본문에 수정하려는 내용이 포함된 샘플 PDF 파일을 업로드하세요. Ensure that the file is added as
pdf_file.요청을 실행합니다.
"실행"을 클릭하여 요청을 실행하세요. 응답에는 수정된 PDF 파일이 포함됩니다. 이 Swagger UI 상호작용을 통해 수정 프로세스를 쉽게 테스트하고 즉각적인 피드백을 받을 수 있습니다.
명령 프롬프트를 통해 CURL 요청을 사용하세요
또는 명령 프롬프트에서 curl POST 요청을 사용하여 동일한 결과를 얻을 수도 있습니다.
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=애플리케이션/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=애플리케이션/pdf' \
-F 'words_to_redact="we"' \
-F 'draw_black_box=true' \
-F 'match_whole_word=true'curl을(를) 내장 PowerShell cmdlet인 Invoke-WebRequest의 별칭으로 해석할 수 있습니다. curl.exe 대신 curl을(를) 사용해 보세요.curl.exe --versioncurl.exe --version)}]
필수 요청 본문 매개변수
| 이름 | 데이터 유형 | 설명 |
|---|---|---|
| `pdf_file` | 애플리케이션/pdf | 수정하려는 PDF 파일입니다. |
| `words_to_redact` | 배열[문자열] | 이 매개변수는 단어 목록을 받아 입력된 단어와 일치하는 텍스트를 삭제합니다. |
선택적 요청 본문 매개변수
| 이름 | 데이터 유형 | 설명 |
|---|---|---|
| `user_password` | 끈 | 입력 PDF 파일에 사용자 암호가 있는 경우 이 작업이 필수입니다. 암호로 보호된 PDF 파일에 암호를 제공하지 않으면 작업이 실패합니다. |
| `owner_password` | 끈 | 입력 PDF 파일에 소유자 암호가 있는 경우 이 작업이 필수입니다. 암호로 보호된 PDF 파일에 암호를 제공하지 않으면 작업이 실패합니다. |
| `specific_pages` | 배열[정수] | 텍스트를 삭제할 페이지를 지정할 수 있습니다. 기본값은 null이며, 이 경우 지정된 단어가 모든 페이지에서 삭제됩니다. |
| `draw_black_box` | 부울 | 가려진 텍스트 위에 검은색 상자를 그릴지 여부를 지정할 수 있습니다. 기본값은 True입니다. |
| `match_whole_word` | 부울 | 단어 내에서 부분적으로 일치하는 부분도 삭제할지 여부를 지정합니다. 예를 들어, 지정된 단어가 "are"인 경우 "hare"와 같이 "are"가 포함된 모든 단어에서 "are"가 삭제됩니다. 기본값은 True입니다. |
| `match_case` | 부울 | 제공된 단어가 대소문자를 정확히 일치해야 하는지 여부를 지정합니다. 기본값은 null입니다. 참고: 이 값을 True로 설정하면 소문자와 대문자 문자열은 일치하지 않습니다. 예를 들어, 제공된 단어가 "WE"인 경우 소문자 "we"는 삭제되지 않습니다. |
| `overlay_text` | 끈 | 이 필드는 가려진 텍스트 위에 표시될 오버레이 텍스트(예: 단어 또는 기호)를 지정합니다. 기본적으로 이 문자열은 비어 있습니다. |
| `save_as_pdfa` | 부울 | 수정된 PDF 파일을 PDF/A-3 규격에 맞춰 저장합니다. 기본값은 False입니다. |
| `save_as_pdfua` | 부울 | 수정된 PDF 파일을 PDF/UA 규격에 맞춰 저장합니다. 기본값은 False입니다. |
선택적 헤더 매개변수
| 이름 | 데이터 유형 | 설명 |
|---|---|---|
| `author` | 끈 | PDF 문서의 작성자를 확인하는 데 유용합니다. 기본적으로 이 필드는 비어 있습니다. |
| `title` | 끈 | PDF 문서의 제목을 표시합니다. 기본적으로 이 필드는 비어 있습니다. |
| `subject` | 끈 | PDF 문서의 내용을 한눈에 파악하는 데 유용합니다. 기본적으로 이 필드는 비어 있습니다. |
자주 묻는 질문
POST 요청을 사용하여 PDF에서 텍스트를 편집하려면 어떻게 해야 하나요?
PDF 파일과 편집하려는 단어로 IronSecureDoc 서버에 POST 요청을 만들어 PDF에서 텍스트를 편집할 수 있습니다. 서버는 요청을 처리하고 편집된 텍스트가 있는 PDF를 반환합니다.
PDF 편집을 위해 IronSecureDoc API를 사용하는 단계는 무엇인가요?
PDF 편집을 위해 IronSecureDoc API를 사용하려면 먼저 IronSecureDoc Docker 이미지를 가져오고 시작하고, Swagger를 사용하여 API를 테스트하며, 편집할 텍스트를 지정하고, API 호출을 실행한 후, 최종적으로 편집된 PDF 문서를 내보내야 합니다.
생산 환경에서 사용하기 전에 IronSecureDoc API를 테스트하려면 어떻게 해야 하나요?
Swagger UI에 액세스하여 제공된 엔드포인트를 사용하여 편집 프로세스를 시뮬레이션함으로써 IronSecureDoc API를 테스트할 수 있습니다.
PDF 편집 요청에서 사용자 정의할 수 있는 매개변수는 무엇인가요?
PDF 편집 요청에서는 user_password, owner_password, specific_pages, draw_black_box, match_whole_word, match_case, overlay_text, save_as_pdfa, save_as_pdfua 등의 매개변수를 사용자 지정할 수 있습니다.
Curl을 사용하여 PDF 편집 요청을 실행하려면 어떻게 해야 하나요?
필요한 매개변수와 파일 경로를 지정하여 커맨드 프롬프트에서 curl POST 요청 명령을 사용하여 PDF 편집 요청을 실행할 수 있습니다.
편집 중 PDF가 비밀번호로 보호된 경우 어떻게 해야 하나요?
PDF가 비밀번호로 보호된 경우, 선택적 매개변수에 user_password 또는 owner_password를 포함하여 편집 프로세스가 문서에 액세스하고 수정할 수 있도록 해야 합니다.
'검은 상자 그리기' 매개변수의 텍스트 편집에서의 목적은 무엇인가요?
'검은 상자 그리기' 매개변수는 편집된 텍스트를 검은 상자로 덮을지 여부를 지정합니다. 이 옵션은 편집된 영역을 시각화하는 데 유용하며 기본적으로 활성화됩니다.
편집 목적으로 IronSecureDoc을 로컬에서 호스팅할 수 있는 방법은 무엇인가요?
Windows, Mac 또는 Linux와 같은 다양한 운영 체제를 위한 튜토리얼을 따라 IronSecureDoc을 로컬에서 호스팅하여 로컬 서버에서 편집 프로세스를 관리할 수 있습니다.
PDF에서 특정 페이지를 편집할 수 있나요?
네, 'specific_pages' 매개변수를 사용하여 편집할 페이지를 지정할 수 있으며, 이를 통해 문서의 특정 영역을 대상으로 할 수 있습니다.
PDF에서 편집된 영역에 텍스트를 오버레이할 수 있나요?
네, 'overlay_text' 매개변수를 사용하여 편집된 영역에 텍스트를 오버레이할 수 있으며, 편집된 텍스트를 사용자 정의 메시지나 플레이스홀더로 교체할 수 있습니다.
IronSecureDoc이 .NET 10 및 그 클라이언트 라이브러리와 호환되나요?
네, IronSecureDoc은 NuGet 패키지 IronSoftware.SecureDoc.Client를 통해 .NET 클라이언트를 제공하며 .NET 10과 호환됩니다. 이렇게 하면 .NET 10 애플리케이션에서 편집 및 관련 API를 원활하게 통합할 수 있습니다.





