EncryptedKeyとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

EncryptedKey クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

XML 暗号化の <EncryptedKey> 要素を表します。このクラスは継承できません。

名前空間: System.Security.Cryptography.Xml
アセンブリ: System.Security (system.security.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 EncryptedKey
    Inherits EncryptedType

Visual Basic (使用法)

Dim instance As EncryptedKey

public sealed class EncryptedKey : EncryptedType

C++

public ref class EncryptedKey sealed : public
 EncryptedType

public final class EncryptedKey extends EncryptedType

JScript

public final class EncryptedKey extends
 EncryptedType

解説

このクラスは、XML 暗号化の <EncryptedKey> 要素を表します。<EncryptedKey> 要素は、暗号化キーを送信するために使用します。この要素は、スタンドアロン XML ドキュメント内に作成できます。また、アプリケーションドキュメント内に配置したり、<EncryptedData> 要素内に <KeyInfo> 要素の子として配置したりできます。キー値は受信者に対して常に暗号化されます。<EncryptedKey> が復号化されると、追加の処理を必要とすることなく、<EncryptionMethod> アルゴリズムで結果のキーを利用できるようになります。

<EncryptedKey> 要素は、EncryptedData クラスの <EncryptedData> 要素に似ていますが、暗号化されるデータが常にキー値であるという点が異なります。

使用例

EncryptedKey クラスを使用して、XML 要素を暗号化および復号化する方法を次のコード例に示します。この例を実行すると、EncryptedKey クラスの各種のプロパティの値がコンソールに表示されます。

Visual Basic

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



Module Program

    Sub Main(ByVal args() As
 String)

        ' Create an XmlDocument object.
        Dim xmlDoc As New
 XmlDocument()

        ' Load an XML file into the XmlDocument object.
        Try
            xmlDoc.PreserveWhitespace = True
            xmlDoc.Load("test.xml")
        Catch e As Exception
            Console.WriteLine(e.Message)
        End Try

        ' Create a new RSA key.  This key will encrypt a symmetric key
,
        ' which will then be imbedded in the XML document.  
        Dim rsaKey As New
 RSACryptoServiceProvider()


        Try
            ' Encrypt the "creditcard" element.
            Encrypt(xmlDoc, "creditcard", rsaKey,
 "rsaKey")

            ' Inspect the EncryptedKey element.
            InspectElement(xmlDoc)

            ' Decrypt the "creditcard" element.
            Decrypt(xmlDoc, rsaKey, "rsaKey")

        Catch e As Exception
            Console.WriteLine(e.Message)
        Finally
            ' Clear the RSA key.
            rsaKey.Clear()
        End Try

    End Sub


    Sub Encrypt(ByVal Doc As
 XmlDocument, ByVal ElementToEncryptParam As
 String, ByVal Alg As RSA, ByVal KeyName As String)
        ' Check the arguments.  
        If Doc Is Nothing
 Then
            Throw New ArgumentNullException("Doc")
        End If
        If ElementToEncryptParam Is Nothing
 Then
            Throw New ArgumentNullException("ElementToEncrypt")
        End If
        If Alg Is Nothing
 Then
            Throw New ArgumentNullException("Alg")
        End If
        ''''''''''''''''''''''''''''''''''''''''''''''''''''
        ' Find the specified element in the XmlDocument
        ' object and create a new XmlElemnt object.
        ''''''''''''''''''''''''''''''''''''''''''''''''''''
        Dim elementToEncrypt As XmlElement
 = Doc.GetElementsByTagName(ElementToEncryptParam)(0)


        ' Throw an XmlException if the element was not found.
        If elementToEncrypt Is Nothing
 Then
            Throw New XmlException("The
 specified element was not found")
        End If

        ''''''''''''''''''''''''''''''''''''''''''''''''''''
        ' 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 Rijndael key.
        Dim sessionKey As New
 RijndaelManaged()
        sessionKey.KeySize = 256

        Dim eXml As New
 EncryptedXml()

        Dim encryptedElement As Byte()
 = eXml.EncryptData(elementToEncrypt, sessionKey, False)

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

        Dim edElement As 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.
        Dim ek As New EncryptedKey()

        Dim encryptedKey As Byte()
 = 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.
        Dim kin As 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)

    End Sub


    Sub Decrypt(ByVal Doc As
 XmlDocument, ByVal Alg As RSA, ByVal
 KeyName As String)
        ' Check the arguments.  
        If Doc Is Nothing
 Then
            Throw New ArgumentNullException("Doc")
        End If
        If Alg Is Nothing
 Then
            Throw New ArgumentNullException("Alg")
        End If
        If KeyName Is Nothing
 Then
            Throw New ArgumentNullException("KeyName")
        End If
        ' Create a new EncryptedXml object.
        Dim exml As 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()

    End Sub


    Sub InspectElement(ByVal Doc As
 XmlDocument)
        ' Get the EncryptedKey element from the XMLDocument object.
        Dim encryptedKey As XmlElement = Doc.GetElementsByTagName("EncryptedKey")(0)

        ' Create a new EncryptedKey object.
        Dim k As New EncryptedKey()

        ' Load the XML from the document to
        ' initialize the EncryptedKey object.
        k.LoadXml(encryptedKey)

        ' Display the properties.
        ' Most values are Null by default.
        Console.WriteLine("EncryptedKey.KeyInfo: "
 + k.KeyInfo.GetXml().InnerXml)
        Console.WriteLine("EncryptedKey.Id: " + k.Id)
        Console.WriteLine("EncryptedKey.CarriedKeyName: "
 + k.CarriedKeyName)
        Console.WriteLine("EncryptedKey.CipherData: "
 + k.CipherData.GetXml().InnerXml)
        Console.WriteLine("EncryptedKey.Encoding: "
 + k.Encoding)
        Console.WriteLine("EncryptedKey.EncryptionMethod: "
 + k.EncryptionMethod.GetXml().InnerXml)
        If k.EncryptionProperties.Count >= 1 Then
            Console.WriteLine("EncryptedKey.EncryptionProperties:
 " + k.EncryptionProperties(0).GetXml().InnerXml)
        End If
        Console.WriteLine("EncryptedKey.MimeType: "
 + k.MimeType)
        Console.WriteLine("EncryptedKey.Recipient: "
 + k.Recipient)

        If k.ReferenceList.Count >= 1 Then
            Console.WriteLine("EncryptedKey.ReferenceList: "
 + k.ReferenceList(0).GetXml().InnerXml)
        End If

    End Sub
End Module

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);
        }

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


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

            // Inspect the EncryptedKey element.
            InspectElement(xmlDoc);

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

        }
        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 Rijndael key.
        RijndaelManaged sessionKey = new RijndaelManaged();
        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();

    }

    static void InspectElement(XmlDocument
 Doc)
    {
        // Get the EncryptedKey element from the XMLDocument object.
        XmlElement encryptedKey = Doc.GetElementsByTagName("EncryptedKey")[0]
 as XmlElement;

        // Create a new EncryptedKey object.
        EncryptedKey k = new EncryptedKey();

        // Load the XML from the document to
        // initialize the EncryptedKey object.
        k.LoadXml(encryptedKey);

        // Display the properties.
        // Most values are Null by default.
        Console.WriteLine("EncryptedKey.KeyInfo: " + k.KeyInfo.GetXml().InnerXml);
        Console.WriteLine("EncryptedKey.Id: " + k.Id);
        Console.WriteLine("EncryptedKey.CarriedKeyName: " + k.CarriedKeyName);
        Console.WriteLine("EncryptedKey.CipherData: " + k.CipherData.GetXml().InnerXml);
        Console.WriteLine("EncryptedKey.Encoding: " + k.Encoding);
        Console.WriteLine("EncryptedKey.EncryptionMethod: " + k.EncryptionMethod.GetXml().InnerXml);
        if (k.EncryptionProperties.Count >= 1)
        {
            Console.WriteLine("EncryptedKey.EncryptionProperties: " + k.EncryptionProperties[0].GetXml().InnerXml);
        }
        Console.WriteLine("EncryptedKey.MimeType: " + k.MimeType);
        Console.WriteLine("EncryptedKey.Recipient: " + k.Recipient);

        if (k.ReferenceList.Count >= 1)
        {
            Console.WriteLine("EncryptedKey.ReferenceList: " + k.ReferenceList[0].GetXml().InnerXml);
        }
    }

}

継承階層

System.Object
System.Security.Cryptography.Xml.EncryptedType
System.Security.Cryptography.Xml.EncryptedKey

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
EncryptedKey メンバ
System.Security.Cryptography.Xml 名前空間

EncryptedKey コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

EncryptedKey クラスの新しいインスタンスを初期化します。

名前空間: System.Security.Cryptography.Xml
アセンブリ: System.Security (system.security.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New EncryptedKey

public EncryptedKey ()

C++

public:
EncryptedKey ()

public EncryptedKey ()

JScript

public function EncryptedKey ()

解説

このコンストラクタは、EncryptedKey クラスの新しいインスタンスを作成します。XML 暗号化標準の詳細については、http://www.w3.org/TR/xmlenc-core/ から入手できる『XML Encryption Syntax and Processing』を参照してください。

使用例

Visual Basic

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



Module Program

    Sub Main(ByVal args() As
 String)

        ' Create an XmlDocument object.
        Dim xmlDoc As New
 XmlDocument()

        ' Load an XML file into the XmlDocument object.
        Try
            xmlDoc.PreserveWhitespace = True
            xmlDoc.Load("test.xml")
        Catch e As Exception
            Console.WriteLine(e.Message)
        End Try

        ' Create a new RSA key.  This key will encrypt a symmetric key
,
        ' which will then be imbedded in the XML document.  
        Dim rsaKey As New
 RSACryptoServiceProvider()


        Try
            ' Encrypt the "creditcard" element.
            Encrypt(xmlDoc, "creditcard", rsaKey,
 "rsaKey")

            ' Inspect the EncryptedKey element.
            InspectElement(xmlDoc)

            ' Decrypt the "creditcard" element.
            Decrypt(xmlDoc, rsaKey, "rsaKey")

        Catch e As Exception
            Console.WriteLine(e.Message)
        Finally
            ' Clear the RSA key.
            rsaKey.Clear()
        End Try

    End Sub


    Sub Encrypt(ByVal Doc As
 XmlDocument, ByVal ElementToEncryptParam As
 String, ByVal Alg As RSA, ByVal KeyName As String)
        ' Check the arguments.  
        If Doc Is Nothing
 Then
            Throw New ArgumentNullException("Doc")
        End If
        If ElementToEncryptParam Is Nothing
 Then
            Throw New ArgumentNullException("ElementToEncrypt")
        End If
        If Alg Is Nothing
 Then
            Throw New ArgumentNullException("Alg")
        End If
        ''''''''''''''''''''''''''''''''''''''''''''''''''''
        ' Find the specified element in the XmlDocument
        ' object and create a new XmlElemnt object.
        ''''''''''''''''''''''''''''''''''''''''''''''''''''
        Dim elementToEncrypt As XmlElement
 = Doc.GetElementsByTagName(ElementToEncryptParam)(0)


        ' Throw an XmlException if the element was not found.
        If elementToEncrypt Is Nothing
 Then
            Throw New XmlException("The
 specified element was not found")
        End If

        ''''''''''''''''''''''''''''''''''''''''''''''''''''
        ' 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 Rijndael key.
        Dim sessionKey As New
 RijndaelManaged()
        sessionKey.KeySize = 256

        Dim eXml As New
 EncryptedXml()

        Dim encryptedElement As Byte()
 = eXml.EncryptData(elementToEncrypt, sessionKey, False)

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

        Dim edElement As 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.
        Dim ek As New EncryptedKey()

        Dim encryptedKey As Byte()
 = 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.
        Dim kin As 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)

    End Sub


    Sub Decrypt(ByVal Doc As
 XmlDocument, ByVal Alg As RSA, ByVal
 KeyName As String)
        ' Check the arguments.  
        If Doc Is Nothing
 Then
            Throw New ArgumentNullException("Doc")
        End If
        If Alg Is Nothing
 Then
            Throw New ArgumentNullException("Alg")
        End If
        If KeyName Is Nothing
 Then
            Throw New ArgumentNullException("KeyName")
        End If
        ' Create a new EncryptedXml object.
        Dim exml As 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()

    End Sub


    Sub InspectElement(ByVal Doc As
 XmlDocument)
        ' Get the EncryptedKey element from the XMLDocument object.
        Dim encryptedKey As XmlElement = Doc.GetElementsByTagName("EncryptedKey")(0)

        ' Create a new EncryptedKey object.
        Dim k As New EncryptedKey()

        ' Load the XML from the document to
        ' initialize the EncryptedKey object.
        k.LoadXml(encryptedKey)

        ' Display the properties.
        ' Most values are Null by default.
        Console.WriteLine("EncryptedKey.KeyInfo: "
 + k.KeyInfo.GetXml().InnerXml)
        Console.WriteLine("EncryptedKey.Id: " + k.Id)
        Console.WriteLine("EncryptedKey.CarriedKeyName: "
 + k.CarriedKeyName)
        Console.WriteLine("EncryptedKey.CipherData: "
 + k.CipherData.GetXml().InnerXml)
        Console.WriteLine("EncryptedKey.Encoding: "
 + k.Encoding)
        Console.WriteLine("EncryptedKey.EncryptionMethod: "
 + k.EncryptionMethod.GetXml().InnerXml)
        If k.EncryptionProperties.Count >= 1 Then
            Console.WriteLine("EncryptedKey.EncryptionProperties:
 " + k.EncryptionProperties(0).GetXml().InnerXml)
        End If
        Console.WriteLine("EncryptedKey.MimeType: "
 + k.MimeType)
        Console.WriteLine("EncryptedKey.Recipient: "
 + k.Recipient)

        If k.ReferenceList.Count >= 1 Then
            Console.WriteLine("EncryptedKey.ReferenceList: "
 + k.ReferenceList(0).GetXml().InnerXml)
        End If

    End Sub
End Module

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);
        }

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


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

            // Inspect the EncryptedKey element.
            InspectElement(xmlDoc);

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

        }
        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 Rijndael key.
        RijndaelManaged sessionKey = new RijndaelManaged();
        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();

    }

    static void InspectElement(XmlDocument
 Doc)
    {
        // Get the EncryptedKey element from the XMLDocument object.
        XmlElement encryptedKey = Doc.GetElementsByTagName("EncryptedKey")[0]
 as XmlElement;

        // Create a new EncryptedKey object.
        EncryptedKey k = new EncryptedKey();

        // Load the XML from the document to
        // initialize the EncryptedKey object.
        k.LoadXml(encryptedKey);

        // Display the properties.
        // Most values are Null by default.
        Console.WriteLine("EncryptedKey.KeyInfo: " + k.KeyInfo.GetXml().InnerXml);
        Console.WriteLine("EncryptedKey.Id: " + k.Id);
        Console.WriteLine("EncryptedKey.CarriedKeyName: " + k.CarriedKeyName);
        Console.WriteLine("EncryptedKey.CipherData: " + k.CipherData.GetXml().InnerXml);
        Console.WriteLine("EncryptedKey.Encoding: " + k.Encoding);
        Console.WriteLine("EncryptedKey.EncryptionMethod: " + k.EncryptionMethod.GetXml().InnerXml);
        if (k.EncryptionProperties.Count >= 1)
        {
            Console.WriteLine("EncryptedKey.EncryptionProperties: " + k.EncryptionProperties[0].GetXml().InnerXml);
        }
        Console.WriteLine("EncryptedKey.MimeType: " + k.MimeType);
        Console.WriteLine("EncryptedKey.Recipient: " + k.Recipient);

        if (k.ReferenceList.Count >= 1)
        {
            Console.WriteLine("EncryptedKey.ReferenceList: " + k.ReferenceList[0].GetXml().InnerXml);
        }
    }

}

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
EncryptedKey クラス
EncryptedKey メンバ
System.Security.Cryptography.Xml 名前空間

EncryptedKey プロパティ

パブリックプロパティパブリックプロパティ

	名前	説明
	CarriedKeyName	XML 暗号化のオプションの <CarriedKeyName> 要素を取得または設定します。
	CipherData	EncryptedType クラスのインスタンスの CipherData 値を取得または設定します。 ( EncryptedType から継承されます。)
	Encoding	XML 暗号化の EncryptedType インスタンスの Encoding 属性を取得または設定します。 ( EncryptedType から継承されます。)
	EncryptionMethod	XML 暗号化の <EncryptionMethod> 要素を取得または設定します。 ( EncryptedType から継承されます。)
	EncryptionProperties	XML 暗号化の <EncryptionProperties> 要素を取得または設定します。 ( EncryptedType から継承されます。)
	Id	XML 暗号化の EncryptedType インスタンスの Id 属性を取得または設定します。 ( EncryptedType から継承されます。)
	KeyInfo	XML 暗号化の <KeyInfo> 要素を取得または設定します。 ( EncryptedType から継承されます。)
	MimeType	XML 暗号化の EncryptedType インスタンスの MimeType 属性を取得または設定します。 ( EncryptedType から継承されます。)
	Recipient	XML 暗号化のオプションの Recipient 属性を取得または設定します。
	ReferenceList	XML 暗号化の <ReferenceList> 要素を取得または設定します。
	Type	XML 暗号化の EncryptedType インスタンスの Type 属性を取得または設定します。 ( EncryptedType から継承されます。)

