ECDsaCng Clase

Definición

Espacio de nombres:

System.Security.Cryptography

Ensamblado:

System.Security.Cryptography.dll

Source:

Cng.NotSupported.cs

Proporciona una implementación de CNG (Cryptography Next Generation) del algoritmo ECDSA (Elliptic Curve Digital Signature Algorithm).

public ref class ECDsaCng sealed : System::Security::Cryptography::ECDsa

public sealed class ECDsaCng : System.Security.Cryptography.ECDsa

type ECDsaCng = class
    inherit ECDsa

Public NotInheritable Class ECDsaCng
Inherits ECDsa

Herencia

Object

AsymmetricAlgorithm

ECAlgorithm

ECDsa

ECDsaCng

Ejemplos

En el ejemplo siguiente se muestra cómo usar la ECDsaCng clase para firmar un mensaje y cómo usar la firma para comprobar que el mensaje no se ha modificado.

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

class Alice
{
    public static void Main(string[] args)
    {
        Bob bob = new Bob();
        using (ECDsaCng dsa = new ECDsaCng())
        {
            dsa.HashAlgorithm = CngAlgorithm.Sha256;
             bob.key = dsa.Key.Export(CngKeyBlobFormat.EccPublicBlob);

             byte[] data = new byte[] { 21, 5, 8, 12, 207 };

             byte[] signature = dsa.SignData(data);

             bob.Receive(data, signature);
            }
    }
}
public class Bob
{
    public byte[] key;

    public void Receive(byte[] data, byte[] signature)
    {
        using (ECDsaCng ecsdKey = new ECDsaCng(CngKey.Import(key, CngKeyBlobFormat.EccPublicBlob)))
        {
            if (ecsdKey.VerifyData(data, signature))
                Console.WriteLine("Data is good");
            else
                Console.WriteLine("Data is bad");
        }
    }
}

Imports System.IO
Imports System.Security.Cryptography
Imports System.Text

Class Alice

    Public Shared Sub Main(ByVal args() As String)
        Dim bob As New Bob()
        If (True) Then
            Using dsa As New ECDsaCng()
                    dsa.HashAlgorithm = CngAlgorithm.Sha256
                    bob.key = dsa.Key.Export(CngKeyBlobFormat.EccPublicBlob)
                    Dim data() As Byte = {21, 5, 8, 12, 207}
                    Dim signature As Byte() = dsa.SignData(data)
                    bob.Receive(data, signature)
            End Using
        End If

    End Sub
End Class


Public Class Bob
    Public key() As Byte

    Public Sub Receive(ByVal data() As Byte, ByVal signature() As Byte)
        Using ecsdKey As New ECDsaCng(CngKey.Import(key, CngKeyBlobFormat.EccPublicBlob))
                If ecsdKey.VerifyData(data, signature) Then
                    Console.WriteLine("Data is good")
                Else
                    Console.WriteLine("Data is bad")
                End If
        End Using

    End Sub
End Class

Comentarios

Esta clase solo se debe usar directamente al realizar la interoperabilidad de la plataforma con la biblioteca CNG de Windows. Cuando no se necesita la interoperabilidad de la plataforma, debe usar los ECDsa.Create métodos de fábrica en lugar de una implementación derivada específica.

Constructores

ECDsaCng()	Inicializa una nueva instancia de la clase ECDsaCng con un par de claves aleatorio.
ECDsaCng(CngKey)	Inicializa una nueva instancia de la clase ECDsaCng mediante el objeto CngKey especificado.
ECDsaCng(ECCurve)	Inicializa una nueva instancia de la clase ECDsaCng cuyo par de claves pública-privada se genera sobre la curva especificada.
ECDsaCng(Int32)	Inicializa una nueva instancia de la clase ECDsaCng con un tamaño de clave de destino especificado.

Campos

KeySizeValue	Representa el tamaño, en bits, del módulo de claves que usa el algoritmo asimétrico. (Heredado de AsymmetricAlgorithm)
LegalKeySizesValue	Especifica los tamaños de clave admitidos por el algoritmo asimétrico. (Heredado de AsymmetricAlgorithm)

Propiedades

