XMLSignatureValidator  - AS3

Stan ważności podpisu kryptograficznego obliczonego na podstawie elementu SignedInfo podpisu.

Możliwe stany:

• valid — jeśli podpis jest ważny pod względem kryptograficznym.
• invalid — jeśli skrót został zmodyfikowany po podpisaniu.
• unknown — jeśli nie wywołano metody verify().

Uwaga: Jeśli właściwość digestStatus ma wartość invalid, wówczas statusy identityStatus i referencesStatus nie są sprawdzane i odpowiednie właściwości będą miały wartości unknown.

Stan ważności certyfikatu podmiotu podpisującego.

Możliwe stany:

• valid — nie upłynął termin ważności certyfikatu, łańcuch certyfikatu prowadzi do zaufanego certyfikatu głównego, a sprawdzenie, czy certyfikat nie został unieważniony, zakończyło się pozytywnie.
• unknown — nie upłynął termin ważności certyfikatu, sprawdzenie, czy certyfikat nie został unieważniony, zakończyło się pozytywnie, ale łańcuch certyfikatu nie prowadzi do zaufanego certyfikatu głównego. Stan unknown zostanie również zgłoszony, jeśli stan nie został jeszcze zweryfikowany, ponieważ niw wywołano metody verify() lub podpis kryptograficzny elementu SignedInfo (digestStatus) jest nieważny.
• invalid — upłynął termin ważności certyfikatu lub sprawdzenie, czy certyfikat nie został unieważniony, zakończyło się negatywnie.

Certyfikaty dodane za pomocą metody addCertificate() i ustawienia właściwości revocationCheckSetting oraz useSystemTrustStore mogą wpłynąć na ważność certyfikaty.

Uwaga: Jeśli status identityStatus ma wartość invalid, status referencesStatus nie jest sprawdzany i odpowiednia właściwość ma wartość unknown. Ponadto odwołania nie są sprawdzane, gdy status identityStatus ma wartość unknown, chyba że właściwość referencesValidationSetting jest ustawiona na validOrUnknownIdentity.

Powiązane elementy interfejsu API

 import flash.security.XMLSignatureValidator;
 
 
 var verifier:XMLSignatureValidator = new XMLSignatureValidator();
 //validate a signature...
  
 var identityResult:String = verifier.identityStatus;

Właściwość isSupported ma wartość true, jeśli na bieżącej platformie jest obsługiwana klasa XMLSignatureValidator; w przeciwnym razie ma wartość false.

Stan ważności danych w odniesieniach w elemencie SignedInfo podpisu.

Możliwe stany:

• valid — jeśli wszystkie odwołania są ważne.
• invalid — jeśli którekolwiek odwołanie jest nieważne.
• unknown — jeśli niezweryfikowane. Odwołania mogą pozostać niezweryfikowane w następujących okolicznościach:
  • Nie wywołano metody verify().
  • Podpis kryptograficzny elementu SignedInfo (digestStatus) jest nieważny.
  • Certyfikat używany do podpisywania (identityStatus) jest nieważny.
  • Ustawienie referencesValidationSetting ma wartość validIdentity (wartość domyślna) i status identityStatus certyfikatu używanego do podpisywania jest nieznany (unknown).
  • Ustawienie referencesValidationSetting ma wartość never.

Ważne: Zewnętrzne zasoby nie są sprawdzane, jeśli element SignedInfo w dokumencie podpisu nie zawiera bezpośrednich odwołań do tych zasobów. Zasoby zewnętrzne będące celami odwołań pośrednich nie są sprawdzane. Na przykład, jeśli podpis XML został użyty do podpisania elementu manifest, sprawdzana jest integralność tylko elementu manifest. Pliki wymienione w manifeście nie są sprawdzane.

Powiązane elementy interfejsu API

 import flash.security.XMLSignatureValidator;
 
 var verifier:XMLSignatureValidator = new XMLSignatureValidator();
 //validate a signature...
  
 var dataResult:String = verifier.referencesStatus;

