XMLSignatureValidator  - AS3

Lo stato di validità della firma crittografica calcolata sull'elemento firma SignedInfo.

Lo stato è:

• valid: se la firma dal punto di vista crittografico è valid.
• invalid: se il digest è stato modificato dopo la firma.
• unknown: se il metodo verify() non è stato chiamato.

Nota: se il valore di digestStatus è invalid, i valori di identityStatus e referencesStatus non vengono verificati e vengono segnalati come unknown.

Lo stato di validità del certificato di firma.

Lo stato dello script può essere:

• valid: il certificato non è scaduto, non ha fallito una verifica delle revoche ed è collegato a catena a un certificato di una fonte attendibile.
• unknown: il certificato non è scaduto e non ha fallito una verifica delle revoche, ma non è collegato a catena a un certificato di una fonte attendibile. Viene segnalato uno stato unknown anche quando lo stato non è stato verificato, sia perché il metodo verify() non è stato chiamato, sia perché la firma crittografica dell'elemento SignedInfo (digestStatus) è invalid.
• invalid: il certificato è scaduto e ha fallito una verifica delle revoche.

I certificati aggiunti mediante il metodo addCertificate() e le impostazioni delle proprietà revocationCheckSetting e useSystemTrustStore possono variare se un certificato è considerato valido.

Nota: se il valore di identityStatus è invalid, il valore di referencesStatus non viene verificato e viene segnalato come unknown. Inoltre, i riferimenti non vengono verificati quando identityStatus è unknown, a meno che il valore di referencesValidationSetting non sia validOrUnknownIdentity.

Elementi API correlati

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

La proprietà isSupported è impostata su true se la classe XMLSignatureValidator è supportata nella piattaforma corrente, altrimenti è impostata su false.

Lo stato di validità dei dati nei riferimenti dell'elemento firma SignedInfo.

Lo stato dello script può essere:

• valid: se tutti i riferimenti sono valid.
• invalid: se uno dei riferimenti è invalid.
• unknown: se non è verificato. I riferimenti possono rimanere non verificati nelle seguenti circostanze:
  • Il metodo verify() non è stato chiamato.
  • La firma crittografica dell'elemento SignedInfo (digestStatus) non è valida.
  • Il certificato di firma (identityStatus) non è valido.
  • referencesValidationSetting è validIdentity (l'impostazione predefinita) e il valore di identityStatus del certificato di firma è unknown.
  • Il valore di referencesValidationSetting è never.

Importante: le risorse esterne non vengono convalidate a meno che non si faccia un riferimento diretto a esse in un elemento SignedInfo all'interno del documento della firma. Le risorse esterne a cui si riferisce un riferimento secondario non vengono convalidate. Ad esempio, se una firma XML accredita un elemento manifesto, viene verificata solo l'integrità dell'elemento manifesto. I file elencati nel manifesto non vengono verificati.

Elementi API correlati

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

Specifica le condizioni nelle quali i riferimenti vengono verificati.

Utilizzate le costanti definite nella classe ReferencesValidationSetting per impostare questa proprietà. Le impostazioni comprendono:

• ReferencesValidationSetting.VALID_IDENTITY: verifica i riferimenti solo se il certificato di firma è valido e collegato a un elemento superiore attendibile. Questa è l'impostazione predefinita.
• ReferencesValidationSetting.VALID_OR_UNKNOWN_IDENTITY: verifica i riferimenti se il certificato di firma è valido, anche se non è collegato a un elemento cartella superiore attendibile.
• ReferencesValidationSetting.NEVER: non verifica mai i riferimenti.

Utilizzate l'impostazione validIdentity predefinita con le firme fornite da un certificato commerciale o quando fornite un vostro certificato come trust anchor ("ancoraggio di attendibilità") con il metodo addCertificate(). Questa impostazione evita la ridondanza legata alla verifica della validità dei riferimento quando il documento firmato viene comunque rifiutato.

Utilizzate l'impostazione validOrUnknownIdentity con le firme fornite da certificati autofirmati. Questa impostazione consente di convalidare che i dati firmati non sono stati alterati, ma non fornisce alcuna garanzia sull'identità dell'autore della firma.

Utilizzate l'impostazione never per evitare la ridondanza legata alla convalida dei riferimenti quando tale convalida non è importante nel contesto dell'applicazione.

Elementi API correlati

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

Specifica il modo in cui viene verificata la revoca dei certificati.

Utilizzate le costanti definite nella classe RevocationSettings per impostare questa proprietà. Le impostazioni comprendono:

• RevocationCheckSettings.NEVER: non verifica la revoca dei certificati.
• RevocationCheckSettings.BEST_EFFORT: verifica la revoca dei certificati, se le informazioni sulla revoca sono disponibili ed è possibile ottenere lo stato della revoca. Se lo stato della revoca non può essere determinato positivamente, il certificato non viene rifiutato.
• RevocationCheckSettings.REQUIRED_IF_AVAILABLE: se il certificato include informazioni sulla revoca, lo stato della revoca deve essere determinato positivamente per convalidare il certificato.
• RevocationCheckSettings.ALWAYS_REQUIRED: verifica sempre la revoca dei certificati. I certificati senza informazioni sulla revoca vengono rifiutati.

Elementi API correlati

Il campo Common Name del certificato di firma.

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

Il campo Distinguished del certificato di firma.

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

Un array che contiene gli Extended Key Usages OID elencati nel certificati di firma.

Ogni Extended Key Usage viene riportato in formato OID numerico.

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

Un array che contiene le impostazioni di attendibilità del certificato di firma.

Le impostazioni di attendibilità vengono derivate dal sistema e dai Key Usages OID di utilizzo principali incorporati nel certificato. Le costanti delle stringhe che rappresentano le impostazioni di attendibilità riconosciute nella classe SignerTrustSettings.

L'array signerTrustSettings di un certificato unknown o invalid è vuoto.

La modifica di un array non modifica le impostazioni di attendibilità del certificato.

Elementi API correlati

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

L'implementazione IURIDereferencer.

Un'implementazione IURIDereferencer deve essere fornita prima di tentare la verifica di una firma.

Elementi API correlati

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

Specifica che i certificati nell'archivio delle fonti attendibili del sistema vengono utilizzati per la creazione della catena.

Se true, gli ancoraggi di attendibilità nell'archivio delle fonti attendibili vengono utilizzati come fonti attendibili. L'archivio delle fonti attendibili non viene utilizzato per impostazione predefinita.

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

Lo stato di validità di una firma XML verificata.

La firma XML viene verificata convalidando la firma crittografica dell'elemento SignedInfo, il certificato di firma e i dati a cui si riferiscono i riferimenti presenti nell'elemento SignedInfo. La validità di ciascuno di questi elementi viene segnalata rispettivamente dalle proprietà digestStatus, identityStatus() e referencesStatus.

Una firma può essere valida (valid), non valida (invalid) o sconosciuta (unknown). Lo stato complessivo dipende dallo stato della verifica dei singoli componenti del file della firma:

• digestStatus: la validità della firma crittografica calcolata sull'elemento SignedInfo.
• identityStatus : la validità del certificato di firma.
• referencesStatus: la validità del digest di tutti i riferimenti dell'elemento SignedInfo della firma.

La validità della firma riportata dalla proprietà validityStatus può essere:

• valid: se referencesStatus, digestStatus e identityStatus sono tutti valid.
• invalid: se uno dei singoli stati è invalid.
• unknown: se uno qualunque dei singoli stati è unknown.

Elementi API correlati

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

Crea un oggetto XMLSignatureValidator.

Dovete impostare la proprietà uriDereferencer prima di chiamare il metodo verify() del nuovo oggetto.

Elementi API correlati

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

Aggiunge un certificato x509 per la creazione del catena.

Il certificato aggiunto deve essere un certificato x509 con codifica DER.

Se il parametro trusted è true, il certificato viene considerato un ancoraggio di attendibilità.

Nota: una firma XML può comprendere i certificati per la creazione della catena dei certificati del firmatario. La classe XMLSignatureValidator utilizza questi certificati per la creazione della catena, ma non come fonte attendibile (per impostazione predefinita).

Parametri

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

Verifica la firma specificata.

La verifica è asincrona. L'oggetto XMLSignatureValidator invia un evento complete quando la verifica viene completata correttamente oppure un evento error se la verifica non può essere completata a causa di errori.

Il processo di verifica non può essere annullato. Mentre è in corso un processo di verifica, le successive chiamate al metodo verify() danno esito negativo. Una volta completata la verifica corrente, potete chiamare di nuovo il metodo verify().

Nota: poiché l'oggetto XMLSignatureValidator implementa solo un sottoinsieme della W3C Recommendation for XML Signature Syntax and Processing, non tutte le firme XML valide possono essere verificate.

Parametri

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

Inviato quando la verifica è stata completata.

Un evento complete non implica che la firma sia valida. Verificate la proprietà validityStatus dell'oggetto XMLSignatureValidator per determinare il risultato della verifica della firma.

Questo evento ha le seguenti proprietà:

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

Elementi API correlati

Inviato se la verifica non può essere completata a causa di errori.

Questo evento ha le seguenti proprietà:

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