SymmetricAlgorithm Sınıf

Tanım

Ad Alanı:

System.Security.Cryptography

Bütünleştirilmiş Kod:

System.Security.Cryptography.dll

Kaynak:

SymmetricAlgorithm.cs

Simetrik algoritmaların tüm uygulamalarının devralması gereken soyut temel sınıfı temsil eder.

public ref class SymmetricAlgorithm abstract : IDisposable

public abstract class SymmetricAlgorithm : IDisposable

type SymmetricAlgorithm = class
    interface IDisposable

Public MustInherit Class SymmetricAlgorithm
Implements IDisposable

Devralma

Object

SymmetricAlgorithm

Türetilmiş

System.Security.Cryptography.Aes

System.Security.Cryptography.DES

System.Security.Cryptography.RC2

System.Security.Cryptography.Rijndael

System.Security.Cryptography.TripleDES

Uygulamalar

IDisposable

Örnekler

Aşağıdaki kod örneği, tarafından belirtilen bir dosyayı şifrelemek için belirtilen Key özelliği ve başlatma vektörünü (IV) içeren sınıfını kullanır Aes ve tarafından belirtilen inNameoutNamedosyaya şifrelenmiş sonucun çıkışını yapar. desKey yönteminin ve desIV parametreleri 8 baytlık dizilerdir. Bu örneği çalıştırmak için yüksek şifreleme paketinin yüklü olması gerekir.

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

Açıklamalar

sınıfından SymmetricAlgorithm türetilen sınıflar, veriler üzerinde şifreleme dönüştürmeleri gerçekleştirmek için anahtar () ve başlatma vektöru (Key) gerektiren şifreleme bloğu zincirleme (IVCBC) adlı bir zincirleme modu kullanır. Sınıflardan biri SymmetricAlgorithm kullanılarak şifrelenen verilerin şifresini çözmek için özelliğini ve IV özelliğini şifreleme için kullanılan değerlere ayarlamanız Key gerekir. Simetrik algoritmanın yararlı olması için gizli anahtarın yalnızca gönderen ve alıcı tarafından bilinmesi gerekir.

Aes, DES, RC2ve TripleDES simetrik algoritmaların uygulamalarıdır.

Türetilmiş sınıfları kullanırken, nesneyi kullanmayı bitirdikten sonra bir çöp toplamayı zorlamanın güvenlik açısından yeterli olmadığını unutmayın. Serbest bırakılmadan önce nesne içindeki hassas verileri sıfıra çıkarmak için nesnesinde yöntemini açıkça çağırmanız Clear gerekir. Atık toplama işleminin toplanan nesnelerin içeriğinin sıfırlanmadığını, yalnızca belleği yeniden konumlandırma için kullanılabilir olarak işaretlediğini unutmayın. Bu nedenle, atık olarak toplanan bir nesnenin içinde bulunan veriler ayrılmamış bellekteki bellek yığınında bulunmaya devam edebilir. Şifreleme nesneleri söz konusu olduğunda, bu veriler anahtar verileri veya düz metin bloğu gibi hassas bilgiler içerebilir.

.NET Framework hassas verileri tutan tüm şifreleme sınıfları bir Clear yöntem uygular. çağrıldığında, Clear yöntemi sıfırlarla nesne içindeki tüm hassas verilerin üzerine yazar ve sonra güvenli bir şekilde çöp toplanabilmesi için nesneyi serbest bırakır. Nesne sıfırlanıp serbest bırakıldığında, nesnesiyle disposing ilişkili tüm yönetilen ve yönetilmeyen kaynakları atmak için True parametresi ayarlanmış yöntemini çağırmanız Dispose gerekir.

Uygulayanlara Notlar

sınıfından SymmetricAlgorithm devraldığınızda, şu üyeleri geçersiz kılmalısınız: CreateDecryptor(Byte[], Byte[]), CreateEncryptor(Byte[], Byte[]), GenerateIV()ve GenerateKey().

Oluşturucular

SymmetricAlgorithm()

SymmetricAlgorithm sınıfının yeni bir örneğini başlatır.

Alanlar

