RSACryptoServiceProvider コンストラクタ (Int32, CspParameters)
キー サイズとパラメータを指定して、RSACryptoServiceProvider クラスの新しいインスタンスを初期化します。
名前空間: System.Security.Cryptography
アセンブリ: mscorlib (mscorlib.dll 内)
構文
'宣言
Public Sub New ( _
dwKeySize As Integer, _
parameters As CspParameters _
)
'使用
Dim dwKeySize As Integer
Dim parameters As CspParameters
Dim instance As New RSACryptoServiceProvider(dwKeySize, parameters)
public RSACryptoServiceProvider (
int dwKeySize,
CspParameters parameters
)
public:
RSACryptoServiceProvider (
int dwKeySize,
CspParameters^ parameters
)
public RSACryptoServiceProvider (
int dwKeySize,
CspParameters parameters
)
public function RSACryptoServiceProvider (
dwKeySize : int,
parameters : CspParameters
)
適用できません。
パラメータ
- dwKeySize
使用するキーのサイズ (ビット単位)。
- parameters
暗号サービス プロバイダ (CSP) に渡すパラメータ。
例外
| 例外の種類 | 条件 |
|---|---|
CSP を取得できません。 または キーを作成できません。 |
解説
このコンストラクタは、parameters パラメータの KeyContainerName フィールドを使用して指定したキー コンテナを作成または再利用します。
既定では、このコンストラクタは、セッション キーの暗号化に適した Exchange キー ペアを作成し、セッション キーを安全に格納して他のユーザーと交換できるようにします。生成されたキーは、アンマネージ CAPI (Microsoft Cryptographic API) で使用する AT_KEYEXCHANGE 値を使用して生成されたキーに対応します。
(デジタル署名済みの) メッセージまたはファイルの認証に適した Signature キー ペアを作成するには、parameters パラメータの KeyNumber フィールドの値を Signature に設定します。この種類のキーは、CAPI で使用される AT_SIGNATURE 値に対応します。
Exchange 値を指定して RSACryptoServiceProvider オブジェクトを作成し、Signature 値を指定して別の RSACryptoServiceProvider オブジェクトを作成する場合に、両方のオブジェクトに同じキー コンテナ名が指定されていると、両方のキーが 1 つのコンテナに格納されます。
RSACryptoServiceProvider クラスを使用して厳密な名前の署名と互換性のあるキーを作成するには、Signature キー ペアを作成する必要があります。
使用例
RSACryptoServiceProvider を作成し、新しいキーを生成して、このキーをキー コンテナ内に格納するコード例を次に示します。
Imports System.Security.Cryptography
Imports System.Text
Module RSACSPExample
Sub Main()
Try
Dim KeyContainerName As String = "MyKeyContainer"
'Create a new key and persist it in
'the key container.
RSAPersistKeyInCSP(KeyContainerName)
'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
'Pass the data to ENCRYPT, the name of the key container,
'and a boolean flag specifying no OAEP padding.
encryptedData = RSAEncrypt(dataToEncrypt, KeyContainerName, False)
'Pass the data to DECRYPT, the name of the key container,
'and a boolean flag specifying no OAEP padding.
decryptedData = RSADecrypt(encryptedData, KeyContainerName, False)
'Display the decrypted plaintext to the console.
Console.WriteLine("Decrypted plaintext: {0}", ByteConverter.GetString(decryptedData))
RSADeleteKeyInCSP(KeyContainerName)
Catch e As ArgumentNullException
'Catch this exception in case the encryption did
'not succeed.
Console.WriteLine("Encryption failed.")
End Try
End Sub
Sub RSAPersistKeyInCSP(ByVal ContainerName As String)
Try
' Create a new instance of CspParameters. Pass
' 13 to specify a DSA container or 1 to specify
' an RSA container. The default is 1.
Dim cspParams As New CspParameters
' Specify the container name using the passed variable.
cspParams.KeyContainerName = ContainerName
'Create a new instance of RSACryptoServiceProvider to generate
'a new key pair. Pass the CspParameters class to persist the
'key in the container.
Dim RSAalg As New RSACryptoServiceProvider(2048, cspParams)
'Indicate that the key was persisted.
Console.WriteLine("The RSA key with a key-size of {0} was persisted in the container, ""{1}"".", _
RSAalg.KeySize, ContainerName)
Catch e As CryptographicException
Console.WriteLine(e.Message)
End Try
End Sub
Sub RSADeleteKeyInCSP(ByVal ContainerName As String)
Try
' Create a new instance of CspParameters. Pass
' 13 to specify a DSA container or 1 to specify
' an RSA container. The default is 1.
Dim cspParams As New CspParameters
' Specify the container name using the passed variable.
cspParams.KeyContainerName = ContainerName
'Create a new instance of RSACryptoServiceProvider.
'Pass the CspParameters class to use the
'key in the container.
Dim RSAalg As New RSACryptoServiceProvider(cspParams)
'Delete the key entry in the container.
RSAalg.PersistKeyInCsp = False
'Call Clear to release resources and delete the key from the container.
RSAalg.Clear()
'Indicate that the key was persisted.
Console.WriteLine("The RSA key was deleted from the container, ""{0}"".", ContainerName)
Catch e As CryptographicException
Console.WriteLine(e.Message)
End Try
End Sub
Function RSAEncrypt(ByVal DataToEncrypt() As Byte, ByVal ContainerName As String, ByVal DoOAEPPadding As Boolean) As Byte()
Try
' Create a new instance of CspParameters. Pass
' 13 to specify a DSA container or 1 to specify
' an RSA container. The default is 1.
Dim cspParams As New CspParameters
' Specify the container name using the passed variable.
cspParams.KeyContainerName = ContainerName
'Create a new instance of RSACryptoServiceProvider.
'Pass the CspParameters class to use the key
'from the key in the container.
Dim RSAalg As New RSACryptoServiceProvider(cspParams)
'Encrypt the passed byte array and specify OAEP padding.
'OAEP padding is only available on Microsoft Windows XP or
'later.
Return RSAalg.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
Function RSADecrypt(ByVal DataToDecrypt() As Byte, ByVal ContainerName As String, ByVal DoOAEPPadding As Boolean) As Byte()
Try
' Create a new instance of CspParameters. Pass
' 13 to specify a DSA container or 1 to specify
' an RSA container. The default is 1.
Dim cspParams As New CspParameters
' Specify the container name using the passed variable.
cspParams.KeyContainerName = ContainerName
'Create a new instance of RSACryptoServiceProvider.
'Pass the CspParameters class to use the key
'from the key in the container.
Dim RSAalg As New RSACryptoServiceProvider(cspParams)
'Decrypt the passed byte array and specify OAEP padding.
'OAEP padding is only available on Microsoft Windows XP or
'later.
Return RSAalg.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 Module
using System;
using System.Security.Cryptography;
using System.Text;
class RSACSPSample
{
static void Main()
{
try
{
string KeyContainerName = "MyKeyContainer";
//Create a new key and persist it in
//the key container.
RSAPersistKeyInCSP(KeyContainerName);
//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;
//Pass the data to ENCRYPT, the name of the key container,
//and a boolean flag specifying no OAEP padding.
encryptedData = RSAEncrypt(dataToEncrypt,KeyContainerName, false);
//Pass the data to DECRYPT, the name of the key container,
//and a boolean flag specifying no OAEP padding.
decryptedData = RSADecrypt(encryptedData,KeyContainerName, false);
//Display the decrypted plaintext to the console.
Console.WriteLine("Decrypted plaintext: {0}", ByteConverter.GetString(decryptedData));
RSADeleteKeyInCSP(KeyContainerName);
}
catch(ArgumentNullException)
{
//Catch this exception in case the encryption did
//not succeed.
Console.WriteLine("Encryption failed.");
}
}
public static void RSAPersistKeyInCSP(string ContainerName)
{
try
{
// Create a new instance of CspParameters. Pass
// 13 to specify a DSA container or 1 to specify
// an RSA container. The default is 1.
CspParameters cspParams = new CspParameters();
// Specify the container name using the passed variable.
cspParams.KeyContainerName = ContainerName;
//Create a new instance of RSACryptoServiceProvider to generate
//a new key pair. Pass the CspParameters class to persist the
//key in the container. Pass an intger of 2048 to specify the
//key-size.
RSACryptoServiceProvider RSAalg = new RSACryptoServiceProvider( 2048, cspParams);
//Indicate that the key was persisted.
Console.WriteLine("The RSA key with a key-size of {0} was persisted in the container, \"{1}\".",
RSAalg.KeySize , ContainerName);
}
catch(CryptographicException e)
{
Console.WriteLine(e.Message);
}
}
public static void RSADeleteKeyInCSP(string ContainerName)
{
try
{
// Create a new instance of CspParameters. Pass
// 13 to specify a DSA container or 1 to specify
// an RSA container. The default is 1.
CspParameters cspParams = new CspParameters();
// Specify the container name using the passed variable.
cspParams.KeyContainerName = ContainerName;
//Create a new instance of DSACryptoServiceProvider.
//Pass the CspParameters class to use the
//key in the container.
RSACryptoServiceProvider RSAalg = new RSACryptoServiceProvider(cspParams);
//Delete the key entry in the container.
RSAalg.PersistKeyInCsp = false;
//Call Clear to release resources and delete the key from the container.
RSAalg.Clear();
//Indicate that the key was persisted.
Console.WriteLine("The RSA key was deleted from the container, \"{0}\".", ContainerName);
}
catch(CryptographicException e)
{
Console.WriteLine(e.Message);
}
}
static public byte[] RSAEncrypt(byte[] DataToEncrypt, string ContainerName, bool DoOAEPPadding)
{
try
{
// Create a new instance of CspParameters. Pass
// 13 to specify a DSA container or 1 to specify
// an RSA container. The default is 1.
CspParameters cspParams = new CspParameters();
// Specify the container name using the passed variable.
cspParams.KeyContainerName = ContainerName;
//Create a new instance of DSACryptoServiceProvider.
//Pass the CspParameters class to use the key
//from the key in the container.
RSACryptoServiceProvider RSAalg = new RSACryptoServiceProvider(cspParams);
//Encrypt the passed byte array and specify OAEP padding.
//OAEP padding is only available on Microsoft Windows XP or
//later.
return RSAalg.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, string ContainerName, bool DoOAEPPadding)
{
try
{
// Create a new instance of CspParameters. Pass
// 13 to specify a DSA container or 1 to specify
// an RSA container. The default is 1.
CspParameters cspParams = new CspParameters();
// Specify the container name using the passed variable.
cspParams.KeyContainerName = ContainerName;
//Create a new instance of DSACryptoServiceProvider.
//Pass the CspParameters class to use the key
//from the key in the container.
RSACryptoServiceProvider RSAalg = new RSACryptoServiceProvider(cspParams);
//Decrypt the passed byte array and specify OAEP padding.
//OAEP padding is only available on Microsoft Windows XP or
//later.
return RSAalg.Decrypt(DataToDecrypt, DoOAEPPadding);
}
//Catch and display a CryptographicException
//to the console.
catch(CryptographicException e)
{
Console.WriteLine(e.ToString());
return null;
}
}
}
using namespace System;
using namespace System::Security::Cryptography;
using namespace System::Text;
void RSAPersistKeyInCSP( String^ ContainerName )
{
try
{
// Create a new instance of CspParameters. Pass
// 13 to specify a DSA container or 1 to specify
// an RSA container. The default is 1.
CspParameters^ cspParams = gcnew CspParameters;
// Specify the container name using the passed variable.
cspParams->KeyContainerName = ContainerName;
//Create a new instance of RSACryptoServiceProvider to generate
//a new key pair. Pass the CspParameters class to persist the
//key in the container. Pass an intger of 2048 to specify the
//key-size.
RSACryptoServiceProvider^ RSAalg = gcnew RSACryptoServiceProvider( 2048,cspParams );
//Indicate that the key was persisted.
Console::WriteLine( "The RSA key with a key-size of {0} was persisted in the container, \"{1}\".", RSAalg->KeySize, ContainerName );
}
catch ( CryptographicException^ e )
{
Console::WriteLine( e->Message );
}
}
void RSADeleteKeyInCSP( String^ ContainerName )
{
try
{
// Create a new instance of CspParameters. Pass
// 13 to specify a DSA container or 1 to specify
// an RSA container. The default is 1.
CspParameters^ cspParams = gcnew CspParameters;
// Specify the container name using the passed variable.
cspParams->KeyContainerName = ContainerName;
//Create a new instance of DSACryptoServiceProvider.
//Pass the CspParameters class to use the
//key in the container.
RSACryptoServiceProvider^ RSAalg = gcnew RSACryptoServiceProvider( cspParams );
//Delete the key entry in the container.
RSAalg->PersistKeyInCsp = false;
//Call Clear to release resources and delete the key from the container.
RSAalg->Clear();
//Indicate that the key was persisted.
Console::WriteLine( "The RSA key was deleted from the container, \"{0}\".", ContainerName );
}
catch ( CryptographicException^ e )
{
Console::WriteLine( e->Message );
}
}
array<Byte>^ RSAEncrypt( array<Byte>^DataToEncrypt, String^ ContainerName, bool DoOAEPPadding )
{
try
{
// Create a new instance of CspParameters. Pass
// 13 to specify a DSA container or 1 to specify
// an RSA container. The default is 1.
CspParameters^ cspParams = gcnew CspParameters;
// Specify the container name using the passed variable.
cspParams->KeyContainerName = ContainerName;
//Create a new instance of DSACryptoServiceProvider.
//Pass the CspParameters class to use the key
//from the key in the container.
RSACryptoServiceProvider^ RSAalg = gcnew RSACryptoServiceProvider( cspParams );
//Encrypt the passed byte array and specify OAEP padding.
//OAEP padding is only available on Microsoft Windows XP or
//later.
return RSAalg->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, String^ ContainerName, bool DoOAEPPadding )
{
try
{
// Create a new instance of CspParameters. Pass
// 13 to specify a DSA container or 1 to specify
// an RSA container. The default is 1.
CspParameters^ cspParams = gcnew CspParameters;
// Specify the container name using the passed variable.
cspParams->KeyContainerName = ContainerName;
//Create a new instance of DSACryptoServiceProvider.
//Pass the CspParameters class to use the key
//from the key in the container.
RSACryptoServiceProvider^ RSAalg = gcnew RSACryptoServiceProvider( cspParams );
//Decrypt the passed byte array and specify OAEP padding.
//OAEP padding is only available on Microsoft Windows XP or
//later.
return RSAalg->Decrypt( DataToDecrypt, DoOAEPPadding );
}
//Catch and display a CryptographicException
//to the console.
catch ( CryptographicException^ e )
{
Console::WriteLine( e );
return nullptr;
}
}
int main()
{
try
{
String^ KeyContainerName = "MyKeyContainer";
//Create a new key and persist it in
//the key container.
RSAPersistKeyInCSP( KeyContainerName );
//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;
//Pass the data to ENCRYPT, the name of the key container,
//and a boolean flag specifying no OAEP padding.
encryptedData = RSAEncrypt( dataToEncrypt, KeyContainerName, false );
//Pass the data to DECRYPT, the name of the key container,
//and a boolean flag specifying no OAEP padding.
decryptedData = RSADecrypt( encryptedData, KeyContainerName, false );
//Display the decrypted plaintext to the console.
Console::WriteLine( "Decrypted plaintext: {0}", ByteConverter->GetString( decryptedData ) );
RSADeleteKeyInCSP( KeyContainerName );
}
catch ( ArgumentNullException^ )
{
//Catch this exception in case the encryption did
//not succeed.
Console::WriteLine( "Encryption failed." );
}
}
import System.*;
import System.Security.Cryptography.*;
import System.Text.*;
class RSACSPSample
{
public static void main(String[] args)
{
try {
String keyContainerName = "MyKeyContainer";
// Create a new key and persist it in
// the key container.
RSAPersistKeyInCSP(keyContainerName);
// 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[];
// Pass the data to ENCRYPT, the name of the key container,
// and a boolean flag specifying no OAEP padding.
encryptedData = RSAEncrypt(dataToEncrypt, keyContainerName, false);
// Pass the data to DECRYPT, the name of the key container,
// and a boolean flag specifying no OAEP padding.
decryptedData = RSADecrypt(encryptedData, keyContainerName, false);
// Display the decrypted plaintext to the console.
Console.WriteLine("Decrypted plaintext: {0}",
byteConverter.GetString(decryptedData));
RSADeleteKeyInCSP(keyContainerName);
}
catch (ArgumentNullException exp) {
// Catch this exception in case the encryption did
// not succeed.
Console.WriteLine("Encryption failed.");
}
} //main
public static void RSAPersistKeyInCSP(String containerName)
{
try {
// Create a new instance of CspParameters. Pass
// 13 to specify a DSA container or 1 to specify
// an RSA container. The default is 1.
CspParameters cspParams = new CspParameters();
// Specify the container name using the passed variable.
cspParams.KeyContainerName = containerName;
// Create a new instance of RSACryptoServiceProvider to generate
// a new key pair. Pass the CspParameters class to persist the
// key in the container. Pass an intger of 2048 to specify the
// key-size.
RSACryptoServiceProvider rsaAlg =
new RSACryptoServiceProvider(2048, cspParams);
// Indicate that the key was persisted.
Console.WriteLine("The RSA key with a key-size of {0} was "
+ "persisted in the container, \"{1}\".",
System.Convert.ToString(rsaAlg.get_KeySize()), containerName);
}
catch (CryptographicException e) {
Console.WriteLine(e.get_Message());
}
} //RSAPersistKeyInCSP
public static void RSADeleteKeyInCSP(String containerName)
{
try {
// Create a new instance of CspParameters. Pass
// 13 to specify a DSA container or 1 to specify
// an RSA container. The default is 1.
CspParameters cspParams = new CspParameters();
// Specify the container name using the passed variable.
cspParams.KeyContainerName = containerName;
// Create a new instance of DSACryptoServiceProvider.
// Pass the CspParameters class to use the
// key in the container.
RSACryptoServiceProvider rsaAlg =
new RSACryptoServiceProvider(cspParams);
// Delete the key entry in the container.
rsaAlg.set_PersistKeyInCsp(false);
// Call Clear to release resources and delete the key from
// the container.
rsaAlg.Clear();
// Indicate that the key was persisted.
Console.WriteLine("The RSA key was deleted from the container, "
+ "\"{0}\".", containerName);
}
catch (CryptographicException e) {
Console.WriteLine(e.get_Message());
}
} //RSADeleteKeyInCSP
public static ubyte[] RSAEncrypt(ubyte dataToEncrypt[],
String containerName, boolean doOAEPPadding)
{
try {
// Create a new instance of CspParameters. Pass
// 13 to specify a DSA container or 1 to specify
// an RSA container. The default is 1.
CspParameters cspParams = new CspParameters();
// Specify the container name using the passed variable.
cspParams.KeyContainerName = containerName;
// Create a new instance of DSACryptoServiceProvider.
// Pass the CspParameters class to use the key
// from the key in the container.
RSACryptoServiceProvider rsaAlg =
new RSACryptoServiceProvider(cspParams);
// Encrypt the passed byte array and specify OAEP padding.
// OAEP padding is only available on Microsoft Windows XP or
// later.
return rsaAlg.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,
String containerName, boolean doOAEPPadding)
{
try {
// Create a new instance of CspParameters. Pass
// 13 to specify a DSA container or 1 to specify
// an RSA container. The default is 1.
CspParameters cspParams = new CspParameters();
// Specify the container name using the passed variable.
cspParams.KeyContainerName = containerName;
// Create a new instance of DSACryptoServiceProvider.
// Pass the CspParameters class to use the key
// from the key in the container.
RSACryptoServiceProvider rsaAlg =
new RSACryptoServiceProvider(cspParams);
// Decrypt the passed byte array and specify OAEP padding.
// OAEP padding is only available on Microsoft Windows XP or
// later.
return rsaAlg.Decrypt(dataToDecrypt, doOAEPPadding);
}
// Catch and display a CryptographicException
// to the console.
catch (CryptographicException e) {
Console.WriteLine(e.ToString());
return null;
}
} //RSADecrypt
} //RSACSPSample
プラットフォーム
Windows 98,Windows Server 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
Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。
バージョン情報
.NET Framework
サポート対象 : 3.0,2.0,1.1,1.0
.NET Compact Framework
サポート対象 : 2.0
参照
関連項目
RSACryptoServiceProvider クラス
RSACryptoServiceProvider メンバ
System.Security.Cryptography 名前空間