SymmetricAlgorithm Sınıf

Tanım

Ad Alanı:

System.Security.Cryptography

Bütünleştirilmiş Kodlar:

netstandard.dll, 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 inNamebelirtilen 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 outNamedosyaya şifrelenmiş sonucu döndürür. 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.

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 (Key) ve başlatma vektör () gerektiren şifreleme blok zinciri (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 nesne üzerinde yöntemini açıkça çağırmanız Clear gerekir. Atık toplamanın toplanan nesnelerin içeriğini sıfırlamadığı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 yer alan veriler ayrılmamış bellekteki bellek yığınında hala bulunabilir. Şifreleme nesneleri söz konusu olduğunda, bu veriler anahtar verileri veya düz metin bloğu gibi hassas bilgiler içerebilir.

.NET Framework'te 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ğırmalısınızDispose.

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

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

Alanlar

Name	Description
BlockSizeValue	Şifreleme işleminin bit cinsinden blok boyutunu 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 bit cinsinden boyutunu temsil eder.
KeyValue	Simetrik algoritmanın gizli dizi anahtarını temsil eder.
LegalBlockSizesValue	Simetrik algoritma tarafından desteklenen blok boyutlarını bit cinsinden belirtir.
LegalKeySizesValue	Simetrik algoritma tarafından desteklenen bit cinsinden anahtar boyutlarını belirtir.
ModeValue	Simetrik algoritmada kullanılan şifreleme modunu temsil eder.
PaddingValue	Simetrik algoritmada kullanılan doldurma modunu temsil eder.

Özellikler

Name	Description
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ışma modunu alır veya ayarlar.
Padding	Simetrik algoritmada kullanılan doldurma modunu alır veya ayarlar.

Yöntemler

Name	Description
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 özelliği ve başlatma vektörünü (IV) içeren bir simetrik şifre çözücü 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 arabellekte çözer.
DecryptCfb(Byte[], Byte[], PaddingMode, Int32)	CFB modunu kullanarak verilerin şifresini belirtilen doldurma modu ve geri bildirim boyutuyla çözer.
DecryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode, Int32)	CFB modunu kullanarak verilerin şifresini belirtilen doldurma modu ve geri bildirim boyutuyla çözer.
DecryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Belirtilen doldurma modu ve geri bildirim boyutuyla CFB modunu kullanarak verilerin şifresini belirtilen arabellekte çö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)	EcB modunu belirtilen doldurma moduyla kullanarak verilerin şifresini belirtilen arabellekte çözer.
Dispose()	Sınıfın geçerli örneği SymmetricAlgorithm tarafından kullanılan tüm kaynakları serbest bırakır.
Dispose(Boolean)	tarafından SymmetricAlgorithm kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları 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ör (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)	Belirli bir doldurma moduna sahip bir şifreleme metninin uzunluğunu ve CBC modunda düz metin uzunluğunu alır.
GetCiphertextLengthCfb(Int32, PaddingMode, Int32)	CFB modunda belirli bir doldurma moduna ve düz metin uzunluğuna sahip bir şifreleme metninin uzunluğunu alır.
GetCiphertextLengthEcb(Int32, PaddingMode)	EcB modunda belirli bir doldurma modu ve düz metin uzunluğu ile bir şifreleme metninin uzunluğunu alır.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
SetKey(ReadOnlySpan<Byte>)	Bu örneğin anahtarını ayarlar.
SetKeyCore(ReadOnlySpan<Byte>)	Bu örneğin anahtarını ayarlar.
ToString()	Geçerli nesneyi temsil eden bir dize 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 arabellekte çö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 belirtilen arabellekte çö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 arabellekte çö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 arabellekte çözmeyi dener.
TryDecryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Belirtilen doldurma moduyla ECB modunu kullanarak verilerin şifresini belirtilen arabellekte çö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 belirtilen arabellekte çö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, belirtilen doldurma modu ve geri bildirim boyutuyla CFB modunu kullanarak verileri belirtilen arabelleğe şifrelemeyi dener.
TryEncryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Belirtilen doldurma moduyla ECB modunu kullanarak verileri belirtilen arabelleğe şifrelemeyi dener.
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 şifrelemeyi dener.
ValidKeySize(Int32)	Belirtilen anahtar boyutunun geçerli algoritma için geçerli olup olmadığını belirler.

Ayrıca bkz.

• Şifreleme Hizmetleri