XML 서명 유효성 검사의 기초

Adobe AIR 1.5 이상

XML 서명의 유효성 검사에 대한 간략한 설명과 코드 예제를 보려면 Adobe Developer Connection의 다음 퀵 스타트 문서를 참조하십시오.

Adobe® AIR®는 XML 서명의 유효성을 검사하는 데 사용되는 XMLSignatureValidator 클래스 및 IURIDereferencer 인터페이스를 제공합니다. XMLSignatureValidator 클래스에서 사용할 수 있는 XML 구문은 XML 서명 구문 및 처리를 위한 W3C 권장 사항의 하위 집합입니다. (권장 사항의 하위 집합만 지원되므로 합법적인 서명을 모두 유효성 검사할 수 있는 것은 아닙니다.) AIR에서는 XML 서명을 만들기 위한 API를 제공하지 않습니다.

XML 서명 유효성 검사 클래스

XML 서명 유효성 검사 API에는 다음과 같은 클래스가 포함되어 있습니다.

패키지

클래스

flash.security

XMLSignatureValidator 문자열 상수는 다음과 같은 클래스에서 정의됩니다.

flash.events

XML 서명 유효성 검사 클래스 사용

XMLSignatureValidator 클래스를 사용하여 XML 서명의 유효성을 검사하려면 다음과 같은 작업을 수행해야 합니다.

  • XMLSignatureValidator 객체를 만듭니다.

  • IURIDereferencer 인터페이스의 구현을 제공합니다. XMLSignatureValidator 객체에서 IURIDereferencer dereference() 메서드를 호출하여 서명의 각 참조에 대한 URI를 전달합니다. dereference() 메서드는 URI를 확인하고 참조된 데이터(서명과 동일한 문서 또는 외부 리소스에 포함되어 있을 수 있음)를 반환해야 합니다.

  • 응용 프로그램에 적합한 XMLSignatureValidator 객체의 인증서 신뢰, 해지 확인 및 참조 유효성 검사 설정을 설정합니다.

  • complete 및 error 이벤트에 대한 이벤트 리스너를 추가합니다.

  • verify() 메서드를 호출하여 유효성을 검사할 서명을 전달합니다.

  • complete 및 error 이벤트를 처리하고 결과를 해석합니다.

다음 예제에서는 XML 서명의 유효성을 검사하는 validate() 함수를 구현합니다. 서명 인증서가 시스템 신뢰 저장소에 있거나 신뢰 저장소의 인증서에 체인으로 연결되도록 XMLSignatureValidator 속성을 설정합니다. 또한 예제에서는 이름이 XMLDereferencer 인 적합한 IURIDereferencer 클래스가 있다고 가정합니다. 

private function validate( xmlSignature:XML ):void 
{ 
    var verifier:XMLSignatureValidator = new XMLSignatureValidator(); 
    verifier.addEventListener(Event.COMPLETE, verificationComplete); 
    verifier.addEventListener(ErrorEvent.ERROR, verificationError); 
    try 
    { 
        verifier.uriDereferencer = new XMLDereferencer(); 
 
        verifier.referencesValidationSetting = 
            ReferencesValidationSetting.VALID_IDENTITY; 
        verifier.revocationCheckSetting = RevocationCheckSettings.BEST_EFFORT; 
        verifier.useSystemTrustStore = true; 
         
        //Verify the signature 
        verifier.verify( xmlSignature ); 
    } 
    catch (e:Error) 
        { 
            trace("Verification error.\n" + e); 
        } 
} 
 
//Trace verification results 
private function verificationComplete(event:Event):void 
 
    var signature:XMLSignatureValidator = event.target as XMLSignatureValidator; 
    trace("Signature status: " + signature.validityStatus + "\n"); 
    trace("  Digest status: " + signature.digestStatus + "\n"); 
    trace("  Identity status: " + signature.identityStatus + "\n"); 
    trace("  Reference status: " + signature.referencesStatus + "\n"); 
} 
 
