キー サイズおよび暗号サービス プロバイダ (CSP) のパラメータを指定して、DSACryptoServiceProvider クラスの新しいインスタンスを初期化します。
名前空間: 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 DSACryptoServiceProvider(dwKeySize, parameters)
public DSACryptoServiceProvider (
int dwKeySize,
CspParameters parameters
)
public:
DSACryptoServiceProvider (
int dwKeySize,
CspParameters^ parameters
)
public DSACryptoServiceProvider (
int dwKeySize,
CspParameters parameters
)
public function DSACryptoServiceProvider (
dwKeySize : int,
parameters : CspParameters
)
適用できません。
パラメータ
- dwKeySize
暗号アルゴリズムで使用されるキーのサイズ (ビット単位)。
- parameters
CSP のパラメータ。
例外
| 例外の種類 | 条件 |
|---|---|
CSP を取得できません。 または キーを作成できません。 |
|
dwKeySize が範囲外です。 |
使用例
DSACryptoServiceProvider を作成し、新しいキー ペアを生成して、このキー ペアをキー コンテナ内で永続化するコード例を次に示します。
Imports System.Security.Cryptography
Module DSACSPExample
Sub Main()
Try
Dim KeyContainerName As String = "MyKeyContainer"
'Create a new key and persist it in
'the key container.
DSAPersistKeyInCSP(KeyContainerName)
'The hash value to sign.
Dim HashValue As Byte() = {59, 4, 248, 102, 77, 97, 142, 201, 210, 12, 224, _
93, 25, 41, 100, 197, 213, 134, 130, 135}
'The value to hold the signed value.
Dim SignedHashValue As Byte() = DSASignHash(HashValue, KeyContainerName, "SHA1")
'Verify the hash and display the results.
If DSAVerifyHash(HashValue, SignedHashValue, KeyContainerName, "SHA1") Then
Console.WriteLine("The hash value was verified.")
Else
Console.WriteLine("The hash value was not verified.")
End If
'Delete
DSADeleteKeyInCSP(KeyContainerName)
Catch e As ArgumentNullException
Console.WriteLine(e.Message)
End Try
End Sub
Sub DSAPersistKeyInCSP(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(13)
' Specify the container name using the passed variable.
cspParams.KeyContainerName = ContainerName
'Create a new instance of DSACryptoServiceProvider to generate
'a new key pair. Pass a key size of 1024. Pass the CspParameters
'class to persist the key in the container.
Dim DSAalg As New DSACryptoServiceProvider(1024, cspParams)
'Indicate that the key was persisted.
Console.WriteLine("The DSA key was persisted in the container, ""{0}"".", ContainerName)
'Indicate the key size.
Console.WriteLine("The key size is: {0}.", DSAalg.KeySize)
Catch e As CryptographicException
Console.WriteLine(e.Message)
End Try
End Sub
Sub DSADeleteKeyInCSP(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(13)
' 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.
Dim DSAalg As New DSACryptoServiceProvider(cspParams)
'Delete the key entry in the container.
DSAalg.PersistKeyInCsp = False
'Call Clear to release resources and delete the key from the container.
DSAalg.Clear()
'Indicate that the key was persisted.
Console.WriteLine("The DSA key was deleted from the container, ""{0}"".", ContainerName)
Catch e As CryptographicException
Console.WriteLine(e.Message)
End Try
End Sub
Function DSASignHash(ByVal HashToSign() As Byte, ByVal ContainerName As String, ByVal HashAlg As String) 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(13)
' 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.
Dim DSAalg As New DSACryptoServiceProvider(cspParams)
'Create an DSASignatureFormatter object and pass it the
'DSACryptoServiceProvider to transfer the private key.
Dim DSAFormatter As New DSASignatureFormatter(DSAalg)
'Set the hash algorithm to the passed value.
DSAFormatter.SetHashAlgorithm(HashAlg)
'Create a signature for HashValue and return it.
Return DSAFormatter.CreateSignature(HashToSign)
Catch e As CryptographicException
Console.WriteLine(e.Message)
Return Nothing
End Try
End Function
Function DSAVerifyHash(ByVal HashValue() As Byte, ByVal SignedHashValue() As Byte, ByVal ContainerName As String, ByVal HashAlg As String) As Boolean
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(13)
' 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.
Dim DSAalg As New DSACryptoServiceProvider(cspParams)
'Create an DSASignatureDeformatter object and pass it the
'DSACryptoServiceProvider to transfer the private key.
Dim DSADeformatter As New DSASignatureDeformatter(DSAalg)
'Set the hash algorithm to the passed value.
DSADeformatter.SetHashAlgorithm(HashAlg)
'Verify signature and return the result.
Return DSADeformatter.VerifySignature(HashValue, SignedHashValue)
Catch e As CryptographicException
Console.WriteLine(e.Message)
Return False
End Try
End Function
End Module
using System;
using System.Security.Cryptography;
class DSACSPExample
{
static void Main()
{
try
{
string KeyContainerName = "MyKeyContainer";
//Create a new key and persist it in
//the key container.
DSAPersistKeyInCSP(KeyContainerName);
//The hash value to sign.
byte[] HashValue = {59,4,248,102,77,97,142,201,210,12,224,93,25,41,100,197,213,134,130,135};
//The value to hold the signed value.
byte[] SignedHashValue = DSASignHash(HashValue, KeyContainerName, "SHA1");
//Verify the hash and display the results.
if(DSAVerifyHash(HashValue, SignedHashValue, KeyContainerName, "SHA1"))
{
Console.WriteLine("The hash value was verified.");
}
else
{
Console.WriteLine("The hash value was not verified.");
}
//Delete
DSADeleteKeyInCSP(KeyContainerName);
}
catch(ArgumentNullException e)
{
Console.WriteLine(e.Message);
}
}
public static void DSAPersistKeyInCSP(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(13);
// Specify the container name using the passed variable.
cspParams.KeyContainerName = ContainerName;
//Create a new instance of DSACryptoServiceProvider to generate
//a new key pair. Pass a key size of 1024. Pass the CspParameters
//class to persist the key in the container.
DSACryptoServiceProvider DSAalg = new DSACryptoServiceProvider(1024, cspParams);
//Indicate that the key was persisted.
Console.WriteLine("The DSA key was persisted in the container, \"{0}\".", ContainerName);
//Indicate the key size.
Console.WriteLine("The key size is: {0}.", DSAalg.KeySize);
}
catch(CryptographicException e)
{
Console.WriteLine(e.Message);
}
}
public static void DSADeleteKeyInCSP(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(13);
// 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.
DSACryptoServiceProvider DSAalg = new DSACryptoServiceProvider(cspParams);
//Delete the key entry in the container.
DSAalg.PersistKeyInCsp = false;
//Call Clear to release resources and delete the key from the container.
DSAalg.Clear();
//Indicate that the key was persisted.
Console.WriteLine("The DSA key was deleted from the container, \"{0}\".", ContainerName);
}
catch(CryptographicException e)
{
Console.WriteLine(e.Message);
}
}
public static byte[] DSASignHash(byte[] HashToSign, string ContainerName, string HashAlg)
{
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(13);
// 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.
DSACryptoServiceProvider DSAalg = new DSACryptoServiceProvider(cspParams);
//Create an DSASignatureFormatter object and pass it the
//DSACryptoServiceProvider to transfer the private key.
DSASignatureFormatter DSAFormatter = new DSASignatureFormatter(DSAalg);
//Set the hash algorithm to the passed value.
DSAFormatter.SetHashAlgorithm(HashAlg);
//Create a signature for HashValue and return it.
return DSAFormatter.CreateSignature(HashToSign);
}
catch(CryptographicException e)
{
Console.WriteLine(e.Message);
return null;
}
}
public static bool DSAVerifyHash(byte[] HashValue, byte[] SignedHashValue, string ContainerName, string HashAlg)
{
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(13);
// 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.
DSACryptoServiceProvider DSAalg = new DSACryptoServiceProvider(cspParams);
//Create an DSASignatureDeformatter object and pass it the
//DSACryptoServiceProvider to transfer the private key.
DSASignatureDeformatter DSADeformatter = new DSASignatureDeformatter(DSAalg);
//Set the hash algorithm to the passed value.
DSADeformatter.SetHashAlgorithm(HashAlg);
//Verify signature and return the result.
return DSADeformatter.VerifySignature(HashValue, SignedHashValue);
}
catch(CryptographicException e)
{
Console.WriteLine(e.Message);
return false;
}
}
}
using namespace System;
using namespace System::Security::Cryptography;
void DSAPersistKeyInCSP( 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( 13 );
// Specify the container name using the passed variable.
cspParams->KeyContainerName = ContainerName;
//Create a new instance of DSACryptoServiceProvider to generate
//a new key pair. Pass a key size of 1024. Pass the CspParameters
//class to persist the key in the container.
DSACryptoServiceProvider^ DSAalg = gcnew DSACryptoServiceProvider( 1024,cspParams );
//Indicate that the key was persisted.
Console::WriteLine( "The DSA key was persisted in the container, \"{0}\".", ContainerName );
//Indicate the key size.
Console::WriteLine( "The key size is: {0}.", DSAalg->KeySize );
}
catch ( CryptographicException^ e )
{
Console::WriteLine( e->Message );
}
}
void DSADeleteKeyInCSP( 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( 13 );
// 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.
DSACryptoServiceProvider^ DSAalg = gcnew DSACryptoServiceProvider( cspParams );
//Delete the key entry in the container.
DSAalg->PersistKeyInCsp = false;
//Call Clear to release resources and delete the key from the container.
DSAalg->Clear();
//Indicate that the key was persisted.
Console::WriteLine( "The DSA key was deleted from the container, \"{0}\".", ContainerName );
}
catch ( CryptographicException^ e )
{
Console::WriteLine( e->Message );
}
}
array<Byte>^ DSASignHash( array<Byte>^HashToSign, String^ ContainerName, String^ HashAlg )
{
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( 13 );
// 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.
DSACryptoServiceProvider^ DSAalg = gcnew DSACryptoServiceProvider( cspParams );
//Create an DSASignatureFormatter object and pass it the
//DSACryptoServiceProvider to transfer the private key.
DSASignatureFormatter^ DSAFormatter = gcnew DSASignatureFormatter( DSAalg );
//Set the hash algorithm to the passed value.
DSAFormatter->SetHashAlgorithm( HashAlg );
//Create a signature for HashValue and return it.
return DSAFormatter->CreateSignature( HashToSign );
}
catch ( CryptographicException^ e )
{
Console::WriteLine( e->Message );
return nullptr;
}
}
bool DSAVerifyHash( array<Byte>^HashValue, array<Byte>^SignedHashValue, String^ ContainerName, String^ HashAlg )
{
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( 13 );
// 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.
DSACryptoServiceProvider^ DSAalg = gcnew DSACryptoServiceProvider( cspParams );
//Create an DSASignatureDeformatter object and pass it the
//DSACryptoServiceProvider to transfer the private key.
DSASignatureDeformatter^ DSADeformatter = gcnew DSASignatureDeformatter( DSAalg );
//Set the hash algorithm to the passed value.
DSADeformatter->SetHashAlgorithm( HashAlg );
//Verify signature and return the result.
return DSADeformatter->VerifySignature( HashValue, SignedHashValue );
}
catch ( CryptographicException^ e )
{
Console::WriteLine( e->Message );
return false;
}
}
int main()
{
try
{
String^ KeyContainerName = "MyKeyContainer";
//Create a new key and persist it in
//the key container.
DSAPersistKeyInCSP( KeyContainerName );
//The hash value to sign.
array<Byte>^HashValue = {59,4,248,102,77,97,142,201,210,12,224,93,25,41,100,197,213,134,130,135};
//The value to hold the signed value.
array<Byte>^SignedHashValue = DSASignHash( HashValue, KeyContainerName, "SHA1" );
//Verify the hash and display the results.
if ( DSAVerifyHash( HashValue, SignedHashValue, KeyContainerName, "SHA1" ) )
{
Console::WriteLine( "The hash value was verified." );
}
else
{
Console::WriteLine( "The hash value was not verified." );
}
//Delete
DSADeleteKeyInCSP( KeyContainerName );
}
catch ( ArgumentNullException^ e )
{
Console::WriteLine( e->Message );
}
}
import System.*;
import System.Security.Cryptography.*;
class DSACSPExample
{
public static void main(String args[])
{
try {
String keyContainerName = "MyKeyContainer";
//Create a new key and persist it in
//the key container.
DSAPersistKeyInCSP(keyContainerName);
//The hash value to sign.
ubyte hashValue[] = { 59, 4, 248, 102, 77, 97, 142, 201, 210, 12,
224, 93, 25, 41, 100, 197, 213, 134, 130, 135 };
//The value to hold the signed value.
ubyte signedHashValue[] = DSASignHash(hashValue, keyContainerName,
"SHA1");
//Verify the hash and display the results.
if (DSAVerifyHash(hashValue, signedHashValue, keyContainerName,
"SHA1")) {
Console.WriteLine("The hash value was verified.");
}
else {
Console.WriteLine("The hash value was not verified.");
}
//Delete
DSADeleteKeyInCSP(keyContainerName);
}
catch (ArgumentNullException e) {
Console.WriteLine(e.get_Message());
}
} //main
public static void DSAPersistKeyInCSP(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(13);
// Specify the container name using the passed variable.
cspParams.KeyContainerName = containerName;
//Create a new instance of DSACryptoServiceProvider to generate
//a new key pair. Pass a key size of 1024. Pass the CspParameters
//class to persist the key in the container.
DSACryptoServiceProvider dsaAlg = new DSACryptoServiceProvider(1024,
cspParams);
//Indicate that the key was persisted.
Console.WriteLine("The DSA key was persisted in the container,"
+ " \"{0}\".", containerName);
//Indicate the key size.
Console.WriteLine("The key size is: {0}.", System.Convert.ToString(
dsaAlg.get_KeySize()));
}
catch (CryptographicException e) {
Console.WriteLine(e.get_Message());
}
} //DSAPersistKeyInCSP
public static void DSADeleteKeyInCSP(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(13);
// 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.
DSACryptoServiceProvider dsaAlg =
new DSACryptoServiceProvider(cspParams);
//Delete the key entry in the container.
dsaAlg.set_PersistKeyInCsp(false);
//Call Clear to release resources and delete the key from the
//container.
dsaAlg.Clear();
//Indicate that the key was persisted.
Console.WriteLine("The DSA key was deleted from the container, "
+ "\"{0}\".", containerName);
}
catch (CryptographicException e) {
Console.WriteLine(e.get_Message());
}
} //DSADeleteKeyInCSP
public static ubyte[] DSASignHash(ubyte hashToSign[], String containerName,
String hashAlg)
{
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(13);
// 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.
DSACryptoServiceProvider dsaAlg =
new DSACryptoServiceProvider(cspParams);
//Create an DSASignatureFormatter object and pass it the
//DSACryptoServiceProvider to transfer the private key.
DSASignatureFormatter dsaFormatter =
new DSASignatureFormatter(dsaAlg);
//Set the hash algorithm to the passed value.
dsaFormatter.SetHashAlgorithm(hashAlg);
//Create a signature for hashValue and return it.
return dsaFormatter.CreateSignature(hashToSign);
}
catch (CryptographicException e) {
Console.WriteLine(e.get_Message());
return null;
}
} //DSASignHash
public static boolean DSAVerifyHash(ubyte hashValue[],
ubyte signedHashValue[], String containerName, String hashAlg)
{
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(13);
// 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.
DSACryptoServiceProvider dsaAlg =
new DSACryptoServiceProvider(cspParams);
//Create an DSASignatureDeformatter object and pass it the
//DSACryptoServiceProvider to transfer the private key.
DSASignatureDeformatter dsaDeformatter =
new DSASignatureDeformatter(dsaAlg);
//Set the hash algorithm to the passed value.
dsaDeformatter.SetHashAlgorithm(hashAlg);
//Verify signature and return the result.
return dsaDeformatter.VerifySignature(hashValue, signedHashValue);
}
catch (CryptographicException e) {
Console.WriteLine(e.get_Message());
return false;
}
} //DSAVerifyHash
} //DSACSPExample
.NET Framework のセキュリティ
- SecurityPermission (アンマネージ コードを呼び出すために必要なアクセス許可)。SecurityPermissionFlag.UnmanagedCode (関連する列挙体)。
プラットフォーム
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
参照
関連項目
DSACryptoServiceProvider クラス
DSACryptoServiceProvider メンバ
System.Security.Cryptography 名前空間