EncryptedXml Klasa

Definicja

Przestrzeń nazw:

System.Security.Cryptography.Xml

Zestaw:

System.Security.Cryptography.Xml.dll

Zestaw:

System.Security.dll

Reprezentuje model procesu implementowania szyfrowania XML.

C#

public class EncryptedXml

Dziedziczenie

Object

EncryptedXml

Przykłady

W poniższym przykładzie kodu pokazano, jak utworzyć prostą klasę narzędzi, która używa algorytmu TripleDES do szyfrowania dokumentu XML.

C#

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

    class Program
    {
        static void Main(string[] args)
        {

            // Create an XmlDocument object.
            XmlDocument xmlDoc = new XmlDocument();

            // Load an XML file into the XmlDocument object.
            try
            {
                xmlDoc.PreserveWhitespace = true;
                xmlDoc.Load("test.xml");
            }
            catch (Exception e)
            {
                Console.WriteLine(e.Message);
                return;
            }

            // Create a new TripleDES key.
            TripleDESCryptoServiceProvider tDESkey = new TripleDESCryptoServiceProvider();

            // Create a new instance of the TrippleDESDocumentEncryption object
            // defined in this sample.
            TrippleDESDocumentEncryption xmlTDES = new TrippleDESDocumentEncryption(xmlDoc, tDESkey);
            
            try
            {
                // Encrypt the "creditcard" element.
                xmlTDES.Encrypt("creditcard");

                // Display the encrypted XML to the console.
                Console.WriteLine("Encrypted XML:");
                Console.WriteLine();
                Console.WriteLine(xmlTDES.Doc.OuterXml);

                // Decrypt the "creditcard" element.
                xmlTDES.Decrypt();

                // Display the encrypted XML to the console.
                Console.WriteLine();
                Console.WriteLine("Decrypted XML:");
                Console.WriteLine();
                Console.WriteLine(xmlTDES.Doc.OuterXml);
            }
            catch (Exception e)
            {
                Console.WriteLine(e.Message);
            }
            finally
            {
                // Clear the TripleDES key.
                xmlTDES.Clear();
            }
        }
    }

class TrippleDESDocumentEncryption
{
    protected XmlDocument docValue;
    protected TripleDES algValue;

    public TrippleDESDocumentEncryption(XmlDocument Doc, TripleDES Key)
    {
        if (Doc != null)
        {
            docValue = Doc;
        }
        else
        {
            throw new ArgumentNullException("Doc");
        }

        if (Key != null)
        {

            algValue = Key;
        }
        else
        {
            throw new ArgumentNullException("Key");
        }
    }

    public XmlDocument Doc { set { docValue = value; } get { return docValue; } }
    public TripleDES Alg { set { algValue = value; } get { return algValue; } }

    public void Clear()
    {
        if (algValue != null)
        {
            algValue.Clear();
        }
        else
        {
            throw new Exception("No TripleDES key was found to clear.");
        }
    }

    public void Encrypt(string Element)
    {
        // Find the element by name and create a new
        // XmlElement object.
        XmlElement inputElement = docValue.GetElementsByTagName(Element)[0] as XmlElement;

        // If the element was not found, throw an exception.
        if (inputElement == null)
        {
            throw new Exception("The element was not found.");
        }

        // Create a new EncryptedXml object.
        EncryptedXml exml = new EncryptedXml(docValue);

        // Encrypt the element using the symmetric key.
        byte[] rgbOutput = exml.EncryptData(inputElement, algValue, false);

        // Create an EncryptedData object and populate it.
        EncryptedData ed = new EncryptedData();

        // Specify the namespace URI for XML encryption elements.
        ed.Type = EncryptedXml.XmlEncElementUrl;

        // Specify the namespace URI for the TrippleDES algorithm.
        ed.EncryptionMethod = new EncryptionMethod(EncryptedXml.XmlEncTripleDESUrl);

        // Create a CipherData element.
        ed.CipherData = new CipherData();

        // Set the CipherData element to the value of the encrypted XML element.
        ed.CipherData.CipherValue = rgbOutput;

        // Replace the plaintext XML elemnt with an EncryptedData element.
        EncryptedXml.ReplaceElement(inputElement, ed, false);
    }

    public void Decrypt()
    {

        // XmlElement object.
        XmlElement encryptedElement = docValue.GetElementsByTagName("EncryptedData")[0] as XmlElement;

        // If the EncryptedData element was not found, throw an exception.
        if (encryptedElement == null)
        {
            throw new Exception("The EncryptedData element was not found.");
        }

        // Create an EncryptedData object and populate it.
        EncryptedData ed = new EncryptedData();
        ed.LoadXml(encryptedElement);

        // Create a new EncryptedXml object.
        EncryptedXml exml = new EncryptedXml();

        // Decrypt the element using the symmetric key.
        byte[] rgbOutput = exml.DecryptData(ed, algValue);

        // Replace the encryptedData element with the plaintext XML elemnt.
        exml.ReplaceData(encryptedElement, rgbOutput);
    }
}

W poniższym przykładzie kodu pokazano, jak zaszyfrować dokument XML przy użyciu klucza symetrycznego. Ten przykład nie zawiera żadnych informacji o kluczu w zaszyfrowanym dokumencie XML.

C#

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

class Program
{
    static void Main(string[] args)
    {

        // Create an XmlDocument object.
        XmlDocument xmlDoc = new XmlDocument();

        // Load an XML file into the XmlDocument object.
        try
        {
            xmlDoc.PreserveWhitespace = true;
            xmlDoc.Load("test.xml");
        }
        catch (Exception e)
        {
            Console.WriteLine(e.Message);
            return;
        }

        // Create a new TripleDES key.
        TripleDESCryptoServiceProvider tDESkey = new TripleDESCryptoServiceProvider();

        try
        {
            // Encrypt the "creditcard" element.
            Encrypt(xmlDoc, "creditcard", tDESkey);

            // Display the encrypted XML to the console.
            Console.WriteLine("Encrypted XML:");
            Console.WriteLine();
            Console.WriteLine(xmlDoc.OuterXml);

            // Decrypt the "creditcard" element.
            Decrypt(xmlDoc, tDESkey);

            // Display the encrypted XML to the console.
            Console.WriteLine();
            Console.WriteLine("Decrypted XML:");
            Console.WriteLine();
            Console.WriteLine(xmlDoc.OuterXml);
        }
        catch (Exception e)
        {
            Console.WriteLine(e.Message);
        }
        finally
        {
            // Clear the TripleDES key.
            tDESkey.Clear();
        }
    }

    public static void Encrypt(XmlDocument Doc, string ElementToEncrypt, SymmetricAlgorithm Alg)
    {
        // Check the arguments.
        if (Doc == null)
            throw new ArgumentNullException("Doc");
        if (ElementToEncrypt == null)
            throw new ArgumentNullException("ElementToEncrypt");
        if (Alg == null)
            throw new ArgumentNullException("Alg");

        ////////////////////////////////////////////////
        // Find the specified element in the XmlDocument
        // object and create a new XmlElemnt object.
        ////////////////////////////////////////////////

        XmlElement elementToEncrypt = Doc.GetElementsByTagName(ElementToEncrypt)[0] as XmlElement;

        // Throw an XmlException if the element was not found.
        if (elementToEncrypt == null)
        {
            throw new XmlException("The specified element was not found");
        }

        //////////////////////////////////////////////////
        // Create a new instance of the EncryptedXml class
        // and use it to encrypt the XmlElement with the
        // symmetric key.
        //////////////////////////////////////////////////

        EncryptedXml eXml = new EncryptedXml();

        byte[] encryptedElement = eXml.EncryptData(elementToEncrypt, Alg, false);

        ////////////////////////////////////////////////
        // Construct an EncryptedData object and populate
        // it with the desired encryption information.
        ////////////////////////////////////////////////

        EncryptedData edElement = new EncryptedData();
        edElement.Type = EncryptedXml.XmlEncElementUrl;

        // Create an EncryptionMethod element so that the
        // receiver knows which algorithm to use for decryption.
        // Determine what kind of algorithm is being used and
        // supply the appropriate URL to the EncryptionMethod element.

        string encryptionMethod = null;

        if (Alg is TripleDES)
        {
            encryptionMethod = EncryptedXml.XmlEncTripleDESUrl;
        }
        else if (Alg is DES)
        {
            encryptionMethod = EncryptedXml.XmlEncDESUrl;
        }
        else if (Alg is Aes)
        {
            switch (Alg.KeySize)
            {
                case 128:
                    encryptionMethod = EncryptedXml.XmlEncAES128Url;
                    break;
                case 192:
                    encryptionMethod = EncryptedXml.XmlEncAES192Url;
                    break;
                case 256:
                    encryptionMethod = EncryptedXml.XmlEncAES256Url;
                    break;
            }
        }
        else
        {
            // Throw an exception if the transform is not in the previous categories
            throw new CryptographicException("The specified algorithm is not supported for XML Encryption.");
        }

        edElement.EncryptionMethod = new EncryptionMethod(encryptionMethod);

        // Add the encrypted element data to the
        // EncryptedData object.
        edElement.CipherData.CipherValue = encryptedElement;

        ////////////////////////////////////////////////////
        // Replace the element from the original XmlDocument
        // object with the EncryptedData element.
        ////////////////////////////////////////////////////

        EncryptedXml.ReplaceElement(elementToEncrypt, edElement, false);
    }

