XMLSignatureValidator  - AS3

Der Gültigkeitsstatus der kryptografischen Signatur, die aus dem SignedInfo-Element der Signatur berechnet wird.

Der Status ist:

• valid: Wenn die Signatur kryptographisch gültig ist.
• invalid: Wenn der Digest nach dem Signieren geändert wurde.
• unknown: Wenn die verify()-Methode nicht aufgerufen wurde.

Hinweis: Wenn der digestStatus ungültig ist, werden der identityStatus und der referencesStatus nicht überprüft und als unknown gemeldet.

Der Gültigkeitsstatus des signierenden Zertifikats.

Der Status kann sein:

• valid: Das Zertifikat ist nicht abgelaufen, hat die Rücknahmeüberprüfung bestanden und ist mit einem vertrauenswürdigen Stammzertifikat verbunden.
• unknown: Das Zertifikat ist nicht abgelaufen, hat die Rücknahmeüberprüfung bestanden, ist jedoch nicht mit einem vertrauenswürdigen Stammzertifikat verbunden. Der Statusunknown wird auch gemeldet, wenn der Status nicht überprüft wurde, weil entweder die verify()-Methode nicht aufgerufen wurde oder weil die kryptographische Signatur des SignedInfo-Elements (digestStatus) ungültig ist.
• invalid: Das Zertifikat ist abgelaufen oder hat eine Rücknahmeüberprüfung nicht bestanden.

Die über die addCertificate()-Methode hinzugefügten Zertifikate und die Einstellungen der revocationCheckSetting- und der useSystemTrustStore-Eigenschaft können ändern, ob ein Zertifikat als gültig betrachtet wird.

Hinweis: Wenn der identityStatus ungültig ist, wird der referencesStatus nicht überprüft und als unknown gemeldet. Außerdem werden Verweise nicht überprüft, wenn der identityStatus unbekannt ist, es sei denn, die referencesValidationSetting ist validOrUnknownIdentity.

Verwandte API-Elemente

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

Die isSupported-Eigenschaft hat den Wert true, wenn die XMLSignatureValidator-Klasse von der aktuellen Plattform unterstützt wird, andernfalls hat sie den Wert false.

Der Gültigkeitsstatus der Daten in den Verweisen im SignedInfo-Element der Signatur.

Der Status kann sein:

• valid: Wenn alle Verweise gültig sind.
• invalid: Wenn einer der Verweise ungültig ist.
• unknown: Wenn keine Überprüfung stattgefunden hat. Verweise können in den folgenden Situationen unüberprüft bleiben:
  • die verify()-Methode wurde nicht aufgerufen
  • die kryptographische Signatur des SignedInfo-Elements (digestStatus) ist ungültig.
  • das signierende Zertifikat (identityStatus) ist ungültig
  • referencesValidationSetting ist validIdentity (die Standardeinstellung) und der identityStatus des signierenden Zertifikats ist unbekannt.
  • die referencesValidationSetting ist never.

Wichtig: Externe Ressourcen werden nur überprüft, wenn sie direkt in einem SignedInfo-Element innerhalb des Signaturdokuments referenziert werden. Externe Ressourcen, auf die von einer sekundären Referenz verwiesen wird, werden nicht überprüft. Wenn z. B. eine XML-Signatur ein Manifest-Element signiert, wird nur die Integrität des Manifest-Elements selbst überprüft. Die im Manifest aufgelisteten Dateien werden nicht überprüft.

Verwandte API-Elemente

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

Gibt die Bedingungen an, unter denen Verweise überprüft werden.

Verwenden Sie Konstanten, die in der ReferencesValidationSetting-Klasse definiert sind, um die Eigenschaft festzulegen. Zu diesen Einstellungen gehören:

• ReferencesValidationSetting.VALID_IDENTITY: Verweise werden nur überprüft, wenn das signierende Zertifikat gültig und mit einem vertrauenswürdigen Stamm verkettet ist. Dies ist die Standardeinstellung.
• ReferencesValidationSetting.VALID_OR_UNKNOWN_IDENTITY: Verweise werden überprüft, wenn das signierende Zertifikat gültig ist, selbst wenn es nicht mit einem vertrauenswürdigen Stamm verkettet ist.
• ReferencesValidationSetting.NEVER: Verweise werden nie überprüft.

Verwenden Sie die Standardeinstellung (validIdentity) für Signaturen, die mit einem kommerziellen Zertifikat signiert sind, oder wenn Sie Ihr eigenes Zertifikat als Vertrauensanker über die addCertificate()-Methode bereitstellen. Durch diese Einstellung wird verhindert, dass Verweise überprüft werden, wenn das signierte Dokument sowieso abgelehnt wird.

Verwenden Sie die Einstellung validOrUnknownIdentity für Signaturen, die mit selbst signierten Zertifikaten signiert sind. Mit dieser Einstellung können Sie überprüfen, ob die signierten Daten unverändert sind, erhalten aber keine Garantie bezüglich der Identität des Signierers.

Verwenden Sie die Einstellung never, um zu verhindern, dass Verweise überprüft werden, wenn diese Überprüfung im Kontext Ihrer Anwendung unerheblich ist.

Verwandte API-Elemente

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

Gibt an, wie die Zertifikatrücknahme überprüft werden soll.

Legen Sie diese Eigenschaft mit Konstanten, die in der RevocationSettings-Klasse definiert sind, fest. Zu diesen Einstellungen gehören:

