소개

디지털 서명은 현대 비즈니스 프로세스에서 문서의 진위성, 무결성, 그리고 부인 방지를 보장하는 데 중요한 역할을 합니다. 기존의 수기 서명과 달리, 디지털 서명은 암호화 기술을 사용하여 서명자의 신원을 확인하고 서명 이후 문서가 변경되지 않았음을 보장합니다.

GroupDocs.Signature for .NET은 개발자가 .NET 애플리케이션에서 강력한 디지털 서명 검증을 구현할 수 있도록 포괄적인 툴킷을 제공합니다. 이 자세한 튜토리얼에서는 GroupDocs.Signature for .NET을 사용하여 문서 내 디지털 서명을 검증하는 과정을 안내합니다.

필수 조건

디지털 서명 검증 기능을 구현하기 전에 다음 필수 구성 요소가 있는지 확인하세요.

  1. .NET용 GroupDocs.Signature: 라이브러리를 다운로드하고 설치하세요. .NET 릴리스용 GroupDocs.Signature.
  2. .NET 개발 환경: Visual Studio 또는 호환되는 .NET 개발 환경.
  3. 디지털 인증서: 문서 서명에 사용된 디지털 인증서 파일(예: .pfx)이거나 신뢰할 수 있는 체인에 속하는 인증서입니다.
  4. 검증용 문서: 검증이 필요한 디지털 서명이 포함된 문서입니다.

필수 네임스페이스 가져오기

GroupDocs.Signature 기능에 액세스하는 데 필요한 네임스페이스를 가져오는 것부터 시작합니다.

using System;
using GroupDocs.Signature;
using GroupDocs.Signature.Domain;
using GroupDocs.Signature.Options;

디지털 서명을 검증하는 과정을 명확하고 관리하기 쉬운 단계로 나누어 보겠습니다.

1단계: 문서 경로 지정

// 디지털 서명이 포함된 문서 경로
string filePath = "sample_multiple_signatures.docx";

예시 경로를 디지털 서명이 포함된 문서의 실제 경로로 바꾸세요.

2단계: 서명 개체 초기화

// 문서 경로를 전달하여 Signature 클래스 인스턴스를 생성합니다.
using (Signature signature = new Signature(filePath))
{
    // 여기에 검증코드가 구현됩니다
}

Signature 클래스는 GroupDocs.Signature API의 모든 작업에 대한 주요 진입점입니다.

3단계: 디지털 확인 옵션 구성

// 설정 확인 옵션
DigitalVerifyOptions options = new DigitalVerifyOptions("YourSignature.pfx")
{
    Contact = "Mr.Smith",     // 예상 서명자 연락
    Password = "1234567890",  // 필요한 경우 인증서 비밀번호
    AllPages = true           // 모든 페이지에서 서명을 확인하세요
};

검증 옵션을 사용하면 다음을 지정할 수 있습니다.

  • 디지털 인증서 파일 경로
  • 예상 서명자 연락처 정보
  • 인증서가 암호로 보호된 경우 해당 인증서의 암호
  • 확인할 페이지 범위(기본적으로 모든 페이지)

4단계: 검증 프로세스 실행

// 검증을 수행하다
VerificationResult result = signature.Verify(options);

이는 귀하가 지정한 옵션에 따라 검증 프로세스를 실행합니다.

5단계: 프로세스 검증 결과

// 검증 결과를 확인하고 그에 따라 처리하세요
if (result.IsValid)
{
    Console.WriteLine($"Document {filePath} contains valid digital signatures!");
    
    // 유효한 서명의 세부 정보 표시
    foreach (DigitalSignature digitalSignature in result.Succeeded)
    {
        Console.WriteLine($"\nValid signature found:");
        Console.WriteLine($"Signer: {digitalSignature.Subject}");
        Console.WriteLine($"Issuer: {digitalSignature.Issuer}");
        Console.WriteLine($"Valid From: {digitalSignature.ValidFrom}");
        Console.WriteLine($"Valid To: {digitalSignature.ValidTo}");
    }
}
else
{
    Console.WriteLine($"Document {filePath} failed verification process.");
    
    // 필요한 경우 실패한 서명에 대한 정보를 표시합니다.
    foreach (DigitalSignature failedSignature in result.Failed)
    {
        Console.WriteLine($"Failed signature reason: {failedSignature.Comments}");
    }
}

이 코드는 검증이 성공했는지 확인하고 검증된 서명에 대한 자세한 정보를 제공합니다.

완전한 예

디지털 서명 검증을 보여주는 완전한 작동 예는 다음과 같습니다.

using System;
using GroupDocs.Signature;
using GroupDocs.Signature.Domain;
using GroupDocs.Signature.Options;