Określa warunki sprawdzania odniesień.

Do ustawiania tej właściwości należy używać stałych zdefiniowanych w klasie ReferencesValidationSetting. Są to następujące ustawienia:

• ReferencesValidationSetting.VALID_IDENTITY — sprawdzaj odwołania tylko wtedy, gdy certyfikat używany do podpisywania jest ważny, a jego łańcuch prowadzi do zaufanego certyfikatu głównego. Jest to ustawienie domyślne.
• ReferencesValidationSetting.VALID_OR_UNKNOWN_IDENTITY — sprawdzaj odwołania, jeśli certyfikat używany do podpisywania jest ważny, nawet jeśli jego łańcuch nie prowadzi do zaufanego certyfikatu głównego.
• ReferencesValidationSetting.NEVER — nigdy nie sprawdzaj odwołań.

Domyślne ustawienie validIdentity powinno być używane w przypadku podpisów podpisanych certyfikatem komercyjnym lub w przypadku udostępnienia za pomocą metody addCertificate() własnego certyfikatu będącego początkiem łańcucha zaufania. To ustawienie pozwala uniknąć narzutu sprawdzania poprawności odwołań w sytuacji, gdy podpisany dokument i tak zostanie odrzucony.

Ustawienia validOrUnknownIdentity należy używać z podpisami podpisanymi za pomocą certyfikatów samopodpisanych. To ustawienie umożliwia sprawdzenie, czy podpisane dane nie zostały zmodyfikowane, ale nie gwarantuje tożsamości podmiotu podpisującego.

Ustawienie never umożliwia uniknięcia narzutu sprawdzania poprawności odwołań, gdy takie sprawdzanie nie jest istotne w kontekście aplikacji.

Powiązane elementy interfejsu API

 import flash.security.ReferencesValidationSetting;
 
 var verifier:XMLSignatureValidator = new XMLSignatureValidator(); 
 verifier.referencesValidationSetting = ReferencesValidationSetting.VALID_OR_UNKNOWN_IDENTITY;

Określa sposób sprawdzania, czy certyfikat nie został unieważniony.

Do ustawiania tej właściwości należy używać stałych zdefiniowanych w klasie RevocationSettings. Są to następujące ustawienia:

• RevocationCheckSettings.NEVER — nie sprawdzaj, czy certyfikat został unieważniony.
• RevocationCheckSettings.BEST_EFFORT — sprawdzaj, czy certyfikat został unieważniony, o ile informacje o unieważnieniu są dostępne i jest możliwe uzyskanie statusu unieważnienia. Jeśli nie jest możliwe jednoznaczne stwierdzenie statusu unieważnienia, certyfikat nie jest odrzucany.
• RevocationCheckSettings.REQUIRED_IF_AVAILABLE — jeśli certyfikat zawiera informacje o unieważnieniu, do zweryfikowania certyfikatu wymagane jest jednoznaczne ustalenie statusu unieważnienia.
• RevocationCheckSettings.ALWAYS_REQUIRED — zawsze sprawdzaj, czy certyfikat jest unieważniony. Certyfikaty bez informacji o unieważnieniu są odrzucane.

Powiązane elementy interfejsu API

Pole Common Name certyfikatu podmiotu podpisującego.

 
 var verifier:XMLSignatureValidator = new XMLSignatureValidator();
 //validate a signature...
  
 var commonName:String = verifier.signerCN;

Pole Distinguished Name certyfikatu podmiotu podpisującego.

 
 var verifier:XMLSignatureValidator = new XMLSignatureValidator();
 //validate a signature...
  
 var distinguishedName:String = verifier.signerDN;

Tablica zawierająca identyfikatory OID Extended Key Usages wymienione w certyfikacie podmiotu podpisującego.

