.NET 앱에서 PDF 민감 정보 가리기

PDF에서 민감한 정보를 가리는 것은 기밀 문서를 다루는 모든 조직에 중요한 단계입니다. 이 튜토리얼에서는 GroupDocs.Redaction을 사용하여 개인 데이터, 법적 조항 또는 원하는 텍스트를 자동으로 찾아 가리는 방법을 알아봅니다. 최종적으로 .NET Core, .NET Framework 및 .NET 5/6+ 프로젝트에서 작동하는 프로덕션 준비 솔루션을 갖게 됩니다.

빠른 답변

  • .NET에서 PDF 가리기를 처리하는 라이브러리는 무엇인가요? GroupDocs.Redaction for .NET.
  • GroupDocs.Redaction이 지원하는 포맷은 몇 개입니까? PDF, DOCX, PPTX 및 이미지 등을 포함한 30개 이상의 입력 및 출력 포맷을 지원합니다.
  • 500페이지 PDF를 전체를 메모리에 로드하지 않고 처리할 수 있나요? 예 – API가 페이지를 스트리밍하여 메모리 사용량을 100 MB 이하로 유지합니다.
  • 개발에 라이선스가 필요합니까? 평가용으로 무료 임시 라이선스를 제공합니다.
  • 비동기 처리가 가능한가요? 최신 버전에서는 논블로킹 I/O를 위한 async 메서드를 제공합니다.

PDF 민감 정보 가리기란?

redact sensitive information pdf는 PDF 파일 내의 기밀 텍스트와 데이터를 영구적으로 제거하거나 마스킹하여 나중에 복구, 조회 또는 추출될 수 없도록 하는 과정을 의미합니다. 가리기는 원본 내용을 자리 표시자 문자나 시각적 블록으로 교체하여 개인정보 보호 규정을 준수하고 민감한 정보를 보호합니다.

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

GroupDocs.Redaction은 50개 이상의 파일 포맷을 지원하며 전체 파일을 RAM에 로드하지 않고 1 GB까지의 문서를 처리할 수 있어 수동 가리기 도구에 비해 최대 3배 빠른 처리를 제공합니다. 내장된 OCR 및 패턴 매칭 엔진을 통해 개인 식별자, 신용카드 번호 또는 사용자 정의 키워드를 한 줄의 코드로 지정할 수 있습니다.

전제 조건

  • .NET Core 3.1, .NET 5, .NET 6 또는 .NET Framework 4.6+가 설치되어 있어야 합니다.
  • Visual Studio 2022(또는 선호하는 IDE).
  • 기본 C# 지식 및 파일 I/O에 대한 이해.
  • GroupDocs.Redaction NuGet 패키지에 접근 가능(아래 설치 단계 참고).

.NET용 GroupDocs.Redaction 설정

패키지 설치

.NET CLI 사용:

dotnet add package GroupDocs.Redaction

Package Manager 사용:

Install-Package GroupDocs.Redaction

NuGet 패키지 관리자 UI 사용:
NuGet 패키지 관리자에서 “GroupDocs.Redaction”을 검색하고 최신 버전을 설치합니다.

라이선스 획득

프로덕션에서 GroupDocs.Redaction을 사용하려면 라이선스가 필요합니다. 다음과 같이 할 수 있습니다:

  • 기 기능을 살펴보기 위해 무료 체험을 신청합니다.
  • 확장 평가를 위한 임시 라이선스를 요청합니다.
  • 무제한 사용을 위한 정식 라이선스를 구매합니다.

기본 초기화 및 설정

첫 번째 단계는 모든 가리기 작업을 관리할 Redactor 인스턴스를 생성하는 것입니다.

using System;
using System.IO;
using GroupDocs.Redaction;

class Program
{
    static void Main()
    {
        // Initialize the Redactor instance with a document path.
        using (Redactor redactor = new Redactor("path/to/your/document.pdf"))
        {
            // Apply your desired redactions here.
            Console.WriteLine("Document ready for redaction!");
        }
    }
}

이 객체는 원본 문서를 로드하고, 가리기 규칙을 적용한 뒤, 결과를 출력합니다.

.NET에서 PDF 민감 정보 가리기 방법

대상 PDF를 로드하고, 가리기 규칙을 정의한 뒤 결과를 저장합니다 – 모두 세 단계로 간단히 수행합니다. Redactor는 각 페이지를 스트리밍하므로 대용량 파일도 과도한 메모리를 사용하지 않고 효율적으로 처리됩니다. 이 방법은 원본 문서는 그대로 유지하면서 가린 버전이 보안 표준을 준수하도록 보장합니다.

