CipherReference Classe

Definição

Namespace:

System.Security.Cryptography.Xml

Assembly:

System.Security.Cryptography.Xml.dll

Pacote:

System.Security.Cryptography.Xml v9.0.0-rc.1.24431.7

Origem:

CipherReference.cs

Representa o elemento <CipherReference> na criptografia XML. Essa classe não pode ser herdada.

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

Herança

Object

EncryptedReference

CipherReference

Exemplos

O exemplo de código a seguir cria uma nova instância do 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

Comentários

Essa classe representa o <CipherReference> elemento na criptografia XML. Ele identifica uma origem que, quando processada, produz os dados criptografados.

Os dados criptografados reais referenciados pelo <CipherReference> são obtidos pelo processo a seguir. A <CipherReference> URI propriedade contém um URI (Uniform Resource Identifier) que é desreferenciado. Se o <CipherReference> elemento também contiver uma cadeia de transformação, os dados resultantes da desreferência do URI serão transformados conforme especificado para produzir os dados criptografados. Por exemplo, se os dados criptografados forem codificados em base64 em um documento XML, as transformações especificariam uma expressão XPath seguida por uma decodificação base64 para que os dados criptografados possam ser extraídos.

A sintaxe do URI e das transformações é semelhante à das assinaturas digitais XML. No entanto, em assinaturas digitais XML, o processamento de geração e validação começa com os mesmos dados de origem e executa essa transformação na mesma ordem. Na criptografia XML, o aplicativo de descriptografação tem apenas os dados criptografados e as transformações especificadas. As transformações são enumeradas na ordem necessária para obter os dados criptografados.

Nota Por padrão, você não pode desreferenciar referências de criptografia de documentos com fontes desconhecidas, como arquivos de um site da Web, porque a DocumentEvidence propriedade é nula. Por exemplo, quando você tenta descriptografar um arquivo que contém um <CipherReference> elemento que faz referência a um arquivo na Web, um SecurityException é gerado, mesmo que a solicitação seja feita por um assembly totalmente confiável.

Se você tiver certeza de que os documentos que está descriptografando podem ser confiáveis, poderá alterar esse comportamento para aplicativos totalmente confiáveis usando o seguinte código:

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

Construtores

CipherReference()	Inicializa uma nova instância da classe CipherReference.
CipherReference(String)	Inicializa uma nova instância da classe CipherReference usando o URI (Uniform Resource Identifier) especificado.
CipherReference(String, TransformChain)	Inicializa uma nova instância da classe CipherReference para criptografia XML usando o URI (Uniform Resource identificador) e informações sobre a cadeia de transformação.

Propriedades

CacheValid	Obtém um valor que indica se o cache é válido. (Herdado de EncryptedReference)
ReferenceType	Obtém ou define um tipo de referência. (Herdado de EncryptedReference)
TransformChain	Obtém ou define a cadeia de transformação de um objeto EncryptedReference. (Herdado de EncryptedReference)
Uri	Obtém ou define o URI (Uniform Resource Identifier) de um objeto EncryptedReference. (Herdado de EncryptedReference)

Métodos

AddTransform(Transform)	Adiciona um objeto Transform à cadeia de transformação atual de um objeto EncryptedReference. (Herdado de EncryptedReference)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetXml()	Retorna a representação XML de um objeto CipherReference.
LoadXml(XmlElement)	Carrega informações de XML no elemento <CipherReference> na criptografia XML.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)