HMACSHA1 Clase

Definición

Espacio de nombres:

System.Security.Cryptography

Ensamblado:

System.Security.Cryptography.dll

Source:

HMACSHA1.cs

Calcula un código de autenticación de mensajes basado en hash (HMAC) mediante la función hash SHA1.

public ref class HMACSHA1 : System::Security::Cryptography::HMAC

public class HMACSHA1 : System.Security.Cryptography.HMAC

type HMACSHA1 = class
    inherit HMAC

Public Class HMACSHA1
Inherits HMAC

Herencia

Object

HashAlgorithm

KeyedHashAlgorithm

HMAC

HMACSHA1

Comentarios

HMACSHA1 es un tipo de algoritmo hash con clave que se construye a partir de la función hash SHA1 y se usa como un código de autenticación de mensajes basado en hash o HMAC. El proceso HMAC mezcla una clave secreta con los datos del mensaje, aplica un hash al resultado con la función hash, mezcla ese valor hash con la clave secreta de nuevo y, a continuación, aplica la función hash una segunda vez. El hash de salida tiene una longitud de 160 bits.

Se puede usar un HMAC para determinar si se ha alterado un mensaje enviado a través de un canal no seguro, siempre que el remitente y el receptor compartan una clave secreta. El remitente calcula el valor hash de los datos originales y envía los datos originales y el valor hash como un único mensaje. El receptor recalcula el valor hash en el mensaje recibido y comprueba que el HMAC calculado coincide con el HMAC transmitido.

Cualquier cambio en los datos o en el valor hash da lugar a un error de coincidencia, ya que se requiere el conocimiento de la clave secreta para cambiar el mensaje y reproducir el valor hash correcto. Por lo tanto, si los valores hash originales y calculados coinciden, el mensaje se autentica.

Sha-1 (algoritmo hash seguro, también denominado SHS, Secure Hash Standard) es un algoritmo hash criptográfico publicado por el Estados Unidos Government. Genera un valor hash de 160 bits a partir de una cadena de longitud arbitraria.

HMACSHA1 acepta claves de cualquier tamaño y genera una secuencia hash de 160 bits de longitud.

Debido a problemas de colisión con SHA1, Microsoft recomienda SHA256.

Constructores

HMACSHA1()	Inicializa una nueva instancia de la clase HMACSHA1 con una clave generada aleatoriamente.
HMACSHA1(Byte[])	Inicializa una nueva instancia de la clase HMACSHA1 con los datos de clave especificados.
HMACSHA1(Byte[], Boolean)	Obsoletos. Inicializa una nueva instancia de la clase HMACSHA1 con los datos de clave especificados y un valor que especifica si se debe usar la versión administrada del algoritmo SHA1.

Campos

HashSizeInBits	Tamaño hash generado por el algoritmo HMAC SHA1, en bits.
HashSizeInBytes	Tamaño hash generado por el algoritmo HMAC SHA1, en bytes.
HashSizeValue	Representa el tamaño en bits del código hash calculado. (Heredado de HashAlgorithm)
HashValue	Representa el valor del código hash calculado. (Heredado de HashAlgorithm)
KeyValue	Clave que se va a usar en el algoritmo hash. (Heredado de KeyedHashAlgorithm)
State	Representa el estado del cálculo del valor hash. (Heredado de HashAlgorithm)

Propiedades

BlockSizeValue	Obtiene o establece el tamaño de bloque que se va a usar en el valor hash. (Heredado de HMAC)
CanReuseTransform	Obtiene un valor que indica si la transformación actual puede volver a usarse. (Heredado de HashAlgorithm)
CanTransformMultipleBlocks	Cuando se invalida en una clase derivada, obtiene un valor que indica si se pueden transformar varios bloques. (Heredado de HashAlgorithm)
Hash	Obtiene el valor del código hash calculado. (Heredado de HashAlgorithm)
HashName	Obtiene o establece el nombre del algoritmo hash que se va a utilizar para la operación hash. (Heredado de HMAC)
HashSize	Obtiene el tamaño en bits del código hash calculado. (Heredado de HashAlgorithm)
InputBlockSize	Cuando se invalida en una clase derivada, obtiene el tamaño del bloque de entrada. (Heredado de HashAlgorithm)
Key	Obtiene o establece la clave que se va a usar en el algoritmo hash.
OutputBlockSize	Cuando se invalida en una clase derivada, obtiene el tamaño del bloque de salida. (Heredado de HashAlgorithm)