단계 1: 문서 로드

Redactor 인스턴스로 PDF를 로드합니다:

using (Redactor redactor = new Redactor("path/to/your/document.pdf"))
{
    // Proceed with redactions.
}

설명: 생성자는 파일 경로와 선택적 로드 옵션을 받아 문서를 추가 작업을 위해 준비합니다.

단계 2: 가리기 정의 및 적용

숨길 텍스트와 교체 방식을 설명하는 TextRedaction 객체를 생성합니다:

// Create a text redaction instance specifying the text pattern.
TextRedaction textRedaction = new TextRedaction("sensitive-text", new ReplacementOptions("[REDACTED]"));

// Apply the redaction.
redactor.Apply(textRedaction);

설명: TextRedaction을 사용하면 정규식, 대소문자 구분 여부, “[REDACTED]”와 같은 교체 텍스트를 지정할 수 있습니다. 시각적 마스킹이 필요하면 검은색 오버레이를 선택할 수도 있습니다.

단계 3: 가린 문서 저장

변경 사항을 새 파일에 저장합니다:

redactor.Save("path/to/redacted/document.pdf");

설명: 저장하면 원본을 그대로 두고 새로운 PDF가 생성되며, 이는 감사 추적에 필수적입니다.

일반적인 문제와 해결책

Redactor.RedactAsync는 호출 스레드를 차단하지 않고 가리기 작업을 수행하는 비동기 메서드로, 대용량 문서의 확장 가능한 처리를 가능하게 합니다.

  • 가리기가 적용되지 않음: 정규식 패턴이 대상 텍스트와 정확히 일치하는지 확인하십시오. 대소문자 구분 없는 검색을 위해 RegexOptions.IgnoreCase를 사용합니다.
  • 대용량 PDF에서 성능 병목: 비동기 처리(Redactor.RedactAsync)를 활성화하고 Process.GetCurrentProcess().PrivateMemorySize64로 메모리를 모니터링합니다.
  • 스캔된 PDF에 OCR 누락: 가리기 규칙을 정의하기 전에 OcrOptions를 활성화하여 이미지를 검색 가능한 텍스트로 변환합니다.

실용적인 적용 사례

GroupDocs.Redaction for .NET은 다양한 실제 시나리오에서 뛰어납니다:

  1. 법률 문서 준비 – 초안을 공유하기 전에 클라이언트 식별자를 자동으로 제거합니다.
  2. 데이터 프라이버시 준수 – 매일 수천 개 파일에 대해 GDPR 또는 HIPAA 가리기 정책을 적용합니다.
  3. 재무 보고 – 실적 발표에서 계좌 번호와 독점적인 수치를 숨깁니다.

성능 고려 사항

  • 비동기 실행은 데스크톱 앱에서 UI 차단을 줄이고 웹 서비스의 처리량을 향상시킵니다.
  • 스트리밍 모드는 메모리 사용량을 낮게 유지합니다; 2 GB RAM VM에서도 1 GB PDF를 안전하게 처리할 수 있습니다.
  • 캐싱은 자주 사용되는 템플릿을 재파싱을 방지하고 배치 작업을 최대 40 % 가속합니다.

자주 묻는 질문

Q: 텍스트가 포함된 이미지를 가릴 수 있나요?
A: 예 – OcrOptions를 통해 OCR을 활성화하면 엔진이 래스터 이미지 내부의 텍스트를 인식하고 가리기를 적용합니다.

Q: GroupDocs.Redaction이 비밀번호로 보호된 PDF에서도 작동하나요?
A: 물론입니다. Redactor를 생성할 때 LoadOptions에 비밀번호를 제공하면 됩니다.

Q: 공식적으로 지원되는 .NET 버전은 무엇인가요?
A: .NET Framework 4.6+, .NET Core 3.1, .NET 5, .NET 6 및 이후 릴리스입니다.

Q: 가리기가 성공했는지 어떻게 확인하나요?
A: Redactor.ValidateRedaction 메서드를 사용하여 숨겨진 텍스트 잔여물이 없는지 확인합니다.

Q: PDF 폴더를 일괄 처리할 수 있나요?
A: 예 – Directory.GetFiles를 순회하고 각 파일에 대해 가리기 루틴을 비동기적으로 호출합니다.

리소스


마지막 업데이트: 2026-10-11
테스트 환경: GroupDocs.Redaction 23.12 for .NET
작성자: GroupDocs

관련 튜토리얼