SymmetricAlgorithm Classe

Definição

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

Herança

Object

SymmetricAlgorithm

Derivado

System.Security.Cryptography.Aes

System.Security.Cryptography.DES

System.Security.Cryptography.RC2

System.Security.Cryptography.Rijndael

System.Security.Cryptography.TripleDES

Atributos

ComVisibleAttribute

Implementações

IDisposable

Exemplos

O seguinte exemplo de código usa a Aes classe com a propriedade especificada Key e o vetor de inicialização (IV) para encriptar um ficheiro especificado por inName, e gera o resultado encriptado para o ficheiro especificado por outName. Os desKey parâmetros e desIV do método são arrays de 8 bytes. Tens de ter instalado o pacote de alta encriptação para executar este exemplo.

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

Observações

As classes que derivam da SymmetricAlgorithm classe utilizam um modo de encadeamento chamado encadeamento de blocos cifrados (CBC), que requer uma chave (Key) e um vetor de inicialização (IV) para realizar transformações criptográficas nos dados. Para desencriptar dados que foram encriptados usando uma das SymmetricAlgorithm classes, deve definir a Key propriedade e a IV propriedade para os mesmos valores usados para encriptação. Para que um algoritmo simétrico seja útil, a chave secreta deve ser conhecida apenas pelo emissor e pelo recetor.

Aes, DES, RC2, e TripleDES são implementações de algoritmos simétricos.

Note que, ao usar classes derivadas, não é suficiente, do ponto de vista da segurança, simplesmente forçar uma recolha de lixo depois de terminar de usar o objeto. Deve chamar explicitamente o Clear método no objeto para zerar quaisquer dados sensíveis dentro do objeto antes de serem libertados. Note que a recolha de lixo não zera o conteúdo dos objetos recolhidos, apenas marca a memória como disponível para realocação. Assim, os dados contidos num objeto recolhido de lixo podem ainda estar presentes no heap de memória na memória não alocada. No caso de objetos criptográficos, estes dados podem conter informações sensíveis, como dados de chave ou um bloco de texto simples.

Todas as classes criptográficas no .NET Framework que detêm dados sensíveis implementam um método Clear. Quando chamado, o Clear método sobrescrive todos os dados sensíveis dentro do objeto com zeros e depois liberta o objeto para que possa ser recolhido de lixo em segurança. Quando o objeto for zerado e libertado, deve então chamar o Dispose método com o disposing parâmetro definido para True eliminar todos os recursos geridos e não geridos associados ao objeto.

Notas para Implementadores

Quando herdas da SymmetricAlgorithm classe, tens de sobrescrever os seguintes membros: CreateDecryptor(Byte[], Byte[]), CreateEncryptor(Byte[], Byte[]), GenerateIV(), e GenerateKey().

Ver também

• Serviços de criptografia