.NET을 사용하여 Word에서 이미지를 Redact하는 GroupDocs 사용 방법

Microsoft Word 파일에서 기밀 시각 자료를 보호해야 할 때, GroupDocs 사용 방법이 가장 먼저 떠오르는 질문입니다. 이 튜토리얼은 삽입된 그림을 찾아서 마스킹하고 영구적으로 제거하는 모든 단계를 안내하여 민감한 정보가 유출되지 않도록 합니다.

빠른 답변

  • GroupDocs가 모든 이미지를 자동으로 Redact할 수 있나요? 예, 각 그림을 순회하면서 ImageAreaRedaction을 적용할 수 있습니다.
  • 지원되는 .NET 버전은 무엇인가요? .NET Framework 4.5+, .NET Core 3.1+, .NET 5/6/7.
  • 개발에 라이선스가 필요합니까? 무료 체험판으로 테스트가 가능하지만, 프로덕션에서는 영구 라이선스가 필요합니다.
  • 원본 레이아웃이 유지되나요? API는 이미지 영역을 비우는 동안 텍스트와 서식을 그대로 유지합니다.
  • 처리 속도는 어느 정도인가요? 일반 서버에서 GroupDocs.Redaction은 200페이지 문서를 2초 미만으로 처리할 수 있습니다.

GroupDocs.Redaction이란?

GroupDocs.Redaction은 텍스트, 이미지 및 메타데이터를 프로그래밍 방식으로 Redact할 수 있는 .NET 라이브러리이며, 20개 이상의 문서 형식을 지원합니다. Microsoft Office가 설치되지 않은 상태에서도 파일을 처리할 수 있어 서버‑사이드 자동화에 적합합니다. 텍스트, 이미지, 메타데이터 Redact를 위한 API를 제공하며 배치 처리, 사용자 정의 Redact 패턴 및 규정 준수 보고서를 지원합니다.

Word에서 이미지 Redact에 GroupDocs를 사용하는 이유는?

이 라이브러리는 20개 이상의 입력 및 출력 형식을 지원하며, 전체 파일을 메모리에 로드하지 않고도 최대 500 MB 문서의 이미지를 Redact할 수 있습니다. 내장된 ImageAreaRedaction 알고리즘은 Redact된 영역이 복구될 수 없도록 보장하여 엄격한 규정 준수 기준을 충족합니다.

사전 요구 사항

  • .NET Framework 4.5+ 또는 .NET Core 3.1+가 설치되어 있어야 합니다.
  • 기본적인 C# 지식 및 Word 파일 구조에 대한 이해.
  • GroupDocs.Redaction NuGet 패키지에 대한 접근 권한(무료 체험 또는 라이선스).

.NET용 GroupDocs.Redaction 설정 방법

.NET CLI를 통해 GroupDocs.Redaction을 설치하는 방법은?

프로젝트 폴더에서 다음 명령을 실행합니다: dotnet add package GroupDocs.Redaction. 이 명령은 최신 안정 버전을 프로젝트 파일에 추가합니다.

dotnet add package GroupDocs.Redaction

Package Manager를 사용하여 GroupDocs.Redaction을 설치하는 방법은?

Package Manager 콘솔에서 Install-Package GroupDocs.Redaction을 실행합니다.

Install-Package GroupDocs.Redaction

임시 라이선스를 얻고 적용하는 방법은?

임시 라이선스는 임시 라이선스 페이지에서 요청할 수 있습니다.
임시 라이선스를 사용하면 워터마크 없이 전체 기능을 평가할 수 있습니다. 구매 후 라이선스 파일을 프로젝트에 배치하고 아래와 같이 로드합니다:

using GroupDocs.Redaction;

Word 문서에서 삽입된 이미지를 Redact하는 방법은?

이미지를 Redact하려면 Redactor 인스턴스로 문서를 로드하고 각 그림을 찾아 숨길 영역을 정의한 뒤 ImageAreaRedaction을 적용합니다. API는 선택된 픽셀을 덮어써 원본 시각 콘텐츠가 복구되지 않도록 하면서 주변 레이아웃과 텍스트는 유지합니다.

소스 및 출력 경로를 준비하는 방법은?

객체를 생성하기 전에 원본 문서와 Redact된 결과물의 절대 경로를 정의합니다.

string sourceFile = "YOUR_DOCUMENT_DIRECTORY/LOREMIPSUM_PDF";
string outputFile = "YOUR_OUTPUT_DIRECTORY/redacted_output.docx";

Redactor 객체를 생성하고 구성하는 방법은?

Redactor는 문서를 로드하고 Redact 작업을 수행하는 핵심 클래스입니다.
문서와 함께 Redactor 인스턴스를 생성합니다:

using (Redactor redactor = new Redactor(sourceFile))
{
    // Code for redaction will go here
}

좌표를 지정하고 이미지 영역 Redact를 적용하는 방법은?

ImageAreaRedaction은 이미지의 사각형 영역을 단색으로 마스킹하는 메서드입니다.
숨기려는 영역의 좌상단 점(samplePoint)과 크기(sampleSize)를 지정한 뒤 ImageAreaRedaction을 호출합니다. 이 메서드는 선택된 픽셀을 단색으로 덮어씁니다.

Point samplePoint = new Point(516, 311);
Size sampleSize = new Size(170, 35);

RedactorChangeLog result = redactor.Apply(new ImageAreaRedaction(
    samplePoint,
    new RegionReplacementOptions(Color.Blue, sampleSize)
));

Redact 결과를 확인하고 파일을 저장하는 방법은?

Redactor.Apply()를 호출한 후 Result 객체를 검사합니다. IsSuccess가 true이면 수정된 문서를 출력 경로에 저장합니다.

if (result.Status != RedactionStatus.Failed)
{
    var savedOutputFile = redactor.Save();
    Console.WriteLine($"Redacted document saved as: {savedOutputFile}");
}

일반적인 문제 및 해결 팁

  • 좌표 오류: X/Y 값이 이미지 경계 내에 있는지 확인하십시오; 그렇지 않으면 API가 ArgumentOutOfRangeException을 발생시킵니다.
  • 라이선스 누락: 체험 라이선스는 30일 후에 만료됩니다; 런타임 오류를 방지하려면 영구 라이선스로 교체하십시오.
  • 지원되지 않는 형식: 파일 확장자가 문서에 나열된 20개 이상의 형식 중 하나인지 확인하십시오; 오래된 .doc 파일은 먼저 .docx로 변환해야 할 수 있습니다.

실용적인 적용 사례

  1. 기밀 보고서: 외부 배포 전에 로고나 차트를 Redact합니다.
  2. 법률 브리프: 개인 데이터가 포함된 고객 사진이나 스캔된 신분증을 숨깁니다.
  3. 비즈니스 계약: 영업 비밀을 드러내는 독점 다이어그램을 마스킹합니다.
  4. 정부 발표: Word에서 생성된 공개 PDF에서 민감한 위성 이미지를 제거합니다.

성능 고려 사항

  • 대량 배치를 처리할 때는 메모리 사용량을 낮게 유지하기 위해 문서를 순차적으로 처리하십시오.
  • 제한된 서버에서 실행하는 경우 RedactorOptions를 사용해 스레드 수를 제한하십시오.
  • using 구문으로 Redactor 인스턴스를 즉시 해제하여 관리되지 않는 리소스를 해제하십시오.

결론

이제 GroupDocs 사용 방법을 알고 .NET API를 사용해 Word 파일에 삽입된 이미지를 신뢰성 있게 Redact할 수 있습니다. 위 단계들을 따르면 이 기능을 모든 문서 처리 파이프라인에 통합하여 기밀 시각 자료가 조직을 벗어나지 않도록 할 수 있습니다.

더 깊이 탐구하려면 다른 Redact 유형(텍스트, 메타데이터)을 실험하고 라이브러리를 웹 서비스, 백그라운드 워커 또는 Azure Functions에 통합해 보십시오.

자주 묻는 질문

Q: 한 번에 여러 그림을 Redact할 수 있나요?
A: 예, 각 그림 노드를 순회하면서 숨겨야 할 각 영역에 대해 ImageAreaRedaction을 호출하면 됩니다.

Q: GroupDocs.Redaction이 비밀번호로 보호된 Word 파일을 지원하나요?
A: 물론입니다. Redactor 객체를 생성할 때 비밀번호를 제공하면 라이브러리가 문서를 안전하게 엽니다.

Q: DOCX 외에 어떤 파일 형식을 처리할 수 있나요?
A: API는 DOC, DOCX, RTF, HTML, PDF 및 20개 이상의 다른 형식을 처리하여 범용 Redact 서비스를 구축할 수 있게 합니다.

Q: 라이선스 없이 Redact를 테스트하려면 어떻게 해야 하나요?
A: GroupDocs 포털에서 임시 라이선스를 사용하십시오; 워터마크 없이 30일 동안 전체 기능을 사용할 수 있습니다.

Q: 문제가 발생하면 어디에서 도움을 받을 수 있나요?
A: 커뮤니티 지원을 위해 GroupDocs 무료 지원 포럼을 방문하거나 엔터프라이즈 지원을 위해 GroupDocs 영업팀에 연락하십시오.

추가 자료


최종 업데이트: 2026-10-16
테스트 환경: .NET용 GroupDocs.Redaction 23.12
작성자: GroupDocs

관련 튜토리얼