• RevocationCheckSettings.NEVER: Die Zertifikatrücknahme wird nicht überprüft.
• RevocationCheckSettings.BEST_EFFORT: Die Zertifikatrücknahme wird überprüft, wenn Rücknahmeinformationen zur Verfügung stehen und der Rücknahmestatus abgerufen werden kann. Wenn der Rücknahmestatus nicht ermittelt werden kann, wird das Zertifikat nicht zurückgewiesen.
• RevocationCheckSettings.REQUIRED_IF_AVAILABLE: Wenn das Zertifikat Rücknahmeinformationen enthält, muss zur Überprüfung des Zertifikats der Rücknahmestatus ermittelt werden.
• RevocationCheckSettings.ALWAYS_REQUIRED: Der Rücknahmestatus wird immer überprüft. Zertifikate ohne Rücknahmeinformationen werden abgelehnt.

Verwandte API-Elemente

Das Feld „Allgemeiner Name“ des signierenden Zertifikats.

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

Das Feld „Eindeutiger Name“ des signierenden Zertifikats.

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

Ein Array, das die OIDs für die erweiterte Tastenverwendung enthält, die im signierenden Zertifikat aufgeführt sind.

Jede erweiterte Tastenverwendung wird in numerischer OID-Form gemeldet.

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

Ein Array, das die Vertrauenseinstellungen des signierenden Zertifikats enthält.

Die Vertrauenseinstellungen werden aus dem System und den Schlüssel-IODs, die im Zertifikat eingebettet sind, abgeleitet. Konstanten für die Strings, die die erkannten Vertrauenseinstellungen repräsentieren, sind in der SignerTrustSettings-Klasse definiert.

Das signerTrustSettings-Array eines Zertifikats mit dem Status unknown oder invalid ist leer.

Das Verändern des Array hat keinen Einfluss auf die Vertrauenseinstellungen des Zertifikats.

Verwandte API-Elemente

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

Die IURIDereferencer-Implementierung.

Eine IURIDereferencer-Implementierung muss bereitgestellt werden, bevor eine Signatur überprüft wird.

Verwandte API-Elemente

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

Gibt an, dass Zertifikate im Vertrauensspeicher des Systems für die Kettenbildung verwendet werden.

Ist der Wert true, werden die Vertrauensanker im Vertrauensspeicher des Systems als vertrauenswürdige Stämme verwendet. Der Vertrauensspeicher des Systems wird standardmäßig nicht verwendet.

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

Der Gültigkeitsstatus einer überprüften XML-Signatur.

Die XML-Signatur wird überprüft, indem die kryptographische Signatur des SignedInfo-Elements, das signierende Zertifikat und die Daten, auf die die Referenzen im SignedInfo-Element verweisen, überprüft werden. Die Gültigkeit jedes dieser Elemente wird einzeln über die digestStatus-, die identityStatus()- bzw. die referencesStatus-Eigenschaft gemeldet.

XML-Signaturen können gültig oder ungültig sein oder ihre Gültigkeit ist unbekannt. Der Gesamtstatus richtet sich nach dem Verifizierungsstatus der einzelnen Komponenten der Signaturdatei:

• digestStatus: Die Gültigkeit der kryptographischen Signatur, die über das SignedInfo-Element berechnet wird.
• identityStatus: Die Gültigkeit des signierenden Zertifikats.
• referencesStatus: Die Gültigkeit des Digests der Verweise im SignedInfo-Element der Signatur.

Die von der validityStatus-Eigenschaft gemeldete Signaturgültigkeit kann folgende Werte aufweisen:

• valid, wenn referencesStatus, digestStatus und identityStatus alle valid sind.
• invalid, wenn einer der Status invalid ist.
• unknown: Wenn einer der Status unknown ist.

Verwandte API-Elemente

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

Erstellt ein neues XMLSignatureValidator-Objekt.

Sie müssen die uriDereferencer-Eigenschaft einstellen, bevor Sie die verify()-Methode des neuen Objekts aufrufen.

Verwandte API-Elemente

 
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);

Fügt ein x509-Zertifikat für die Kettenbildung hinzu.

Das hinzugefügte Zertifikat muss ein DER-kodiertes x509-Zertifikat sein.

Wenn der trusted-Parameter den Wert true hat, wird das Zertifikat als Vertrauensanker angesehen.

Hinweis: Eine XML-Signatur kann Zertifikate zum Bilden der Zertifikatkette des Unterzeichners enthalten. Die XMLSignatureValidator-Klasse verwendet diese Zertifikate zur Kettenbildung, aber nicht als vertrauenswürdige Stämme (standardmäßig).

Parameter

 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);

Überprüft die angegebene Signatur.

Die Überprüfung ist asynchron. Das XMLSignatureValidator-Objekt löst ein complete-Ereignis aus, wenn die Überprüfung erfolgreich abgeschlossen wird bzw. ein error-Ereignis, wenn die Überprüfung aufgrund von Fehlern nicht abgeschlossen werden kann.

Der Überprüfungsprozess kann nicht abgebrochen werden. Wenn gerade ein Überprüfungsprozess ausgeführt wird, schlagen anschließende Aufrufe der verify()-Methode fehl. Nach der aktuellen Überprüfung können Sie die verify()-Methode erneut aufrufen.

Hinweis: Da der XMLSignatureValidator nur einen Teilsatz der W3C-Empfehlung für die Syntax und Verarbeitung von XML-Signaturen implementiert, können nicht alle gültigen XML-Signaturen überprüft werden.

Parameter

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 );

Wird ausgelöst, wenn die Überprüfung abgeschlossen ist.

Ein complete-Ereignis bedeutet nicht, dass die Signatur gültig ist. Überprüfen Sie die validityStatus-Eigenschaft des XMLSignatureValidator-Objekts, um das Ergebnis der Signaturüberprüfung zu ermitteln.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

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);    
}

Verwandte API-Elemente

Wird ausgelöst, wenn die Überprüfung aufgrund von Fehlern nicht abgeschlossen werden kann.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

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