RSACryptoServiceProvider.SignData 方法

定义

命名空间:

System.Security.Cryptography

程序集:

netstandard.dll, System.Security.Cryptography.dll

计算指定数据的哈希值，并对其进行签名。

重载

SignData(Byte[], Object)	使用指定的哈希算法计算指定字节数组的哈希值，并对生成的哈希值进行签名。
SignData(Stream, Object)	使用指定的哈希算法计算指定输入流的哈希值，并对生成的哈希值进行签名。
SignData(Byte[], Int32, Int32, Object)	使用指定的哈希算法计算指定字节数组子集的哈希值，并对生成的哈希值进行签名。

SignData(Byte[], Object)

Source:

RSACryptoServiceProvider.Unix.cs

使用指定的哈希算法计算指定字节数组的哈希值，并对生成的哈希值进行签名。

C#

public byte[] SignData(byte[] buffer, object halg);

参数

buffer

Byte[]

要进行哈希处理和签名的输入数据。

halg

Object

要用于创建哈希值的哈希算法。

返回

Byte[]

指定数据的 RSA 签名。

例外

ArgumentNullException

halg 参数为 null。

ArgumentException

halg 参数不是有效的类型。

示例

下面的代码示例对数据进行签名和验证。

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.
            ASCIIEncoding ByteConverter = new ASCIIEncoding();

            string dataString = "Data to Sign";

            // Create byte arrays to hold original, encrypted, and decrypted data.
            byte[] originalData = ByteConverter.GetBytes(dataString);
            byte[] signedData;

            // Create a new instance of the RSACryptoServiceProvider class
            // and automatically create a new key-pair.
            RSACryptoServiceProvider RSAalg = new RSACryptoServiceProvider();

            // Export the key information to an RSAParameters object.
            // You must pass true to export the private key for signing.
            // However, you do not need to export the private key
            // for verification.
            RSAParameters Key = RSAalg.ExportParameters(true);

            // Hash and sign the data.
            signedData = HashAndSignBytes(originalData, Key);

            // Verify the data and display the result to the
            // console.
            if(VerifySignedHash(originalData, signedData, Key))
            {
                Console.WriteLine("The data was verified.");
            }
            else
            {
                Console.WriteLine("The data does not match the signature.");
            }
        }
        catch(ArgumentNullException)
        {
            Console.WriteLine("The data was not signed or verified");
        }
    }
    public static byte[] HashAndSignBytes(byte[] DataToSign, RSAParameters Key)
    {
        try
        {
            // Create a new instance of RSACryptoServiceProvider using the
            // key from RSAParameters.
            RSACryptoServiceProvider RSAalg = new RSACryptoServiceProvider();

            RSAalg.ImportParameters(Key);

            // Hash and sign the data. Pass a new instance of SHA256
            // to specify the hashing algorithm.
            return RSAalg.SignData(DataToSign, SHA256.Create());
        }
        catch(CryptographicException e)
        {
            Console.WriteLine(e.Message);

            return null;
        }
    }

    public static bool VerifySignedHash(byte[] DataToVerify, byte[] SignedData, RSAParameters Key)
    {
        try
        {
            // Create a new instance of RSACryptoServiceProvider using the
            // key from RSAParameters.
            RSACryptoServiceProvider RSAalg = new RSACryptoServiceProvider();

            RSAalg.ImportParameters(Key);

            // Verify the data using the signature.  Pass a new instance of SHA256
            // to specify the hashing algorithm.
            return RSAalg.VerifyData(DataToVerify, SHA256.Create(), SignedData);
        }
        catch(CryptographicException e)
        {
            Console.WriteLine(e.Message);

            return false;
        }
    }
}

注解

此方法创建使用 VerifyData 方法验证的数字签名。

参数 halg 可以接受 String、 HashAlgorithm或 Type。

另请参阅

• SignData(Byte[], HashAlgorithmName, RSASignaturePadding)
• 加密服务

SignData(Stream, Object)

Source:

RSACryptoServiceProvider.Unix.cs

