Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.
Traduzione
Originale
Questo argomento non è stato ancora valutato - Valuta questo argomento

Classe HMACSHA1

Calcola Hash-based Message Authentication Code (HMAC) tramite SHA1 funzione hash.

Spazio dei nomi:  System.Security.Cryptography
Assembly:  mscorlib (in mscorlib.dll)
[ComVisibleAttribute(true)]
public class HMACSHA1 : HMAC

Il tipo HMACSHA1 espone i seguenti membri.

  NomeDescrizione
Metodo pubblicoHMACSHA1()Inizializza una nuova istanza di HMACSHA1 classe con una chiave casualmente generata un'eccezione.
Metodo pubblicoHMACSHA1(Byte[])Inizializza una nuova istanza di HMACSHA1 classe con i dati chiave specificati.
Metodo pubblicoHMACSHA1(Byte[], Boolean)Inizializza una nuova istanza di HMACSHA1 classe con i dati chiave specificati e un valore che specifica se utilizzare la versione gestita dell'algoritmo SHA1.
In alto
  NomeDescrizione
Proprietà protetta.BlockSizeValueOttiene o imposta la dimensione di un blocco a utilizzare il valore hash. (Ereditato da HMAC)
Proprietà pubblicaCanReuseTransformottiene un valore che indica se la trasformazione corrente può essere riutilizzata. (Ereditato da HashAlgorithm)
Proprietà pubblicaCanTransformMultipleBlocksUna volta sottoposto a override in una classe derivata, ottiene un valore che indica se i blocchi più possono essere trasformati. (Ereditato da HashAlgorithm)
Proprietà pubblicaHashOttiene il valore del codice hash calcolato. (Ereditato da HashAlgorithm)
Proprietà pubblicaHashNameOttiene o imposta il nome di algoritmo hash da utilizzare per l'hashing. (Ereditato da HMAC)
Proprietà pubblicaHashSizeOttiene la dimensione, in bit, il codice hash calcolato. (Ereditato da HashAlgorithm)
Proprietà pubblicaInputBlockSizeUna volta sottoposto a override in una classe derivata, ottiene la dimensione di un blocco di input. (Ereditato da HashAlgorithm)
Proprietà pubblicaKeyOttiene o imposta la chiave da utilizzare nell'algoritmo hash. (Ereditato da HMAC)
Proprietà pubblicaOutputBlockSizeUna volta sottoposto a override in una classe derivata, ottiene la dimensione di un blocco di output. (Ereditato da HashAlgorithm)
In alto
  NomeDescrizione
Metodo pubblicoClearLibera tutte le risorse utilizzate da HashAlgorithm classe. (Ereditato da HashAlgorithm)
Metodo pubblicoComputeHash(Byte[])calcola il valore hash per la matrice di byte specificata. (Ereditato da HashAlgorithm)
Metodo pubblicoComputeHash(Stream)calcola il valore hash per specificato Stream oggetto. (Ereditato da HashAlgorithm)
Metodo pubblicoComputeHash(Byte[], Int32, Int32)Calcola il valore hash per l'area specificata di una matrice di byte specificata. (Ereditato da HashAlgorithm)
Metodo pubblicoDispose()Libera tutte le risorse utilizzate dall'istanza corrente di HashAlgorithm classe. (Ereditato da HashAlgorithm)
Metodo protettoDispose(Boolean)Rilascia risorse non gestite utilizzate da HMAC classe quando una modifica della chiave è legittima e facoltativamente dealloca risorse gestite. (Ereditato da HMAC)
Metodo pubblicoEquals(Object) Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Metodo protettoFinalize Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto stesso venga reclamato dalla procedura di Garbage Collection. (Ereditato da Object)
Metodo pubblicoGetHashCodeFunge da funzione hash per un determinato tipo. (Ereditato da Object)
Metodo pubblicoGetTypeOttiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Metodo protettoHashCoreUna volta sottoposto a override in una classe derivata da, i dati della route scritto nell'oggetto impostazione predefinita HMAC algoritmo hash per calcolare il valore hash. (Ereditato da HMAC)
Metodo protettoHashFinalUna volta sottoposto a override in una classe derivata, viene completato il calcolo di hash dopo che gli ultimi dati vengono elaborati dall'oggetto flusso di crittografia. (Ereditato da HMAC)
Metodo pubblicoInitializeInizializza un'istanza dell'implementazione predefinita di HMAC. (Ereditato da HMAC)
Metodo protettoMemberwiseCloneConsente di creare una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
Metodo pubblicoToString Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
Metodo pubblicoTransformBlockCalcola il valore hash per l'area specificata di una matrice di byte di input e copia area specificata per la matrice di byte di input all'area specificata di una matrice di byte di output. (Ereditato da HashAlgorithm)
Metodo pubblicoTransformFinalBlockCalcola il valore hash per l'area specificata di una matrice di byte specificata. (Ereditato da HashAlgorithm)
In alto
  NomeDescrizione
Campo protettoHashSizeValueRappresenta la dimensione, in bit, il codice hash calcolato. (Ereditato da HashAlgorithm)
Campo protettoHashValueRappresenta il valore del codice hash calcolato. (Ereditato da HashAlgorithm)
Campo protettoKeyValueLa chiave da utilizzare nell'algoritmo hash. (Ereditato da KeyedHashAlgorithm)
Campo protettoStateRappresenta lo stato del calcolo hash. (Ereditato da HashAlgorithm)
In alto

