XMLSignatureValidator  - AS3

Giltigheten hos signaturens kryptografi beräknad över signaturens SignedInfo-element.

Statusen är:

• valid — Om signaturen är kryptografiskt giltig.
• invalid — Om sammanfattningen har ändrats efter signering.
• unknown — Om verify()-metoden inte har anropats.

Obs! Om digestStatus är ogiltigt kontrolleras inte identityStatus och referencesStatus och det rapporteras som unknown.

Giltighetsstatus hos signeringscertifikatet.

Statusen kan vara:

• valid – Certifikatet har inte upphört att gälla, har inte fastnat i en återkallningskontroll och är kopplat via en kedja till ett tillförlitligt rotcertifikat.
• unknown – Certifikatet har inte upphört att gälla och har inte fastnat i en återkallningskontroll, men är inte kopplat via en kedja till ett tillförlitligt rotcertifikat. En status på unknown rapporteras också när statusen inte har verifierats, antingen därför att verify()-metoden inte har anropats eller därför att den kryptografiska signaturen i SignedInfo-elementet (digestStatus) är ogiltig.
• invalid – Certifikatet har upphört att gälla eller har fastnat i en återkallningskontroll.

De certifikat som läggs till med hjälp av metoden addCertificate() och inställningen av revocationCheckSetting och useSystemTrustStore kan ändra huruvida ett certifikat anses giltigt.

Obs! Om identityStatus är ogiltigt kontrolleras inte referencesStatus och det rapporteras som unknown. Referenser kontrolleras heller inte när identityStatus är okänt såvida inte referencesValidationSetting är validOrUnknownIdentity

Relaterade API-element

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

Egenskapen isSupported är true om klassen XMLSignatureValidator stöds på den aktuella plattformen, och i annat fall är värdet false.

Giltighetsstatus för data i referenserna i signaturen för SignedInfo-elementet.

Statusen kan vara:

• valid — Om alla referenser är giltiga
• invalid – Om någon referens är ogiltig.
• unknown – Om inte kontrollerad. Referenser kan vara okontrollerade i följande fall:
  • metoden verify() har inte anropats
  • den kryptografiska signaturen för SignedInfo-elementet ( digestStatus ) är ogiltig.
  • signeringscertifikatet ( identityStatus ) är ogiltigt
  • referencesValidationSetting är validIdentity (som är standardinställningen) och identityStatus för signeringscertifikatet är unknown.
  • referencesValidationSetting är never.

Viktigt! Externa resurser valideras inte såvida de inte refereras direkt i ett SignedInfo-element i signaturdokumentet. Externa resurser som refereras av en sekundär referens valideras inte. Om till exempel en XML-signatur signerar ett manifestelement, verifieras bara manifestelementets integritet. Filerna som anges i manifestet kontrolleras inte.

Relaterade API-element

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

Anger de villkor under vilka referenser kontrolleras.

Använd de konstanter som har definierats i klassen ReferencesValidationSetting när du vill ange den här egenskapen. Inställningarna inkluderar:

• ReferencesValidationSetting.VALID_IDENTITY – Kontrollera referenser enbart om signeringscertifikatet är giltigt och går upp till en tillförlitlig rot. Detta är standardinställningen.
• ReferencesValidationSetting.VALID_OR_UNKNOWN_IDENTITY – Kontrollera referenser om signeringscertifikatet är giltigt, även om det inte leder upp till en tillförlitlig rot.
• ReferencesValidationSetting.NEVER – Kontrollera aldrig referenser.

Använd standardinställningen validIdentity med signaturer som har signerats med ett kommersiellt certifikat eller när du tillhandahåller ett eget certifikat som en förtroendebas med hjälp av metoden addCertificate(). Om du använder den här inställningen undviker du allmän kontroll av referensgiltighet när signerade dokument ändå kommer att avvisas.

Använd inställningen validOrUnknownIdentity med signaturer som har signerats med självsignerade certifikat. Med den här inställningen kan du validera att signerade data inte har ändrats, men det ger inga garantier om signerarens identitet.

Använd inställningen never om du vill undvika allmän validering av referenser när sådan validering inte behövs.

Relaterade API-element

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

Anger hur certifikatåterkallning kontrolleras.

Använd de konstanter som har definierats i klassen RevocationSettings när du vill ange den här egenskapen. Inställningarna inkluderar:

