SymmetricAlgorithm Classe

Definizione

Spazio dei nomi:

System.Security.Cryptography

Assembly:

netstandard.dll, System.Security.Cryptography.dll

Origine:

SymmetricAlgorithm.cs

Rappresenta la classe base astratta da cui devono ereditare tutte le implementazioni di algoritmi simmetrici.

public ref class SymmetricAlgorithm abstract : IDisposable

public abstract class SymmetricAlgorithm : IDisposable

type SymmetricAlgorithm = class
    interface IDisposable

Public MustInherit Class SymmetricAlgorithm
Implements IDisposable

Ereditarietà

Object

SymmetricAlgorithm

Derivato

System.Security.Cryptography.Aes

System.Security.Cryptography.DES

System.Security.Cryptography.RC2

System.Security.Cryptography.Rijndael

System.Security.Cryptography.TripleDES

Implementazioni

IDisposable

Esempio

Nell'esempio di codice seguente viene usata la classe con la Aes proprietà specificata Key e il vettore di inizializzazione (IV) per crittografare un file specificato da inNamee restituisce il risultato crittografato al file specificato da outName. I desKey parametri e desIV del metodo sono matrici a 8 byte. Per eseguire questo esempio, è necessario che sia installato il pacchetto di crittografia elevato.

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 SymmetricAlgorithm classe usano una modalità di concatenamento denominata CBC (Cipher Block Chaining), che richiede una chiave (Key) e un vettore di inizializzazione (IV) per eseguire trasformazioni crittografiche sui dati. Per decrittografare i dati crittografati usando una delle SymmetricAlgorithm classi, è necessario impostare la Key proprietà e la IV proprietà sui valori utilizzati per la crittografia. Affinché un algoritmo simmetrico sia utile, la chiave privata deve essere nota solo al mittente e al destinatario.

Aes, DES, RC2e TripleDES sono implementazioni di algoritmi simmetrici.

Si noti che quando si usano classi derivate, non è sufficiente, dal punto di vista della sicurezza, per forzare semplicemente un'operazione di Garbage Collection al termine dell'utilizzo dell'oggetto . È necessario chiamare in modo esplicito il Clear metodo sull'oggetto per evitare che tutti i dati sensibili all'interno dell'oggetto vengano rilasciati. Si noti che Garbage Collection non consente di eliminare il contenuto degli oggetti raccolti, ma contrassegna semplicemente la memoria come disponibile per la riallocazione. Pertanto, i dati contenuti in un oggetto Garbage Collection possono essere ancora presenti nell'heap di memoria in 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 in .NET Framework che contengono dati sensibili implementano un Clear metodo. Quando viene chiamato, il Clear metodo sovrascrive tutti i dati sensibili all'interno dell'oggetto con zeri e quindi rilascia l'oggetto in modo che possa essere sottoposto a Garbage Collection in modo sicuro. Quando l'oggetto è stato zero e rilasciato, è necessario chiamare il metodo con il Disposedisposing parametro impostato su per True eliminare tutte le risorse gestite e non gestite associate all'oggetto.

Note per gli implementatori

Quando si eredita dalla SymmetricAlgorithm classe , è necessario eseguire l'override dei membri seguenti: CreateDecryptor(Byte[], Byte[]), CreateEncryptor(Byte[], Byte[])GenerateIV(), e GenerateKey().

Costruttori

Nome	Descrizione
SymmetricAlgorithm()	Inizializza una nuova istanza della classe SymmetricAlgorithm.

Campi