HMACSHA1 è un tipo di algoritmo hash con chiavi che viene creato dalla funzione hash SHA1 e viene utilizzato come HMAC, o di codice basato su hash di autenticazione messaggi. Il processo HMAC scrum una chiave privata i dati del messaggio, esegue l'hashing il risultato con la funzione hash, combinazioni che il valore hash con la chiave privata ancora quindi applica la funzione hash una seconda volta. L'hash di output è 160 bit di lunghezza.

Un HMAC può essere utilizzato per determinare se un messaggio inviato su un canale non protetto è stato alterato, a condizione che il mittente e il ricevente condividono una chiave privata. Il mittente calcola il valore hash dei dati originali e invia i dati originali che il valore hash come singolo messaggio. Il ricevitore ricalcola il valore hash sul messaggio e i controlli prima che il HMAC calcolato corrisponde al HMAC di trasmissione.

Qualsiasi modifica apportata ai dati o il valore hash comporta una mancata corrispondenza, perché la conoscenza della chiave privata è obbligatoria per modificare il messaggio e riprodurre il valore hash corretto. Pertanto, se la versione originale e la corrispondenza calcolata di valori hash corrispondono, il messaggio viene autenticato.

Lo SHA-1 (Secure Hash Algorithm), denominati anche SHS, standard sicuro hash) è un algoritmo hash di crittografia pubblicato il governo degli Stati Uniti. Genera un valore hash a 160 bit da una stringa arbitraria di lunghezza.

HMACSHA1 accetta chiavi di qualsiasi dimensione e produce una sequenza di hash che esegue a 160 bit di lunghezza.

Nell'esempio di codice come firmare un file tramite HMACSHA1 oggetto e come testare il file.


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

public class HMACSHA1example
{

    public static void Main(string[] Fileargs)
    {
        string dataFile;
        string signedFile;
        //If no file names are specified, create them.
        if (Fileargs.Length < 2)
        {
            dataFile = @"text.txt";
            signedFile = "signedFile.enc";

            if (!File.Exists(dataFile))
            {
                // Create a file to write to.
                using (StreamWriter sw = File.CreateText(dataFile))
                {
                    sw.WriteLine("Here is a message to sign");
                }
            }

        }
        else
        {
            dataFile = Fileargs[0];
            signedFile = Fileargs[1];
        }
        try
        {
            // Create a random key using a random number generator. This would be the
            //  secret key shared by sender and receiver.
            byte[] secretkey = new Byte[64];
            //RNGCryptoServiceProvider is an implementation of a random number generator.
            using (RNGCryptoServiceProvider rng = new RNGCryptoServiceProvider())
            {
                // The array is now filled with cryptographically strong random bytes.
                rng.GetBytes(secretkey);

                // Use the secret key to sign the message file.
                SignFile(secretkey, dataFile, signedFile);

                // Verify the signed file
                VerifyFile(secretkey, signedFile);
            }
        }
        catch (IOException e)
        {
            Console.WriteLine("Error: File not found", e);
        }

    }  //end main
    // Computes a keyed hash for a source file and creates a target file with the keyed hash
    // prepended to the contents of the source file. 
    public static void SignFile(byte[] key, String sourceFile, String destFile)
    {
        // Initialize the keyed hash object.
        using (HMACSHA1 hmac = new HMACSHA1(key))
        {
            using (FileStream inStream = new FileStream(sourceFile, FileMode.Open))
            {
                using (FileStream outStream = new FileStream(destFile, FileMode.Create))
                {
                    // Compute the hash of the input file.
                    byte[] hashValue = hmac.ComputeHash(inStream);
                    // Reset inStream to the beginning of the file.
                    inStream.Position = 0;
                    // Write the computed hash value to the output file.
                    outStream.Write(hashValue, 0, hashValue.Length);
                    // Copy the contents of the sourceFile to the destFile.
                    int bytesRead;
                    // read 1K at a time
                    byte[] buffer = new byte[1024];
                    do
                    {
                        // Read from the wrapping CryptoStream.
                        bytesRead = inStream.Read(buffer, 0, 1024);
                        outStream.Write(buffer, 0, bytesRead);
                    } while (bytesRead > 0);
                }
            }
        }
        return;
    } // end SignFile


    // Compares the key in the source file with a new key created for the data portion of the file. If the keys 
    // compare the data has not been tampered with.
    public static bool VerifyFile(byte[] key, String sourceFile)
    {
        bool err = false;
        // Initialize the keyed hash object. 
        using (HMACSHA1 hmac = new HMACSHA1(key))
        {
            // Create an array to hold the keyed hash value read from the file.
            byte[] storedHash = new byte[hmac.HashSize / 8];
            // Create a FileStream for the source file.
            using (FileStream inStream = new FileStream(sourceFile, FileMode.Open))
            {
                // Read in the storedHash.
                inStream.Read(storedHash, 0, storedHash.Length);
                // Compute the hash of the remaining contents of the file.
                // The stream is properly positioned at the beginning of the content, 
                // immediately after the stored hash value.
                byte[] computedHash = hmac.ComputeHash(inStream);
                // compare the computed hash with the stored value

                for (int i = 0; i < storedHash.Length; i++)
                {
                    if (computedHash[i] != storedHash[i])
                    {
                        err = true;
                    }
                }
            }
        }
        if (err)
        {
            Console.WriteLine("Hash values differ! Signed file has been tampered with!");
            return false;
        }
        else
        {
            Console.WriteLine("Hash values agree -- no tampering occurred.");
            return true;
        }

    } //end VerifyFile

} //end class


.NET Framework

Supportato in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.
Il documento è risultato utile?
(1500 caratteri rimanenti)

Aggiunte alla community

AGGIUNGI
© 2013 Microsoft. Tutti i diritti riservati.