BlockSizeValue	Şifreleme işleminin blok boyutunu bit cinsinden temsil eder.
FeedbackSizeValue	Şifreleme işleminin bit cinsinden geri bildirim boyutunu temsil eder.
IVValue	Simetrik algoritma için başlatma vektörlerini (IV) temsil eder.
KeySizeValue	Simetrik algoritma tarafından kullanılan gizli anahtarın boyutunu bit cinsinden temsil eder.
KeyValue	Simetrik algoritma için gizli anahtarı temsil eder.
LegalBlockSizesValue	Simetrik algoritma tarafından desteklenen blok boyutlarını bit cinsinden belirtir.
LegalKeySizesValue	Simetrik algoritma tarafından desteklenen anahtar boyutlarını bit cinsinden belirtir.
ModeValue	Simetrik algoritmada kullanılan şifreleme modunu temsil eder.
PaddingValue	Simetrik algoritmada kullanılan doldurma modunu temsil eder.

Özellikler

BlockSize	Şifreleme işleminin blok boyutunu bit cinsinden alır veya ayarlar.
FeedbackSize	Şifreleme Geri Bildirimi (CFB) ve Çıkış Geri Bildirimi (OFB) şifreleme modları için şifreleme işleminin bit cinsinden geri bildirim boyutunu alır veya ayarlar.
IV	Simetrik algoritma için başlatma vektörlerini (IV) alır veya ayarlar.
Key	Simetrik algoritma için gizli anahtarı alır veya ayarlar.
KeySize	Simetrik algoritma tarafından kullanılan gizli anahtarın boyutunu bit cinsinden alır veya ayarlar.
LegalBlockSizes	Simetrik algoritma tarafından desteklenen blok boyutlarını bit cinsinden alır.
LegalKeySizes	Simetrik algoritma tarafından desteklenen bit cinsinden anahtar boyutlarını alır.
Mode	Simetrik algoritmanın çalışması için modu alır veya ayarlar.
Padding	Simetrik algoritmada kullanılan doldurma modunu alır veya ayarlar.

Yöntemler