Informacje Extended Key Usage są przekazywane w postaci liczbowych identyfikatorów OID.

 import flash.security.XMLSignatureValidator;
 
 var verifier:XMLSignatureValidator = new XMLSignatureValidator();
 //validate a signature...
  
 var extendedKeyOIDs:Array = verifier.signerExtendedKeyUsages;

Tablica zawierająca ustawienia zaufania certyfikatu podmiotu podpisującego.

Ustawienia zaufania są określane na podstawie ustawień systemowych i identyfikatorów OID wykorzystania klucza osadzonych w certyfikacie. Stałe ciągi znaków reprezentujące rozpoznawane ustawienia zaufania są zdefiniowane w klasie SignerTrustSettings.

Tablica signerTrustSettings certyfikatu o stanie unknown lub invalid jest pusta.

Zmodyfikowanie tablicy nie zmienia ustawień zaufania certyfikatu.

Powiązane elementy interfejsu API

 import flash.security.XMLSignatureValidator;
 
 var verifier:XMLSignatureValidator = new XMLSignatureValidator();
 //validate a signature...
  
 var certificateTrustedFor:Array = verifier.signerTrustSettings;

Implementacja interfejsu IURIDereferencer.

Przed próbą zweryfikowania podpisu należy udostępnić implementację interfejsu IURIDereferencer.

Powiązane elementy interfejsu API

 import com.example.SignedMessageDereferencer; //A custom class implementing IURIDereferencer
 
 var verifier:XMLSignatureValidator = new XMLSignatureValidator(); 
 verifier.uriDereferencer = new SignedMessageDereferencer();

Określa, że do budowania łańcucha mają być używane certyfikaty z systemowego magazynu certyfikatów zaufanych.

Wartość true powoduje, że w charakterze zaufanych certyfikatów głównych są używane certyfikaty z systemowego magazynu certyfikatów zaufanych. Domyślnie systemowy magazyn certyfikatów zaufanych nie jest używany.

 var verifier:XMLSignatureValidator = new XMLSignatureValidator(); 
 verifier.useSystemTrustStore = true;

Stan ważności zweryfikowanego podpisu XML.

Weryfikacja podpisu XML polega na zweryfikowaniu podpisu kryptograficznego elementu SignedInfo, certyfikatu używanego do podpisywania oraz danych adresowanych przez odwołania w elemencie SignedInfo. Ważność każdego z tych elementów jest zgłaszana odpowiednio we właściwościach digestStatus, identityStatus() oraz referencesStatus.

Podpis XML może być ważny, nieważny lub nieznany. Ogólny stan zależy od stanu weryfikacji poszczególnych składników pliku podpisu:

• digestStatus — ważność podpisu kryptograficznego obliczonego na podstawie elementu SignedInfo.
• identityStatus — ważność certyfikatu podmiotu podpisującego.
• referencesStatus — ważność skrótu odwołań w elemencie SignedInfo.

Ważność podpisu określona we właściwości validityStatus może być wyrażona wartościami:

• valid — jeśli stany składników referencesStatus, digestStatus i identityStatus są równe wartości valid.
• invalid — jeśli którykolwiek stan jest równy wartości invalid.
• unknown — jeśli którykolwiek status jest równy wartości unknown.

Powiązane elementy interfejsu API

 import flash.security.XMLSignatureValidator;
 
 var verifier:XMLSignatureValidator = new XMLSignatureValidator();
 //validate the signature...
  
 var validationResult:String = verifier.validityStatus;

Tworzy obiekt XMLSignatureValidator.

Należy ustawić właściwość uriDereferencer przed wywołaniem metody verify() nowego obiektu.

Powiązane elementy interfejsu API

 
import com.example.EnvelopedDereferencer; //Your custom IURIDereferencer implementation

//Create the object
var verifier:XMLSignatureValidator = new XMLSignatureValidator();

//Provide the IURIDerferencer
verifier.uriDereferencer = new EnvelopedDereferencer(xmlDoc);