    public static void Decrypt(XmlDocument Doc, SymmetricAlgorithm Alg)
    {
        // Check the arguments.
        if (Doc == null)
            throw new ArgumentNullException("Doc");
        if (Alg == null)
            throw new ArgumentNullException("Alg");

        // Find the EncryptedData element in the XmlDocument.
        XmlElement encryptedElement = Doc.GetElementsByTagName("EncryptedData")[0] as XmlElement;

        // If the EncryptedData element was not found, throw an exception.
        if (encryptedElement == null)
        {
            throw new XmlException("The EncryptedData element was not found.");
        }

        // Create an EncryptedData object and populate it.
        EncryptedData edElement = new EncryptedData();
        edElement.LoadXml(encryptedElement);

        // Create a new EncryptedXml object.
        EncryptedXml exml = new EncryptedXml();

        // Decrypt the element using the symmetric key.
        byte[] rgbOutput = exml.DecryptData(edElement, Alg);

        // Replace the encryptedData element with the plaintext XML element.
        exml.ReplaceData(encryptedElement, rgbOutput);
    }
}

W poniższym przykładzie kodu pokazano, jak zaszyfrować dokument XML przy użyciu klucza symetrycznego. Ten przykład osadza nazwę klucza w zaszyfrowanym dokumencie XML używanym przez metodę odszyfrowywania w celu znalezienia odpowiedniego klucza odszyfrowywania.

C#

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

class Program
{
    static void Main(string[] args)
    {

        // Create an XmlDocument object.
        XmlDocument xmlDoc = new XmlDocument();

        // Load an XML file into the XmlDocument object.
        try
        {
            xmlDoc.PreserveWhitespace = true;
            xmlDoc.Load("test.xml");
        }
        catch (Exception e)
        {
            Console.WriteLine(e.Message);
            return;
        }

        // Create a new TripleDES key.
        TripleDESCryptoServiceProvider tDESkey = new TripleDESCryptoServiceProvider();

        try
        {
            // Encrypt the "creditcard" element.
            Encrypt(xmlDoc, "creditcard", tDESkey, "tDESKey");

            // Display the encrypted XML to the console.
            Console.WriteLine("Encrypted XML:");
            Console.WriteLine();
            Console.WriteLine(xmlDoc.OuterXml);

            // Decrypt the "creditcard" element.
            Decrypt(xmlDoc, tDESkey, "tDESKey");

            // Display the encrypted XML to the console.
            Console.WriteLine();
            Console.WriteLine("Decrypted XML:");
            Console.WriteLine();
            Console.WriteLine(xmlDoc.OuterXml);
        }
        catch (Exception e)
        {
            Console.WriteLine(e.Message);
        }
        finally
        {
            // Clear the TripleDES key.
            tDESkey.Clear();
        }
    }

    public static void Encrypt(XmlDocument Doc, string ElementToEncrypt, SymmetricAlgorithm Alg, string KeyName)
    {
        // Check the arguments.
        if (Doc == null)
            throw new ArgumentNullException("Doc");
        if (ElementToEncrypt == null)
            throw new ArgumentNullException("ElementToEncrypt");
        if (Alg == null)
            throw new ArgumentNullException("Alg");

        ////////////////////////////////////////////////
        // Find the specified element in the XmlDocument
        // object and create a new XmlElemnt object.
        ////////////////////////////////////////////////

        XmlElement elementToEncrypt = Doc.GetElementsByTagName(ElementToEncrypt)[0] as XmlElement;

        // Throw an XmlException if the element was not found.
        if (elementToEncrypt == null)
        {
            throw new XmlException("The specified element was not found");
        }

        //////////////////////////////////////////////////
        // Create a new instance of the EncryptedXml class
        // and use it to encrypt the XmlElement with the
        // symmetric key.
        //////////////////////////////////////////////////

        EncryptedXml eXml = new EncryptedXml();

        byte[] encryptedElement = eXml.EncryptData(elementToEncrypt, Alg, false);

        ////////////////////////////////////////////////
        // Construct an EncryptedData object and populate
        // it with the desired encryption information.
        ////////////////////////////////////////////////

        EncryptedData edElement = new EncryptedData();
        edElement.Type = EncryptedXml.XmlEncElementUrl;

        // Create an EncryptionMethod element so that the
        // receiver knows which algorithm to use for decryption.
        // Determine what kind of algorithm is being used and
        // supply the appropriate URL to the EncryptionMethod element.

        string encryptionMethod = null;

        if (Alg is TripleDES)
        {
            encryptionMethod = EncryptedXml.XmlEncTripleDESUrl;
        }
        else if (Alg is DES)
        {
            encryptionMethod = EncryptedXml.XmlEncDESUrl;
        }
        else if (Alg is Aes)
        {
            switch (Alg.KeySize)
            {
                case 128:
                    encryptionMethod = EncryptedXml.XmlEncAES128Url;
                    break;
                case 192:
                    encryptionMethod = EncryptedXml.XmlEncAES192Url;
                    break;
                case 256:
                    encryptionMethod = EncryptedXml.XmlEncAES256Url;
                    break;
            }
        }
        else
        {
            // Throw an exception if the transform is not in the previous categories
            throw new CryptographicException("The specified algorithm is not supported for XML Encryption.");
        }

        edElement.EncryptionMethod = new EncryptionMethod(encryptionMethod);

        // Set the KeyInfo element to specify the
        // name of a key.

        // Create a new KeyInfo element.
        edElement.KeyInfo = new KeyInfo();

        // Create a new KeyInfoName element.
        KeyInfoName kin = new KeyInfoName();

        // Specify a name for the key.
        kin.Value = KeyName;

        // Add the KeyInfoName element.
        edElement.KeyInfo.AddClause(kin);

        // Add the encrypted element data to the
        // EncryptedData object.
        edElement.CipherData.CipherValue = encryptedElement;

        ////////////////////////////////////////////////////
        // Replace the element from the original XmlDocument
        // object with the EncryptedData element.
        ////////////////////////////////////////////////////

        EncryptedXml.ReplaceElement(elementToEncrypt, edElement, false);
    }

    public static void Decrypt(XmlDocument Doc, SymmetricAlgorithm Alg, string KeyName)
    {
        // Check the arguments.
        if (Doc == null)
            throw new ArgumentNullException("Doc");
        if (Alg == null)
            throw new ArgumentNullException("Alg");
        if (KeyName == null)
            throw new ArgumentNullException("KeyName");

        // Create a new EncryptedXml object.
        EncryptedXml exml = new EncryptedXml(Doc);

        // Add a key-name mapping.
        // This method can only decrypt documents
        // that present the specified key name.
        exml.AddKeyNameMapping(KeyName, Alg);

        // Decrypt the element.
        exml.DecryptDocument();
    }
}

W poniższym przykładzie kodu pokazano, jak zaszyfrować dokument XML przy użyciu klucza asymetrycznego. Ten przykład tworzy symetryczny klucz sesji w celu zaszyfrowania dokumentu, a następnie używa klucza asymetrycznego do osadzenia zaszyfrowanej wersji klucza sesji w dokumencie XML.

C#

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

class Program
{
    static void Main(string[] args)
    {

        // Create an XmlDocument object.
        XmlDocument xmlDoc = new XmlDocument();

        // Load an XML file into the XmlDocument object.
        try
        {
            xmlDoc.PreserveWhitespace = true;
            xmlDoc.Load("test.xml");
        }
        catch (Exception e)
        {
            Console.WriteLine(e.Message);
            return;
        }

        // Create a new RSA key.  This key will encrypt a symmetric key,
        // which will then be imbedded in the XML document.
        RSA rsaKey = RSA.Create();

        try
        {
            // Encrypt the "creditcard" element.
            Encrypt(xmlDoc, "creditcard", rsaKey, "rsaKey");

            // Display the encrypted XML to the console.
            Console.WriteLine("Encrypted XML:");
            Console.WriteLine();
            Console.WriteLine(xmlDoc.OuterXml);
            xmlDoc.Save("test.xml");

            // Decrypt the "creditcard" element.
            Decrypt(xmlDoc, rsaKey, "rsaKey");
            xmlDoc.Save("test.xml");

            // Display the encrypted XML to the console.
            Console.WriteLine();
            Console.WriteLine("Decrypted XML:");
            Console.WriteLine();
            Console.WriteLine(xmlDoc.OuterXml);
        }
        catch (Exception e)
        {
            Console.WriteLine(e.Message);
        }
        finally
        {
            // Clear the RSA key.
            rsaKey.Clear();
        }
    }

    public static void Encrypt(XmlDocument Doc, string ElementToEncrypt, RSA Alg, string KeyName)
    {
        // Check the arguments.
        if (Doc == null)
            throw new ArgumentNullException("Doc");
        if (ElementToEncrypt == null)
            throw new ArgumentNullException("ElementToEncrypt");
        if (Alg == null)
            throw new ArgumentNullException("Alg");

        ////////////////////////////////////////////////
        // Find the specified element in the XmlDocument
        // object and create a new XmlElemnt object.
        ////////////////////////////////////////////////

        XmlElement elementToEncrypt = Doc.GetElementsByTagName(ElementToEncrypt)[0] as XmlElement;

        // Throw an XmlException if the element was not found.
        if (elementToEncrypt == null)
        {
            throw new XmlException("The specified element was not found");
        }

        //////////////////////////////////////////////////
        // Create a new instance of the EncryptedXml class
        // and use it to encrypt the XmlElement with the
        // a new random symmetric key.
        //////////////////////////////////////////////////

        // Create a 256 bit Aes key.
        Aes sessionKey = Aes.Create();
        sessionKey.KeySize = 256;

        EncryptedXml eXml = new EncryptedXml();

        byte[] encryptedElement = eXml.EncryptData(elementToEncrypt, sessionKey, false);

        ////////////////////////////////////////////////
        // Construct an EncryptedData object and populate
        // it with the desired encryption information.
        ////////////////////////////////////////////////

        EncryptedData edElement = new EncryptedData();
        edElement.Type = EncryptedXml.XmlEncElementUrl;

        // Create an EncryptionMethod element so that the
        // receiver knows which algorithm to use for decryption.

        edElement.EncryptionMethod = new EncryptionMethod(EncryptedXml.XmlEncAES256Url);

        // Encrypt the session key and add it to an EncryptedKey element.
        EncryptedKey ek = new EncryptedKey();

        byte[] encryptedKey = EncryptedXml.EncryptKey(sessionKey.Key, Alg, false);

        ek.CipherData = new CipherData(encryptedKey);

        ek.EncryptionMethod = new EncryptionMethod(EncryptedXml.XmlEncRSA15Url);

        // Set the KeyInfo element to specify the
        // name of the RSA key.

        // Create a new KeyInfo element.
        edElement.KeyInfo = new KeyInfo();

        // Create a new KeyInfoName element.
        KeyInfoName kin = new KeyInfoName();

        // Specify a name for the key.
        kin.Value = KeyName;

        // Add the KeyInfoName element to the
        // EncryptedKey object.
        ek.KeyInfo.AddClause(kin);

        // Add the encrypted key to the
        // EncryptedData object.

        edElement.KeyInfo.AddClause(new KeyInfoEncryptedKey(ek));

        // Add the encrypted element data to the
        // EncryptedData object.
        edElement.CipherData.CipherValue = encryptedElement;

        ////////////////////////////////////////////////////
        // Replace the element from the original XmlDocument
        // object with the EncryptedData element.
        ////////////////////////////////////////////////////

        EncryptedXml.ReplaceElement(elementToEncrypt, edElement, false);
    }

    public static void Decrypt(XmlDocument Doc, RSA Alg, string KeyName)
    {
        // Check the arguments.
        if (Doc == null)
            throw new ArgumentNullException("Doc");
        if (Alg == null)
            throw new ArgumentNullException("Alg");
        if (KeyName == null)
            throw new ArgumentNullException("KeyName");

        // Create a new EncryptedXml object.
        EncryptedXml exml = new EncryptedXml(Doc);

        // Add a key-name mapping.
        // This method can only decrypt documents
        // that present the specified key name.
        exml.AddKeyNameMapping(KeyName, Alg);

        // Decrypt the element.
        exml.DecryptDocument();
    }
}

Poniższy przykład kodu przedstawia sposób szyfrowania dokumentu XML przy użyciu certyfikatu X.509. Ten przykład tworzy symetryczny klucz sesji w celu zaszyfrowania dokumentu, a następnie używa certyfikatu X.509 do osadzenia zaszyfrowanej wersji klucza sesji w dokumencie XML.

C#

using System;
using System.Xml;
using System.Security.Cryptography;
using System.Security.Cryptography.Xml;
using System.Security.Cryptography.X509Certificates;

