.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로 변환해야 할 수 있습니다.
실용적인 적용 사례
- 기밀 보고서: 외부 배포 전에 로고나 차트를 Redact합니다.
- 법률 브리프: 개인 데이터가 포함된 고객 사진이나 스캔된 신분증을 숨깁니다.
- 비즈니스 계약: 영업 비밀을 드러내는 독점 다이어그램을 마스킹합니다.
- 정부 발표: 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 영업팀에 연락하십시오.
추가 자료
- 문서: GroupDocs Redaction 문서
- API 참조: GroupDocs API 참조
- 다운로드: 최신 릴리스
최종 업데이트: 2026-10-16
테스트 환경: .NET용 GroupDocs.Redaction 23.12
작성자: GroupDocs