Clear()	sınıfı tarafından SymmetricAlgorithm kullanılan tüm kaynakları serbest bırakır.
Create()	Geçersiz. Simetrik algoritmayı gerçekleştirmek için kullanılan varsayılan bir şifreleme nesnesi oluşturur.
Create(String)	Geçersiz. Simetrik algoritmayı gerçekleştirmek için kullanılan belirtilen şifreleme nesnesini oluşturur.
CreateDecryptor()	Geçerli Key özellik ve başlatma vektörünü (IV ile simetrik bir decryptor nesnesi oluşturur.
CreateDecryptor(Byte[], Byte[])	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen Key özellik ve başlatma vektörünü (IV ) içeren bir simetrik decryptor nesnesi oluşturur.
CreateEncryptor()	Geçerli Key özelliği ve başlatma vektörünü (IV ) içeren bir simetrik şifreleme nesnesi oluşturur.
CreateEncryptor(Byte[], Byte[])	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen Key özellik ve başlatma vektörünü (IV ) içeren bir simetrik şifreleme nesnesi oluşturur.
DecryptCbc(Byte[], Byte[], PaddingMode)	Belirtilen doldurma moduyla CBC modunu kullanarak verilerin şifresini çözer.
DecryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode)	Belirtilen doldurma moduyla CBC modunu kullanarak verilerin şifresini çözer.
DecryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)	Belirtilen doldurma moduyla CBC modunu kullanarak verilerin şifresini belirtilen arabelleğe çözer.
DecryptCfb(Byte[], Byte[], PaddingMode, Int32)	Belirtilen doldurma modu ve geri bildirim boyutuyla CFB modunu kullanarak verilerin şifresini çözer.
DecryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode, Int32)	Belirtilen doldurma modu ve geri bildirim boyutuyla CFB modunu kullanarak verilerin şifresini çözer.
DecryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Belirtilen doldurma modu ve geri bildirim boyutuyla CFB modunu kullanarak verilerin şifresini belirtilen arabelleğe çözer.
DecryptEcb(Byte[], PaddingMode)	Belirtilen doldurma moduyla ECB modunu kullanarak verilerin şifresini çözer.
DecryptEcb(ReadOnlySpan<Byte>, PaddingMode)	Belirtilen doldurma moduyla ECB modunu kullanarak verilerin şifresini çözer.
DecryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)	Belirtilen doldurma moduyla ECB modunu kullanarak verilerin şifresini belirtilen arabelleğe çözer.
Dispose()	SymmetricAlgorithm sınıfının geçerli örneği tarafından kullanılan tüm kaynakları serbest bırakır.
Dispose(Boolean)	SymmetricAlgorithm tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır.
EncryptCbc(Byte[], Byte[], PaddingMode)	Belirtilen doldurma moduyla CBC modunu kullanarak verileri şifreler.
EncryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode)	Belirtilen doldurma moduyla CBC modunu kullanarak verileri şifreler.
EncryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)	Belirtilen doldurma moduyla CBC modunu kullanarak verileri belirtilen arabelleğe şifreler.
EncryptCfb(Byte[], Byte[], PaddingMode, Int32)	CfB modunu kullanarak verileri belirtilen doldurma modu ve geri bildirim boyutuyla şifreler.
EncryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode, Int32)	CfB modunu kullanarak verileri belirtilen doldurma modu ve geri bildirim boyutuyla şifreler.
EncryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	CfB modunu belirtilen doldurma modu ve geri bildirim boyutuyla kullanarak verileri belirtilen arabelleğe şifreler.
EncryptEcb(Byte[], PaddingMode)	Belirtilen doldurma moduyla ECB modunu kullanarak verileri şifreler.
EncryptEcb(ReadOnlySpan<Byte>, PaddingMode)	Belirtilen doldurma moduyla ECB modunu kullanarak verileri şifreler.
EncryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)	EcB modunu belirtilen doldurma moduyla kullanarak verileri belirtilen arabelleğe şifreler.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GenerateIV()	Türetilmiş bir sınıfta geçersiz kılındığında, algoritma için kullanılacak rastgele bir başlatma vektöru (IV) oluşturur.
GenerateKey()	Türetilmiş bir sınıfta geçersiz kılındığında, algoritma için kullanılacak rastgele bir anahtar (Key) oluşturur.
GetCiphertextLengthCbc(Int32, PaddingMode)	CBC modunda belirli bir doldurma modu ve düz metin uzunluğu ile bir şifreleme metninin uzunluğunu alır.
GetCiphertextLengthCfb(Int32, PaddingMode, Int32)	CfB modunda belirli bir doldurma modu ve düz metin uzunluğu ile bir şifreleme metninin uzunluğunu alır.
GetCiphertextLengthEcb(Int32, PaddingMode)	Belirli bir doldurma moduyla bir şifreleme metninin uzunluğunu ve ECB modunda düz metin uzunluğunu alır.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
TryDecryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode)	Belirtilen doldurma moduyla CBC modunu kullanarak verilerin şifresini belirtilen arabelleğe çözmeyi dener.
TryDecryptCbcCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen doldurma moduyla CBC modunu kullanarak verilerin şifresini çözmeyi dener.
TryDecryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode, Int32)	Belirtilen doldurma modu ve geri bildirim boyutuyla CFB modunu kullanarak verilerin şifresini belirtilen arabelleğe çözmeyi dener.
TryDecryptCfbCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen doldurma modu ve geri bildirim boyutuyla CFB modunu kullanarak verilerin şifresini belirtilen arabelleğe çözmeyi dener.
TryDecryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Belirtilen doldurma moduyla ECB modunu kullanarak verilerin şifresini belirtilen arabelleğe çözmeyi dener.
TryDecryptEcbCore(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen doldurma moduyla ECB modunu kullanarak verilerin şifresini çözmeyi dener.
TryEncryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode)	Belirtilen doldurma moduyla CBC modunu kullanarak verileri belirtilen arabelleğe şifrelemeye çalışır.
TryEncryptCbcCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen doldurma moduyla CBC modunu kullanarak verileri belirtilen arabelleğe şifrelemeyi dener.
TryEncryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode, Int32)	Belirtilen doldurma modu ve geri bildirim boyutuyla CFB modunu kullanarak verileri belirtilen arabelleğe şifrelemeye çalışır.
TryEncryptCfbCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, cfb modunu belirtilen doldurma modu ve geri bildirim boyutuyla kullanarak verileri belirtilen arabelleğe şifrelemeye çalışır.
TryEncryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Belirtilen doldurma moduyla ECB modunu kullanarak verileri belirtilen arabelleğe şifrelemeye çalışır.
TryEncryptEcbCore(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen doldurma moduyla ECB modunu kullanarak verileri belirtilen arabelleğe şifrelemeye çalışır.
ValidKeySize(Int32)	Belirtilen anahtar boyutunun geçerli algoritma için geçerli olup olmadığını belirler.

Ayrıca bkz.

• Şifreleme Hizmetleri