Métodos

Clear()	Libera todos los recursos que utiliza la clase HashAlgorithm. (Heredado de HashAlgorithm)
ComputeHash(Byte[])	Calcula el valor hash para la matriz de bytes especificada. (Heredado de HashAlgorithm)
ComputeHash(Byte[], Int32, Int32)	Calcula el valor hash para la región especificada de la matriz de bytes indicada. (Heredado de HashAlgorithm)
ComputeHash(Stream)	Calcula el valor hash del objeto Stream especificado. (Heredado de HashAlgorithm)
ComputeHashAsync(Stream, CancellationToken)	Calcula de manera asincrónica el valor hash del objeto Stream especificado. (Heredado de HashAlgorithm)
Dispose()	Libera todos los recursos usados por la instancia actual de la clase HashAlgorithm. (Heredado de HashAlgorithm)
Dispose(Boolean)	Este miembro reemplaza a Dispose(Boolean); puede haber documentación más completa en ese tema. Libera los recursos no administrados que usa KeyedHashAlgorithm y, de forma opcional, libera los recursos administrados.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
HashCore(Byte[], Int32, Int32)	Redirige los datos escritos en el objeto al algoritmo hash SHA1 para el cálculo del código de autenticación de mensajes basado en hash (HMAC).
HashCore(ReadOnlySpan<Byte>)	Envía los datos escritos en el objeto al algoritmo HMAC para el cálculo del HMAC.
HashData(Byte[], Byte[])	Calcula el HMAC de los datos mediante el algoritmo SHA1.
HashData(Byte[], Stream)	Calcula el HMAC de una secuencia mediante el algoritmo SHA1.
HashData(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)	Calcula el HMAC de los datos mediante el algoritmo SHA1.
HashData(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>)	Calcula el HMAC de los datos mediante el algoritmo SHA1.
HashData(ReadOnlySpan<Byte>, Stream)	Calcula el HMAC de una secuencia mediante el algoritmo SHA1.
HashData(ReadOnlySpan<Byte>, Stream, Span<Byte>)	Calcula el HMAC de una secuencia mediante el algoritmo SHA1.
HashDataAsync(Byte[], Stream, CancellationToken)	Calcula de forma asincrónica el HMAC de una secuencia mediante el algoritmo SHA1.
HashDataAsync(ReadOnlyMemory<Byte>, Stream, CancellationToken)	Calcula de forma asincrónica el HMAC de una secuencia mediante el algoritmo SHA1.
HashDataAsync(ReadOnlyMemory<Byte>, Stream, Memory<Byte>, CancellationToken)	Calcula de forma asincrónica el HMAC de una secuencia mediante el algoritmo SHA1.
HashFinal()	Finaliza el cálculo de HMAC una vez que el algoritmo procesa los últimos datos.
Initialize()	Restablece el algoritmo hash a su estado inicial.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
TransformBlock(Byte[], Int32, Int32, Byte[], Int32)	Calcula el valor hash para la región especificada de la matriz de bytes de entrada y copia la región especificada de la matriz de bytes de entrada resultante en la región indicada de la matriz de bytes de salida. (Heredado de HashAlgorithm)
TransformFinalBlock(Byte[], Int32, Int32)	Calcula el valor hash para la región especificada de la matriz de bytes indicada. (Heredado de HashAlgorithm)
TryComputeHash(ReadOnlySpan<Byte>, Span<Byte>, Int32)	Intenta calcular el valor de hash para la matriz de bytes especificada. (Heredado de HashAlgorithm)
TryHashData(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32)	Intenta calcular el HMAC de los datos mediante el algoritmo SHA1.
TryHashFinal(Span<Byte>, Int32)	Intenta finalizar el cálculo de HMAC una vez que el algoritmo HMAC procesa los últimos datos.

Consulte también

• servicios criptográficos