CipherReference Třída

Definice

Obor názvů:

System.Security.Cryptography.Xml

Sestavení:

System.Security.Cryptography.Xml.dll

Balíček:

System.Security.Cryptography.Xml v9.0.0-preview.5.24306.7

Zdroj:

CipherReference.cs

<CipherReference> Představuje element v šifrování XML. Tato třída se nemůže dědit.

public ref class CipherReference sealed : System::Security::Cryptography::Xml::EncryptedReference

public sealed class CipherReference : System.Security.Cryptography.Xml.EncryptedReference

type CipherReference = class
    inherit EncryptedReference

Public NotInheritable Class CipherReference
Inherits EncryptedReference

Dědičnost

Object

EncryptedReference

CipherReference

Příklady

Následující příklad kódu vytvoří novou instanci objektu CipherReference.

#using <System.Xml.dll>
#using <System.Security.dll>
#using <System.dll>

using namespace System;
using namespace System::Security::Cryptography::Xml;
using namespace System::Xml;
using namespace System::IO;

/// This sample used the EncryptedData class to create an encrypted data element
/// and write it to an XML file. It demonstrates the use of CipherReference.

[STAThread]
int main()
{
   
   //Create a URI string.
   String^ uri = "http://www.woodgrovebank.com/document.xml";
   
   // Create a Base64 transform. The input content retrieved from the
   // URI should be Base64-decoded before other processing.
   Transform^ base64 = gcnew XmlDsigBase64Transform;
   
   //Create a transform chain and add the transform to it.
   TransformChain^ tc = gcnew TransformChain;
   tc->Add( base64 );
   
   //Create <CipherReference> information.
   CipherReference ^ reference = gcnew CipherReference( uri,tc );
   
   // Create a new CipherData object using the CipherReference information.
   // Note that you cannot assign both a CipherReference and a CipherValue
   // to a CipherData object.
   CipherData ^ cd = gcnew CipherData( reference );
   
   // Create a new EncryptedData object.
   EncryptedData^ ed = gcnew EncryptedData;
   
   //Add an encryption method to the object.
   ed->Id = "ED";
   ed->EncryptionMethod = gcnew EncryptionMethod( "http://www.w3.org/2001/04/xmlenc#aes128-cbc" );
   ed->CipherData = cd;
   
   //Add key information to the object.
   KeyInfo^ ki = gcnew KeyInfo;
   ki->AddClause( gcnew KeyInfoRetrievalMethod( "#EK","http://www.w3.org/2001/04/xmlenc#EncryptedKey" ) );
   ed->KeyInfo = ki;
   
   // Create new XML document and put encrypted data into it.
   XmlDocument^ doc = gcnew XmlDocument;
   XmlElement^ encryptionPropertyElement = dynamic_cast<XmlElement^>(doc->CreateElement( "EncryptionProperty", EncryptedXml::XmlEncNamespaceUrl ));
   EncryptionProperty ^ ep = gcnew EncryptionProperty( encryptionPropertyElement );
   ed->AddProperty( ep );
   
   // Output the resulting XML information into a file.
   try
   {
      String^ path = "c:\\test\\MyTest.xml";
      File::WriteAllText( path, ed->GetXml()->OuterXml );
   }
   catch ( IOException^ e ) 
   {
      Console::WriteLine( "File IO error. {0}", e );
   }

}

using System;
using System.Security.Cryptography.Xml;
using System.Xml;
using System.IO;

/// This sample used the EncryptedData class to create an encrypted data element
/// and write it to an XML file. It demonstrates the use of CipherReference.
namespace EncryptedDataSample
{
    class Example
    {
        [STAThread]
        static void Main(string[] args)
        {
            //Create a URI string.
            String uri = "http://www.woodgrovebank.com/document.xml";
            // Create a Base64 transform. The input content retrieved from the
            // URI should be Base64-decoded before other processing.
            Transform base64 = new XmlDsigBase64Transform();
            //Create a transform chain and add the transform to it.
            TransformChain tc = new TransformChain();
            tc.Add(base64);
            //Create <CipherReference> information.
            CipherReference reference = new CipherReference(uri, tc);

            // Create a new CipherData object using the CipherReference information.
            // Note that you cannot assign both a CipherReference and a CipherValue
            // to a CipherData object.
            CipherData cd = new CipherData(reference);

            // Create a new EncryptedData object.
            EncryptedData ed = new EncryptedData();

            //Add an encryption method to the object.
            ed.Id = "ED";
            ed.EncryptionMethod = new EncryptionMethod("http://www.w3.org/2001/04/xmlenc#aes128-cbc");
            ed.CipherData = cd;

            //Add key information to the object.
            KeyInfo ki = new KeyInfo();
            ki.AddClause(new KeyInfoRetrievalMethod("#EK", "http://www.w3.org/2001/04/xmlenc#EncryptedKey"));
            ed.KeyInfo = ki;

            // Create new XML document and put encrypted data into it.
            XmlDocument doc = new XmlDocument();
            XmlElement encryptionPropertyElement = (XmlElement)doc.CreateElement("EncryptionProperty", EncryptedXml.XmlEncNamespaceUrl);
            EncryptionProperty ep = new EncryptionProperty(encryptionPropertyElement);
            ed.AddProperty(ep);

            // Output the resulting XML information into a file.
            try
            {
                string path = @"c:\test\MyTest.xml";

                File.WriteAllText(path, ed.GetXml().OuterXml);
            }
            catch (IOException e)
            {
                Console.WriteLine("File IO error. {0}", e);
            }
        }
    }
}

