IURIDereferencer arabirimini uygulama

Zarflı bir XML imzası oluşturulduğunda, imza öğeleri imzalanan verilere eklenir. Örneğin, aşağıdaki mesajı bir zarflı imza yapısı kullanarak imzaladıysanız:

<message> 
    <data>...</data> 
</message>

Elde edilen imzalı belge şöyle görünür:

<message> 
    <data>...</data> 
     <Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> 
        <SignedInfo> 
            <CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/> 
            <SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/> 
            <Reference URI=""> 
                <Transforms> 
                    <Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/> 
                </Transforms> 
                <DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"/> 
                <DigestValue>yv6...Z0Y=</DigestValue> 
            </Reference> 
        </SignedInfo> 
        <SignatureValue>cCY...LQ==</SignatureValue> 
        <KeyInfo> 
            <X509Data> 
                <X509Certificate>MII...4e</X509Certificate> 
            </X509Data> 
        </KeyInfo> 
    </Signature> 
</message>

İmzanın, URI olarak boş bir dizeye sahip tek bir Reference öğesi içerdiğine dikkat edin. Bu bağlamda boş bir dize, belgenin köküne başvurur.

Ayrıca, dönüştürme algoritmasının zarflı imza dönüştürmenin uygulandığını belirttiğine dikkat edin. Zarflı imza dönüştürme uygulandığında, XMLSignatureValidator özeti hesaplamadan önce imzayı otomatik olarak belgeden siler. Bu, başvuran nesnenin verileri döndürmesi sırasında Signature öğesini kaldırması gerekmediği anlamına gelir.

Aşağıdaki örnek, zarflı imzalar için bir başvuran nesneyi gösterir:

package 
{ 
    import flash.events.ErrorEvent; 
      import flash.events.EventDispatcher;  
    import flash.security.IURIDereferencer; 
    import flash.utils.ByteArray; 
    import flash.utils.IDataInput; 
 
    public class EnvelopedDereferencer 
        extends EventDispatcher implements IURIDereferencer 
    { 
        private var signedMessage:XML; 
         
        public function EnvelopedDereferencer( signedMessage:XML ) 
        { 
            this.signedMessage = signedMessage; 
        } 
 
        public function dereference( uri:String ):IDataInput 
        { 
            try 
            { 
                if( uri.length != 0 ) 
                { 
                    throw( new Error("Unsupported signature type.") ); 
                } 
                var data:ByteArray = new ByteArray(); 
                data.writeUTFBytes( signedMessage.toXMLString() ); 
                data.position = 0; 
            } 
            catch (e:Error) 
                { 
                var error:ErrorEvent = 
                    new ErrorEvent("Ref error " + uri + " ", false, false, e.message); 
                this.dispatchEvent(error); 
                data = null; 
                throw new Error("Reference not resolvable: " + uri + ", " + e.message); 
            } 
            finally 
            { 
                return data; 
            } 
        }         
    } 
}

Bu dereferencer sınıfı, zarflı imza belgesini dereference() yöntemi tarafından kullanılabilir duruma getirmek için signedMessage parametresini içeren yapıcı işlevini kullanır. Zarflı imzadaki başvuru her zaman imzalı verilerin köküne başvurduğundan, dereferencer() yöntemi belgeyi bir bayt dizisine yazar ve döndürür.

İmzalı veriler imzanın kendisiyle aynı belgede yer aldığında, başvurulardaki URI'ler imzalanan öğelere yönelmek için genellikle XPath veya XPointer sözdizimini kullanır. XML İmza Sözdizimi ve İşleme için W3C Önerisi, yalnızca bu sözdizimini önerir, yani uygulamanızı karşılaşmayı beklediğiniz imzalar üzerine kurmalısınız (ve desteklenmeyen sözdiziminin üstesinden başarıyla gelebilmek için uygulamaya yeterli hata denetimini eklemelisiniz).

AIR uygulamasının imzası, bir zarflanan imza örneğidir. Uygulamadaki dosyalar, Manifest öğesinde listelenmiştir. Manifest öğesi, Reference URI'sinde Manifest öğesinin kimliğine başvuran “#PackageContents” dizesi kullanılarak belirtilir.

<Signature xmlns="http://www.w3.org/2000/09/xmldsig#" Id="PackageSignature"> 
    <SignedInfo> 
        <CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/> 
        <SignatureMethod Algorithm="http://www.w3.org/TR/xmldsig-core#rsa-sha1"/> 
        <Reference URI="#PackageContents"> 
            <Transforms> 
                <Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/> 
            </Transforms> 
            <DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"/> 
            <DigestValue>ZMGqQdaRKQc1HirIRsDpeBDlaElS+pPotdziIAyAYDk=</DigestValue> 
        </Reference> 
    </SignedInfo> 
    <SignatureValue Id="PackageSignatureValue">cQK...7Zg==</SignatureValue> 
    <KeyInfo> 
        <X509Data> 
            <X509Certificate>MII...T4e</X509Certificate> 
        </X509Data> 
    </KeyInfo> 
    <Object> 
    <Manifest Id="PackageContents"> 
        <Reference URI="mimetype"> 
            <DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"> 
            </DigestMethod> 
            <DigestValue>0/oCb84THKMagtI0Dy0KogEu92TegdesqRr/clXct1c=</DigestValue> 
        </Reference> 
        <Reference URI="META-INF/AIR/application.xml"> 
            <DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"> 
            </DigestMethod> 
            <DigestValue>P9MqtqSdqcqnFgeoHCJysLQu4PmbUW2JdAnc1WLq8h4=</DigestValue> 
        </Reference> 
        <Reference URI="XMLSignatureValidation.swf"> 
            <DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"> 
            </DigestMethod> 
            <DigestValue>OliRHRAgc9qt3Dk0m0Bi53Ur5ur3fAweIFwju74rFgE=</DigestValue> 
        </Reference> 
    </Manifest> 
</Object> 
</Signature>

Bu imzanın doğrulanması için başvuran nesne Reference öğesinden "#PackageContents" içeren URI dizesini almalı ve bir ByteArray nesnesinde Manifest öğesini döndürmelidir. “#” simgesi, öğe kimliği niteliğinin değerini belirtir.

Aşağıdaki örnek, AIR uygulama imzalarının doğrulanması için başvuran nesneyi uygular. Uygulama, bir AIR imzasının bilinen yapısı üzerine kurularak basit tutulmuştur. Genel amaçlı bir başvuran nesne, önemli ölçüde karmaşık olabilir.

package 
{ 
    import flash.events.ErrorEvent;    
    import flash.security.IURIDereferencer; 
    import flash.utils.ByteArray; 
    import flash.utils.IDataInput; 
     
    public class AIRSignatureDereferencer implements IURIDereferencer { 
        private const XML_SIG_NS:Namespace = 
            new Namespace( "http://www.w3.org/2000/09/xmldsig#" ); 
        private var airSignature:XML; 
     
        public function AIRSignatureDereferencer( airSignature:XML ) { 
            this.airSignature = airSignature; 
        } 
         
        public function dereference( uri:String ):IDataInput {     
            var data:ByteArray = null;     
            try 
            {     
                if( uri != "#PackageContents" ) 
                { 
                    throw( new Error("Unsupported signature type.") ); 
                } 
                var manifest:XMLList = 
                    airSignature.XML_SIG_NS::Object.XML_SIG_NS::Manifest; 
                data = new ByteArray(); 
                data.writeUTFBytes( manifest.toXMLString()); 
                data.position = 0; 
            } 
            catch (e:Error) 
            { 
                data = null; 
                throw new Error("Reference not resolvable: " + uri + ", " + e.message); 
            } 
            finally 
            { 
                return data; 
            } 
             
        } 
    } 
}

Bu türde bir imzayı doğruladığınızda, yalnızca Manifest öğesindeki veriler doğrulanır. Paketteki gerçek dosyalar hiç denetlenmez. Paket dosyalarıyla oynanıp oynanmadığını denetlemek için dosyaları okumalı, SHA256 özetini hesaplamalı ve sonucu bildirimde kayıtlı özetle harmanlamalısınız. XMLSignatureValidator, bunun gibi ikincil başvuruları otomatik olarak kontrol etmez.

URI harici bir kaynağa başvurduğunda, verilere erişilmeli ve veriler bir ByteArray nesnesine yüklenmelidir. URI mutlak bir URL içeriyorsa, bu sadece dosyanın okunması veya URL'nin istenmesi anlamına gelir. En yaygın rastlanan durum olan URI'nin göreli bir yol içermesi durumunda, IURIDereferencer uygulamanız imzalanan dosyalara giden yolları çözmek için bir yol içermelidir.

Aşağıdaki örnek, başvuran birim imzalanan dosyaların çözülmesi için temel olarak oluşturulduğunda başlatılan bir File nesnesini kullanır.

package 
{ 
    import flash.events.ErrorEvent; 
    import flash.events.EventDispatcher; 
    import flash.filesystem.File; 
    import flash.filesystem.FileMode; 
    import flash.filesystem.FileStream; 
    import flash.security.IURIDereferencer; 
    import flash.utils.ByteArray; 
    import flash.utils.IDataInput; 
    public class RelativeFileDereferencer 
        extends EventDispatcher implements IURIDereferencer 
    { 
        private var base:File; 
         
        public function RelativeFileDereferencer( base:File ) 
        { 
            this.base = base; 
        } 
 
        public function dereference( uri:String ):IDataInput 
        { 
            var data:ByteArray = null; 
            try{ 
                var referent:File = this.base.resolvePath( uri ); 
                var refStream:FileStream = new FileStream();             
                data = new ByteArray(); 
                refStream.open( referent, FileMode.READ ); 
                 
                refStream.readBytes( data, 0, data.bytesAvailable ); 
                 
            } catch ( e:Error ) { 
                data = null; 
                throw new Error("Reference not resolvable: " + referent.nativePath + ", " + e.message ); 
            } finally { 
                return data; 
            } 
        }         
    } 
}

dereference() işlevi, başvuru URI'si tarafından yöneltilen dosyayı basit şekilde konumlandırır, dosya içeriğini bir bayt dizisine yükler ve ByteArray nesnesini döndürür.