SymmetricAlgorithm クラス

定義

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

継承

Object

SymmetricAlgorithm

派生

System.Security.Cryptography.Aes

System.Security.Cryptography.DES

System.Security.Cryptography.RC2

System.Security.Cryptography.Rijndael

System.Security.Cryptography.TripleDES

属性

ComVisibleAttribute

実装

IDisposable

例

次のコード例では、Aes指定したKeyプロパティと初期化ベクトル (IV) を持つ クラスを使用して、 で指定されたファイルを暗号化し、 でinNameoutName指定されたファイルに暗号化された結果を出力します。 desKeyメソッドの パラメーターと desIV パラメーターは 8 バイト配列です。 この例を実行するには、高暗号化パックがインストールされている必要があります。

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

注釈

クラスから SymmetricAlgorithm 派生するクラスは、暗号ブロック チェーン (CBC) と呼ばれるチェーン モードを使用します。これには、データに対して暗号化変換を実行するためにキー (Key) と初期化ベクトル (IV) が必要です。 クラスの 1 つを使用して暗号化されたデータの暗号化をSymmetricAlgorithm解除するには、 プロパティと プロパティをIV、暗号化に使用されたのと同じ値に設定Keyする必要があります。 対称アルゴリズムを役立てるには、秘密キーが送信者と受信側にのみ認識されている必要があります。

Aes、 DES、 RC2、および TripleDES は対称アルゴリズムの実装です。

派生クラスを使用する場合、オブジェクトの使用が完了した後にガベージ コレクションを強制するだけでは、セキュリティの観点からは十分ではないことに注意してください。 オブジェクトを解放する Clear 前に、オブジェクト内の機密データをゼロにするには、 オブジェクトの メソッドを明示的に呼び出す必要があります。 ガベージ コレクションは、収集されたオブジェクトの内容をゼロにするのではなく、単にメモリを再割り当て可能としてマークします。 したがって、ガベージ コレクション オブジェクト内に含まれるデータは、未割り当てメモリのメモリ ヒープにまだ存在する可能性があります。 暗号化オブジェクトの場合、このデータには、キー データやプレーン テキストのブロックなどの機密情報が含まれている可能性があります。

機密データを保持する .NET Framework 内のすべての暗号化クラスは、 メソッドを Clear 実装します。 メソッドを Clear 呼び出すと、オブジェクト内のすべての機密データがゼロで上書きされ、オブジェクトが解放され、安全にガベージ コレクションできるようになります。 オブジェクトがゼロに設定され、解放されたら、 パラメーターを にTrue設定して メソッドをdisposing呼び出Disposeして、オブジェクトに関連付けられているすべてのマネージド リソースとアンマネージド リソースを破棄する必要があります。

注意 (実装者)

クラスからSymmetricAlgorithm継承する場合は、、および の各メンバーGenerateIV()CreateDecryptor(Byte[], Byte[])CreateEncryptor(Byte[], Byte[])をオーバーライドするGenerateKey()必要があります。

コンストラクター

フィールド

プロパティ

メソッド

明示的なインターフェイスの実装

適用対象

こちらもご覧ください

• Cryptographic Services