SymmetricAlgorithm 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 astratta dalla quale devono ereditare tutte le implementazioni di algoritmi simmetrici.
public ref class SymmetricAlgorithm abstract : IDisposable
public abstract class SymmetricAlgorithm : IDisposable
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class SymmetricAlgorithm : IDisposable
type SymmetricAlgorithm = class
interface IDisposable
[<System.Runtime.InteropServices.ComVisible(true)>]
type SymmetricAlgorithm = class
interface IDisposable
Public MustInherit Class SymmetricAlgorithm
Implements IDisposable
- Ereditarietà
-
SymmetricAlgorithm
- Derivato
- Attributi
- Implementazioni
Esempio
Nell'esempio di codice seguente viene utilizzata la classe con la proprietà e il vettore di inizializzazione specificati ( ) per crittografare un file specificato da e restituisce il risultato crittografato nel Aes Key file specificato da IV inName
outName
. I desKey
parametri e per il metodo sono desIV
matrici a 8 byte. Per eseguire questo esempio, è necessario che sia installato il pacchetto di crittografia high.
void EncryptData( String^ inName, String^ outName, array<Byte>^aesKey, array<Byte>^aesIV )
{
//Create the file streams to handle the input and output files.
FileStream^ fin = gcnew FileStream( inName,FileMode::Open,FileAccess::Read );
FileStream^ fout = gcnew FileStream( outName,FileMode::OpenOrCreate,FileAccess::Write );
fout->SetLength( 0 );
//Create variables to help with read and write.
array<Byte>^bin = gcnew array<Byte>(100);
long rdlen = 0; //This is the total number of bytes written.
long totlen = (long)fin->Length; //This is the total length of the input file.
int len; //This is the number of bytes to be written at a time.
Aes^ aes = Aes::Create();
CryptoStream^ encStream = gcnew CryptoStream( fout,aes->CreateEncryptor( aesKey, aesIV ),CryptoStreamMode::Write );
Console::WriteLine( "Encrypting..." );
//Read from the input file, then encrypt and write to the output file.
while ( rdlen < totlen )
{
len = fin->Read( bin, 0, 100 );
encStream->Write( bin, 0, len );
rdlen = rdlen + len;
Console::WriteLine( "{0} bytes processed", rdlen );
}
encStream->Close();
fout->Close();
fin->Close();
}
private static void EncryptData(string inName, string outName, byte[] aesKey, byte[] aesIV)
{
//Create the file streams to handle the input and output files.
FileStream fin = new FileStream(inName, FileMode.Open, FileAccess.Read);
FileStream fout = new FileStream(outName, FileMode.OpenOrCreate, FileAccess.Write);
fout.SetLength(0);
//Create variables to help with read and write.
byte[] bin = new byte[100]; //This is intermediate storage for the encryption.
long rdlen = 0; //This is the total number of bytes written.
long totlen = fin.Length; //This is the total length of the input file.
int len; //This is the number of bytes to be written at a time.
Aes aes = Aes.Create();
CryptoStream encStream = new CryptoStream(fout, aes.CreateEncryptor(aesKey, aesIV), CryptoStreamMode.Write);
Console.WriteLine("Encrypting...");
//Read from the input file, then encrypt and write to the output file.
while(rdlen < totlen)
{
len = fin.Read(bin, 0, 100);
encStream.Write(bin, 0, len);
rdlen = rdlen + len;
Console.WriteLine("{0} bytes processed", rdlen);
}
encStream.Close();
fout.Close();
fin.Close();
}
Private Shared Sub EncryptData(inName As String, outName As String, _
rijnKey() As Byte, rijnIV() As Byte)
'Create the file streams to handle the input and output files.
Dim fin As New FileStream(inName, FileMode.Open, FileAccess.Read)
Dim fout As New FileStream(outName, FileMode.OpenOrCreate, _
FileAccess.Write)
fout.SetLength(0)
'Create variables to help with read and write.
Dim bin(100) As Byte 'This is intermediate storage for the encryption.
Dim rdlen As Long = 0 'This is the total number of bytes written.
Dim totlen As Long = fin.Length 'Total length of the input file.
Dim len As Integer 'This is the number of bytes to be written at a time.
'Creates the default implementation, which is RijndaelManaged.
Dim rijn As SymmetricAlgorithm = SymmetricAlgorithm.Create()
Dim encStream As New CryptoStream(fout, _
rijn.CreateEncryptor(rijnKey, rijnIV), CryptoStreamMode.Write)
Console.WriteLine("Encrypting...")
'Read from the input file, then encrypt and write to the output file.
While rdlen < totlen
len = fin.Read(bin, 0, 100)
encStream.Write(bin, 0, len)
rdlen = Convert.ToInt32(rdlen + len)
Console.WriteLine("{0} bytes processed", rdlen)
End While
encStream.Close()
fout.Close()
fin.Close()
End Sub
Commenti
Le classi che derivano dalla classe usano una modalità di concatenamento denominata SymmetricAlgorithm CBC (Cipher Block Chaining), che richiede una chiave ( ) e un vettore di inizializzazione ( ) per eseguire trasformazioni crittografiche sui Key IV dati. Per decrittografare i dati crittografati usando una delle classi , è necessario impostare la proprietà e la proprietà sui valori usati SymmetricAlgorithm Key per la IV crittografia. Per un algoritmo simmetrico utile, la chiave privata deve essere nota solo al mittente e al destinatario.
Aes, DES RC2 , e sono TripleDES implementazioni di algoritmi simmetrici.
Si noti che quando si usano classi derivate, non è sufficiente, dal punto di vista della sicurezza, forzare semplicemente un'operazione di Garbage Collection dopo aver terminato di usare l'oggetto . È necessario chiamare in modo Clear esplicito il metodo sull'oggetto per azzerare tutti i dati sensibili all'interno dell'oggetto prima che venga rilasciato. Si noti che l'operazione di Garbage Collection non azzera il contenuto degli oggetti raccolti, ma contrassegna semplicemente la memoria come disponibile per la riallocazione. Di conseguenza, i dati contenuti in un oggetto sottoposto a Garbage Collection possono essere ancora presenti nell'heap di memoria nella memoria non allocata. Nel caso di oggetti crittografici, questi dati possono contenere informazioni riservate, ad esempio dati chiave o un blocco di testo normale.
Tutte le classi crittografiche nel .NET Framework che contengono dati sensibili implementano un Clear
metodo . Quando viene chiamato, il metodo sovrascrive tutti i dati sensibili all'interno dell'oggetto con zeri e quindi rilascia l'oggetto in modo che possa essere sottoposto a Clear
Garbage Collection in modo sicuro. Quando l'oggetto è stato azzerato e rilasciato, è necessario chiamare il metodo con il parametro impostato su per eliminare tutte le risorse gestite e non gestite associate Dispose
disposing
True
all'oggetto .
Note per gli implementatori
Quando si eredita dalla SymmetricAlgorithm classe , è necessario eseguire l'override dei membri seguenti: , , e CreateDecryptor(Byte[], Byte[]) CreateEncryptor(Byte[], Byte[]) GenerateIV() GenerateKey() .
Costruttori
SymmetricAlgorithm() |
Inizializza una nuova istanza della classe SymmetricAlgorithm. |
Campi
BlockSizeValue |
Rappresenta la dimensione in bit del blocco dell'operazione di crittografia. |
FeedbackSizeValue |
Rappresenta la dimensione in bit della quantità di informazioni raccolte dell'operazione di crittografia. |
IVValue |
Rappresenta il vettore di inizializzazione IV per l'algoritmo simmetrico. |
KeySizeValue |
Rappresenta la dimensione in bit della chiave privata usata dall'algoritmo simmetrico. |
KeyValue |
Rappresenta la chiave privata per l'algoritmo simmetrico. |
LegalBlockSizesValue |
Specifica le dimensioni in bit dei blocchi supportate dall'algoritmo simmetrico. |
LegalKeySizesValue |
Specifica le dimensioni in bit delle chiavi supportate dall'algoritmo simmetrico. |
ModeValue |
Rappresenta la modalità di crittografia usata nell'algoritmo simmetrico. |
PaddingValue |
Rappresenta la modalità di riempimento usata nell'algoritmo simmetrico. |
Proprietà
BlockSize |
Ottiene o imposta la dimensione in bit del blocco dell'operazione di crittografia. |
FeedbackSize |
Ottiene o imposta le dimensioni delle informazioni raccolte dell'operazione di crittografia per le modalità di crittografia CFB (Cipher Feedback) e OFB (Output Feedback). |
IV |
Ottiene o imposta il vettore di inizializzazione (IV) per l'algoritmo simmetrico. |
Key |
Ottiene o imposta la chiave segreta per l'algoritmo simmetrico. |
KeySize |
Ottiene o imposta la dimensione in bit della chiave segreta utilizzata dall'algoritmo simmetrico. |
LegalBlockSizes |
Ottiene le dimensioni in bit dei blocchi supportate dall'algoritmo simmetrico. |
LegalKeySizes |
Ottiene le dimensioni in bit delle chiavi supportate dall'algoritmo simmetrico. |
Mode |
Ottiene o imposta la modalità di funzionamento dell'algoritmo simmetrico. |
Padding |
Ottiene o imposta la modalità di riempimento usata nell'algoritmo simmetrico. |
Metodi
Clear() |
Rilascia tutte le risorse usate dalla classe SymmetricAlgorithm. |
Create() |
Obsoleta.
Crea l'oggetto di crittografia predefinito usato per eseguire l'algoritmo simmetrico. |
Create(String) |
Crea l'oggetto di crittografia specificato usato per eseguire l'algoritmo simmetrico. |
CreateDecryptor() |
Crea un oggetto di decrittografia simmetrica con la proprietà Key corrente e il vettore di inizializzazione IV. |
CreateDecryptor(Byte[], Byte[]) |
Quando è sottoposto a override in una classe derivata, crea un oggetto di decrittografia simmetrica con la proprietà Key e il vettore di inizializzazione IV specificati. |
CreateEncryptor() |
Crea un oggetto di crittografia simmetrica con la proprietà Key corrente e il vettore di inizializzazione IV. |
CreateEncryptor(Byte[], Byte[]) |
Quando è sottoposto a override in una classe derivata, crea un oggetto di crittografia simmetrica con la proprietà Key e il vettore di inizializzazione IV specificati. |
DecryptCbc(Byte[], Byte[], PaddingMode) |
Decrittografa i dati usando la modalità CBC con la modalità di riempimento specificata. |
DecryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode) |
Decrittografa i dati usando la modalità CBC con la modalità di riempimento specificata. |
DecryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode) |
Decrittografa i dati nel buffer specificato, usando la modalità CBC con la modalità di riempimento specificata. |
DecryptCfb(Byte[], Byte[], PaddingMode, Int32) |
Decrittografa i dati usando la modalità CFB con la modalità di riempimento e le dimensioni del feedback specificate. |
DecryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode, Int32) |
Decrittografa i dati usando la modalità CFB con la modalità di riempimento e le dimensioni del feedback specificate. |
DecryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32) |
Decrittografa i dati nel buffer specificato, usando la modalità CFB con la modalità di riempimento e le dimensioni del feedback specificate. |
DecryptEcb(Byte[], PaddingMode) |
Decrittografa i dati usando la modalità STANDBY con la modalità di riempimento specificata. |
DecryptEcb(ReadOnlySpan<Byte>, PaddingMode) |
Decrittografa i dati usando la modalità STANDBY con la modalità di riempimento specificata. |
DecryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode) |
Decrittografa i dati nel buffer specificato, utilizzando la modalità DISA con la modalità di riempimento specificata. |
Dispose() |
Rilascia tutte le risorse usate dall'istanza corrente della classe SymmetricAlgorithm. |
Dispose(Boolean) |
Rilascia le risorse non gestite usate da SymmetricAlgorithm e, facoltativamente, le risorse gestite. |
EncryptCbc(Byte[], Byte[], PaddingMode) |
Crittografa i dati usando la modalità CBC con la modalità di riempimento specificata. |
EncryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode) |
Crittografa i dati usando la modalità CBC con la modalità di riempimento specificata. |
EncryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode) |
Crittografa i dati nel buffer specificato, usando la modalità CBC con la modalità di riempimento specificata. |
EncryptCfb(Byte[], Byte[], PaddingMode, Int32) |
Crittografa i dati usando la modalità CFB con la modalità di riempimento e le dimensioni del feedback specificate. |
EncryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode, Int32) |
Crittografa i dati usando la modalità CFB con la modalità di riempimento e le dimensioni del feedback specificate. |
EncryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32) |
Crittografa i dati nel buffer specificato, usando la modalità CFB con la modalità di riempimento e le dimensioni del feedback specificate. |
EncryptEcb(Byte[], PaddingMode) |
Crittografa i dati usando la modalità DISA con la modalità di riempimento specificata. |
EncryptEcb(ReadOnlySpan<Byte>, PaddingMode) |
Crittografa i dati usando la modalità DISA con la modalità di riempimento specificata. |
EncryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode) |
Crittografa i dati nel buffer specificato, usando la modalità BCE con la modalità di riempimento specificata. |
Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
Finalize() |
Questo membro esegue l'override di Finalize(). L'argomento corrispondente può contenere documentazione più completa. Consente a un oggetto Object di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto Object stesso venga recuperato dalla procedura di Garbage Collection. |
GenerateIV() |
Quando è sottoposto a override in una classe derivata, genera un vettore di inizializzazione casuale IV da usare per l'algoritmo. |
GenerateKey() |
Quando è sottoposto a override in una classe derivata, genera una chiave casuale Key da usare per l'algoritmo. |
GetCiphertextLengthCbc(Int32, PaddingMode) |
Ottiene la lunghezza di un testo crittografato con una modalità di riempimento e una lunghezza di testo non crittografato specificati in modalità CBC. |
GetCiphertextLengthCfb(Int32, PaddingMode, Int32) |
Ottiene la lunghezza di un testo crittografato con una modalità di riempimento e una lunghezza di testo non crittografato specificati in modalità CFB. |
GetCiphertextLengthEcb(Int32, PaddingMode) |
Ottiene la lunghezza di un testo crittografato con una modalità di riempimento e una lunghezza di testo non crittografato specificati in modalità BCE. |
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) |
ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
TryDecryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode) |
Tenta di decrittografare i dati nel buffer specificato, usando la modalità CBC con la modalità di riempimento specificata. |
TryDecryptCbcCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32) |
Quando sottoposto a override in una classe derivata, tenta di decrittografare i dati nel buffer specificato, usando la modalità CBC con la modalità di riempimento specificata. |
TryDecryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode, Int32) |
Tenta di decrittografare i dati nel buffer specificato, usando la modalità CFB con la modalità di riempimento e le dimensioni del feedback specificate. |
TryDecryptCfbCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32, Int32) |
Quando sottoposto a override in una classe derivata, tenta di decrittografare i dati nel buffer specificato, usando la modalità CFB con la modalità di riempimento e le dimensioni di feedback specificate. |
TryDecryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32) |
Tenta di decrittografare i dati nel buffer specificato, usando la modalità BCE con la modalità di riempimento specificata. |
TryDecryptEcbCore(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32) |
Quando sottoposto a override in una classe derivata, tenta di decrittografare i dati nel buffer specificato, usando la modalità ECB con la modalità di riempimento specificata. |
TryEncryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode) |
Tenta di crittografare i dati nel buffer specificato, usando la modalità CBC con la modalità di riempimento specificata. |
TryEncryptCbcCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32) |
Quando sottoposto a override in una classe derivata, tenta di crittografare i dati nel buffer specificato, usando la modalità CBC con la modalità di riempimento specificata. |
TryEncryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode, Int32) |
Tenta di crittografare i dati nel buffer specificato, usando la modalità CFB con la modalità di riempimento e le dimensioni del feedback specificate. |
TryEncryptCfbCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32, Int32) |
Quando sottoposto a override in una classe derivata, tenta di crittografare i dati nel buffer specificato, usando la modalità CFB con la modalità di riempimento e le dimensioni di feedback specificate. |
TryEncryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32) |
Tenta di crittografare i dati nel buffer specificato, usando la modalità BCE con la modalità di riempimento specificata. |
TryEncryptEcbCore(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32) |
Quando sottoposto a override in una classe derivata, tenta di crittografare i dati nel buffer specificato, usando la modalità ECB con la modalità di riempimento specificata. |
ValidKeySize(Int32) |
Determina se la dimensione specificata della chiave è valida per l'algoritmo corrente. |
Implementazioni dell'interfaccia esplicita
IDisposable.Dispose() |
Questa API supporta l'infrastruttura del prodotto e non è previsto che venga usata direttamente dal codice. Rilascia le risorse non gestite usate da SymmetricAlgorithm e, facoltativamente, le risorse gestite. |