class Program
{
    static void Main(string[] args)
    {

        // Create an XmlDocument object.
        XmlDocument xmlDoc = new XmlDocument();

        // Load an XML file into the XmlDocument object.
        try
        {
            xmlDoc.PreserveWhitespace = true;
            xmlDoc.Load("test.xml");
        }
        catch (Exception e)
        {
            Console.WriteLine(e.Message);
            return;
        }

        // Create a new X509Certificate2 object by loading
        // an X.509 certificate file.  To use XML encryption
        // with an X.509 certificate, use an X509Certificate2
        // object to encrypt, but use a certificate in a certificate
        // store to decrypt.

        // You can create a new test certificate file using the
        // makecert.exe tool.

        // Create an X509Certificate2 object for encryption.
        X509Certificate2 cert = new X509Certificate2("test.pfx");

        // Put the certificate in certificate store for decryption.
        X509Store store = new X509Store(StoreLocation.CurrentUser);

        store.Open(OpenFlags.ReadWrite);

        store.Add(cert);

        store.Close();

        try
        {
            // Encrypt the "creditcard" element.
            Encrypt(xmlDoc, "creditcard", cert);

            // Display the encrypted XML to the console.
            Console.WriteLine("Encrypted XML:");
            Console.WriteLine();
            Console.WriteLine(xmlDoc.OuterXml);

            // Decrypt the "creditcard" element.
            Decrypt(xmlDoc);

            // Display the encrypted XML to the console.
            Console.WriteLine();
            Console.WriteLine("Decrypted XML:");
            Console.WriteLine();
            Console.WriteLine(xmlDoc.OuterXml);
        }
        catch (Exception e)
        {
            Console.WriteLine(e.Message);
        }
    }

    public static void Encrypt(XmlDocument Doc, string ElementToEncrypt, X509Certificate2 Cert)
    {
        // Check the arguments.
        if (Doc == null)
            throw new ArgumentNullException("Doc");
        if (ElementToEncrypt == null)
            throw new ArgumentNullException("ElementToEncrypt");
        if (Cert == null)
            throw new ArgumentNullException("Cert");

        ////////////////////////////////////////////////
        // Find the specified element in the XmlDocument
        // object and create a new XmlElemnt object.
        ////////////////////////////////////////////////

        XmlElement elementToEncrypt = Doc.GetElementsByTagName(ElementToEncrypt)[0] as XmlElement;

        // Throw an XmlException if the element was not found.
        if (elementToEncrypt == null)
        {
            throw new XmlException("The specified element was not found");
        }

        //////////////////////////////////////////////////
        // Create a new instance of the EncryptedXml class
        // and use it to encrypt the XmlElement with the
        // X.509 Certificate.
        //////////////////////////////////////////////////

        EncryptedXml eXml = new EncryptedXml();

        // Encrypt the element.
        EncryptedData edElement = eXml.Encrypt(elementToEncrypt, Cert);

        ////////////////////////////////////////////////////
        // Replace the element from the original XmlDocument
        // object with the EncryptedData element.
        ////////////////////////////////////////////////////

        EncryptedXml.ReplaceElement(elementToEncrypt, edElement, false);
    }

    public static void Decrypt(XmlDocument Doc)
    {
        // Check the arguments.
        if (Doc == null)
            throw new ArgumentNullException("Doc");

        // Create a new EncryptedXml object.
        EncryptedXml exml = new EncryptedXml(Doc);

        // Decrypt the XML document.
        exml.DecryptDocument();
    }
}

Uwagi

Klasa EncryptedXml jest główną klasą używaną do szyfrowania XML w .NET Framework. Szyfrowanie XML to oparty na standardach, współdziałalny sposób szyfrowania wszystkich lub części dokumentu XML lub dowolnych danych. Klasy szyfrowania .NET FRAMEWORK XML implementują specyfikację składni i przetwarzania XML w wersji 1.0 konsorcjum World Wide Web Consortium (W3C).

EncryptedXml Użyj klasy zawsze, gdy zachodzi potrzeba udostępniania zaszyfrowanych danych XML między aplikacjami lub organizacjami w standardowy sposób. Wszystkie dane zaszyfrowane przy użyciu tej klasy można odszyfrować za pomocą dowolnej implementacji specyfikacji W3C na potrzeby szyfrowania XML.

Szyfrowanie XML zastępuje dowolny element XML zwykłego tekstu lub dokument <EncryptedData> elementem, który zawiera zaszyfrowaną (lub tekst szyfrową) reprezentację zwykłego tekstu XML lub dowolnych danych. Element <EncryptedData> może opcjonalnie zawierać informacje o tym, gdzie znaleźć klucz, który odszyfruje tekst szyfrowania i który algorytm kryptograficzny został użyty do szyfrowania zwykłego tekstu.

Element <EncryptedKey> jest podobny do <EncryptedData> elementu w stylu i użyciu, z tą różnicą, że umożliwia szyfrowanie klucza, który odszyfruje wartość <EncryptedData> elementu. Należy pamiętać, że <EncryptedKey> element i <EncryptedData> element nigdy nie będą zawierać niezaszyfrowanego klucza.

