Freigeben über


AsymmetricKeyExchangeDeformatter-Klasse

Stellt die Basisklasse dar, aus der alle Deformatierungsprogramme für den asymmetrischen Schlüsselaustausch abgeleitet werden.

Namespace: System.Security.Cryptography
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
<ComVisibleAttribute(True)> _
Public MustInherit Class AsymmetricKeyExchangeDeformatter
'Usage
Dim instance As AsymmetricKeyExchangeDeformatter
[ComVisibleAttribute(true)] 
public abstract class AsymmetricKeyExchangeDeformatter
[ComVisibleAttribute(true)] 
public ref class AsymmetricKeyExchangeDeformatter abstract
/** @attribute ComVisibleAttribute(true) */ 
public abstract class AsymmetricKeyExchangeDeformatter
ComVisibleAttribute(true) 
public abstract class AsymmetricKeyExchangeDeformatter

Hinweise

Deformatierungsprogramme für den asymmetrischen Schlüsselaustausch entschlüsseln Schlüsselaustauschdaten.

Der Schlüsselaustausch ermöglicht es Absendern, vertrauliche Informationen zu erstellen, z. B. Zufallsdaten, die in einem symmetrischen Verschlüsselungsalgorithmus als Schlüssel verwendet werden können, und diese verschlüsselt an den gewünschten Empfänger zu senden.

Warnung

Es wird dringend davon abgeraten, aus den bereitgestellten Basisfunktionen eine eigene Methode für den Schlüsselaustausch zu erstellen, da für einen erfolgreichen Schlüsselaustausch eine sorgfältige Ausführung zahlreicher Operationen erforderlich ist.

Beispiel

Im folgenden Beispiel wird das Erweitern der AsymmetricKeyExchangeDeformatter-Klasse veranschaulicht.

imports System
imports System.Security.Cryptography

Namespace Contoso
    Public Class ContosoDeformatter
        Inherits AsymmetricKeyExchangeDeformatter

        Private rsaKey As RSA

        ' Default constructor.
        Public Sub New()

        End Sub

        ' Constructor with the public key to use for decryption.
        Public Sub New(ByVal key As AsymmetricAlgorithm)
            SetKey(key)
        End Sub

        ' Set the public key for encyption operations.
        Public Overrides Sub SetKey(ByVal key As AsymmetricAlgorithm)
            If (Not key Is Nothing) Then
                rsaKey = CType(key, RSA)
            Else
                Throw New ArgumentNullException("key")
            End If
        End Sub

        ' Disallow access to the parameters of the formatter.
        Public Overrides Property Parameters() As String
            Get
                Return Nothing
            End Get
            Set(ByVal Value As String)

            End Set
        End Property

        ' Create the encrypted key exchange data from the specified input
        ' data. This method uses the RSACryptoServiceProvider only. To
        ' support additional providers or provide custom decryption logic,
        ' add logic to this member.
        Public Overrides Function DecryptKeyExchange( _
            ByVal rgbData() As Byte) As Byte()

            Dim decryptedBytes() As Byte

            If (Not rsaKey Is Nothing) Then
                If (TypeOf (rsaKey) Is RSACryptoServiceProvider) Then
                    Dim rsaProvider As RSACryptoServiceProvider
                    rsaProvider = CType(rsaKey, RSACryptoServiceProvider)

                    decryptedBytes = rsaProvider.Decrypt(rgbData, True)
                End If

                ' Add custom decryption logic here.

            Else
                Throw New CryptographicUnexpectedOperationException( _
                    "Cryptography_MissingKey")
            End If

            Return decryptedBytes
        End Function
    End Class
End Namespace
'
' This code example produces the following output:
'
' Data to encrypt : Sample Contoso encryption application.
' Encrypted data: Kh34dfg-(*&834d+3
' Data decrypted : Sample Contoso encryption application.
' 
' This sample completed successfully; press Exit to continue.
using System;
using System.Security.Cryptography;

namespace Contoso
{
    public class ContosoDeformatter : AsymmetricKeyExchangeDeformatter 
    {
        private RSA rsaKey;

        // Default constructor.
        public ContosoDeformatter(){}

        // Constructor with the public key to use for decryption.
        public ContosoDeformatter(AsymmetricAlgorithm key) 
        {
            SetKey(key);
        }

        // Set the public key for encyption operations.
        public override void SetKey(AsymmetricAlgorithm key) 
        {
            if (key != null) 
            {
                rsaKey = (RSA) key;            }
            else 
            {
                throw new ArgumentNullException("key");
            }
        }

        // Disallow access to the parameters of the formatter.
        public override String Parameters 
        {
            get { return null; }
            set { ; }
        }

        // Create the encrypted key exchange data from the specified input
        // data. This method uses the RSACryptoServiceProvider only. To
        // support additional providers or provide custom decryption logic,
        // add logic to this member.
        public override byte[] DecryptKeyExchange(byte[] rgbData) 
        {
            byte[] decryptedBytes = null;

            if (rsaKey != null)
            {
                if (rsaKey is RSACryptoServiceProvider) 
                {
                    RSACryptoServiceProvider serviceProvder = 
                        (RSACryptoServiceProvider) rsaKey;

                    decryptedBytes = serviceProvder.Decrypt(rgbData, true);
                } 
                // Add custom decryption logic here.
            }
            else 
            {
                throw new CryptographicUnexpectedOperationException(
                    "Cryptography_MissingKey");
            }

            return decryptedBytes;
        }
    }
}
//
// This code example produces the following output:
//
// Data to encrypt : Sample Contoso encryption application.
// Encrypted data: Khasdf-3248&$%23
// Data decrypted : Sample Contoso encryption application.
// 
// This sample completed successfully; press Enter to exit.

Vererbungshierarchie

System.Object
  System.Security.Cryptography.AsymmetricKeyExchangeDeformatter
     System.Security.Cryptography.RSAOAEPKeyExchangeDeformatter
     System.Security.Cryptography.RSAPKCS1KeyExchangeDeformatter

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

AsymmetricKeyExchangeDeformatter-Member
System.Security.Cryptography-Namespace