GroupDocs.Redaction .NET를 사용한 문서 가리기 방법: 안전한 문서 가리기 및 네트워크 설정

오늘날 빠르게 변화하는 디지털 세계에서 문서를 안전하게 가리는 방법은 개발자와 IT 팀에게 가장 큰 관심사입니다. 개인 건강 기록, 법률 계약서, 내부 보고서 등을 보호하든, GroupDocs.Redaction for .NET은 파일의 나머지 부분을 그대로 유지하면서 기밀 정보를 제거할 수 있는 검증된 도구 모음을 제공합니다. 이 튜토리얼에서는 라이브러리 설치, 확장 가능한 검색 네트워크 구성, 고용량 작업을 처리할 수 있는 가리기 노드 배포 과정을 단계별로 안내합니다.

빠른 답변

  • 첫 번째 단계는 무엇인가요? .NET CLI 또는 Package Manager를 통해 GroupDocs.Redaction NuGet 패키지를 설치합니다.
  • 스케일링을 어떻게 설정하나요? ConfiguringSearchNetwork.Configure 메서드를 사용하여 기본 경로와 포트를 정의한 다음 슬레이브 노드를 시작합니다.
  • PDF와 이미지를 가릴 수 있나요? 예—GroupDocs.Redaction은 PDF, DOCX, PPTX 및 일반 이미지 형식을 포함해 30개 이상의 파일 형식을 지원합니다.
  • 어떤 라이선스가 필요합니까? 프로덕션에는 임시 또는 정식 라이선스가 필요하며, 평가를 위한 무료 체험판이 제공됩니다.
  • .NET‑Core와 호환되나요? 물론입니다—.NET Framework 4.5+와 .NET Core 3.1+ 모두 완벽히 지원됩니다.

문서 가리기란 무엇인가요?

문서 가리기는 파일에서 민감한 내용을 영구적으로 제거하거나 마스킹하여 이후에 복구하거나 볼 수 없도록 하는 과정입니다. 이는 법률, 의료, 금융 분야에서 개인 식별자, 영업 비밀, 기밀 정보를 공개하거나 제3자와 공유하기 전에 보호하기 위해 일반적으로 사용됩니다. GroupDocs.Redaction은 프로그래밍 방식으로 이 작업을 수행하여 수동 편집 없이도 개인정보 보호 규정을 준수하도록 합니다.

.NET용 GroupDocs.Redaction을 사용하는 이유

GroupDocs.Redaction은 50개 이상의 입력 및 출력 형식을 지원하며 전체 문서를 메모리에 로드하지 않고도 수백 페이지 파일을 처리할 수 있어 수동 가리기 도구에 비해 CPU 사용량을 최대 40 %까지 절감합니다. 또한 스캔된 이미지에 대한 OCR이 내장되어 있어 사진 안에 숨겨진 텍스트도 자동으로 가릴 수 있습니다.

전제 조건

  • 필수 라이브러리: GroupDocs.Redaction for .NET, GroupDocs.Search.Scaling (호환 버전).
  • 개발 환경: Visual Studio 2022 또는 .NET 호환 IDE.
  • 서버 접근: 마스터 노드를 호스팅할 최소 하나의 머신(또는 VM)과 슬레이브 노드를 위한 추가 머신이 필요합니다.
  • 지식: 기본 C# 및 .NET 개념, 파일 I/O에 대한 이해.

문서를 단계별로 가리기

소스 파일을 로드하고, 가리기 영역을 정의한 뒤 결과를 저장합니다—몇 줄의 코드만으로 가능합니다.

로드, 가리기, 저장을 두 문장만으로 수행합니다: Redactor 객체를 인스턴스화하고 RedactionArea를 추가한 뒤 Save를 호출합니다. 이 직접적인 패턴은 방대한 워크플로에 광범위한 보일러플레이트 없이 가리기 기능을 통합할 수 있게 해줍니다.

단계 1: NuGet 패키지 설치

.NET CLI 사용:

dotnet add package GroupDocs.Redaction

Package Manager 사용:

Install-Package GroupDocs.Redaction

또는 NuGet Package Manager UI에서 “GroupDocs.Redaction”을 검색하고 최신 안정 버전을 설치합니다.

단계 2: 라이선스 획득 및 적용

  • 무료 체험 – 모든 기능을 30일 동안 평가합니다.
  • 임시 라이선스 – 체험 기간 이후 테스트를 연장합니다.
  • 정식 라이선스 – 프로덕션 수준 성능 및 지원을 이용할 수 있습니다.

단계 3: Redactor 초기화

