XMLSignatureValidator  - AS3

İmza SignedInfo öğesi üzerinde hesaplanan kriptografik imzanın geçerlilik durumu.

Durum:

• valid — İmza kriptografik olarak geçerli olursa.
• invalid — İmzalama işleminden sonra özet değiştirilmişse.
• unknown — verify() yöntemi çağrılmamışsa.

Not: digestStatus geçersizse, identityStatus ve referencesStatus kontrol edilmez ve unknown olarak bildirilir.

İmzalama sertifikasının geçerlilik durumu.

Durum şunlardan biri olabilir:

• valid — Sertifikanın süresi dolmamıştır, iptal kontrolünden başarıyla geçmiştir ve güvenilen bir kök sertifikasına zincirlidir.
• unknown — Sertifikanın süresi dolmamıştır, iptal kontrolünden başarıyla geçmiştir ve güvenilen bir kök sertifikasına zincirli değildir. verify() yöntemi çağrılmadığı için veya SignedInfo öğesinin kriptografik imzası (digestStatus) geçersiz olduğu için durum doğrulanmadığında unknown durumu da bildirilir.
• invalid — Sertifikanın süresi dolmuştur veya iptal kontrolünden geçememiştir.

addCertificate() yöntemi kullanılarak eklenen sertifikalar, revocationCheckSetting ayarları ve useSystemTrustStore özellikleri, bir sertifikanın geçerli olarak değerlendirilip değerlendirilmeme durumunu değiştirebilir.

Not: identityStatus geçersizse, referencesStatus kontrol edilmez ve unknown olarak bildirilir. Ayrıca, identityStatus bilinmiyorsa, referencesValidationSetting öğesi validOrUnknownIdentity olmadığı sürece başvurular kontrol edilmez

İlgili API Öğeleri

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

XMLSignatureValidator sınıfı geçerli platformda destekleniyorsa, isSupported özelliği true olarak, aksi halde false olarak ayarlanır.

İmza SignedInfo öğesindeki başvurularda bulunan verilerin geçerlilik durumu.

Durum şunlardan biri olabilir:

• valid — Tüm başvurular geçerliyse.
• invalid — Herhangi bir başvuru geçersizse.
• unknown — Doğrulanmadıysa. Başvurular, aşağıdaki koşullarda doğrulanmamış olarak kalabilir:
  • verify() yöntemi çağrılmamışsa
  • SignedInfo öğesinin kriptografik imzası (digestStatus) geçersizse.
  • imzalama sertifikası (identityStatus) geçersizse
  • referencesValidationSetting öğesi validIdentity (varsayılan ayar) ise ve imzalama sertifikasının identityStatus öğesi bilinmiyorsa.
  • referencesValidationSetting, never ise.

Önemli: İmza belgesi içinde bulunan SignedInfo öğesinde doğrudan başvurulmadıkları sürece, harici kaynaklar doğrulanmaz. İkincil bir başvuru tarafından başvurulan harici kaynaklar doğrulanmaz. Örneğin, XML imzası bir bildirim öğesini imzalıyorsa, yalnızca bildirim öğesinin kendisinin bütünlüğü doğrulanır. Bildirimde listelenen dosyalar kontrol edilmez.

İlgili API Öğeleri

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

Başvuruların kontrol edileceği koşulları belirler.

Bu özelliği ayarlamak için ReferencesValidationSetting sınıfında tanımlanan sabitleri kullanın. Ayarlar şunları içerir:

• ReferencesValidationSetting.VALID_IDENTITY — Yalnızca imzalama sertifikası geçerliyse ve güvenilir bir köke bağlanıyorsa başvuruları kontrol et. Bu varsayılan ayardır.
• ReferencesValidationSetting.VALID_OR_UNKNOWN_IDENTITY — İmzalama sertifikası geçerliyse, güvenilir bir köke bağlanmıyorsa bile başvuruları kontrol et.
• ReferencesValidationSetting.NEVER — Başvuruları hiçbir zaman kontrol etme.

Varsayılan validIdentity ayarını ticari bir sertifikayla imzalanmış imzalarla veya addCertificate() yöntemini kullanarak kendi sertifikanızı güven bağlantısı olarak sağladığınızda kullanın. Bu ayar, imzalanan belgenin yine de reddedileceği durumlarda, başvuru geçerliliğini kontrol etme yükünü önler.

validOrUnknownIdentity ayarını, kendinden imzalı sertifikalarla imzalanan imzalarla kullanın. Bu ayar, imzalanan verilerin değiştirilmediğini, ancak imzalayanın kimliği hakkında herhangi bir garanti vermediğini doğrulamanızı sağlar.

never ayarını, uygulamanız bağlamında bu tür bir doğrulama önemli olmadığında, başvuruları doğrulama yükünü önlemek için kullanın.

İlgili API Öğeleri

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

Sertifika iptalinin nasıl kontrol edildiğini belirtir.

Bu özelliği ayarlamak için RevocationSettings sınıfında tanımlanan sabitleri kullanın. Ayarlar şunları içerir:

• RevocationCheckSettings.NEVER — Sertifika iptalini kontrol etmez.
• RevocationCheckSettings.BEST_EFFORT — İptal bilgileri mevcutsa ve iptal durumu edinilebiliyorsa sertifika iptalini kontrol eder. İptal durumu pozitif biçimde belirlenemiyorsa sertifika reddedilmez.
• RevocationCheckSettings.REQUIRED_IF_AVAILABLE — Sertifika iptal bilgilerini içeriyorsa iptal durumu, sertifikayı doğrulamak üzere pozitif olarak belirlenmelidir.
• RevocationCheckSettings.ALWAYS_REQUIRED — Her zaman sertifika iptalini kontrol eder. İptal bilgileri içermeyen sertifikalar reddedilir.

İlgili API Öğeleri

İmzalama sertifikasının Ortak Ad alanı.

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

İmzalama sertifikasının Ayırt Edilen Ad alanı.

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

İmzalama sertifikasında listelenen Genişletilmiş Anahtar Kullanımı OID'lerini içeren bir dizi.

Genişletilen her anahtar kullanımı, sayısal OID biçiminde bildirilir.

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

İmzalama sertifikasının güven ayarlarını içeren dizi.

Güven ayarları, sistemden türetilir ve anahtar kullanımı OID'leri (Nesne Kimliği) sertifikaya gömülüdür. Tanınan güven ayarlarını sunan dizelere ait sabitler, SignerTrustSettings sınıfında tanımlanır.

unknown veya invalid sertifikasının signerTrustSettings dizisi boştur.

Dizinin değiştirilmesi, sertifika güven ayarlarını değiştirmez.

İlgili API Öğeleri

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

IURIDereferencer uygulaması.

Bir imza doğrulamaya çalışmadan önce IURIDereferencer uygulaması sağlanmalıdır.

İlgili API Öğeleri

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

Sistemin güven deposundaki sertifikaların zincir oluşturma için kullanıldığını belirtir.

true ise sistemin güven deposundaki güven tutturucuları, güvenilen kökler olarak kullanılır. Sistemin güven deposu varsayılan olarak kullanılmaz.

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

Doğrulanmış XML imzasının geçerlilik durumu.

XML imzası, SignedInfo öğesinin kriptografik imzasının, imzalama sertifikasının ve SignedInfo öğesindeki başvuruların hedef aldığı verilerin doğrulanması yoluyla doğrulanır. Bu öğelerin her birinin geçerliliği, sırasıyla digestStatus, identityStatus() ve referencesStatus özellikleri tarafından ayrı ayrı bildirilir.

XML imzasının geçerliliği valid, invalid veya unknown olabilir. Genel durum, imza dosyasının bağımsız bileşenlerinin doğrulama durumuna bağlıdır.

• digestStatus — SignedInfo öğesi üzerinde hesaplanan kriptografik imzanın geçerliliği.
• identityStatus — İmzalama sertifikasının geçerliliği.
• referencesStatus — İmza SignedInfo öğesindeki başvuruların özetinin geçerliliği.

validityStatus özelliği tarafından bildirilen imza geçerliliği aşağıdaki durumlara sahip olabilir:

• valid — referencesStatus, digestStatus ve identityStatus öğelerinin tümü valid olur.
• invalid — Herhangi bir bağımsız durum invalid ise.
• unknown — Her bir durum unknown olduğunda.

İlgili API Öğeleri

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

XMLSignatureValidator nesnesi oluşturur.

Yeni nesnenin verify() yöntemini çağırmadan önce uriDereferencer özelliğini ayarlamanız gerekir.

İlgili API Öğeleri

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

Zincir oluşturma için x509 sertifikası ekler.

Eklenen sertifika, DER ile kodlanmış x509 sertifikası olmalıdır.

trusted parametresi true ise sertifika, güven tutturucusu olarak değerlendirilir.

Not: XML imzası, imzalayanın sertifika zincirini oluşturmak için sertifikalar içerebilir. XMLSignatureValidator sınıfı, bu sertifikaları güvenilen kökler olarak değil (varsayılan olarak), zincir oluşturma için kullanır.

Parametreler

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

Belirtilen imzayı doğrular.

Doğrulama eşzamansızdır. XMLSignatureValidator nesnesi, doğrulama başarıyla tamamlandığında bir complete olayı veya doğrulama hatalar nedeniyle tamamlanamıyorsa bir error olayı gönderir.

Doğrulama işlemi iptal edilemez. Doğrulama işlemi devam ederken verify() yöntemine yapılan sonraki çağrılar başarısız olur. Geçerli doğrulama kontrolü tamamlandıktan sonra verify() yöntemini yeniden çağırabilirsiniz.

Not: XMLSignatureValidator yalnızca W3C recommendation for XML Signature Syntax and Processing (XML İmzası Sözdizimi ve İşlemesi için W3C Önerileri) alt kümesi uyguladığından, tüm geçerli XML imzaları doğrulanmaz.

Parametreler

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

Doğrulama işlemi tamamlandığında gönderilir.

complete olayı, imzanın geçerli olmadığını gösterir. İmza doğrulama sonucunu belirlemek için XMLSignatureValidator nesnesinin validityStatus özelliğini kontrol edin.

Bu olay şu özelliklere sahiptir:

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

İlgili API Öğeleri

Doğrulama işlemi hatalar nedeniyle tamamlanamıyorsa gönderilir.

Bu olay şu özelliklere sahiptir:

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