• RevocationCheckSettings.NEVER – Kontrollera inte certifikatåterkallning.
• RevocationCheckSettings.BEST_EFFORT – Kontrollera certifikatåterkallning, om återkallningsinformationen är tillgänglig och återkallningsstatus kan hämtas. Om det inte går att säkert bestämma återkallningsstatus nekas inte certifikatet.
• RevocationCheckSettings.REQUIRED_IF_AVAILABLE – Om certifikatet innehåller återkallningsinformation måste återkallningsstatus bestämmas säkert för att certifikatet ska kunna verifieras.
• RevocationCheckSettings.ALWAYS_REQUIRED – Kontrollera alltid certifikatåterkallning. Certifikat utan återkallningsinformation nekas.

Relaterade API-element

Fältet för signeringscertifikatets allmänna namn.

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

Fältet för signeringscertifikatets unika namn.

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

En array som innehåller de OID för utökad nyckelanvändning som anges i signeringscertifikatet.

Varje utökad nyckelanvändning rapporteras i numeriskt OID-format.

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

En array som innehåller signeringscertifikatets förtroendeinställningar.

Förtroendeinställningar härleds från systemet och de OID för nyckelanvändning som är inbäddade i certifikatet. Konstanter för de strängar som representerar de identifierade förtroendeinställningarna anges i klassen SignerTrustSettings.

Arrayen signerTrustSettings för ett certifikat med statusen unknown eller invalid är tom.

Certifikatets förtroendeinställningar ändras inte om arrayen redigeras.

Relaterade API-element

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

IURIDereferencer-implementeringen.

Du måste ange en IURIDereferencer-implementering innan du försöker kontrollera en signatur.

Relaterade API-element

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

Anger att certifikaten i systemets förtroendearkiv används för kedjeskapande.

Om värdet är true används förtroendebaserna i systemets förtroendearkiv som tillförlitliga rötter. Systemets förtroendearkiv används inte som standard.

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

Giltighetsstatus hos en kontrollerad XML-signatur.

XML-signaturen verifieras genom validering av den kryptografiska signaturen för SignedInfo-elementet, signeringscertifikatet och de data som adresseras av referenserna i SignedInfo-elementet. Giltigheten hos vart och ett av de här elementen rapporteras enskilt i de olika egenskaperna digestStatus, identityStatus() och referencesStatus.

En XML-signatur kan ha statusen valid, invalid eller unknown. Den överordnade statusen beror på kontrollstatusen för de enskilda komponenterna i signaturfilen:

• digestStatus – Giltigheten hos signaturens kryptografi beräknad över SignedInfo-elementet.
• identityStatus – Giltigheten hos signeringscertifikatet.
• referencesStatus – Giltigheten hos sammanfattningen av referenserna i signaturens SignedInfo-element.

Den signaturstatus som rapporteras av egenskapen validityStatus kan vara:

• valid – Om referencesStatus, digestStatus och identityStatus alla har värdet valid.
• invalid – Om någon enskild status har värdet invalid.
• unknown – om någon enskild status har värdet unknown.

Relaterade API-element

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

Skapar ett XMLSignatureValidator-objekt.

Du måste ange egenskapen uriDereferencer innan du anropar metoden verify() för det nya objektet.

Relaterade API-element

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

Lägger till ett x509-certifikat för kedjeskapande.

Det certifikat som läggs till måste vara ett DER-kodat x509-certifikat.

Om parametern trusted har värdet true fungerar certifikatet som förtroendebas.

Obs! En XML-signatur kan innehålla certifikat för att skapa signerarens certifikatkedja. Klassen XMLSignatureValidator använder de här certifikaten för kedjeskapande, men inte som tillförlitliga rötter (som standard).

Parametrar

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

Kontrollerar den angivna signaturen.

Kontrollen är asynkron. XMLSignatureValidator-objektet skickar en complete-händelse när kontrollen har slutförts eller en error-händelse om det inte går att slutföra kontrollen på grund av fel.

Det går inte att avbryta kontrollen. Så länge en kontroll pågår misslyckas efterföljande anrop till metoden verify(). När den aktuella kontrollen har slutförts kan du anropa metoden verify() igen.

Obs! Eftersom XMLSignatureValidator endast implementerar en delmängd av W3C-rekommendationen för XML-signatursyntax och -bearbetning, kan alla giltiga XML-signaturer inte verifieras.

Parametrar

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

Skickas när kontrollen har slutförts.

En complete-händelse anger inte att signaturen är giltig. Kontrollera validityStatus-egenskapen för XMLSignatureValidator-objektet för att ta reda på resultaten från signaturverifieringen.

Den här händelsen har följande egenskaper:

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

Relaterade API-element

Skickas om kontrollen inte kan slutföras på grund av fel.

Den här händelsen har följande egenskaper:

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