HashAlgorithm	Obtiene o establece el algoritmo hash que se utiliza en la firma y comprobación de datos
Key	Obtiene o establece la clave que se debe usar para firmar y comprobar datos.
KeyExchangeAlgorithm	Obtiene el nombre del algoritmo de intercambio de claves. (Heredado de ECDsa)
KeySize	Obtiene o establece el tamaño, en bits, del módulo de claves que usa el algoritmo asimétrico.
LegalKeySizes	Obtiene los tamaños de clave, en bits, admitidos por el establecedor de propiedad KeySize.
SignatureAlgorithm	Obtiene el nombre del algoritmo de firma. (Heredado de ECDsa)

Métodos

Clear()	Libera todos los recursos que utiliza la clase AsymmetricAlgorithm. (Heredado de AsymmetricAlgorithm)
Dispose()	Libera todos los recursos usados por la instancia actual de la clase AsymmetricAlgorithm. (Heredado de AsymmetricAlgorithm)
Dispose(Boolean)	Libera los recursos no administrados utilizados por la clase AsymmetricAlgorithm y, de forma opcional, libera los recursos administrados. (Heredado de AsymmetricAlgorithm)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
ExportECPrivateKey()	Exporta la clave actual en el formato ECPrivateKey. (Heredado de ECDsa)
ExportECPrivateKeyPem()	Exporta la clave actual en formato ECPrivateKey, codificada en PEM. (Heredado de ECAlgorithm)
ExportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, PbeParameters)	Exporta la clave actual en el formato EncryptedPrivateKeyInfo de PKCS#8 con una contraseña basada en bytes.
ExportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, PbeParameters)	Exporta la clave actual en el formato EncryptedPrivateKeyInfo de PKCS#8 con una contraseña basada en caracteres.
ExportEncryptedPkcs8PrivateKeyPem(ReadOnlySpan<Byte>, PbeParameters)	Exporta la clave actual en el formato EncryptedPrivateKeyInfo de PKCS#8 con una contraseña basada en bytes, PEM codificada. (Heredado de AsymmetricAlgorithm)
ExportEncryptedPkcs8PrivateKeyPem(ReadOnlySpan<Char>, PbeParameters)	Exporta la clave actual en el formato EncryptedPrivateKeyInfo de PKCS#8 con una contraseña basada en caracteres, codificada en PEM. (Heredado de AsymmetricAlgorithm)
ExportExplicitParameters(Boolean)	Exporta la clave y parámetros de curva explícitos que usa el objeto de criptografía de curva elíptica (ECC) en un objeto ECParameters.
ExportParameters(Boolean)	Exporta la clave usada por el objeto de criptografía de curva elíptica (ECC) en un objeto ECParameters. Si la clave se creó como una curva con nombre, el campo Curve contiene parámetros de curva con nombre; en caso contrario, contiene parámetros explícitos.
ExportPkcs8PrivateKey()	Exporta la clave actual en el formato PrivateKeyInfo de PKCS#8. (Heredado de AsymmetricAlgorithm)
ExportPkcs8PrivateKeyPem()	Exporta la clave actual en el formato PKCS#8 PrivateKeyInfo, con codificación PEM. (Heredado de AsymmetricAlgorithm)
ExportSubjectPublicKeyInfo()	Exporta la parte de la clave pública de la clave actual en el formato SubjectPublicKeyInfo de X.509. (Heredado de AsymmetricAlgorithm)
ExportSubjectPublicKeyInfoPem()	Exporta la parte de clave pública de la clave actual en el formato SubjectPublicKeyInfo X.509, codificado en PEM. (Heredado de AsymmetricAlgorithm)
FromXmlString(String)	Se produce este método en todos los casos. (Heredado de ECDsa)
FromXmlString(String, ECKeyXmlFormat)	Obsoletos. Deserializa la información de clave de una cadena XML mediante el formato especificado.
GenerateKey(ECCurve)	Genera un nuevo par de claves pública-privada efímeras para la curva especificada y reemplaza la clave actual.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetMaxSignatureSize(DSASignatureFormat)	Obtiene el tamaño más grande, en bytes, para una firma generada por esta clave en el formato indicado. (Heredado de ECDsa)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
HashData(Byte[], Int32, Int32, HashAlgorithmName)	Cuando se reemplaza en una clase derivada, calcula el valor hash de la parte especificada de una matriz de bytes usando el algoritmo hash especificado. (Heredado de ECDsa)
HashData(Stream, HashAlgorithmName)	Cuando se reemplaza en una clase derivada, calcula el valor hash de la secuencia binaria especificada usando el algoritmo hash especificado. (Heredado de ECDsa)
ImportECPrivateKey(ReadOnlySpan<Byte>, Int32)	Importa el par de claves pública/privada desde una estructura ECPrivateKey, reemplazando las claves de este objeto. (Heredado de ECDsa)
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32)	Importa el par de claves pública/privada desde una estructura EncryptedPrivateKeyInfo de PKCS#8 después de descifrar con una contraseña basada en bytes, reemplazando las claves de este objeto.
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Int32)	Importa el par de claves pública/privada desde una estructura EncryptedPrivateKeyInfo de PKCS#8 después de descifrar con una contraseña basada en caracteres, reemplazando las claves de este objeto.
ImportFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)	Importa una clave privada codificada con PEM RFC 7468 cifrada, reemplazando las claves de este objeto. (Heredado de ECDsa)
ImportFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	Importa una clave privada codificada con PEM RFC 7468 cifrada, reemplazando las claves de este objeto. (Heredado de ECDsa)
ImportFromPem(ReadOnlySpan<Char>)	Importa una clave codificada con PEM RFC 7468, reemplazando las claves de este objeto. (Heredado de ECDsa)
ImportParameters(ECParameters)	Reemplaza la clave existente con la que funciona la instancia actual mediante la creación de un nuevo CngKey para la estructura de parámetros.
ImportPkcs8PrivateKey(ReadOnlySpan<Byte>, Int32)	Importa el par de claves pública/privada desde una estructura PrivateKeyInfo de PKCS#8 después del descifrado, reemplazando las claves de este objeto.
ImportSubjectPublicKeyInfo(ReadOnlySpan<Byte>, Int32)	Importa la clave pública desde una estructura SubjectPublicKeyInfo de X.509 después del descifrado, reemplazando las claves de este objeto. (Heredado de ECDsa)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
SignData(Byte[])	Genera una firma para los datos especificados.
SignData(Byte[], HashAlgorithmName)	Calcula el valor hash de la matriz de bytes especificada usando el algoritmo hash especificado y firma el valor hash resultante. (Heredado de ECDsa)
SignData(Byte[], HashAlgorithmName, DSASignatureFormat)	Calcula el valor hash de los datos especificados y lo firma con el formato de firma especificado. (Heredado de ECDsa)
SignData(Byte[], Int32, Int32)	Genera una firma digital para la longitud de datos especificada, comenzando en el desplazamiento especificado.
SignData(Byte[], Int32, Int32, HashAlgorithmName)	Calcula el valor hash de una parte de la matriz de bytes especificada usando el algoritmo hash especificado y firma el valor hash resultante. (Heredado de ECDsa)
SignData(Byte[], Int32, Int32, HashAlgorithmName, DSASignatureFormat)	Calcula el valor hash de los datos especificados y lo firma con el formato de firma especificado. (Heredado de ECDsa)
SignData(ReadOnlySpan<Byte>, HashAlgorithmName)	Calcula el valor hash de los datos especificados y lo firma. (Heredado de ECDsa)
SignData(ReadOnlySpan<Byte>, HashAlgorithmName, DSASignatureFormat)	Calcula el valor hash de los datos especificados y lo firma con el formato de firma especificado. (Heredado de ECDsa)
SignData(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName)	Calcula el valor hash de los datos especificados y lo firma en el formato indicado en el búfer proporcionado. (Heredado de ECDsa)
SignData(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName, DSASignatureFormat)	Calcula el valor hash de los datos especificados y lo firma en el formato indicado en el búfer proporcionado. (Heredado de ECDsa)
SignData(Stream)	Genera una firma para el flujo de datos especificado, leyendo hasta el final del flujo.
SignData(Stream, HashAlgorithmName)	Calcula el valor hash de la secuencia especificada usando el algoritmo hash especificado y firma el valor hash resultante. (Heredado de ECDsa)
SignData(Stream, HashAlgorithmName, DSASignatureFormat)	Calcula el valor hash de los datos especificados y lo firma con el formato de firma especificado. (Heredado de ECDsa)
SignDataCore(ReadOnlySpan<Byte>, HashAlgorithmName, DSASignatureFormat)	Calcula el valor hash de los datos especificados y lo firma con el formato de firma especificado. (Heredado de ECDsa)
SignDataCore(Stream, HashAlgorithmName, DSASignatureFormat)	Calcula el valor hash de los datos especificados y lo firma con el formato de firma especificado. (Heredado de ECDsa)
SignHash(Byte[])	Genera una firma del valor hash especificado.
SignHash(Byte[], DSASignatureFormat)	Calcula la firma ECDSA para el valor hash especificado en el formato indicado. (Heredado de ECDsa)
SignHash(ReadOnlySpan<Byte>)	Calcula la firma ECDSA para el valor hash especificado. (Heredado de ECDsa)
SignHash(ReadOnlySpan<Byte>, DSASignatureFormat)	Calcula la firma ECDSA para el valor hash especificado en el formato indicado. (Heredado de ECDsa)
SignHash(ReadOnlySpan<Byte>, Span<Byte>)	Calcula la firma ECDSA para el valor hash especificado en el búfer proporcionado. (Heredado de ECDsa)
SignHash(ReadOnlySpan<Byte>, Span<Byte>, DSASignatureFormat)	Calcula la firma ECDSA para el valor hash especificado en el formato indicado en el búfer proporcionado. (Heredado de ECDsa)
SignHashCore(ReadOnlySpan<Byte>, DSASignatureFormat)	Calcula la firma ECDSA para el valor hash especificado en el formato indicado. (Heredado de ECDsa)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
ToXmlString(Boolean)	Se produce este método en todos los casos. (Heredado de ECDsa)
ToXmlString(ECKeyXmlFormat)	Obsoletos. Serializa la información de clave en una cadena XML mediante el formato especificado.
TryExportECPrivateKey(Span<Byte>, Int32)	Intenta exportar la clave actual en el formato ECPrivateKey a un búfer proporcionado. (Heredado de ECDsa)
TryExportECPrivateKeyPem(Span<Char>, Int32)	Intenta exportar la clave actual en el formato ECPrivateKey codificado en PEM a un búfer proporcionado. (Heredado de ECAlgorithm)
TryExportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, PbeParameters, Span<Byte>, Int32)	Intenta exportar la clave actual en el formato EncryptedPrivateKeyInfo de PKCS#8 a un búfer proporcionado, utilizando una contraseña basada en bytes.
TryExportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, PbeParameters, Span<Byte>, Int32)	Intenta exportar la clave actual en el formato EncryptedPrivateKeyInfo de PKCS#8 a un búfer proporcionado, utilizando una contraseña basada en caracteres.
TryExportEncryptedPkcs8PrivateKeyPem(ReadOnlySpan<Byte>, PbeParameters, Span<Char>, Int32)	Intenta exportar la clave actual en el formato EncryptedPrivateKeyInfo de PKCS#8 con una contraseña basada en bytes, PEM codificada. (Heredado de AsymmetricAlgorithm)
TryExportEncryptedPkcs8PrivateKeyPem(ReadOnlySpan<Char>, PbeParameters, Span<Char>, Int32)	Exporta la clave actual en el formato EncryptedPrivateKeyInfo de PKCS#8 con una contraseña basada en caracteres, codificada en PEM. (Heredado de AsymmetricAlgorithm)
TryExportPkcs8PrivateKey(Span<Byte>, Int32)	Intenta exportar la clave actual en el formato PrivateKeyInfo de PKCS#8 a un búfer proporcionado.
TryExportPkcs8PrivateKeyPem(Span<Char>, Int32)	Intenta exportar la clave actual en el formato PKCS#8 PrivateKeyInfo codificado en PEM en un búfer proporcionado. (Heredado de AsymmetricAlgorithm)
TryExportSubjectPublicKeyInfo(Span<Byte>, Int32)	Intenta exportar la clave actual en el formato SubjectPublicKeyInfo de X.509 a un búfer proporcionado. (Heredado de ECDsa)
TryExportSubjectPublicKeyInfoPem(Span<Char>, Int32)	Intenta exportar la clave actual en el formato X.509 SubjectPublicKeyInfo codificado en PEM en un búfer proporcionado. (Heredado de AsymmetricAlgorithm)
TryHashData(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName, Int32)	Intenta calcular el valor hash del intervalo de bytes de solo lectura especificado en el destino proporcionado mediante el algoritmo hash especificado. (Heredado de ECDsa)
TrySignData(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName, DSASignatureFormat, Int32)	Intenta crear la firma ECDSA para los datos especificados en el formato indicado en el búfer proporcionado. (Heredado de ECDsa)
TrySignData(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName, Int32)	Intenta calcular la firma digital ECDSA del intervalo de bytes de solo lectura especificado en el destino proporcionado mediante el algoritmo hash especificado y la clave actual. (Heredado de ECDsa)
TrySignDataCore(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName, DSASignatureFormat, Int32)	Intenta crear la firma ECDSA para los datos especificados en el formato indicado en el búfer proporcionado. (Heredado de ECDsa)
TrySignHash(ReadOnlySpan<Byte>, Span<Byte>, DSASignatureFormat, Int32)	Intenta crear la firma ECDSA para el valor hash especificado en el formato indicado en el búfer proporcionado. (Heredado de ECDsa)
TrySignHash(ReadOnlySpan<Byte>, Span<Byte>, Int32)	Intenta calcular la firma digital ECDSA del intervalo de bytes de solo lectura especificado que representa un hash de datos en el destino proporcionado mediante la clave actual.
TrySignHashCore(ReadOnlySpan<Byte>, Span<Byte>, DSASignatureFormat, Int32)	Intenta crear la firma ECDSA para el valor hash especificado en el formato indicado en el búfer proporcionado. (Heredado de ECDsa)
VerifyData(Byte[], Byte[])	Comprueba la firma digital de los datos especificados.
VerifyData(Byte[], Byte[], HashAlgorithmName)	Comprueba si una firma digital es adecuada para la clave actual y proporciona datos con un algoritmo hash especificado. (Heredado de ECDsa)
VerifyData(Byte[], Byte[], HashAlgorithmName, DSASignatureFormat)	Comprueba que una firma digital sea válida para los datos proporcionados. (Heredado de ECDsa)
VerifyData(Byte[], Int32, Int32, Byte[])	Comprueba una firma para la longitud de datos especificada, comenzando en el desplazamiento especificado.
VerifyData(Byte[], Int32, Int32, Byte[], HashAlgorithmName)	Comprueba que una firma digital es adecuada para la clave actual y proporciona la parte de los datos un algoritmo hash especificado. (Heredado de ECDsa)
VerifyData(Byte[], Int32, Int32, Byte[], HashAlgorithmName, DSASignatureFormat)	Comprueba que una firma digital sea válida para los datos proporcionados. (Heredado de ECDsa)
VerifyData(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, HashAlgorithmName)	Comprueba si una firma digital es adecuada para la clave actual y proporciona datos con un algoritmo hash especificado. (Heredado de ECDsa)
VerifyData(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, HashAlgorithmName, DSASignatureFormat)	Comprueba que una firma digital sea válida para los datos proporcionados. (Heredado de ECDsa)
VerifyData(Stream, Byte[])	Comprueba la firma digital del flujo de datos especificado, leyendo hasta el final del flujo.
VerifyData(Stream, Byte[], HashAlgorithmName)	Comprueba si una firma digital es adecuada para la clave actual y proporciona datos con un algoritmo hash especificado. (Heredado de ECDsa)
VerifyData(Stream, Byte[], HashAlgorithmName, DSASignatureFormat)	Comprueba que una firma digital sea válida para los datos proporcionados. (Heredado de ECDsa)
VerifyDataCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, HashAlgorithmName, DSASignatureFormat)	Comprueba que una firma digital sea válida para los datos proporcionados. (Heredado de ECDsa)
VerifyDataCore(Stream, ReadOnlySpan<Byte>, HashAlgorithmName, DSASignatureFormat)	Comprueba que una firma digital sea válida para los datos proporcionados. (Heredado de ECDsa)
VerifyHash(Byte[], Byte[])	Comprueba que una firma digital es adecuada para la clave actual y el hash de datos proporcionado.
VerifyHash(Byte[], Byte[], DSASignatureFormat)	Comprueba que una firma digital es válida para el hash proporcionado. (Heredado de ECDsa)
VerifyHash(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)	Comprueba que una firma digital es adecuada para la clave actual y el hash de datos proporcionado.
VerifyHash(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, DSASignatureFormat)	Comprueba que una firma digital es válida para el hash proporcionado. (Heredado de ECDsa)
VerifyHashCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, DSASignatureFormat)	Comprueba que una firma digital es válida para el hash proporcionado. (Heredado de ECDsa)