Imports System.Security.Cryptography.Xml
Imports System.Xml
Imports System.IO


'/ This sample used the EncryptedData class to create a EncryptedData element
'/ and write it to an XML file. It demonstrates the use of CipherReference.
Module Module1

    Sub Main()
        ' Create a URI string.
        Dim uri As String = "http://www.woodgrovebank.com/document.xml"
        ' Create a Base64 transform. The input content retrieved from the
        ' URI should be Base64-decoded before other processing.
        Dim base64 As Transform = New XmlDsigBase64Transform
        Dim tc As New TransformChain
        tc.Add(base64)
        ' Create <CipherReference> information.
        Dim reference As CipherReference = New CipherReference(uri, tc)

        ' Create a new CipherData object.
        ' Note that you cannot assign both a CipherReference and a CipherValue
        ' to a CipherData object.
        Dim cd As CipherData = New CipherData(Reference)

        ' Create a new EncryptedData object.
        Dim ed As New EncryptedData

        'Add an encryption method to the object.
        ed.Id = "ED"
        ed.EncryptionMethod = New EncryptionMethod("http://www.w3.org/2001/04/xmlenc#aes128-cbc")
        ed.CipherData = cd

        'Add key information to the object.
        Dim ki As New KeyInfo
        ki.AddClause(New KeyInfoRetrievalMethod("#EK", "http://www.w3.org/2001/04/xmlenc#EncryptedKey"))
        ed.KeyInfo = ki

        ' Create new XML document and put encrypted data into it.
        Dim doc As New XmlDocument
        Dim encryptionPropertyElement As XmlElement = CType(doc.CreateElement("EncryptionProperty", EncryptedXml.XmlEncNamespaceUrl), XmlElement)
        Dim ep As New EncryptionProperty(encryptionPropertyElement)
        ed.AddProperty(ep)

        ' Output the resulting XML information into a file.
        Dim path As String = "c:\test\MyTest.xml"
        File.WriteAllText(path, ed.GetXml().OuterXml)
    End Sub

End Module

Poznámky

Tato třída představuje <CipherReference> element v šifrování XML. Identifikuje zdroj, který při zpracování poskytuje šifrovaná data.

Skutečná šifrovaná data, na která odkazuje objekt, <CipherReference> se získají následujícím procesem. Vlastnost <CipherReference> URI obsahuje identifikátor URI (Uniform Resource Identifier), který je dereferenced. <CipherReference> Pokud element obsahuje také transformační řetězec, data vyplývající z dereferencování identifikátoru URI se transformují tak, jak je uvedeno, aby se vytvořily šifrovaná data. Pokud jsou například šifrovaná data zakódovaná v dokumentu XML64, transformace by určily výraz XPath následovaný dekódováním base64, aby bylo možné extrahovat šifrovaná data.

Syntaxe identifikátoru URI a transformací je podobná syntaxi digitálních podpisů XML. V digitálních podpisech XML však generování i zpracování ověření začíná se stejnými zdrojovými daty a provádí tuto transformaci ve stejném pořadí. V šifrování XML má dešifrovací aplikace pouze šifrovaná data a zadané transformace. Transformace jsou vyčíslovány v pořadí potřebném k získání šifrovaných dat.

Poznámka Ve výchozím nastavení nelze dereference šifrovat odkazy z dokumentů s neznámými zdroji, jako jsou soubory z webu, protože DocumentEvidence vlastnost je null. Například při pokusu o dešifrování souboru obsahujícího <CipherReference> prvek, který odkazuje na soubor na webu, SecurityException vyvolá se, i když požadavek je proveden plně důvěryhodné sestavení.

Pokud jste si jistí, že dokumenty, které dešifrujete, mohou být důvěryhodné, můžete toto chování u plně důvěryhodných aplikací změnit pomocí následujícího kódu:

Evidence ev = new Evidence();  
ev.AddHost (new Zone(SecurityZone.MyComputer));  
EncryptedXml exml = new EncryptedXml(doc, ev);  

Konstruktory

CipherReference()	Inicializuje novou instanci CipherReference třídy.
CipherReference(String)	Inicializuje novou instanci CipherReference třídy pomocí zadaného identifikátoru URI (Uniform Resource Identifier).
CipherReference(String, TransformChain)	Inicializuje novou instanci CipherReference třídy pomocí zadaného identifikátoru URI (Uniform Resource Identifier) a transformuje informace o řetězu.

Vlastnosti

CacheValid	Získá hodnotu, která označuje, zda je mezipaměť platná. (Zděděno od EncryptedReference)
ReferenceType	Získá nebo nastaví typ odkazu. (Zděděno od EncryptedReference)
TransformChain	Získá nebo nastaví transformační řetězec objektu EncryptedReference . (Zděděno od EncryptedReference)
Uri	Získá nebo nastaví identifikátor URI (Uniform Resource Identifier) objektu EncryptedReference . (Zděděno od EncryptedReference)

Metody

AddTransform(Transform)	Transform Přidá objekt do aktuálního řetězce transformace objektuEncryptedReference. (Zděděno od EncryptedReference)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
GetXml()	Vrátí reprezentaci XML objektu CipherReference .
LoadXml(XmlElement)	Načte informace XML do elementu <CipherReference> v šifrování XML.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)