Rfc2898DeriveBytesとは？ わかりやすく解説

.NET Framework クラス ライブラリ リファレンス
索引トップ 用語の索引 ランキング
日本マイクロソフト株式会社日本マイクロソフト株式会社

Rfc2898DeriveBytes クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

HMACSHA1 に基づく擬似乱数ジェネレータを使用して、パスワード ベースのキー派生機能 (PBKDF2) を実装します。

名前空間: System.Security.Cryptography
アセンブリ: mscorlib (mscorlib.dll 内)
構文構文

Visual Basic (宣言)
<ComVisibleAttribute(True)> _
Public Class Rfc2898DeriveBytes
    Inherits DeriveBytes
Visual Basic (使用法)
Dim instance As Rfc2898DeriveBytes
C#
[ComVisibleAttribute(true)] 
public class Rfc2898DeriveBytes : DeriveBytes
C++
[ComVisibleAttribute(true)] 
public ref class Rfc2898DeriveBytes : public
 DeriveBytes
J#
/** @attribute ComVisibleAttribute(true) */ 
public class Rfc2898DeriveBytes extends DeriveBytes
JScript
ComVisibleAttribute(true) 
public class Rfc2898DeriveBytes extends
 DeriveBytes
解説解説

Rfc2898DeriveBytes は引数として、パスワード、salt、反復回数を受け取り、GetBytes メソッドを呼び出してキーを生成します。

RFC 2898 には、パスワードと salt からキーおよび初期化ベクタ (IV) を作成するためのメソッドが規定されています。実質的に無制限の長さのキーを生成できる擬似乱数関数と、パスワード ベースのキー派生関数である PBKDF2 を使用して、キーを派生させることができます。Rfc2898DeriveBytes クラスは、基本キーおよびその他のパラメータから派生キーを生成するときに使用できます。パスワード ベースのキー派生関数では、基本キーがパスワードに、その他のパラメータは salt 値および反復回数になります。

