RSACryptoServiceProvider.SignHash Méthode

Définition

Espace de noms:

System.Security.Cryptography

Assemblys:

netstandard.dll, System.Security.Cryptography.dll

Calcule la signature pour la valeur de hachage spécifiée.

Surcharges

SignHash(Byte[], String)	Calcule la signature pour la valeur de hachage spécifiée.
SignHash(Byte[], HashAlgorithmName, RSASignaturePadding)	Calcule la signature pour la valeur de hachage spécifiée à l’aide du remplissage spécifié.

SignHash(Byte[], String)

Source:

RSACryptoServiceProvider.Unix.cs

Calcule la signature pour la valeur de hachage spécifiée.

C#

public byte[] SignHash(byte[] rgbHash, string? str);

Paramètres

rgbHash

Byte[]

Valeur de hachage des données à signer.

str

String

Identificateur d’algorithme de hachage (OID) utilisé pour créer la valeur de hachage des données.

Retours

Byte[]

Signature RSA pour la valeur de hachage spécifiée.

Exceptions

ArgumentNullException

Le paramètre rgbHash a la valeur null.

CryptographicException

Le fournisseur de services de chiffrement ne peut pas être acquis.

- ou -

Il n’existe aucune clé privée.

Exemples

L’exemple de code suivant chiffre certaines données, crée un hachage des données chiffrées, puis signe le hachage avec une signature numérique.

C#

// This example uses the SHA1 algorithm.
// Due to collision problems with SHA1, Microsoft recommends SHA256 or better.
using System;
using System.Text;
using System.Security.Cryptography;

namespace RSACryptoServiceProvider_Examples
{
    class MyMainClass
    {
        static void Main()
        {
            byte[] toEncrypt;
            byte[] encrypted;
            byte[] signature;
            //Choose a small amount of data to encrypt.
            string original = "Hello";
            ASCIIEncoding myAscii = new ASCIIEncoding();

            //Create a sender and receiver.
            Sender mySender = new Sender();
            Receiver myReceiver = new Receiver();

            //Convert the data string to a byte array.
            toEncrypt = myAscii.GetBytes(original);

            //Encrypt data using receiver's public key.
            encrypted = mySender.EncryptData(myReceiver.PublicParameters, toEncrypt);

            //Hash the encrypted data and generate a signature on the hash
            // using the sender's private key.
            signature = mySender.HashAndSign(encrypted);

            Console.WriteLine("Original: {0}", original);

            //Verify the signature is authentic using the sender's public key.
            if (myReceiver.VerifyHash(mySender.PublicParameters, encrypted, signature))
            {
                //Decrypt the data using the receiver's private key.
                myReceiver.DecryptData(encrypted);
            }
            else
            {
                Console.WriteLine("Invalid signature");
            }
        }
    }

    class Sender
    {
        RSAParameters rsaPubParams;
        RSAParameters rsaPrivateParams;

        public Sender()
        {
            RSACryptoServiceProvider rsaCSP = new RSACryptoServiceProvider();

            //Generate public and private key data.
            rsaPrivateParams = rsaCSP.ExportParameters(true);
            rsaPubParams = rsaCSP.ExportParameters(false);
        }

        public RSAParameters PublicParameters
        {
            get
            {
                return rsaPubParams;
            }
        }

        //Manually performs hash and then signs hashed value.
        public byte[] HashAndSign(byte[] encrypted)
        {
            RSACryptoServiceProvider rsaCSP = new RSACryptoServiceProvider();
            SHA1Managed hash = new SHA1Managed();
            byte[] hashedData;

            rsaCSP.ImportParameters(rsaPrivateParams);

            hashedData = hash.ComputeHash(encrypted);
            return rsaCSP.SignHash(hashedData, CryptoConfig.MapNameToOID("SHA1"));
        }

        //Encrypts using only the public key data.
        public byte[] EncryptData(RSAParameters rsaParams, byte[] toEncrypt)
        {
            RSACryptoServiceProvider rsaCSP = new RSACryptoServiceProvider();

            rsaCSP.ImportParameters(rsaParams);
            return rsaCSP.Encrypt(toEncrypt, false);
        }
    }

    class Receiver
    {
        RSAParameters rsaPubParams;
        RSAParameters rsaPrivateParams;

        public Receiver()
        {
            RSACryptoServiceProvider rsaCSP = new RSACryptoServiceProvider();

            //Generate public and private key data.
            rsaPrivateParams = rsaCSP.ExportParameters(true);
            rsaPubParams = rsaCSP.ExportParameters(false);
        }

        public RSAParameters PublicParameters
        {
            get
            {
                return rsaPubParams;
            }
        }

        //Manually performs hash and then verifies hashed value.
        public bool VerifyHash(RSAParameters rsaParams, byte[] signedData, byte[] signature)
        {
            RSACryptoServiceProvider rsaCSP = new RSACryptoServiceProvider();
            SHA1Managed hash = new SHA1Managed();
            byte[] hashedData;

            rsaCSP.ImportParameters(rsaParams);
            bool dataOK = rsaCSP.VerifyData(signedData, CryptoConfig.MapNameToOID("SHA1"), signature);
            hashedData = hash.ComputeHash(signedData);
            return rsaCSP.VerifyHash(hashedData, CryptoConfig.MapNameToOID("SHA1"), signature);
        }

        //Decrypt using the private key data.
        public void DecryptData(byte[] encrypted)
        {
            byte[] fromEncrypt;
            string roundTrip;
            ASCIIEncoding myAscii = new ASCIIEncoding();
            RSACryptoServiceProvider rsaCSP = new RSACryptoServiceProvider();

            rsaCSP.ImportParameters(rsaPrivateParams);
            fromEncrypt = rsaCSP.Decrypt(encrypted, false);
            roundTrip = myAscii.GetString(fromEncrypt);

            Console.WriteLine("RoundTrip: {0}", roundTrip);
        }
    }
}

Remarques

Cette méthode crée une signature numérique qui est vérifiée à l’aide de la VerifyHash méthode .

Les algorithmes de hachage valides sont SHA1 et MD5. L’identificateur de l’algorithme peut être dérivé du nom de hachage à l’aide de la MapNameToOID méthode .

En raison de problèmes de collision avec SHA1 et MD5, Microsoft recommande un modèle de sécurité basé sur SHA256 ou supérieur.

Voir aussi

• SignHash(Byte[], HashAlgorithmName, RSASignaturePadding)
• services de chiffrement

SignHash(Byte[], HashAlgorithmName, RSASignaturePadding)

Source:

RSACryptoServiceProvider.Unix.cs

Calcule la signature pour la valeur de hachage spécifiée à l’aide du remplissage spécifié.

C#

public override byte[] SignHash(byte[] hash, System.Security.Cryptography.HashAlgorithmName hashAlgorithm, System.Security.Cryptography.RSASignaturePadding padding);

Paramètres

hash

Byte[]

Valeur de hachage des données à signer.

hashAlgorithm

HashAlgorithmName

Nom de l’algorithme de hachage utilisé pour créer la valeur de hachage des données.

padding

RSASignaturePadding

Remplissage.

Retours

Byte[]

Signature RSA pour la valeur de hachage spécifiée.

Exceptions

ArgumentException

hashAlgorithm est null ou Empty.

ArgumentNullException

hash a la valeur null.

-ou-

padding a la valeur null.

CryptographicException

padding n’est pas égal à Pkcs1.