使用指定的哈希算法计算指定输入流的哈希值，并对生成的哈希值进行签名。

C#

public byte[] SignData(System.IO.Stream inputStream, object halg);

参数

inputStream

Stream

要进行哈希处理和签名的输入流。

halg

Object

要用于创建哈希值的哈希算法。

返回

Byte[]

指定数据的 RSA 签名。

例外

ArgumentNullException

halg 参数为 null。

ArgumentException

halg 参数不是有效的类型。

示例

下面的代码示例对数据进行签名和验证。

C#

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

class RSACSPSample
{
    static void Main()
    {
        try
        {
            ASCIIEncoding ByteConverter = new ASCIIEncoding();

            // Create some bytes to be signed.
            byte[] dataBytes = ByteConverter.GetBytes("Here is some data to sign!");

            // Create a buffer for the memory stream.
            byte[] buffer = new byte[dataBytes.Length];

            // Create a MemoryStream.
            MemoryStream mStream = new MemoryStream(buffer);

            // Write the bytes to the stream and flush it.
            mStream.Write(dataBytes, 0, dataBytes.Length);

            mStream.Flush();

            // Create a new instance of the RSACryptoServiceProvider class
            // and automatically create a new key-pair.
            RSACryptoServiceProvider RSAalg = new RSACryptoServiceProvider();

            // Export the key information to an RSAParameters object.
            // You must pass true to export the private key for signing.
            // However, you do not need to export the private key
            // for verification.
            RSAParameters Key = RSAalg.ExportParameters(true);

            // Hash and sign the data.
            byte[] signedData = HashAndSignBytes(mStream, Key);

            // Verify the data and display the result to the
            // console.
            if(VerifySignedHash(dataBytes, signedData, Key))
            {
                Console.WriteLine("The data was verified.");
            }
            else
            {
                Console.WriteLine("The data does not match the signature.");
            }

            // Close the MemoryStream.
            mStream.Close();
        }
        catch(ArgumentNullException)
        {
            Console.WriteLine("The data was not signed or verified");
        }
    }
    public static byte[] HashAndSignBytes(Stream DataStream, RSAParameters Key)
    {
        try
        {
            // Reset the current position in the stream to
            // the beginning of the stream (0). RSACryptoServiceProvider
            // can't verify the data unless the stream position
            // is set to the starting position of the data.
            DataStream.Position = 0;

            // Create a new instance of RSACryptoServiceProvider using the
            // key from RSAParameters.
            RSACryptoServiceProvider RSAalg = new RSACryptoServiceProvider();

            RSAalg.ImportParameters(Key);

            // Hash and sign the data. Pass a new instance of SHA256
            // to specify the hashing algorithm.
            return RSAalg.SignData(DataStream, SHA256.Create());
        }
        catch(CryptographicException e)
        {
            Console.WriteLine(e.Message);

            return null;
        }
    }

    public static bool VerifySignedHash(byte[] DataToVerify, byte[] SignedData, RSAParameters Key)
    {
        try
        {
            // Create a new instance of RSACryptoServiceProvider using the
            // key from RSAParameters.
            RSACryptoServiceProvider RSAalg = new RSACryptoServiceProvider();

            RSAalg.ImportParameters(Key);

            // Verify the data using the signature.  Pass a new instance of SHA256
            // to specify the hashing algorithm.
            return RSAalg.VerifyData(DataToVerify, SHA256.Create(), SignedData);
        }
        catch(CryptographicException e)
        {
            Console.WriteLine(e.Message);

            return false;
        }
    }
}

注解

参数 halg 可以接受 String、 HashAlgorithm或 Type。

另请参阅

• SignData(Stream, HashAlgorithmName, RSASignaturePadding)
• 加密服务

SignData(Byte[], Int32, Int32, Object)

Source:

RSACryptoServiceProvider.Unix.cs

使用指定的哈希算法计算指定字节数组子集的哈希值，并对生成的哈希值进行签名。

C#

public byte[] SignData(byte[] buffer, int offset, int count, object halg);

参数

buffer

Byte[]

要进行哈希处理和签名的输入数据。

offset

Int32

数组中的偏移量，从该位置开始使用数据。

count

Int32

数组中用作数据的字节数。

halg

Object

要用于创建哈希值的哈希算法。

返回

Byte[]

指定数据的 RSA 签名。

例外

ArgumentNullException

halg 参数为 null。

ArgumentException

halg 参数不是有效的类型。

示例

下面的代码示例对数据进行签名和验证。

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.
            ASCIIEncoding ByteConverter = new ASCIIEncoding();

            string dataString = "Data to Sign";

            // Create byte arrays to hold original, encrypted, and decrypted data.
            byte[] originalData = ByteConverter.GetBytes(dataString);
            byte[] signedData;
            byte[] smallArray;

            // Create a new instance of the RSACryptoServiceProvider class
            // and automatically create a new key-pair.
            RSACryptoServiceProvider RSAalg = new RSACryptoServiceProvider();

            // Export the key information to an RSAParameters object.
            // You must pass true to export the private key for signing.
            // However, you do not need to export the private key
            // for verification.
            RSAParameters Key = RSAalg.ExportParameters(true);

            // Hash and sign the data.  Start at the fifth offset
            // only use data from the next 7 bytes.
            signedData = HashAndSignBytes(originalData, Key, 5, 7 );

            // The previous method only signed one segment
            // of the array.  Create a new array for verification
            // that only holds the data that was actually signed.
            //
            // Initialize the array.
            smallArray = new byte[7];
            // Copy 7 bytes starting at the 5th index to
            // the new array.
            Array.Copy(originalData, 5 , smallArray, 0, 7);

            // Verify the data and display the result to the
            // console.
            if(VerifySignedHash(smallArray, signedData, Key))
            {
                Console.WriteLine("The data was verified.");
            }
            else
            {
                Console.WriteLine("The data does not match the signature.");
            }
        }
        catch(ArgumentNullException)
        {
            Console.WriteLine("The data was not signed or verified");
        }
    }
    public static byte[] HashAndSignBytes(byte[] DataToSign, RSAParameters Key, int Index, int Length)
    {
        try
        {
            // Create a new instance of RSACryptoServiceProvider using the
            // key from RSAParameters.
            RSACryptoServiceProvider RSAalg = new RSACryptoServiceProvider();

            RSAalg.ImportParameters(Key);

            // Hash and sign the data. Pass a new instance of SHA256
            // to specify the hashing algorithm.
            return RSAalg.SignData(DataToSign,Index,Length, SHA256.Create());
        }
        catch(CryptographicException e)
        {
            Console.WriteLine(e.Message);

            return null;
        }
    }

    public static bool VerifySignedHash(byte[] DataToVerify, byte[] SignedData, RSAParameters Key)
    {
        try
        {
            // Create a new instance of RSACryptoServiceProvider using the
            // key from RSAParameters.
            RSACryptoServiceProvider RSAalg = new RSACryptoServiceProvider();

            RSAalg.ImportParameters(Key);

            // Verify the data using the signature.  Pass a new instance of SHA256
            // to specify the hashing algorithm.
            return RSAalg.VerifyData(DataToVerify, SHA256.Create(), SignedData);
        }
        catch(CryptographicException e)
        {
            Console.WriteLine(e.Message);

            return false;
        }
    }
}

注解

此方法创建使用 VerifyData 方法验证的数字签名。

参数 halg 可以接受 String、 HashAlgorithm或 Type。 字符串值可以是下列值之一：

• 对象标识符 (OID) 要使用的哈希算法的友好名称，在加密配置文件中注册的名称或加密 API OID 表中的名称。

• OID 值。 OID 必须是加密 API 识别的 OID。

例如，可以使用 SignData (新字节[5]、“1.3.14.3.26”) 或 SignData (新字节[5]、“sha1”) 或 SignData (新字节[5]、“SHA1”) 。

另请参阅

• SignData(Byte[], Int32, Int32, HashAlgorithmName, RSASignaturePadding)
• 加密服务