Aby wymienić kluczowe informacje, użyj jednej z następujących metod:

• Nie dołączaj żadnych kluczowych informacji. W przypadku wybrania tej opcji obie strony muszą uzgodnić algorytm i klucz przed wymianą zaszyfrowanych danych.

• Uwzględnij lokalizację klucza w atrybucie <RetrievalMethod> Uniform Resource Identifier (URI) elementu. Obie strony muszą z wyprzedzeniem uzgodnić kluczową lokalizację, a ta lokalizacja musi być przechowywana w tajemnicy.

• Dołącz nazwę ciągu mapowania na klucz w elemecie <KeyName> . Obie strony muszą uzgodnić mapowanie nazw kluczy przed wymianą zaszyfrowanych danych, a to mapowanie musi być przechowywane w tajemnicy.

• Dołącz zaszyfrowany klucz do <EncryptedKey> elementu . Obie strony muszą uzgodnić klucz, który odszyfrowuje zaszyfrowany klucz przed wymianą zaszyfrowanych danych. Opcjonalnie możesz dołączyć nazwę lub lokalizację klucza, który odszyfruje klucz w elemecie <EncryptedKey> .

Konstruktory

EncryptedXml()	Inicjuje nowe wystąpienie klasy EncryptedXml.
EncryptedXml(XmlDocument)	Inicjuje EncryptedXml nowe wystąpienie klasy przy użyciu określonego dokumentu XML.
EncryptedXml(XmlDocument, Evidence)	Inicjuje EncryptedXml nowe wystąpienie klasy przy użyciu określonego dokumentu XML i dowodów.

Pola

XmlEncAES128KeyWrapUrl	Reprezentuje algorytm zawijania klucza 128-bitowego standardu AES (Uniform Resource Identifier) przestrzeni nazw (Rijndael Key Wrap algorithm). To pole jest stałe.
XmlEncAES128Url	Reprezentuje przestrzeń nazw Uniform Resource Identifier (URI) algorytmu 128-bitowego algorytmu Advanced Encryption Standard (AES) (znanego również jako algorytm Rijndael). To pole jest stałe.
XmlEncAES192KeyWrapUrl	Reprezentuje algorytm zawijania klucza 192-bitowego standardu AES (Uniform Resource Identifier) przestrzeni nazw (Rijndael Key Wrap algorithm). To pole jest stałe.
XmlEncAES192Url	Reprezentuje przestrzeń nazw Uniform Resource Identifier (URI) dla algorytmu 192-bitowego algorytmu Advanced Encryption Standard (AES) (znanego również jako algorytm Rijndael). To pole jest stałe.
XmlEncAES256KeyWrapUrl	Reprezentuje algorytm zawijania klucza 256-bitowego standardu AES (Uniform Resource Identifier) przestrzeni nazw (Rijndael Key Wrap algorithm). To pole jest stałe.
XmlEncAES256Url	Reprezentuje przestrzeń nazw Uniform Resource Identifier (URI) dla 256-bitowego algorytmu AES (Advanced Encryption Standard) (znanego również jako algorytm Rijndael). To pole jest stałe.
XmlEncDESUrl	Reprezentuje przestrzeń nazw Uniform Resource Identifier (URI) algorytmu szyfrowania cyfrowego (DES). To pole jest stałe.
XmlEncElementContentUrl	Reprezentuje przestrzeń nazw Uniform Resource Identifier (URI) dla zawartości elementu szyfrowania XML. To pole jest stałe.
XmlEncElementUrl	Reprezentuje przestrzeń nazw Uniform Resource Identifier (URI) dla elementu szyfrowania XML. To pole jest stałe.
XmlEncEncryptedKeyUrl	Reprezentuje przestrzeń nazw Uniform Resource Identifier (URI) dla elementu szyfrowania <EncryptedKey> XML. To pole jest stałe.
XmlEncNamespaceUrl	Reprezentuje przestrzeń nazw Uniform Resource Identifier (URI) dla składni i przetwarzania szyfrowania XML. To pole jest stałe.
XmlEncRSA15Url	Reprezentuje identyfikator URI (Uniform Resource Identifier) przestrzeni nazw dla algorytmu PKCS (Public Key Cryptography Standard) RSA (Public Key Cryptography Standard) w wersji 1.5. To pole jest stałe.
XmlEncRSAOAEPUrl	Reprezentuje przestrzeń nazw Uniform Resource Identifier (URI) dla algorytmu szyfrowania RSA Optimal Asymetryczne dopełnienie szyfrowania (OAEP). To pole jest stałe.
XmlEncSHA256Url	Reprezentuje przestrzeń nazw Uniform Resource Identifier (URI) dla algorytmu SHA-256. To pole jest stałe.
XmlEncSHA512Url	Reprezentuje przestrzeń nazw Uniform Resource Identifier (URI) dla algorytmu SHA-512. To pole jest stałe.
XmlEncTripleDESKeyWrapUrl	Reprezentuje przestrzeń nazw Uniform Resource Identifier (URI) dla algorytmu zawijania kluczy TRIPLEDES. To pole jest stałe.
XmlEncTripleDESUrl	Reprezentuje przestrzeń nazw Uniform Resource Identifier (URI) dla algorytmu Triple DES. To pole jest stałe.

Właściwości

DocumentEvidence	Pobiera lub ustawia dowody XmlDocument obiektu, z którego EncryptedXml jest skonstruowany obiekt.
Encoding	Pobiera lub ustawia kodowanie używane do szyfrowania XML.
Mode	Pobiera lub ustawia tryb szyfrowania używany do szyfrowania XML.
Padding	Pobiera lub ustawia tryb wypełniania używany do szyfrowania XML.
Recipient	Pobiera lub ustawia adresat zaszyfrowanych informacji o kluczu.
Resolver	Pobiera lub ustawia XmlResolver obiekt używany przez model dom (Document Object Model) do rozpoznawania odwołań zewnętrznych XML.
XmlDSigSearchDepth	Pobiera lub ustawia głębokość rekursji podpisu cyfrowego XML, aby zapobiec nieskończonej rekursji i przepełnieniu stosu. Może się tak zdarzyć, jeśli kod XML podpisu cyfrowego zawiera identyfikator URI, który następnie wskazuje oryginalny kod XML.

Metody

AddKeyNameMapping(String, Object)	Definiuje mapowanie między nazwą klucza a kluczem symetrycznym lub kluczem asymetrycznym.
ClearKeyNameMappings()	Resetuje wszystkie mapowanie nazw kluczy.
DecryptData(EncryptedData, SymmetricAlgorithm)	Odszyfrowuje <EncryptedData> element przy użyciu określonego algorytmu symetrycznego.
DecryptDocument()	Odszyfrowuje wszystkie <EncryptedData> elementy dokumentu XML, które zostały określone podczas inicjowania EncryptedXml klasy.
DecryptEncryptedKey(EncryptedKey)	Określa klucz reprezentowany przez EncryptedKey element.
DecryptKey(Byte[], RSA, Boolean)	Odszyfrowuje <EncryptedKey> element przy użyciu algorytmu asymetrycznego.
DecryptKey(Byte[], SymmetricAlgorithm)	Odszyfrowuje <EncryptedKey> element przy użyciu algorytmu symetrycznego.
Encrypt(XmlElement, String)	Szyfruje zewnętrzny kod XML elementu przy użyciu określonego klucza w tabeli mapowania kluczy.
Encrypt(XmlElement, X509Certificate2)	Szyfruje zewnętrzny kod XML elementu przy użyciu określonego certyfikatu X.509.
EncryptData(Byte[], SymmetricAlgorithm)	Szyfruje dane w określonej tablicy bajtów przy użyciu określonego algorytmu symetrycznego.
EncryptData(XmlElement, SymmetricAlgorithm, Boolean)	Szyfruje określony element lub jego zawartość przy użyciu określonego algorytmu symetrycznego.
EncryptKey(Byte[], RSA, Boolean)	Szyfruje klucz używany przez adresata <EncryptedData> do odszyfrowywania elementu.
EncryptKey(Byte[], SymmetricAlgorithm)	Szyfruje klucz przy użyciu algorytmu symetrycznego, którego odbiorca używa do odszyfrowywania <EncryptedData> elementu.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetDecryptionIV(EncryptedData, String)	Pobiera wektor inicjowania odszyfrowywania (IV) z EncryptedData obiektu.
GetDecryptionKey(EncryptedData, String)	Pobiera klucz odszyfrowywania z określonego EncryptedData obiektu.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetIdElement(XmlDocument, String)	Określa sposób rozpoznawania wewnętrznych odwołań identyfikatora URI (Uniform Resource Identifier).
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ReplaceData(XmlElement, Byte[])	Zastępuje element określoną odszyfrowaną <EncryptedData> sekwencją bajtów.
ReplaceElement(XmlElement, EncryptedData, Boolean)	Zamienia określony element na określony EncryptedData obiekt.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Dotyczy