AsymmetricKeyExchangeDeformatter Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta la classe base da cui derivano tutti i deformattatori di scambio delle chiavi asimmetriche.
public ref class AsymmetricKeyExchangeDeformatter abstract[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public abstract class AsymmetricKeyExchangeDeformatterpublic abstract class AsymmetricKeyExchangeDeformatter[System.Runtime.InteropServices.ComVisible(true)]
public abstract class AsymmetricKeyExchangeDeformatter[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
type AsymmetricKeyExchangeDeformatter = classtype AsymmetricKeyExchangeDeformatter = class[<System.Runtime.InteropServices.ComVisible(true)>]
type AsymmetricKeyExchangeDeformatter = classPublic MustInherit Class AsymmetricKeyExchangeDeformatter- Ereditarietà
-
AsymmetricKeyExchangeDeformatter
- Derivato
- Attributi
Esempio
Nell'esempio seguente viene illustrato come estendere la AsymmetricKeyExchangeDeformatter classe.
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("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 rsa = (RSA)rsaKey;
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.
Commenti
Deformatters di scambio di chiavi asimmetriche decrittografa i dati di scambio delle chiavi.
Lo scambio delle chiavi consente a un mittente di creare informazioni segrete, ad esempio dati casuali che possono essere usati come chiave in un algoritmo di crittografia simmetrica e usare la crittografia per inviarle al destinatario previsto.
Attenzione
È consigliabile non tentare di creare un metodo di scambio delle chiavi personalizzato dalla funzionalità di base fornita, perché è necessario eseguire con attenzione molti dettagli dell'operazione in modo che lo scambio di chiavi sia riuscito.
Costruttori
| AsymmetricKeyExchangeDeformatter() |
Inizializza una nuova istanza di AsymmetricKeyExchangeDeformatter. |
Proprietà
| Parameters |
In caso di override in una classe derivata, ottiene o imposta i parametri per lo scambio delle chiavi asimmetriche. |
Metodi
| DecryptKeyExchange(Byte[]) |
In caso di override in una classe derivata, estrae le informazioni segrete dai dati crittografati di scambio delle chiavi. |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
| MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
| SetKey(AsymmetricAlgorithm) |
In caso di override in una classe derivata, imposta la chiave privata da usare per decrittografare le informazioni segrete. |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |