RSACryptoServiceProvider クラス

.NET Framework クラス ライブラリ リファレンス

RSACryptoServiceProvider クラス

暗号サービス プロバイダ (CSP : Cryptographic Service Provider) によって提供された RSA アルゴリズムの実装を使用して、非対称暗号化および復号化を実行します。このクラスは継承できません。

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

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
Public NotInheritable Class
 RSACryptoServiceProvider
    Inherits RSA
    Implements ICspAsymmetricAlgorithm

Visual Basic (使用法)

Dim instance As RSACryptoServiceProvider

C#

[ComVisibleAttribute(true)] 
public sealed class RSACryptoServiceProvider
 : RSA, ICspAsymmetricAlgorithm

C++

[ComVisibleAttribute(true)] 
public ref class RSACryptoServiceProvider sealed
 : public RSA, ICspAsymmetricAlgorithm

J#

/** @attribute ComVisibleAttribute(true) */ 
public final class RSACryptoServiceProvider
 extends RSA implements ICspAsymmetricAlgorithm

JScript

ComVisibleAttribute(true) 
public final class RSACryptoServiceProvider
 extends RSA implements ICspAsymmetricAlgorithm

解説

これは RSA の既定の実装です。

Microsoft Enhanced Cryptographic Provider がインストールされている場合、RSACryptoServiceProvider は 384 ビットから 16384 ビットのキー長を 8 ビット単位でサポートします。Microsoft ベース暗号化プロバイダがインストールされている場合は、384 ビットから 512 ビットのキー長を 8 ビット単位でサポートします。

Topic	Location
方法 : XML ドキュメントのデジタル署名を検証する	.NET Framework: セキュリティ
方法 : キー コンテナに非対称キーを格納する	.NET Framework: セキュリティ
方法 : デジタル署名で XML ドキュメントに署名する	.NET Framework: セキュリティ
方法 : 非対称キーで XML 要素を復号化する	.NET Framework: セキュリティ
方法 : 非対称キーで XML 要素を暗号化する	.NET Framework: セキュリティ

使用例

RSACryptoServiceProvider クラスを使用して、文字列をバイト配列に暗号化し、そのバイトを文字列に復号化するコード例を次に示します。

Visual Basic

Imports System
Imports System.Security.Cryptography
Imports System.Text

 _

Class RSACSPSample


    Shared Sub Main()
        Try
            'Create a UnicodeEncoder to convert between byte array and
 string.
            Dim ByteConverter As New
 UnicodeEncoding()

            'Create byte arrays to hold original, encrypted, and decrypted
 data.
            Dim dataToEncrypt As Byte()
 = ByteConverter.GetBytes("Data to Encrypt")
            Dim encryptedData() As Byte
            Dim decryptedData() As Byte

            'Create a new instance of RSACryptoServiceProvider to generate
            'public and private key data.
            Dim RSA As New
 RSACryptoServiceProvider()

            'Pass the data to ENCRYPT, the public key information 
            '(using RSACryptoServiceProvider.ExportParameters(false)
,
            'and a boolean flag specifying no OAEP padding.
            encryptedData = RSAEncrypt(dataToEncrypt, RSA.ExportParameters(False),
 False)

            'Pass the data to DECRYPT, the private key information 
            '(using RSACryptoServiceProvider.ExportParameters(true)
,
            'and a boolean flag specifying no OAEP padding.
            decryptedData = RSADecrypt(encryptedData, RSA.ExportParameters(True),
 False)

            'Display the decrypted plaintext to the console. 
            Console.WriteLine("Decrypted plaintext: {0}",
 ByteConverter.GetString(decryptedData))
        Catch e As ArgumentNullException
            'Catch this exception in case the encryption did
            'not succeed.
            Console.WriteLine("Encryption failed.")
        End Try
    End Sub


    Public Shared Function
 RSAEncrypt(ByVal DataToEncrypt() As Byte,
 ByVal RSAKeyInfo As RSAParameters, ByVal DoOAEPPadding As Boolean)
 As Byte()
        Try
            'Create a new instance of RSACryptoServiceProvider.
            Dim RSA As New
 RSACryptoServiceProvider()

            'Import the RSA Key information. This only needs
            'toinclude the public key information.
            RSA.ImportParameters(RSAKeyInfo)

            'Encrypt the passed byte array and specify OAEP padding.
  
            'OAEP padding is only available on Microsoft Windows XP
 or
            'later.  
            Return RSA.Encrypt(DataToEncrypt, DoOAEPPadding)
            'Catch and display a CryptographicException  
            'to the console.
        Catch e As CryptographicException
            Console.WriteLine(e.Message)

            Return Nothing
        End Try
    End Function


    Public Shared Function
 RSADecrypt(ByVal DataToDecrypt() As Byte,
 ByVal RSAKeyInfo As RSAParameters, ByVal DoOAEPPadding As Boolean)
 As Byte()
        Try
            'Create a new instance of RSACryptoServiceProvider.
            Dim RSA As New
 RSACryptoServiceProvider()

            'Import the RSA Key information. This needs
            'to include the private key information.
            RSA.ImportParameters(RSAKeyInfo)

            'Decrypt the passed byte array and specify OAEP padding.
  
            'OAEP padding is only available on Microsoft Windows XP
 or
            'later.  
            Return RSA.Decrypt(DataToDecrypt, DoOAEPPadding)
            'Catch and display a CryptographicException  
            'to the console.
        Catch e As CryptographicException
            Console.WriteLine(e.ToString())

            Return Nothing
        End Try
    End Function
End Class

C#

using System;
using System.Security.Cryptography;
using System.Text;

class RSACSPSample
{

    static void Main()
    {
        try
        {
            //Create a UnicodeEncoder to convert between byte array
 and string.
            UnicodeEncoding ByteConverter = new UnicodeEncoding();

            //Create byte arrays to hold original, encrypted, and decrypted
 data.
            byte[] dataToEncrypt = ByteConverter.GetBytes("Data to Encrypt");
            byte[] encryptedData;
            byte[] decryptedData;
            
            //Create a new instance of RSACryptoServiceProvider to generate
            //public and private key data.
            RSACryptoServiceProvider RSA = new RSACryptoServiceProvider();

            //Pass the data to ENCRYPT, the public key information 
            //(using RSACryptoServiceProvider.ExportParameters(false)
,
            //and a boolean flag specifying no OAEP padding.
            encryptedData = RSAEncrypt(dataToEncrypt,RSA.ExportParameters(false),
 false);

            //Pass the data to DECRYPT, the private key information
 
            //(using RSACryptoServiceProvider.ExportParameters(true)
,
            //and a boolean flag specifying no OAEP padding.
            decryptedData = RSADecrypt(encryptedData,RSA.ExportParameters(true),
 false);

            //Display the decrypted plaintext to the console. 
            Console.WriteLine("Decrypted plaintext: {0}", ByteConverter.GetString(decryptedData));
        }
        catch(ArgumentNullException)
        {
            //Catch this exception in case the encryption did
            //not succeed.
            Console.WriteLine("Encryption failed.");

        }
    }

    static public byte[] RSAEncrypt(byte[]
 DataToEncrypt, RSAParameters RSAKeyInfo, bool DoOAEPPadding)
    {
        try
        {    
            //Create a new instance of RSACryptoServiceProvider.
            RSACryptoServiceProvider RSA = new RSACryptoServiceProvider();

            //Import the RSA Key information. This only needs
            //toinclude the public key information.
            RSA.ImportParameters(RSAKeyInfo);

            //Encrypt the passed byte array and specify OAEP padding.
  
            //OAEP padding is only available on Microsoft Windows XP
 or
            //later.  
            return RSA.Encrypt(DataToEncrypt, DoOAEPPadding);
        }
        //Catch and display a CryptographicException  
        //to the console.
        catch(CryptographicException e)
        {
            Console.WriteLine(e.Message);

            return null;
        }

    }

    static public byte[] RSADecrypt(byte[]
 DataToDecrypt, RSAParameters RSAKeyInfo,bool DoOAEPPadding)
    {
        try
        {
            //Create a new instance of RSACryptoServiceProvider.
            RSACryptoServiceProvider RSA = new RSACryptoServiceProvider();

            //Import the RSA Key information. This needs
            //to include the private key information.
            RSA.ImportParameters(RSAKeyInfo);

            //Decrypt the passed byte array and specify OAEP padding.
  
            //OAEP padding is only available on Microsoft Windows XP
 or
            //later.  
            return RSA.Decrypt(DataToDecrypt, DoOAEPPadding);
        }
        //Catch and display a CryptographicException  
        //to the console.
        catch(CryptographicException e)
        {
            Console.WriteLine(e.ToString());

            return null;
        }

    }
}

C++

using namespace System;
using namespace System::Security::Cryptography;
using namespace System::Text;
array<Byte>^ RSAEncrypt( array<Byte>^DataToEncrypt, RSAParameters RSAKeyInfo,
 bool DoOAEPPadding )
{
   try
   {
      
      //Create a new instance of RSACryptoServiceProvider.
      RSACryptoServiceProvider^ RSA = gcnew RSACryptoServiceProvider;
      
      //Import the RSA Key information. This only needs
      //toinclude the public key information.
      RSA->ImportParameters( RSAKeyInfo );
      
      //Encrypt the passed byte array and specify OAEP padding.  
      //OAEP padding is only available on Microsoft Windows XP or
      //later.  
      return RSA->Encrypt( DataToEncrypt, DoOAEPPadding );
   }
   //Catch and display a CryptographicException  
   //to the console.
   catch ( CryptographicException^ e ) 
   {
      Console::WriteLine( e->Message );
      return nullptr;
   }

}

array<Byte>^ RSADecrypt( array<Byte>^DataToDecrypt, RSAParameters RSAKeyInfo,
 bool DoOAEPPadding )
{
   try
   {
      
      //Create a new instance of RSACryptoServiceProvider.
      RSACryptoServiceProvider^ RSA = gcnew RSACryptoServiceProvider;
      
      //Import the RSA Key information. This needs
      //to include the private key information.
      RSA->ImportParameters( RSAKeyInfo );
      
      //Decrypt the passed byte array and specify OAEP padding.  
      //OAEP padding is only available on Microsoft Windows XP or
      //later.  
      return RSA->Decrypt( DataToDecrypt, DoOAEPPadding );
   }
   //Catch and display a CryptographicException  
   //to the console.
   catch ( CryptographicException^ e ) 
   {
      Console::WriteLine( e );
      return nullptr;
   }

}

