SymmetricAlgorithm Classe

Definizione

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.

Si applica a

Vedi anche