private function verificationError(event:ErrorEvent):void 
{ 
    trace("Verification error.\n" + event.text);                 
}

XML 서명 유효성 검사 프로세스

XMLSignatureValidator verify() 메서드를 호출할 때 AIR에서는 다음 단계를 수행합니다.

  • 서명 인증서의 공개 키를 사용하여 서명의 암호화 무결성을 확인합니다.

  • XMLSignatureValidator 객체의 현재 설정을 기반으로 하여 인증서의 암호화 무결성, ID 및 신뢰성을 설정합니다.

    서명 인증서에 설정된 신뢰는 유효성 검사 프로세스 무결성의 핵심 요소입니다. 서명 유효성 검사는 올바르게 정의된 암호화 프로세스를 사용하여 수행되지만 서명 인증서의 신뢰성은 알고리즘 방식으로 내릴 수 없는 판단입니다.

    일반적으로 다음과 같은 세 가지 방법으로 인증서를 신뢰할 수 있는지 여부를 판단할 수 있습니다.

    • 인증 기관 및 운영 체제 신뢰 저장소 사용

    • 서명자에게서 직접 인증서 복사본, 인증서의 신뢰 앵커로 사용되는 다른 인증서 또는 공개 키와 같이 인증서를 안정적으로 식별할 수 있는 정보 가져오기

    • 응용 프로그램의 최종 사용자에게 인증서를 신뢰하는지 여부 문의 인증서에 있는 식별 정보를 원래 신뢰할 수 없으므로 이러한 쿼리는 자체 서명된 인증서에 유효하지 않습니다.

  • 서명된 데이터의 암호화 무결성을 확인합니다.

    서명된 데이터는 IURIDereferencer 구현을 통해 확인합니다. 서명 문서의 각 참조에 대해 IURIDereferencer 구현 dereference() 메서드가 호출됩니다. dereference() 메서드에서 반환한 데이터를 사용하여 참조 다이제스트를 계산할 수 있습니다. 이 다이제스트 값은 서명 문서에 기록된 다이제스트와 비교됩니다. 다이제스트가 일치하는 경우 데이터는 서명된 이후 변경되지 않았습니다.

    XML 서명의 유효성 검사 결과를 사용할 때 중요하게 고려해야 할 하나의 사항은 서명한 항목만 안전하다는 것입니다. 예를 들어 패키지에 있는 파일을 나열하는 서명된 목록을 살펴보십시오. XMLSignatureValidator에서 서명을 확인할 때는 목록 자체가 변경되지 않았는지만 확인합니다. 파일에 있는 데이터에 서명하지 않았기 때문에 목록에서 참조하는 파일을 변경하거나 삭제하는 경우 계속 서명의 유효성을 검사합니다.

    참고: 이러한 목록에 있는 파일을 확인하기 위해 표시에서 사용하는 동일한 해시 알고리즘을 사용하여 파일 데이터의 다이제스트를 계산하고 결과를 서명된 표시에 저장된 다이제스트와 비교할 수 있습니다. 추가 파일의 존재 여부를 확인해야 하는 경우도 있습니다.

유효성 검사 결과 해석

유효성 검사 결과는 XMLSignatureValidator 객체의 상태 속성에 의해 보고됩니다. 이러한 속성은 유효성 검사기 객체에서 complete 이벤트를 전달한 후 읽을 수 있습니다. 네 가지 상태 속성에는 validityStatus , digestStatus , identityStatus 및 referencesStatus 가 있습니다.

validityStatus 속성

validityStatus 속성은 서명의 전체 유효성을 보고합니다. validityStatus 는 기타 세 가지 상태 속성의 상태에 따라 다르며 다음 값 중 하나를 가질 수 있습니다.

  • valid - digestStatus , identityStatus 및 referencesStatus 모두가 valid 인 경우

  • invalid - 개별 상태 속성 중 하나 이상이 invalid 인 경우

  • unknown — 개별 상태 속성 중 하나 이상이 unknown 이고 각 상태 중 하나도 invalid 가 아닌 경우

digestStatus 속성

digestStatus 속성은 메시지 다이제스트의 암호화 확인 결과를 보고합니다. digestStatus 속성은 다음 값 중 하나를 가질 수 있습니다.

  • valid - 서명 문서 자체가 서명 이후 변경되지 않은 경우

  • invalid — 서명 문서가 변경되거나 잘못된 경우

  • unknown - verify() 메서드가 오류 없이 완료되지 않은 경우

identityStatus 속성

identityStatus 속성은 서명 인증서의 상태를 보고합니다. 이 속성의 값은 다음과 같은 여러 요인에 따라 다릅니다.

  • 인증서의 암호화 무결성

  • 인증서가 만료 또는 해지되었는지 여부

  • 현재 시스템에서 인증서를 신뢰할 수 있는지 여부

  • XMLSignatureValidator 객체의 상태(예: 신뢰 체인을 구축하는 데 추가 인증서가 추가되었는지 여부, 이러한 인증서를 신뢰할 수 있는지 여부, useSystemTrustStore 및 revocationCheckSettings 속성의 값)

identityStatus 는 다음과 같은 값을 가질 수 있습니다.

  • valid - 서명 인증서가 유효한 것으로 간주되려면 다음 조건을 충족해야 합니다.

    • 서명 인증서를 변경하지 않아야 합니다.

    • 서명 인증서가 만료되거나 해지되지 않아야 합니다. 단, 서명에 유효한 타임스탬프가 있는 경우는 예외입니다. 서명에 타임스탬프가 있는 경우 인증서는 문서 서명 시 유효했던 경우 유효한 것으로 간주됩니다. 타임스탬프에 서명하기 위해 타임스탬프 서비스에서 사용하는 인증서는 사용자 컴퓨터에 있는 신뢰할 수 있는 루트 인증서에 연결되어야 합니다.

    • 서명 인증서를 신뢰합니다. 인증서가 시스템 신뢰 저장소에 있거나 시스템 신뢰 저장소의 다른 인증서에 체인으로 연결되어 있으며 useSystemTrustStore 속성을 true로 설정하는 경우 인증서를 신뢰합니다. 또한 XMLSignatureValidator 객체의 addCertificate() 메서드를 사용하여 인증서를 신뢰한 것으로 지정할 수 있습니다.

    • 사실 인증서는 서명 인증서입니다.

  • invalid - 인증서가 만료되었거나 해지되었습니다. 서명 시 유효성을 제공하는 타임스탬프가 없거나 인증서가 변경되었습니다.

  • unknown - 인증서가 잘못된 것은 아니지만 신뢰할 수 없습니다. 예를 들어 자체 서명된 인증서는 unknown 으로 보고됩니다(명시적으로 신뢰하지 않는 경우). verify() 메서드를 오류 없이 완료하지 않았거나 서명 다이제스트가 잘못되어 ID를 확인하지 않은 경우 identityStatus 도 unknown 으로 보고됩니다.

referencesStatus 속성

referencesStatus 속성은 서명의 SignedData 요소에 있는 참조의 암호화 무결성을 보고합니다.

  • valid - 서명에 있는 모든 참조의 계산된 다이제스트가 XML 서명에 기록된 해당 다이제스트와 일치하는 경우 valid 상태는 서명된 데이터가 변경되지 않았음을 나타냅니다.

  • invalid - 계산된 다이제스트가 서명에 있는 해당 다이제스트와 일치하지 않는 경우

  • unknown - 참조 다이제스트를 확인하지 않은 경우 전체 서명 다이제스트가 invalid 이거나 서명 인증서가 잘못된 경우 참조를 확인하지 않습니다. identityStatus 가 unknown 인 경우 참조는 referencesValidationSetting 이 validOrUnknown 인 경우에만 확인됩니다.