参照

EncryptedKey メソッド

パブリックメソッドパブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	AddProperty	XML 暗号化の現在の EncryptedType オブジェクトの <EncryptedProperties> 要素に <EncryptionProperty> 子要素を追加します。 ( EncryptedType から継承されます。)
	AddReference	オーバーロードされます。 <ReferenceList> 要素に参照要素を追加します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	GetXml	オーバーライドされます。 EncryptedKey オブジェクトの XML 表現を返します。
	LoadXml	オーバーライドされます。指定した XML 情報を XML 暗号化の <EncryptedKey> 要素に読み込みます。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

EncryptedKey メンバ

XML 暗号化の <EncryptedKey> 要素を表します。このクラスは継承できません。

EncryptedKey データ型で公開されるメンバを以下の表に示します。

パブリックコンストラクタ

	名前	説明
	EncryptedKey	EncryptedKey クラスの新しいインスタンスを初期化します。

パブリックプロパティ

	名前	説明
	CarriedKeyName	XML 暗号化のオプションの <CarriedKeyName> 要素を取得または設定します。
	CipherData	EncryptedType クラスのインスタンスの CipherData 値を取得または設定します。(EncryptedType から継承されます。)
	Encoding	XML 暗号化の EncryptedType インスタンスの Encoding 属性を取得または設定します。(EncryptedType から継承されます。)
	EncryptionMethod	XML 暗号化の <EncryptionMethod> 要素を取得または設定します。(EncryptedType から継承されます。)
	EncryptionProperties	XML 暗号化の <EncryptionProperties> 要素を取得または設定します。(EncryptedType から継承されます。)
	Id	XML 暗号化の EncryptedType インスタンスの Id 属性を取得または設定します。(EncryptedType から継承されます。)
	KeyInfo	XML 暗号化の <KeyInfo> 要素を取得または設定します。(EncryptedType から継承されます。)
	MimeType	XML 暗号化の EncryptedType インスタンスの MimeType 属性を取得または設定します。(EncryptedType から継承されます。)
	Recipient	XML 暗号化のオプションの Recipient 属性を取得または設定します。
	ReferenceList	XML 暗号化の <ReferenceList> 要素を取得または設定します。
	Type	XML 暗号化の EncryptedType インスタンスの Type 属性を取得または設定します。(EncryptedType から継承されます。)

パブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	AddProperty	XML 暗号化の現在の EncryptedType オブジェクトの <EncryptedProperties> 要素に <EncryptionProperty> 子要素を追加します。 (EncryptedType から継承されます。)
	AddReference	オーバーロードされます。 <ReferenceList> 要素に参照要素を追加します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	GetXml	オーバーライドされます。 EncryptedKey オブジェクトの XML 表現を返します。
	LoadXml	オーバーライドされます。指定した XML 情報を XML 暗号化の <EncryptedKey> 要素に読み込みます。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

EncryptedKeyとは？わかりやすく解説

EncryptedKey クラス

EncryptedKey コンストラクタ

EncryptedKey プロパティ

関連項目

EncryptedKey メソッド

関連項目

EncryptedKey メンバ

関連項目

英和和英テキスト翻訳

「EncryptedKey」の関連用語


	© 2026 Microsoft.All rights reserved.

EncryptedKeyとは？ わかりやすく解説

EncryptedKey クラス

EncryptedKey コンストラクタ

EncryptedKey プロパティ

関連項目

EncryptedKey メソッド

関連項目

EncryptedKey メンバ

関連項目

急上昇のことば

英和和英テキスト翻訳

「EncryptedKey」の関連用語

EncryptedKeyとは？わかりやすく解説