PBKDF2 の詳細については、RFC の Web サイト (http://www.rfc-editor.org) で、「RFC 2898, PKCS #5: Password-Based Cryptography Specification Version 2.0」を参照してください。特に、セクション 5.2 の「PBKDF2」を参照してください。

セキュリティに関するメモセキュリティに関するメモ

パスワードをソース コード内にハード コーディングすることは絶対に避けてください。ハード コーディングされたパスワードは、MSIL 逆アセンブラ (Ildasm.exe) や 16 進エディタを使用したり、アセンブリを Notepad.exe などのテキスト エディタで開いたりすることによって簡単にアセンブリから取得されてしまいます。

使用例使用例

Rfc2898DeriveBytes クラスを使用して、TripleDES クラスのまったく同じ 2 つのキーを作成するコード例を次に示します。次に、このキーを使用して、一部のデータを暗号化および復号化します。

C#
using System;
using System.IO;
using System.Text;
using System.Security.Cryptography;

public class rfc2898test
{
    // Generate a key k1 with password pwd1 and salt salt1.
    // Generate a key k2 with password pwd1 and salt salt1.
    // Encrypt data1 with key k1 using symmetric encryption, creating
 edata1.
    // Decrypt edata1 with key k2 using symmetric decryption, creating
 data2.
    // data2 should equal data1.

    private const string
 usageText = "Usage: RFC2898 <password>\nYou must specify the password
 for encryption.\n";
    public static void Main(string[]
 passwordargs)
    {
        //If no file name is specified, write usage text.
        if (passwordargs.Length == 0)
        {
            Console.WriteLine(usageText);
        }
        else
        {
            string pwd1 = passwordargs[0];
            
            byte[] salt1 = new byte[] { 0x00, 0x01, 0x02, 0x03,
 0x04, 0x05, 0x06, 0xF1, 0xF0, 0xEE, 0x21, 0x22, 0x45};
            //data1 can be a string or contents of a file.
            string data1 = "Some test data";
            //The default iteration count is 1000 so the two methods
 use the same iteration count.
            int myIterations = 1000;
            try
            {
                Rfc2898DeriveBytes k1 = new Rfc2898DeriveBytes(pwd1,
 salt1,myIterations);
                Rfc2898DeriveBytes k2 = new Rfc2898DeriveBytes(pwd1,
 salt1);
                // Encrypt the data.
                TripleDES encAlg = TripleDES.Create();
                encAlg.Key = k1.GetBytes(16);
                MemoryStream encryptionStream = new MemoryStream();
                CryptoStream encrypt = new CryptoStream(encryptionStream,
 encAlg.CreateEncryptor(),CryptoStreamMode.Write);
                byte[] utfD1 = new System.Text.UTF8Encoding(false).GetBytes(data1);

                encrypt.Write(utfD1, 0, utfD1.Length);
                encrypt.FlushFinalBlock();
                encrypt.Close();
                byte[] edata1 = encryptionStream.ToArray();
                k1.Reset();

                // Try to decrypt, thus showing it can be round-tripped.
                TripleDES decAlg = TripleDES.Create();
                decAlg.Key = k2.GetBytes(16);
                decAlg.IV = encAlg.IV;
                MemoryStream decryptionStreamBacking = new MemoryStream();
                CryptoStream decrypt = new CryptoStream(decryptionStreamBacking,decAlg.CreateDecryptor(),
 CryptoStreamMode.Write);
                decrypt.Write(edata1, 0, edata1.Length);
                decrypt.Flush();
                decrypt.Close();
                k2.Reset();
                string data2 = new UTF8Encoding(false).GetString(decryptionStreamBacking.ToArray());

                if (!data1.Equals(data2))
                {
                    Console.WriteLine("Error: The two values are not equal.");
                }
                else
                {
                    Console.WriteLine("The two values are equal.");
                    Console.WriteLine("k1 iterations: {0}",k1.IterationCount);
                    Console.WriteLine("k2 iterations: {0}",k2.IterationCount);
                }
            }
            catch (Exception e)
            {
                Console.WriteLine("Error: ",e);
            }

        }
    }
}
C++
using namespace System;
using namespace System::IO;
using namespace System::Text;
using namespace System::Security::Cryptography;

// Generate a key k1 with password pwd1 and salt salt1.
// Generate a key k2 with password pwd1 and salt salt1.
// Encrypt data1 with key k1 using symmetric encryption, creating edata1.
// Decrypt edata1 with key k2 using symmetric decryption, creating data2.
// data2 should equal data1.

int main()
{
   array<String^>^passwordargs = Environment::GetCommandLineArgs();
   String^ usageText = "Usage: RFC2898 <password>\nYou must specify the
 password for encryption.\n";

   //If no file name is specified, write usage text.
   if ( passwordargs->Length == 1 )
   {
      Console::WriteLine( usageText );
   }
   else
   {
      String^ pwd1 = passwordargs[ 1 ];
      
      array<Byte>^salt1 = gcnew array<Byte>{
         0x00,0x01,0x02,0x03,0x04,0x05,0x06,0xF1,0xF0,0xEE,0x21,0x22,0x45
      };

      //data1 can be a string or contents of a file.
      String^ data1 = "Some test data";

      //The default iteration count is 1000 so the two methods use the
 same iteration count.
      int myIterations = 1000;

      try
      {
         Rfc2898DeriveBytes ^ k1 = gcnew Rfc2898DeriveBytes( pwd1,salt1,myIterations
 );
         Rfc2898DeriveBytes ^ k2 = gcnew Rfc2898DeriveBytes( pwd1,salt1 );

         // Encrypt the data.
         TripleDES^ encAlg = TripleDES::Create();
         encAlg->Key = k1->GetBytes( 16 );
         MemoryStream^ encryptionStream = gcnew MemoryStream;
         CryptoStream^ encrypt = gcnew CryptoStream( encryptionStream,encAlg->CreateEncryptor(),CryptoStreamMode::Write
 );
         array<Byte>^utfD1 = (gcnew System::Text::UTF8Encoding( false
 ))->GetBytes( data1 );

         encrypt->Write( utfD1, 0, utfD1->Length );
         encrypt->FlushFinalBlock();
         encrypt->Close();
         array<Byte>^edata1 = encryptionStream->ToArray();
         k1->Reset();

         // Try to decrypt, thus showing it can be round-tripped.
         TripleDES^ decAlg = TripleDES::Create();
         decAlg->Key = k2->GetBytes( 16 );
         decAlg->IV = encAlg->IV;
         MemoryStream^ decryptionStreamBacking = gcnew MemoryStream;
         CryptoStream^ decrypt = gcnew CryptoStream( decryptionStreamBacking,decAlg->CreateDecryptor(),CryptoStreamMode::Write
 );

         decrypt->Write( edata1, 0, edata1->Length );
         decrypt->Flush();
         decrypt->Close();
         k2->Reset();

         String^ data2 = (gcnew UTF8Encoding( false ))->GetString(
 decryptionStreamBacking->ToArray() );
         if (  !data1->Equals( data2 ) )
         {
            Console::WriteLine( "Error: The two values are not equal."
 );
         }
         else
         {
            Console::WriteLine( "The two values are equal." );
            Console::WriteLine( "k1 iterations: {0}", k1->IterationCount
 );
            Console::WriteLine( "k2 iterations: {0}", k2->IterationCount
 );
         }
      }

      catch ( Exception^ e ) 
      {
         Console::WriteLine( "Error: ", e );
      }
   }
}
J#
import System.*;
import System.IO.*;
import System.Text.*;
import System.Security.Cryptography.*;

public class rfc2898test
{
    // Generate a key k1 with password pwd1 and salt salt1.
    // Generate a key k2 with password pwd1 and salt salt1.
    // Encrypt data1 with key k1 using symmetric encryption, creating
 eData1.
    // Decrypt eData1 with key k2 using symmetric decryption, creating
 data2.
    // data2 should equal data1.
    private static String usageText = "Usage:
 RFC2898 <password>\n"
        + "You must specify the password for encryption.\n";

    public static void main(String[]
 passwordArgs)
    {
        //If no file name is specified, write usage text.
        if (passwordArgs.get_Length() == 0) {
            Console.WriteLine(usageText);
        }
        else {
            String pwd1 = (String)passwordArgs.get_Item(0);

            ubyte salt1[] = new ubyte[] { 0x0, 0x1, 0x2, 0x3,
 0x4, 0x5, 0x6,
                0xF1, 0xF0, 0xEE, 0x21, 0x22, 0x45 };
            //data1 can be a string or contents of a file.
            String data1 = "Some test data";
            //The default iteration count is 1000 so the two methods
 use the
            //same iteration count.
            int myIterations = 1000;
            try {
                Rfc2898DeriveBytes k1 = new Rfc2898DeriveBytes(pwd1,
 salt1,
                    myIterations);
                Rfc2898DeriveBytes k2 = new Rfc2898DeriveBytes(pwd1,
 salt1);
                // Encrypt the data.
                TripleDES encAlg = TripleDES.Create();
                encAlg.set_Key(k1.GetBytes(16));
                MemoryStream encryptionStream = new MemoryStream();
                CryptoStream encrypt = new CryptoStream(encryptionStream,
 
                    encAlg.CreateEncryptor(), CryptoStreamMode.Write);
                ubyte utfD1[] = (new System.Text.UTF8Encoding(false)).
                    GetBytes(data1);
                encrypt.Write(utfD1, 0, utfD1.get_Length());
                encrypt.FlushFinalBlock();
                encrypt.Close();
                ubyte eData1[] = encryptionStream.ToArray();
                k1.Reset();
                // Try to decrypt, thus showing it can be round-tripped.
                TripleDES decAlg = TripleDES.Create();
                decAlg.set_Key(k2.GetBytes(16));
                decAlg.set_IV(encAlg.get_IV());
                MemoryStream decryptionStreamBacking = new MemoryStream();
                CryptoStream decrypt = new CryptoStream(decryptionStreamBacking,
 
                    decAlg.CreateDecryptor(), CryptoStreamMode.Write);
                decrypt.Write(eData1, 0, eData1.get_Length());
                decrypt.Flush();
                decrypt.Close();
                k2.Reset();
                String data2 = (new UTF8Encoding(false)).
                    GetString(decryptionStreamBacking.ToArray());
                if (!(data1.Equals(data2))) {
                    Console.WriteLine("Error: The two values are not equal.");
                }
                else {
                    Console.WriteLine("The two values are equal.");
                    Console.WriteLine("k1 iterations: {0}", (System.Int32)k1.
                        get_IterationCount());
                    Console.WriteLine("k2 iterations: {0}", (System.Int32)k2.
                        get_IterationCount());
                }
            }           
            catch (System.Exception e) {
                Console.WriteLine("Error: ", e);
            }
        }
    } //main
} //rfc2898test
継承階層継承階層
System.Object
   System.Security.Cryptography.DeriveBytes
    System.Security.Cryptography.Rfc2898DeriveBytes
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0
参照参照
関連項目
Rfc2898DeriveBytes メンバ
System.Security.Cryptography 名前空間
その他の技術情報
暗号サービス

Rfc2898DeriveBytes コンストラクタ (String, Int32)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

キーを派生させるために使用するパスワードおよび salt サイズを指定して、Rfc2898DeriveBytes クラスの新しいインスタンスを初期化します。

名前空間: System.Security.Cryptography
アセンブリ: mscorlib (mscorlib.dll 内)
構文構文

Visual Basic (宣言)
Public Sub New ( _
    password As String, _
    saltSize As Integer _
)
Visual Basic (使用法)
Dim password As String
Dim saltSize As Integer

Dim instance As New Rfc2898DeriveBytes(password,
 saltSize)
C#
public Rfc2898DeriveBytes (
    string password,
    int saltSize
)
C++
public:
Rfc2898DeriveBytes (
    String^ password, 
    int saltSize
)
J#
public Rfc2898DeriveBytes (
    String password, 
    int saltSize
)
JScript
public function Rfc2898DeriveBytes (
    password : String, 
    saltSize : int
)

パラメータ

password

キーを派生させるために使用するパスワード。

saltSize

クラスで生成するランダム salt のサイズ。

例外例外
例外の種類条件

ArgumentException

指定された salt のサイズが 8 バイト未満です。

ArgumentNullException

パスワードまたは salt は null 参照 (Visual Basic では Nothing) です。

解説解説

salt のサイズは 8 バイト以上であることが必要です。

RFC 2898 には、パスワードと salt からキーおよび初期化ベクタ (IV) を作成するためのメソッドが規定されています。実質的に無制限の長さのキーを生成できる擬似乱数関数と、パスワード ベースのキー派生関数である PBKDF2 を使用して、キーを派生させることができます。Rfc2898DeriveBytes クラスは、基本キーおよびその他のパラメータから派生キーを生成するときに使用できます。パスワード ベースのキー派生関数では、基本キーがパスワードに、その他のパラメータは salt 値および反復回数になります。

PBKDF2 の詳細については、RFC の Web サイト (http://www.rfc-editor.org) で、「RFC 2898, PKCS #5: Password-Based Cryptography Specification Version 2.0」を参照してください。特に、セクション 5.2 の「PBKDF2」を参照してください。

セキュリティに関するメモセキュリティに関するメモ

パスワードをソース コード内にハード コーディングすることは絶対に避けてください。ハード コーディングされたパスワードは、MSIL 逆アセンブラ (Ildasm.exe) や 16 進エディタを使用したり、アセンブリを Notepad.exe などのテキスト エディタで開いたりすることによって簡単にアセンブリから取得されてしまいます。

使用例使用例

Rfc2898DeriveBytes クラスを使用して、TripleDES クラスのまったく同じ 2 つのキーを作成するコード例を次に示します。次に、このキーを使用して、一部のデータを暗号化および復号化します。

C#
Rfc2898DeriveBytes k1 = new Rfc2898DeriveBytes(pwd1, salt1,myIterations);
Rfc2898DeriveBytes k2 = new Rfc2898DeriveBytes(pwd1, salt1);
C++
Rfc2898DeriveBytes ^ k1 = gcnew Rfc2898DeriveBytes( pwd1,salt1,myIterations );
Rfc2898DeriveBytes ^ k2 = gcnew Rfc2898DeriveBytes( pwd1,salt1 );
J#
Rfc2898DeriveBytes k1 = new Rfc2898DeriveBytes(pwd1, salt1,
    myIterations);
Rfc2898DeriveBytes k2 = new Rfc2898DeriveBytes(pwd1, salt1);
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0
参照参照
関連項目
Rfc2898DeriveBytes クラス
Rfc2898DeriveBytes メンバ
System.Security.Cryptography 名前空間
その他の技術情報
暗号サービス

Rfc2898DeriveBytes コンストラクタ (String, Int32, Int32)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

キーを派生させるために使用するパスワード、salt サイズ、および反復回数を指定して、Rfc2898DeriveBytes クラスの新しいインスタンスを初期化します。

名前空間: System.Security.Cryptography
アセンブリ: mscorlib (mscorlib.dll 内)
構文構文

Visual Basic (宣言)
Public Sub New ( _
    password As String, _
    saltSize As Integer, _
    iterations As Integer _
)
Visual Basic (使用法)
Dim password As String
Dim saltSize As Integer
Dim iterations As Integer

Dim instance As New Rfc2898DeriveBytes(password,
 saltSize, iterations)
C#
public Rfc2898DeriveBytes (
    string password,
    int saltSize,
    int iterations
)
C++
public:
Rfc2898DeriveBytes (
    String^ password, 
    int saltSize, 
    int iterations
)
J#
public Rfc2898DeriveBytes (
    String password, 
    int saltSize, 
    int iterations
)
JScript
public function Rfc2898DeriveBytes (
    password : String, 
    saltSize : int, 
    iterations : int
)

パラメータ

password

キーを派生させるために使用するパスワード。

saltSize

クラスで生成するランダム salt のサイズ。

iterations

演算の反復処理回数。

例外例外
例外の種類条件

ArgumentException

指定された salt のサイズが 8 バイト未満であるか、反復回数が 1 未満です。

ArgumentNullException

パスワードまたは salt は null 参照 (Visual Basic では Nothing) です。

解説解説

salt のサイズが 8 バイト以上、かつ、反復回数が 0 以上であることが必要です。反復回数は最低でも 1000 にすることをお勧めします。

RFC 2898 には、パスワードと salt からキーおよび初期化ベクタ (IV) を作成するためのメソッドが規定されています。実質的に無制限の長さのキーを生成できる擬似乱数関数と、パスワード ベースのキー派生関数である PBKDF2 を使用して、キーを派生させることができます。Rfc2898DeriveBytes クラスは、基本キーおよびその他のパラメータから派生キーを生成するときに使用できます。パスワード ベースのキー派生関数では、基本キーがパスワードに、その他のパラメータは salt 値および反復回数になります。

PBKDF2 の詳細については、RFC の Web サイト (http://www.rfc-editor.org) で、「RFC 2898, PKCS #5: Password-Based Cryptography Specification Version 2.0」を参照してください。特に、セクション 5.2 の「PBKDF2」を参照してください。

セキュリティに関するメモセキュリティに関するメモ

パスワードをソース コード内にハード コーディングすることは絶対に避けてください。ハード コーディングされたパスワードは、MSIL 逆アセンブラ (Ildasm.exe) や 16 進エディタを使用したり、アセンブリを Notepad.exe などのテキスト エディタで開いたりすることによって簡単にアセンブリから取得されてしまいます。

使用例使用例

Rfc2898DeriveBytes クラスを使用して、TripleDES クラスのまったく同じ 2 つのキーを作成するコード例を次に示します。次に、このキーを使用して、一部のデータを暗号化および復号化します。

C#
Rfc2898DeriveBytes k1 = new Rfc2898DeriveBytes(pwd1, salt1,myIterations);
Rfc2898DeriveBytes k2 = new Rfc2898DeriveBytes(pwd1, salt1);
C++
Rfc2898DeriveBytes ^ k1 = gcnew Rfc2898DeriveBytes( pwd1,salt1,myIterations );
Rfc2898DeriveBytes ^ k2 = gcnew Rfc2898DeriveBytes( pwd1,salt1 );
J#
Rfc2898DeriveBytes k1 = new Rfc2898DeriveBytes(pwd1, salt1,
    myIterations);
Rfc2898DeriveBytes k2 = new Rfc2898DeriveBytes(pwd1, salt1);
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0
参照参照
関連項目
Rfc2898DeriveBytes クラス
Rfc2898DeriveBytes メンバ
System.Security.Cryptography 名前空間
その他の技術情報
暗号サービス

Rfc2898DeriveBytes コンストラクタ (Byte[], Byte[], Int32)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

キーを派生させるために使用するパスワード、salt、および反復回数を指定して、Rfc2898DeriveBytes クラスの新しいインスタンスを初期化します。

名前空間: System.Security.Cryptography
アセンブリ: mscorlib (mscorlib.dll 内)
構文構文

Visual Basic (宣言)
Public Sub New ( _
    password As Byte(), _
    salt As Byte(), _
    iterations As Integer _
)
Visual Basic (使用法)
Dim password As Byte()
Dim salt As Byte()
Dim iterations As Integer

Dim instance As New Rfc2898DeriveBytes(password,
 salt, iterations)
C#
public Rfc2898DeriveBytes (
    byte[] password,
    byte[] salt,
    int iterations
)
C++
public:
Rfc2898DeriveBytes (
    array<unsigned char>^ password, 
    array<unsigned char>^ salt, 
    int iterations
)
J#
public Rfc2898DeriveBytes (
    byte[] password, 
    byte[] salt, 
    int iterations
)
JScript
public function Rfc2898DeriveBytes (
    password : byte[], 
    salt : byte[], 
    iterations : int
)

パラメータ

password

キーを派生させるために使用するパスワード。

salt

キーを派生させるために使用するキー salt。

iterations

演算の反復処理回数。

例外例外
例外の種類条件

ArgumentException

指定された salt のサイズが 8 バイト未満であるか、反復回数が 1 未満です。

ArgumentNullException

パスワードまたは salt は null 参照 (Visual Basic では Nothing) です。

解説解説

salt のサイズが 8 バイト以上、かつ、反復回数が 0 以上であることが必要です。反復回数は最低でも 1000 にすることをお勧めします。

RFC 2898 には、パスワードと salt からキーおよび初期化ベクタ (IV) を作成するためのメソッドが規定されています。実質的に無制限の長さのキーを生成できる擬似乱数関数と、パスワード ベースのキー派生関数である PBKDF2 を使用して、キーを派生させることができます。Rfc2898DeriveBytes クラスは、基本キーおよびその他のパラメータから派生キーを生成するときに使用できます。パスワード ベースのキー派生関数では、基本キーがパスワードに、その他のパラメータは salt 値および反復回数になります。

PBKDF2 の詳細については、RFC の Web サイト (http://www.rfc-editor.org) で、「RFC 2898, PKCS #5: Password-Based Cryptography Specification Version 2.0」を参照してください。特に、セクション 5.2 の「PBKDF2」を参照してください。

セキュリティに関するメモセキュリティに関するメモ

パスワードをソース コード内にハード コーディングすることは絶対に避けてください。ハード コーディングされたパスワードは、MSIL 逆アセンブラ (Ildasm.exe) や 16 進エディタを使用したり、アセンブリを Notepad.exe などのテキスト エディタで開いたりすることによって簡単にアセンブリから取得されてしまいます。

プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0
参照参照
関連項目
Rfc2898DeriveBytes クラス
Rfc2898DeriveBytes メンバ
System.Security.Cryptography 名前空間

Rfc2898DeriveBytes コンストラクタ

Rfc2898DeriveBytes クラスの新しいインスタンスを初期化します。
オーバーロードの一覧オーバーロードの一覧

名前 説明
Rfc2898DeriveBytes (String, Byte[]) キーを派生させるために使用するパスワードおよび salt を指定して、Rfc2898DeriveBytes クラスの新しいインスタンスを初期化します。
Rfc2898DeriveBytes (String, Int32) キーを派生させるために使用するパスワードおよび salt サイズを指定して、Rfc2898DeriveBytes クラスの新しいインスタンスを初期化します。
Rfc2898DeriveBytes (Byte[], Byte[], Int32) キーを派生させるために使用するパスワード、salt、および反復回数を指定して、Rfc2898DeriveBytes クラスの新しいインスタンスを初期化します。
Rfc2898DeriveBytes (String, Byte[], Int32) キーを派生させるために使用するパスワード、salt、および反復処理回数を指定して、Rfc2898DeriveBytes クラスの新しいインスタンスを初期化します。
Rfc2898DeriveBytes (String, Int32, Int32) キーを派生させるために使用するパスワード、salt サイズ、および反復回数を指定して、Rfc2898DeriveBytes クラスの新しいインスタンスを初期化します。
参照参照

関連項目

Rfc2898DeriveBytes クラス
Rfc2898DeriveBytes メンバ
System.Security.Cryptography 名前空間

その他の技術情報

暗号サービス

Rfc2898DeriveBytes コンストラクタ (String, Byte[], Int32)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

キーを派生させるために使用するパスワード、salt、および反復処理回数を指定して、Rfc2898DeriveBytes クラスの新しいインスタンスを初期化します。

名前空間: System.Security.Cryptography
アセンブリ: mscorlib (mscorlib.dll 内)
構文構文

Visual Basic (宣言)
Public Sub New ( _
    password As String, _
    salt As Byte(), _
    iterations As Integer _
)
Visual Basic (使用法)
Dim password As String
Dim salt As Byte()
Dim iterations As Integer

Dim instance As New Rfc2898DeriveBytes(password,
 salt, iterations)
C#
public Rfc2898DeriveBytes (
    string password,
    byte[] salt,
    int iterations
)
C++
public:
Rfc2898DeriveBytes (
    String^ password, 
    array<unsigned char>^ salt, 
    int iterations
)
J#
public Rfc2898DeriveBytes (
    String password, 
    byte[] salt, 
    int iterations
)
JScript
public function Rfc2898DeriveBytes (
    password : String, 
    salt : byte[], 
    iterations : int
)

パラメータ

password

キーを派生させるために使用するパスワード。

salt

キーを派生させるために使用するキー salt。

iterations

演算の反復処理回数。

例外例外
例外の種類条件

ArgumentException

指定された salt のサイズが 8 バイト未満であるか、反復回数が 1 未満です。

ArgumentNullException

パスワードまたは salt は null 参照 (Visual Basic では Nothing) です。

解説解説

salt のサイズが 8 バイト以上、かつ、反復回数が 0 以上であることが必要です。反復回数は最低でも 1000 にすることをお勧めします。

RFC 2898 には、パスワードと salt からキーおよび初期化ベクタ (IV) を作成するためのメソッドが規定されています。実質的に無制限の長さのキーを生成できる擬似乱数関数と、パスワード ベースのキー派生関数である PBKDF2 を使用して、キーを派生させることができます。Rfc2898DeriveBytes クラスは、基本キーおよびその他のパラメータから派生キーを生成するときに使用できます。パスワード ベースのキー派生関数では、基本キーがパスワードに、その他のパラメータは salt 値および反復回数になります。

PBKDF2 の詳細については、RFC の Web サイト (http://www.rfc-editor.org) で、「RFC 2898, PKCS #5: Password-Based Cryptography Specification Version 2.0」を参照してください。特に、セクション 5.2 の「PBKDF2」を参照してください。

セキュリティに関するメモセキュリティに関するメモ

パスワードをソース コード内にハード コーディングすることは絶対に避けてください。ハード コーディングされたパスワードは、MSIL 逆アセンブラ (Ildasm.exe) や 16 進エディタを使用したり、アセンブリを Notepad.exe などのテキスト エディタで開いたりすることによって簡単にアセンブリから取得されてしまいます。

使用例使用例

Rfc2898DeriveBytes クラスを使用して、TripleDES クラスのまったく同じ 2 つのキーを作成するコード例を次に示します。次に、このキーを使用して、一部のデータを暗号化および復号化します。

C#
decrypt.Write(edata1, 0, edata1.Length);
decrypt.Flush();
decrypt.Close();
k2.Reset();
C++
decrypt->Write( edata1, 0, edata1->Length );
decrypt->Flush();
decrypt->Close();
k2->Reset();
J#
decrypt.Write(eData1, 0, eData1.get_Length());
decrypt.Flush();
decrypt.Close();
k2.Reset();
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0
参照参照
関連項目
Rfc2898DeriveBytes クラス
Rfc2898DeriveBytes メンバ
System.Security.Cryptography 名前空間
その他の技術情報
暗号サービス

Rfc2898DeriveBytes コンストラクタ (String, Byte[])

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

キーを派生させるために使用するパスワードおよび salt を指定して、Rfc2898DeriveBytes クラスの新しいインスタンスを初期化します。

名前空間: System.Security.Cryptography
アセンブリ: mscorlib (mscorlib.dll 内)
構文構文

Visual Basic (宣言)
Public Sub New ( _
    password As String, _
    salt As Byte() _
)
Visual Basic (使用法)
Dim password As String
Dim salt As Byte()

Dim instance As New Rfc2898DeriveBytes(password,
 salt)
C#
public Rfc2898DeriveBytes (
    string password,
    byte[] salt
)
C++
public:
Rfc2898DeriveBytes (
    String^ password, 
    array<unsigned char>^ salt
)
J#
public Rfc2898DeriveBytes (
    String password, 
    byte[] salt
)
JScript
public function Rfc2898DeriveBytes (
    password : String, 
    salt : byte[]
)

パラメータ

password

キーを派生させるために使用するパスワード。

salt

キーを派生させるために使用するキー salt。

例外例外
例外の種類条件

ArgumentException

指定された salt のサイズが 8 バイト未満であるか、反復回数が 1 未満です。

ArgumentNullException

パスワードまたは salt は null 参照 (Visual Basic では Nothing) です。

解説解説

salt のサイズは 8 バイト以上であることが必要です。

RFC 2898 には、パスワードと salt からキーおよび初期化ベクタ (IV) を作成するためのメソッドが規定されています。実質的に無制限の長さのキーを生成できる擬似乱数関数と、パスワード ベースのキー派生関数である PBKDF2 を使用して、キーを派生させることができます。Rfc2898DeriveBytes クラスは、基本キーおよびその他のパラメータから派生キーを生成するときに使用できます。パスワード ベースのキー派生関数では、基本キーがパスワードに、その他のパラメータは salt 値および反復回数になります。

PBKDF2 の詳細については、RFC の Web サイト (http://www.rfc-editor.org) で、「RFC 2898, PKCS #5: Password-Based Cryptography Specification Version 2.0」を参照してください。特に、セクション 5.2 の「PBKDF2」を参照してください。

セキュリティに関するメモセキュリティに関するメモ

パスワードをソース コード内にハード コーディングすることは絶対に避けてください。ハード コーディングされたパスワードは、MSIL 逆アセンブラ (Ildasm.exe) や 16 進エディタを使用したり、アセンブリを Notepad.exe などのテキスト エディタで開いたりすることによって簡単にアセンブリから取得されてしまいます。

使用例使用例

Rfc2898DeriveBytes クラスを使用して、TripleDES クラスのまったく同じ 2 つのキーを作成するコード例を次に示します。次に、このキーを使用して、一部のデータを暗号化および復号化します。

C#
Rfc2898DeriveBytes k1 = new Rfc2898DeriveBytes(pwd1, salt1,myIterations);
Rfc2898DeriveBytes k2 = new Rfc2898DeriveBytes(pwd1, salt1);
C++
Rfc2898DeriveBytes ^ k1 = gcnew Rfc2898DeriveBytes( pwd1,salt1,myIterations );
Rfc2898DeriveBytes ^ k2 = gcnew Rfc2898DeriveBytes( pwd1,salt1 );
J#
Rfc2898DeriveBytes k1 = new Rfc2898DeriveBytes(pwd1, salt1,
    myIterations);
Rfc2898DeriveBytes k2 = new Rfc2898DeriveBytes(pwd1, salt1);
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0
参照参照
関連項目
Rfc2898DeriveBytes クラス
Rfc2898DeriveBytes メンバ
System.Security.Cryptography 名前空間
その他の技術情報
暗号サービス

Rfc2898DeriveBytes プロパティ


パブリック プロパティパブリック プロパティ

  名前 説明
パブリック プロパティ IterationCount 演算の反復処理回数を取得または設定します。
パブリック プロパティ Salt 演算で使用するキー salt 値を取得または設定します。
参照参照

関連項目

Rfc2898DeriveBytes クラス
System.Security.Cryptography 名前空間

その他の技術情報

暗号サービス

Rfc2898DeriveBytes メソッド


パブリック メソッドパブリック メソッド

( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
パブリック メソッド GetBytes オーバーライドされます。 パスワード、salt、および反復回数から疑似ランダム キーを返します。
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 ( Object から継承されます。)
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
パブリック メソッド Reset オーバーライドされます。 演算の状態をリセットします。
パブリック メソッド ToString  現在の Object を表す String を返します。 ( Object から継承されます。)
プロテクト メソッドプロテクト メソッド
  名前 説明
プロテクト メソッド Finalize  Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
プロテクト メソッド MemberwiseClone  現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
参照参照

関連項目

Rfc2898DeriveBytes クラス
System.Security.Cryptography 名前空間

その他の技術情報

暗号サービス

Rfc2898DeriveBytes メンバ

HMACSHA1 に基づく擬似乱数ジェネレータを使用して、パスワード ベースのキー派生機能 (PBKDF2) を実装します。

Rfc2898DeriveBytes データ型で公開されるメンバを以下の表に示します。


パブリック コンストラクタパブリック コンストラクタ
  名前 説明
パブリック メソッド Rfc2898DeriveBytes オーバーロードされます。 Rfc2898DeriveBytes クラスの新しいインスタンスを初期化します。
パブリック プロパティパブリック プロパティ
  名前 説明
パブリック プロパティ IterationCount 演算の反復処理回数を取得または設定します。
パブリック プロパティ Salt 演算で使用するキー salt 値を取得または設定します。
パブリック メソッドパブリック メソッド
( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
パブリック メソッド GetBytes オーバーライドされます。 パスワード、salt、および反復回数から疑似ランダム キーを返します。
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 (Object から継承されます。)
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
パブリック メソッド Reset オーバーライドされます。 演算の状態をリセットします。
パブリック メソッド ToString  現在の Object を表す String を返します。 (Object から継承されます。)
プロテクト メソッドプロテクト メソッド
  名前 説明
プロテクト メソッド Finalize  Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
プロテクト メソッド MemberwiseClone  現在の Object の簡易コピーを作成します。 (Object から継承されます。)
参照参照

関連項目

Rfc2898DeriveBytes クラス
System.Security.Cryptography 名前空間

その他の技術情報

暗号サービス

急上昇のことば

バレーボール日本女子代表
ピリオド
福岡ソフトバンクホークスの選手一覧
アットマーク
しました
英和和英テキスト翻訳>> Weblio翻訳
英語⇒日本語日本語⇒英語
  

辞書ショートカット

カテゴリ一覧

全て

＋ ビジネス

＋ 業界用語

＋ コンピュータ

＋ 電車

＋ 自動車・バイク

＋ 船

＋ 工学

＋ 建築・不動産

＋ 学問

＋ 文化

＋ 生活

＋ ヘルスケア

＋ 趣味

＋ スポーツ

＋ 生物

＋ 食品

＋ 人名

＋ 方言

＋ 辞書・百科事典

すべての辞書の索引

あいうえお
かきくけこ
さしすせそ
たちつてと
なにぬねの
はひふへほ
まみむめも
やゆよ
らりるれろ
わをん
がぎぐげご
ざじずぜぞ
だぢづでど
ばびぶべぼ
ぱぴぷぺぽ
ＡＢＣＤＥ
ＦＧＨＩＪ
ＫＬＭＮＯ
ＰＱＲＳＴ
ＵＶＷＸＹ
Ｚ
１２３４５
６７８９０
記号

Weblioのサービス

「Rfc2898DeriveBytes」の関連用語

1
Rfc2898DeriveBytes コンストラクタ
.NET Framework クラス ライブラリ リファレンス
100% |||||

2
Rfc2898DeriveBytes.GetBytes メソッド
.NET Framework クラス ライブラリ リファレンス
100% |||||

3
Rfc2898DeriveBytes プロパティ
.NET Framework クラス ライブラリ リファレンス
100% |||||

4
Rfc2898DeriveBytes.IterationCount プロパティ
.NET Framework クラス ライブラリ リファレンス
100% |||||

5
PasswordDeriveBytes.GetBytes メソッド
.NET Framework クラス ライブラリ リファレンス
100% |||||

6
Rfc2898DeriveBytes クラス
.NET Framework クラス ライブラリ リファレンス
100% |||||

7
Rfc2898DeriveBytes メンバ
.NET Framework クラス ライブラリ リファレンス
100% |||||

8
Rfc2898DeriveBytes.Reset メソッド
.NET Framework クラス ライブラリ リファレンス
100% |||||

9
Rfc2898DeriveBytes.Salt プロパティ
.NET Framework クラス ライブラリ リファレンス
94% |||||

10
DeriveBytes クラス
.NET Framework クラス ライブラリ リファレンス
72% |||||

Rfc2898DeriveBytesのお隣キーワード

ReturnMessage.Uri プロパティ

ReturnOutOfFinally クラス

ReturnOutOfFinally コンストラクタ

ReturnOutOfFinally プロパティ

ReturnOutOfFinally メソッド

ReturnOutOfFinally メンバ

Rfc2898DeriveBytes

Rfc2898DeriveBytes クラス

Rfc2898DeriveBytes コンストラクタ

Rfc2898DeriveBytes プロパティ

Rfc2898DeriveBytes メソッド

Rfc2898DeriveBytes メンバ

Rfc2898DeriveBytes.GetBytes メソッド

検索ランキング

   

 英語⇒日本語
日本語⇒英語		    


Rfc2898DeriveBytesのページの著作権
Weblio 辞書 情報提供元は 参加元一覧 にて確認できます。

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2024 Microsoft.All rights reserved.

©2024 GRAS Group, Inc.RSS