Redactor는 메모리 내 단일 문서를 나타내는 핵심 클래스이며 가리기 작업을 제공합니다.

using GroupDocs.Redaction;

// Initialize the Redactor
Redactor redactor = new Redactor("your-document-path");

검색 네트워크 스케일링 설정 방법

ConfiguringSearchNetwork.Configure는 지정된 경로와 포트로 검색 네트워크 환경을 초기화하는 도우미 메서드입니다. 소스 문서의 기본 디렉터리를 설정하고 시작 TCP 포트를 지정하며, 클러스터 내 각 노드를 자동으로 등록합니다. 이 구성은 여러 노드가 동시에 가리기 요청을 처리하도록 하여 처리량을 높이고 서버 팜 전반에 부하를 균등하게 분산시킵니다.

   using GroupDocs.Search.Scaling.Configuring;

   string basePath = @"YOUR_DOCUMENT_DIRECTORY";
   int basePort = 49136; // Change if port is busy

   Configuration configuration = ConfiguringSearchNetwork.Configure(basePath, basePort);
  • basePath – 소스 문서가 들어있는 루트 폴더.
  • basePort – 시작 TCP 포트; 각 노드는 이 값을 자동으로 증가시킵니다.

슬레이브 노드 배포 방법

SearchNode.StartSlaveNode는 마스터 노드에 등록되어 가리기 작업을 처리하는 보조 검색 노드를 시작합니다. 이 메서드는 마스터 주소, 고유 노드 식별자 및 선택적 타임아웃 설정을 필요로 합니다. 시작 후 슬레이브 노드는 들어오는 작업을 수신하고 문서를 병렬로 처리하며 상태를 마스터에 보고하여 네트워크 전반에 고가용성과 장애 복구를 제공합니다.

   using GroupDocs.Search.Scaling;
   using System;

   int sendTimeout = 3000; // Timeout in milliseconds
   int receiveTimeout = 3000;
   int connectTimeout = 3000;
   int retryTimeout = 1000;

   SearchNetworkNode node1 = SearchNetworkNode.CreateSlaveNode(
       1,
       basePath + "Node1\",
       sendTimeout, 
       receiveTimeout, 
       connectTimeout, 
       retryTimeout);
  • timeout 매개변수를 예상 네트워크 지연에 따라 조정합니다.
  • 노드를 지리적으로 분산시켜 원격 사용자의 지연을 줄입니다.

일반적인 문제 및 해결책

  • 포트 충돌 – 선택한 basePort를 다른 서비스가 사용하고 있지 않은지 확인합니다. netstat 또는 Windows 리소스 모니터를 사용해 충돌을 확인하세요.
  • 파일 접근 오류 – 프로세스 ID가 basePath에 대한 읽기/쓰기 권한을 가지고 있는지 확인합니다.
  • 대용량 파일 타임아웃 – 노드의 timeout 값을 늘리거나 대형 PDF를 가리기 전에 작은 청크로 분할합니다.

자주 묻는 질문

Q: GroupDocs.Redaction for .NET란?
A: 30개 이상의 문서 형식에서 레이아웃과 메타데이터를 유지하면서 민감한 데이터를 프로그래밍 방식으로 제거하거나 마스킹할 수 있는 .NET 라이브러리입니다.

Q: GroupDocs.Search.Scaling을 사용해 검색 네트워크를 어떻게 구성하나요?**
A: 문서 디렉터리와 basePort를 지정하여 ConfiguringSearchNetwork.Configure를 호출하고, SearchNode.StartSlaveNode를 사용해 슬레이브 노드를 시작합니다.

Q: 다른 서버에 노드를 배포할 수 있나요?**
A: 예—각 노드는 TCP를 통해 마스터에 등록되므로 원하는 만큼의 머신에 수평 확장이 가능합니다.

Q: 타임아웃을 설정할 때 흔히 발생하는 함정은 무엇인가요?**
A: 네트워크 지연이나 대용량 파일로 인해 기본 타임아웃 값이 너무 낮을 수 있습니다. 환경에 맞는 성능 테스트를 통해 값을 조정하세요.

Q: GroupDocs.Redaction에 대한 추가 자료는 어디서 찾을 수 있나요?**
A: 아래에 나열된 공식 문서, API 레퍼런스, 최신 릴리스 페이지, 커뮤니티 포럼 및 임시 라이선스 포털을 참고하십시오.

리소스

마지막 업데이트: 2026-07-21
테스트 환경: GroupDocs.Redaction 23.9 for .NET, GroupDocs.Search.Scaling 2.4
작성자: GroupDocs

관련 튜토리얼