Nome	Descrizione
BlockSizeValue	Rappresenta le dimensioni del blocco, in bit, dell'operazione di crittografia.
FeedbackSizeValue	Rappresenta le dimensioni del feedback, in bit, dell'operazione di crittografia.
IVValue	Rappresenta il vettore di inizializzazione (IV) per l'algoritmo simmetrico.
KeySizeValue	Rappresenta le dimensioni, in bit, della chiave privata usata dall'algoritmo simmetrico.
KeyValue	Rappresenta la chiave privata per l'algoritmo simmetrico.
LegalBlockSizesValue	Specifica le dimensioni dei blocchi, in bit, supportate dall'algoritmo simmetrico.
LegalKeySizesValue	Specifica le dimensioni delle chiavi, in bit, supportate dall'algoritmo simmetrico.
ModeValue	Rappresenta la modalità di crittografia utilizzata nell'algoritmo simmetrico.
PaddingValue	Rappresenta la modalità di riempimento utilizzata nell'algoritmo simmetrico.

Proprietà

Nome	Descrizione
BlockSize	Ottiene o imposta le dimensioni del blocco, in bit, dell'operazione di crittografia.
FeedbackSize	Ottiene o imposta le dimensioni del feedback, in bit, dell'operazione crittografica per le modalità di crittografia CIPHER FEEDBACK (TLS) e Output Feedback (OFB).
IV	Ottiene o imposta il vettore di inizializzazione (IV) per l'algoritmo simmetrico.
Key	Ottiene o imposta la chiave privata per l'algoritmo simmetrico.
KeySize	Ottiene o imposta le dimensioni, in bit, della chiave privata utilizzata dall'algoritmo simmetrico.
LegalBlockSizes	Ottiene le dimensioni dei blocchi, in bit, supportate dall'algoritmo simmetrico.
LegalKeySizes	Ottiene le dimensioni delle chiavi, in bit, supportate dall'algoritmo simmetrico.
Mode	Ottiene o imposta la modalità per l'operazione dell'algoritmo simmetrico.
Padding	Ottiene o imposta la modalità di riempimento utilizzata nell'algoritmo simmetrico.

Metodi

