CipherReference Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет элемент <CipherReference> в XML-шифровании. Этот класс не наследуется.
public ref class CipherReference sealed : System::Security::Cryptography::Xml::EncryptedReferencepublic sealed class CipherReference : System.Security.Cryptography.Xml.EncryptedReferencetype CipherReference = class
inherit EncryptedReferencePublic NotInheritable Class CipherReference
Inherits EncryptedReference- Наследование
Примеры
В следующем примере кода создается новый экземпляр .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
Комментарии
Этот класс представляет <CipherReference> элемент в XML-шифровании. Он идентифицирует источник, который при обработке возвращает зашифрованные данные.
Фактические зашифрованные данные, на которые ссылается объект , <CipherReference> получаются следующим процессом. Свойство <CipherReference> URI содержит универсальный код ресурса (URI), разыменованный.
<CipherReference> Если элемент также содержит цепочку преобразования, данные, полученные в результате разыменовки URI, преобразуются в соответствии с указанными для создания зашифрованных данных. Например, если зашифрованные данные в XML-документе закодированы в кодировке Base64, преобразования указывают выражение XPath, за которым следует декодирование Base64, чтобы можно было извлечь зашифрованные данные.
Синтаксис URI и преобразований аналогичен синтаксису цифровых подписей XML. Однако в цифровых подписях XML и генерация, и проверочный процесс начинаются с одних и того же источника данных и выполняют это преобразование в одном порядке. При шифровании XML приложение расшифровывает только зашифрованные данные и указанные преобразования. Преобразования перечисляются в порядке, необходимом для получения зашифрованных данных.
Примечание По умолчанию нельзя разыменовывать ссылки на шифры из документов с неизвестными источниками, такими как файлы с веб-сайта, так как DocumentEvidence свойство имеет значение NULL. Например, при попытке расшифровать файл, содержащий <CipherReference> элемент, ссылающийся на файл в Интернете, SecurityException создается исключение , даже если запрос выполняется сборкой с полным доверием.
Если вы уверены, что расшифровываемые документы могут быть доверенными, это поведение можно изменить для полностью доверенных приложений с помощью следующего кода:
Evidence ev = new Evidence();
ev.AddHost (new Zone(SecurityZone.MyComputer));
EncryptedXml exml = new EncryptedXml(doc, ev);
Конструкторы
| CipherReference() |
Инициализирует новый экземпляр класса CipherReference. |
| CipherReference(String) |
Инициализирует новый экземпляр класса CipherReference с помощью указанного универсального кода ресурса (URI). |
| CipherReference(String, TransformChain) |
Инициализирует новый экземпляр класса CipherReference указанным URI и сведениями о цепочке преобразований. |
Свойства
| CacheValid |
Получает значение, указывающее, является ли кэш допустимым. (Унаследовано от EncryptedReference) |
| ReferenceType |
Получает или задает ссылочный тип. (Унаследовано от EncryptedReference) |
| TransformChain |
Получает или задает цепочку преобразований объекта EncryptedReference. (Унаследовано от EncryptedReference) |
| Uri |
Получает или задает универсальный код ресурса (URI) объекта EncryptedReference. (Унаследовано от EncryptedReference) |
Методы
| AddTransform(Transform) |
Добавляет объект Transform в цепочку преобразований объекта EncryptedReference. (Унаследовано от EncryptedReference) |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
| GetXml() |
Возвращает XML-представление объекта CipherReference. |
| LoadXml(XmlElement) |
Загружает сведения XML в элемент |
| MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