namespace GroupDocs.Signature.Examples
{
    class Program
    {
        static void Main(string[] args)
        {
            // 문서 경로
            string filePath = "sample_multiple_signatures.docx";
            
            try
            {
                // Signature 인스턴스 초기화
                using (Signature signature = new Signature(filePath))
                {
                    // 설정 확인 옵션
                    DigitalVerifyOptions options = new DigitalVerifyOptions("YourSignature.pfx")
                    {
                        Contact = "Mr.Smith",
                        Password = "1234567890"
                    };
                    
                    // 문서 서명 확인
                    VerificationResult result = signature.Verify(options);
                    
                    // 프로세스 검증 결과
                    if (result.IsValid)
                    {
                        Console.WriteLine($"Document {filePath} contains valid digital signatures!");
                        
                        foreach (DigitalSignature item in result.Succeeded)
                        {
                            Console.WriteLine($"\nValid signature found.");
                            Console.WriteLine($"Subject: {item.Subject}");
                            Console.WriteLine($"Comments: {item.Comments}");
                            Console.WriteLine($"Sign Time: {item.SignTime}");
                        }
                    }
                    else
                    {
                        Console.WriteLine($"\nDocument {filePath} failed verification process.");
                    }
                }
            }
            catch (Exception ex)
            {
                Console.WriteLine($"Error: {ex.Message}");
            }
        }
    }
}

고급 검증 시나리오

GroupDocs.Signature는 더욱 복잡한 검증 시나리오에 대한 추가 옵션을 제공합니다.

여러 디지털 서명 확인

// 검증 옵션 목록 만들기
List<VerifyOptions> listOptions = new List<VerifyOptions>();

// 첫 번째 인증서 확인 옵션 추가
listOptions.Add(new DigitalVerifyOptions("Certificate1.pfx")
{
    Contact = "John Smith"
});

// 두 번째 인증서 확인 옵션 추가
listOptions.Add(new DigitalVerifyOptions("Certificate2.pfx")
{
    Contact = "Jane Doe"
});

// 여러 옵션으로 확인
VerificationResult result = signature.Verify(listOptions);

특정 페이지의 서명 확인

// 첫 번째 페이지에서만 디지털 서명을 확인하세요
DigitalVerifyOptions options = new DigitalVerifyOptions("YourSignature.pfx")
{
    AllPages = false,
    PageNumber = 1
};

타임스탬프 및 인증 기관 검증 사용

DigitalVerifyOptions options = new DigitalVerifyOptions("YourSignature.pfx")
{
    ValidateTimeStampOnly = true,   // 타임스탬프만 검증합니다
    CertificateAuth = CertificateAuthType.Standard  // 서명자의 인증서를 검증합니다
};

디지털 서명 검증을 위한 모범 사례

  1. 적절한 인증서 관리: 인증서 파일을 안전하게 저장하고 비밀번호를 적절하게 관리하세요.
  2. 인증서 검증: 인증서 자체가 유효한지 확인하기 위해 인증서 체인 검증을 구현합니다.
  3. 오류 처리: 검증 실패를 원활하게 관리하기 위해 강력한 오류 처리를 구현합니다.
  4. 로깅: 감사 및 규정 준수 목적으로 검증 시도와 결과를 기록합니다.
  5. 정기적인 인증서 업데이트: 인증서가 만료되기 전에 업데이트하세요.

일반적인 문제 해결

유효하지 않은 인증서

  • 인증서 파일 경로가 올바른지 확인하세요
  • 인증서 비밀번호가 올바른지 확인하세요
  • 인증서가 만료되었는지 확인하세요

서명을 찾을 수 없습니다

  • 문서에 실제로 디지털 서명이 포함되어 있는지 확인하세요
  • 올바른 페이지를 확인하고 있는지 확인하세요

검증 실패

  • 서명 후 문서가 수정되었는지 확인하세요
  • 서명자의 인증서가 신뢰할 수 있는 인증서 체인에 있는지 확인하세요.

결론

GroupDocs.Signature for .NET은 문서 내 디지털 서명을 검증하는 강력하고 유연한 솔루션을 제공합니다. 이 단계별 가이드를 따라 .NET 애플리케이션에서 강력한 디지털 서명 검증을 구현하여 문서의 신뢰성과 무결성을 보장할 수 있습니다.

디지털 서명 검증은 현대 비즈니스 환경에서 안전한 문서 워크플로우의 핵심 요소입니다. GroupDocs.Signature를 사용하면 다양한 검증 시나리오를 처리하는 포괄적인 API를 활용하여 최소한의 노력으로 이 기능을 확실하게 구현할 수 있습니다.

자주 묻는 질문

GroupDocs.Signature는 Adobe Acrobat을 사용하여 서명된 PDF 문서의 서명을 확인할 수 있나요?

네, GroupDocs.Signature는 Adobe Acrobat 및 기타 호환 PDF 소프트웨어로 만든 PDF 문서의 표준 디지털 서명을 확인할 수 있습니다.

GroupDocs.Signature는 문서 타임스탬프 검증을 지원합니까?

네, API는 디지털 서명 검증 프로세스의 일부로 문서 타임스탬프를 검증하는 옵션을 제공합니다.

여러 페이지로 된 문서의 특정 페이지에 있는 서명을 확인할 수 있나요?

네, 전체 문서가 아닌 특정 페이지의 서명만 확인하도록 검증 옵션을 구성할 수 있습니다.

GroupDocs.Signature는 단일 문서 내에서 여러 서명의 검증을 지원합니까?

네, GroupDocs.Signature는 단일 문서 내에서 여러 디지털 서명을 검증하고 각 서명에 대한 자세한 결과를 제공할 수 있습니다.

서로 다른 인증기관의 인증서로 생성된 서명을 검증할 수 있나요?

네, GroupDocs.Signature는 신뢰할 수 있는 인증서 체인에 있는 한 다양한 인증 기관의 인증서로 생성된 서명의 검증을 지원합니다.

관련 자료