AsymmetricKeyExchangeDeformatter Klasse

Definition

Namespace:

System.Security.Cryptography

Assembly:

System.Security.Cryptography.dll

Quelle:

AsymmetricKeyExchangeDeformatter.cs

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

public ref class AsymmetricKeyExchangeDeformatter abstract

public abstract class AsymmetricKeyExchangeDeformatter

type AsymmetricKeyExchangeDeformatter = class

Public MustInherit Class AsymmetricKeyExchangeDeformatter

Vererbung

Object

AsymmetricKeyExchangeDeformatter

Abgeleitet

System.Security.Cryptography.RSAOAEPKeyExchangeDeformatter

System.Security.Cryptography.RSAPKCS1KeyExchangeDeformatter

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Die AsymmetricKeyExchangeDeformatter -Klasse erweitert wird.

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 encryption.
        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(nameof(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 RSA class 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 RSA rsa)
                {
                    decryptedBytes = rsa.Decrypt(rgbData, RSAEncryptionPadding.OaepSHA1);
                }
                // 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.

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 encryption.
        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 ReadOnly 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 RSA class 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 RSA) Then
                    Dim rsa As RSA
                    rsa = CType(rsaKey, RSA)

                    decryptedBytes = rsa.Decrypt(rgbData, RSAEncryptionPadding.OaepSHA1)
                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.

Hinweise

Asymmetrische Schlüsselaustausch-Deformatierer entschlüsseln Schlüsselaustauschdaten.

Der Schlüsselaustausch ermöglicht es einem Absender, geheime Informationen zu erstellen, z. B. zufällige Daten, die als Schlüssel in einem symmetrischen Verschlüsselungsalgorithmus verwendet werden können, und die Verschlüsselung zu verwenden, um sie an den beabsichtigten Empfänger zu senden.

Achtung

Es wird dringend empfohlen, nicht zu versuchen, eine eigene Schlüsselaustauschmethode aus der bereitgestellten Grundlegenden Funktionalität zu erstellen, da viele Details des Vorgangs sorgfältig ausgeführt werden müssen, damit der Schlüsselaustausch erfolgreich ist.

Konstruktoren

AsymmetricKeyExchangeDeformatter()

Initialisiert eine neue Instanz von AsymmetricKeyExchangeDeformatter.

Eigenschaften

Parameters

Ruft beim Überschreiben in einer abgeleiteten Klasse die Parameter für den asymmetrischen Schlüsselaustausch ab oder legt diese fest.

Methoden

DecryptKeyExchange(Byte[])	Extrahiert beim Überschreiben in einer abgeleiteten Klasse geheime Informationen aus den verschlüsselten Schlüsselaustauschdaten.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
SetKey(AsymmetricAlgorithm)	Legt beim Überschreiben in einer abgeleiteten Klasse den privaten Schlüssel fest, der zum Entschlüsseln der geheimen Informationen verwendet werden soll.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)