int main()
{
   try
   {
      
      //Create a UnicodeEncoder to convert between byte array and string.
      UnicodeEncoding^ ByteConverter = gcnew UnicodeEncoding;
      
      //Create byte arrays to hold original, encrypted, and decrypted
 data.
      array<Byte>^dataToEncrypt = ByteConverter->GetBytes( "Data to
 Encrypt" );
      array<Byte>^encryptedData;
      array<Byte>^decryptedData;
      
      //Create a new instance of RSACryptoServiceProvider to generate
      //public and private key data.
      RSACryptoServiceProvider^ RSA = gcnew RSACryptoServiceProvider;
      
      //Pass the data to ENCRYPT, the public key information 
      //(using RSACryptoServiceProvider.ExportParameters(false),
      //and a boolean flag specifying no OAEP padding.
      encryptedData = RSAEncrypt( dataToEncrypt, RSA->ExportParameters( false
 ), false );
      
      //Pass the data to DECRYPT, the private key information 
      //(using RSACryptoServiceProvider.ExportParameters(true),
      //and a boolean flag specifying no OAEP padding.
      decryptedData = RSADecrypt( encryptedData, RSA->ExportParameters( true
 ), false );
      
      //Display the decrypted plaintext to the console. 
      Console::WriteLine( "Decrypted plaintext: {0}", ByteConverter->GetString(
 decryptedData ) );
   }
   catch ( ArgumentNullException^ ) 
   {
      
      //Catch this exception in case the encryption did
      //not succeed.
      Console::WriteLine( "Encryption failed." );
   }

}

J#

import System.*;
import System.Security.Cryptography.*;
import System.Text.*;

class RSACSPSample
{
    public static void main(String[]
 args)
    {
        try {
            // Create a UnicodeEncoder to convert between byte array
 and string.
            UnicodeEncoding byteConverter =  new UnicodeEncoding();
            
            // Create byte arrays to hold original, encrypted, 
            // and decrypted data.
            ubyte dataToEncrypt[] = byteConverter.GetBytes("Data to Encrypt");
            ubyte encryptedData[];
            ubyte decryptedData[];
            
            // Create a new instance of RSACryptoServiceProvider to
 generate
            // public and private key data.
            RSACryptoServiceProvider rsa =  new RSACryptoServiceProvider();
            
            // Pass the data to ENCRYPT, the public key information
 
            // (using RSACryptoServiceProvider.ExportParameters(false)
,
            // and a boolean flag specifying no OAEP padding.
            encryptedData = RSAEncrypt(dataToEncrypt, 
                rsa.ExportParameters(false), false);
            
            // Pass the data to DECRYPT, the private key information
 
            //(using RSACryptoServiceProvider.ExportParameters(true)
,
            // and a boolean flag specifying no OAEP padding.
            decryptedData = RSADecrypt(encryptedData, 
                rsa.ExportParameters(true), false);
            
            // Display the decrypted plaintext to the console. 
            Console.WriteLine("Decrypted plaintext: {0}", 
                byteConverter.GetString(decryptedData));
        }
        catch (ArgumentNullException exp) {
            //Catch this exception in case the encryption did
            //not succeed.
            Console.WriteLine("Encryption failed.");
        }
    } //main 

    public static ubyte[] RSAEncrypt(ubyte
 dataToEncrypt[], 
        RSAParameters rsaKeyInfo, boolean doOaepPadding) 
    {
        try {
            // Create a new instance of RSACryptoServiceProvider.
            RSACryptoServiceProvider rsa =  new RSACryptoServiceProvider();
            
            // Import the rsa Key information. This only needs
            // toinclude the public key information.
            rsa.ImportParameters(rsaKeyInfo);
            
            // Encrypt the passed byte array and specify OAEP padding.
  
            // OAEP padding is only available on Microsoft Windows XP
 or
            // later.  
            return rsa.Encrypt(dataToEncrypt, doOaepPadding) ;
        }
        // Catch and display a CryptographicException  
        // to the console.
        catch (CryptographicException e) {
            Console.WriteLine(e.get_Message());
            return null ;
        }
    } //RSAEncrypt

    public static ubyte[] RSADecrypt(ubyte
 dataToDecrypt[], 
        RSAParameters rsaKeyInfo, boolean doOaepPadding) 
    {
        try {
            // Create a new instance of RSACryptoServiceProvider.
            RSACryptoServiceProvider rsa =  new RSACryptoServiceProvider();
            
            // Import the rsa Key information. This needs
            // to include the private key information.
            rsa.ImportParameters(rsaKeyInfo);
            
            // Decrypt the passed byte array and specify OAEP padding.
  
            // OAEP padding is only available on Microsoft Windows XP
 or
            // later.  
            return rsa.Decrypt(dataToDecrypt, doOaepPadding) ;
        }
        // Catch and display a CryptographicException  
        // to the console.
        catch (CryptographicException e) {
            Console.WriteLine(e.ToString());
            return null ;
        }
    } //RSADecrypt
} //RSACSPSample

RSACryptoServiceProvider を使用して作成したキー情報を RSAParameters オブジェクトにエクスポートするコード例を次に示します。

Visual Basic

Try

    'Create a new RSACryptoServiceProvider object. 
    Dim RSA As New RSACryptoServiceProvider()

    'Export the key information to an RSAParameters object.
    'Pass false to export the public key information or pass
    'true to export public and private key information.
    Dim RSAParams As RSAParameters = RSA.ExportParameters(False)


Catch e As CryptographicException
    'Catch this exception in case the encryption did
    'not succeed.
    Console.WriteLine(e.Message)
End Try

C#

try
{
    //Create a new RSACryptoServiceProvider object.
    RSACryptoServiceProvider RSA = new RSACryptoServiceProvider();


    //Export the key information to an RSAParameters object.
    //Pass false to export the public key information or pass
    //true to export public and private key information.
    RSAParameters RSAParams = RSA.ExportParameters(false);


}
catch(CryptographicException e)
{
    //Catch this exception in case the encryption did
    //not succeed.
    Console.WriteLine(e.Message);

}

C++

try
{
   //Create a new RSACryptoServiceProvider Object*.
   RSACryptoServiceProvider^ RSA = gcnew RSACryptoServiceProvider;
   
   //Export the key information to an RSAParameters object.
   //Pass false to export the public key information or pass
   //true to export public and private key information.
   RSAParameters RSAParams = RSA->ExportParameters( false );
}
catch ( CryptographicException^ e ) 
{
   //Catch this exception in case the encryption did
   //not succeed.
   Console::WriteLine( e->Message );
}

J#

try {
    // Create a new RSACryptoServiceProvider object.
    RSACryptoServiceProvider rsa = new RSACryptoServiceProvider();

    // Export the key information to an RSAParameters object.
    // Pass false to export the public key information or pass
    // true to export public and private key information.
    RSAParameters rsaParams = rsa.ExportParameters(false);
}
catch (CryptographicException e) {
    // Catch this exception in case the encryption did
    // not succeed.
    Console.WriteLine(e.get_Message());
}

継承階層

System.Object
   System.Security.Cryptography.AsymmetricAlgorithm
     System.Security.Cryptography.RSA
      System.Security.Cryptography.RSACryptoServiceProvider

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
RSACryptoServiceProvider メンバ
System.Security.Cryptography 名前空間
その他の技術情報
暗号サービス