Nome	Descrizione
Clear()	Rilascia tutte le risorse usate dalla SymmetricAlgorithm classe .
Create()	Obsoleti. Crea un oggetto di crittografia predefinito utilizzato per eseguire l'algoritmo simmetrico.
Create(String)	Obsoleti. Crea l'oggetto di crittografia specificato utilizzato per eseguire l'algoritmo simmetrico.
CreateDecryptor()	Crea un oggetto decrittografia simmetrica con la proprietà corrente Key e il vettore di inizializzazione (IV).
CreateDecryptor(Byte[], Byte[])	Quando sottoposto a override in una classe derivata, crea un oggetto decrittografia simmetrico con la proprietà e il vettore di inizializzazione specificati Key (IV).
CreateEncryptor()	Crea un oggetto encryptor simmetrico con la proprietà corrente Key e il vettore di inizializzazione (IV).
CreateEncryptor(Byte[], Byte[])	Quando sottoposto a override in una classe derivata, crea un oggetto encryptor simmetrico con la proprietà e il vettore di inizializzazione specificati Key (IV).
DecryptCbc(Byte[], Byte[], PaddingMode)	Decrittografa i dati usando la modalità CBC con la modalità spaziatura interna specificata.
DecryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode)	Decrittografa i dati usando la modalità CBC con la modalità spaziatura interna specificata.
DecryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)	Decrittografa i dati nel buffer specificato, usando la modalità CBC con la modalità spaziatura interna specificata.
DecryptCfb(Byte[], Byte[], PaddingMode, Int32)	Decrittografa i dati usando la modalità MODALITÀ DI RIEMPIMENTO e le dimensioni del feedback specificate.
DecryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode, Int32)	Decrittografa i dati usando la modalità MODALITÀ DI RIEMPIMENTO e le dimensioni del feedback specificate.
DecryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Decrittografa i dati nel buffer specificato, utilizzando la modalità BUFFER con la modalità di riempimento e le dimensioni di feedback specificate.
DecryptEcb(Byte[], PaddingMode)	Decrittografa i dati usando la modalità BCE con la modalità di riempimento specificata.
DecryptEcb(ReadOnlySpan<Byte>, PaddingMode)	Decrittografa i dati usando la modalità BCE con la modalità di riempimento specificata.
DecryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)	Decrittografa i dati nel buffer specificato, utilizzando la modalità BCE con la modalità spaziatura interna specificata.
Dispose()	Rilascia tutte le risorse usate dall'istanza corrente della SymmetricAlgorithm classe .
Dispose(Boolean)	Rilascia le risorse non gestite usate da SymmetricAlgorithm e, facoltativamente, rilascia le risorse gestite.
EncryptCbc(Byte[], Byte[], PaddingMode)	Crittografa i dati usando la modalità CBC con la modalità spaziatura interna specificata.
EncryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode)	Crittografa i dati usando la modalità CBC con la modalità spaziatura interna specificata.
EncryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)	Crittografa i dati nel buffer specificato, usando la modalità CBC con la modalità spaziatura interna specificata.
EncryptCfb(Byte[], Byte[], PaddingMode, Int32)	Crittografa i dati usando la modalità DISTRIBUISCI con la modalità di riempimento e le dimensioni di feedback specificate.
EncryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode, Int32)	Crittografa i dati usando la modalità DISTRIBUISCI con la modalità di riempimento e le dimensioni di feedback specificate.
EncryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Crittografa i dati nel buffer specificato, usando lamodalitàa con la modalità di riempimento e le dimensioni del feedback specificate.
EncryptEcb(Byte[], PaddingMode)	Crittografa i dati usando la modalità BCE con la modalità di riempimento specificata.
EncryptEcb(ReadOnlySpan<Byte>, PaddingMode)	Crittografa i dati usando la modalità BCE 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à spaziatura interna specificata.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
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 determinata modalità di riempimento e lunghezza di testo non crittografato in modalità CBC.
GetCiphertextLengthCfb(Int32, PaddingMode, Int32)	Ottiene la lunghezza di un testo crittografato con una determinata modalità di riempimento e lunghezza di testo non crittografato in modalità TLS.
GetCiphertextLengthEcb(Int32, PaddingMode)	Ottiene la lunghezza di un testo crittografato con una determinata modalità di riempimento e lunghezza di testo non crittografato in modalità BCE.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
SetKey(ReadOnlySpan<Byte>)	Imposta la chiave per questa istanza.
SetKeyCore(ReadOnlySpan<Byte>)	Imposta la chiave per questa istanza.
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à spaziatura interna 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à spaziatura interna specificata.
TryDecryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode, Int32)	Tenta di decrittografare i dati nel buffer specificato, usando lamodalitàa con la modalità di riempimento e le dimensioni del feedback specificate.
TryDecryptCfbCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32, Int32)	Quando ne viene eseguito l'override in una classe derivata, tenta di decrittografare i dati nel buffer specificato, usando lamodalitàa con la modalità di riempimento e le dimensioni del feedback specificate.
TryDecryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Tenta di decrittografare i dati nel buffer specificato, utilizzando 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à BCE con la modalità spaziatura interna 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à spaziatura interna 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à spaziatura interna specificata.
TryEncryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode, Int32)	Tenta di crittografare i dati nel buffer specificato, usando la modalità ESEGUI CON la modalità di riempimento e le dimensioni del feedback specificate.
TryEncryptCfbCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32, Int32)	Quando ne viene eseguito l'override in una classe derivata, tenta di crittografare i dati nel buffer specificato, usando la modalità BUFFER con la modalità di riempimento e le dimensioni del feedback specificate.
TryEncryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Tenta di crittografare i dati nel buffer specificato, usando la modalità BCE con la modalità spaziatura interna 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à BCE con la modalità spaziatura interna specificata.
ValidKeySize(Int32)	Determina se la dimensione della chiave specificata è valida per l'algoritmo corrente.

Vedi anche

• Servizi di crittografia