//Set validation options
verifier.referencesValidationSetting = ReferencesValidationSetting.VALID_OR_UNKNOWN_IDENTITY;
verifier.revocationCheckSetting = RevocationCheckSettings.NEVER;
verifier.useSystemTrustStore = true;

//Add listeners to handle results
verifier.addEventListener(Event.COMPLETE, verificationComplete);
verifier.addEventListener(ErrorEvent.ERROR, verificationError);

Dodaje certyfikat x509 potrzebny do zbudowania łańcucha.

Dodawany certyfikat musi być certyfikatem x509 zakodowanym w standardzie DER.

Jeśli parametr trusted ma wartość true, certyfikat jest uznawany za początek łańcucha zaufania.

Uwaga: Podpis XML może zawierać certyfikaty służące do budowania łańcucha certyfikatów podmiotu podpisującego. Klasa XMLSignatureValidator używa tych certyfikatów do budowania łańcucha, ale nie jako zaufanych certyfikatów głównych (domyślnie).

Parametry

 import flash.utils.ByteArray;
 
 var verifier:XMLSignatureValidator = new XMLSignatureValidator();
 var certificate:ByteArray = new ByteArray();
 
 var certFile:File = new File("certificate.cer");
 var certFileStream:FileStream = new FileStream();
 certFileStream.open(certFile, FileMode.READ);
 certFileStream.readBytes(certificate, 0, certFileStream.bytesAvailable);

 verifier.addCertificate(certificate, true);

Weryfikuje określony podpis.

Weryfikacja przebiega asynchronicznie. Obiekt XMLSignatureValidator wywołuje zdarzenie complete po pomyślnym zakończeniu weryfikacji albo zdarzenie error, jeśli weryfikacji nie można ukończyć z powodu błędów.

Procesu weryfikacji nie można anulować. W trakcie weryfikacji kolejne wywołania metody verify() kończą się niepowodzeniem. Po zakończeniu bieżącej weryfikacji można ponownie wywołać metodę verify().

Uwaga: Ponieważ klasa XMLSignatureValidator implementuje tylko podzbiór zaleceń W3C w zakresie składni i przetwarzania podpisów XML, nie wszystkie formalnie poprawne podpisy XML można zweryfikować.

Parametry

import flash.filesystem.File;
import flash.filesystem.FileStream;
import com.example.SignedMessageDereferencer; //Your IURIDereferencer implementation
 
const xmlSignatureNS:Namespace = new Namespace( "http://www.w3.org/2000/09/xmldsig#" );

var verifier:XMLSignatureValidator = new XMLSignatureValidator();
verifier.uriDereferencer = new SignedMessageDereferencer();

var signatureFile:File = new File( "path/to/XMLSignatureDocument.xml" );
var sigFileStream:FileStream = new FileStream();
sigFileStream.open( signatureFile, FileMode.READ );

var xmlDoc:XML = XML( sigFileStream.readUTFBytes(sigFileStream.bytesAvailable) );
var xmlSig:XML = XML( xmlDoc..xmlSignatureNS::Signature );

verifier.verify( xmlSig );

Wywoływane po ukończeniu weryfikacji.

Zdarzenie complete nie oznacza, że podpis jest ważny. W celu określenia wyniku weryfikacji podpisu należy sprawdzić wartość właściwości validityStatus obiektu XMLSignatureValidator.

To zdarzenie ma następujące właściwości:

private function verificationComplete(event:Event):void{
    var validator:XMLSignatureValidator = event.target as XMLSignatureValidator;
    trace("Digest status: " + validator.digestStatus);
    trace("Identity status: " + validator.identityStatus);
    trace("Reference status: " + validator.referencesStatus);
    trace("Signature status: " + validator.validityStatus);    
}

Powiązane elementy interfejsu API

Wywoływane, jeśli weryfikacji nie można ukończyć z powodu błędów.

To zdarzenie ma następujące właściwości:

private function verificationError(event:ErrorEvent):void{
    trace("Verification error: " + event.text);                
}