ECDsaCng Classe

Definição

Namespace:

System.Security.Cryptography

Assembly:

System.Security.Cryptography.dll

Origem:

Cng.NotSupported.cs

Fornece uma implementação CNG (Cryptography Next Generation) do ECDSA (Algoritmo de Assinatura Digital de Curva Elíptica).

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

Herança

Object

AsymmetricAlgorithm

ECAlgorithm

ECDsa

ECDsaCng

Exemplos

O exemplo a seguir mostra como usar a ECDsaCng classe para assinar uma mensagem e como usar a assinatura para verificar se a mensagem não foi alterada.

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

Comentários

Essa classe só deve ser usada diretamente ao fazer interoperabilidade de plataforma com a biblioteca CNG do Windows. Quando a interoperabilidade de plataforma não for necessária, você deverá usar os ECDsa.Create métodos de fábrica em vez de uma implementação derivada específica.

Construtores

ECDsaCng()	Inicializa uma nova instância da classe ECDsaCng com um par de chaves aleatório.
ECDsaCng(CngKey)	Inicializa uma nova instância da classe ECDsaCng usando o objeto CngKey especificado.
ECDsaCng(ECCurve)	Inicializa uma nova instância da classe ECDsaCng cujo par de chaves pública/privada é gerado ao longo da curva especificada.
ECDsaCng(Int32)	Inicializa uma nova instância da classe ECDsaCng com um tamanho de chave de destino especificado.

Campos

KeySizeValue	Representa o tamanho, em bits, do módulo chave usado pelo algoritmo assimétrico. (Herdado de AsymmetricAlgorithm)
LegalKeySizesValue	Especifica os tamanhos de chave que são compatíveis com o algoritmo assimétrico. (Herdado de AsymmetricAlgorithm)

Propriedades

HashAlgorithm	Obtém ou define o algoritmo de chave a ser usado ao assinar e verificar os dados.
Key	Obtém ou define a chave a ser usada ao assinar e verificar dados.
KeyExchangeAlgorithm	Obtém o nome do algoritmo de troca de chaves. (Herdado de ECDsa)
KeySize	Obtém ou define o tamanho, em bits, do módulo chave usado pelo algoritmo assimétrico.
LegalKeySizes	Obtém os tamanhos de chave, em bits, compatíveis com o setter de propriedade KeySize.
SignatureAlgorithm	Obtém o nome do algoritmo de assinatura. (Herdado de ECDsa)

Métodos

Clear()	Libera todos os recursos usados pela classe AsymmetricAlgorithm. (Herdado de AsymmetricAlgorithm)
Dispose()	Libera todos os recursos usados pela instância atual da classe AsymmetricAlgorithm. (Herdado de AsymmetricAlgorithm)
Dispose(Boolean)	Libera os recursos não gerenciados usados pela classe AsymmetricAlgorithm e, opcionalmente, libera os recursos gerenciados. (Herdado de AsymmetricAlgorithm)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
ExportECPrivateKey()	Exporta a chave atual no formato ECPrivateKey. (Herdado de ECDsa)
ExportECPrivateKeyPem()	Exporta a chave atual no formato ECPrivateKey, codificado em PEM. (Herdado de ECAlgorithm)
ExportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, PbeParameters)	Exporta a chave atual no formato EncryptedPrivateKeyInfo do PKCS nº 8 com uma senha baseada em bytes.
ExportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, PbeParameters)	Exporta a chave atual no formato EncryptedPrivateKeyInfo do PKCS nº 8 com uma senha baseada em caracteres.
ExportEncryptedPkcs8PrivateKeyPem(ReadOnlySpan<Byte>, PbeParameters)	Exporta a chave atual no formato PKCS#8 EncryptedPrivateKeyInfo com uma senha baseada em bytes, codificada em PEM. (Herdado de AsymmetricAlgorithm)
ExportEncryptedPkcs8PrivateKeyPem(ReadOnlySpan<Char>, PbeParameters)	Exporta a chave atual no formato PKCS#8 EncryptedPrivateKeyInfo com uma senha baseada em caracteres, codificada em PEM. (Herdado de AsymmetricAlgorithm)
ExportExplicitParameters(Boolean)	Exporta os parâmetros de chave e curva explícita usados pelo objeto de criptografia de curva elíptica (ECC) em um objeto ECParameters.
ExportParameters(Boolean)	Exporta a chave usada pelo objeto de criptografia de curva elíptica (ECC) em um objeto ECParameters. Se a chave foi criada como uma curva nomeada, o campo Curve contém parâmetros de curva nomeada; caso contrário, ele contém parâmetros explícitos.
ExportPkcs8PrivateKey()	Exporta a chave atual no formato PrivateKeyInfo do PKCS nº 8. (Herdado de AsymmetricAlgorithm)
ExportPkcs8PrivateKeyPem()	Exporta a chave atual no formato PKCS#8 PrivateKeyInfo, codificado em PEM. (Herdado de AsymmetricAlgorithm)
ExportSubjectPublicKeyInfo()	Exporta a parte pública da chave atual no formato SubjectPublicKeyInfo X.509. (Herdado de AsymmetricAlgorithm)
ExportSubjectPublicKeyInfoPem()	Exporta a parte de chave pública da chave atual no formato SubjectPublicKeyInfo X.509, codificado em PEM. (Herdado de AsymmetricAlgorithm)
FromXmlString(String)	Esse método é gerado em todos os casos. (Herdado de ECDsa)
FromXmlString(String, ECKeyXmlFormat)	Obsoleto. Desserializa as informações da chave de uma cadeia de caracteres XML usando o formato especificado.
GenerateKey(ECCurve)	Gera um novo par de chaves pública/privada efêmero para a curva especificada, que substitui a chave atual.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetMaxSignatureSize(DSASignatureFormat)	Obtém o maior tamanho, em bytes, de uma assinatura produzida por essa chave no formato indicado. (Herdado de ECDsa)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
HashData(Byte[], Int32, Int32, HashAlgorithmName)	Quando substituído em uma classe derivada, calcula o valor de hash de uma parte especificada de uma matriz de bytes usando o algoritmo de hash especificado. (Herdado de ECDsa)
HashData(Stream, HashAlgorithmName)	Quando substituído em uma classe derivada, calcula o valor de hash do fluxo binário especificado usando um algoritmo de hash especificado. (Herdado de ECDsa)
ImportECPrivateKey(ReadOnlySpan<Byte>, Int32)	Importa o par de chaves pública/privada de uma estrutura de ECPrivateKey, substituindo as chaves desse objeto. (Herdado de ECDsa)
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32)	Importa o par de chaves pública/privada de uma estrutura de EncryptedPrivateKeyInfo do PKCS nº 8 após descriptografar com uma senha baseada em bytes, substituindo as chaves desse objeto.
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Int32)	Importa o par de chaves pública/privada de uma estrutura de EncryptedPrivateKeyInfo do PKCS nº 8 após descriptografar com uma senha baseada em caracteres, substituindo as chaves desse objeto.
ImportFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)	Importa uma chave privada criptografada no formato PEM conforme RFC 7468, substituindo as chaves do objeto. (Herdado de ECDsa)
ImportFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	Importa uma chave privada criptografada no formato PEM conforme RFC 7468, substituindo as chaves do objeto. (Herdado de ECDsa)
ImportFromPem(ReadOnlySpan<Char>)	Importa uma chave codificada no formato PEM do RFC 7468, substituindo as chaves do objeto. (Herdado de ECDsa)
ImportParameters(ECParameters)	Substitui a chave existente em que a instância atual está trabalhando, criando um novo CngKey para a estrutura dos parâmetros.
ImportPkcs8PrivateKey(ReadOnlySpan<Byte>, Int32)	Importa o par de chaves pública/privada de uma estrutura de PrivateKeyInfo do PKCS nº 8 após a descriptografia, substituindo as chaves desse objeto.
ImportSubjectPublicKeyInfo(ReadOnlySpan<Byte>, Int32)	Importa a chave pública de uma estrutura de SubjectPublicKeyInfo X.509 após a descriptografia, substituindo as chaves desse objeto. (Herdado de ECDsa)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
SignData(Byte[])	Gera uma assinatura para os dados especificados.
SignData(Byte[], HashAlgorithmName)	Calcula o valor de hash da matriz de byte especificada usando o algoritmo de hash especificado e assina o valor de hash resultante. (Herdado de ECDsa)
SignData(Byte[], HashAlgorithmName, DSASignatureFormat)	Calcula o valor de hash dos dados especificados e os assina usando o formato de assinatura especificado. (Herdado de ECDsa)
SignData(Byte[], Int32, Int32)	Gera uma assinatura digital para o tamanho especificado dos dados, começando no deslocamento indicado.
SignData(Byte[], Int32, Int32, HashAlgorithmName)	Calcula o valor de hash de uma parte da matriz de byte especificada usando o algoritmo de hash especificado e assina o valor de hash resultante. (Herdado de ECDsa)
SignData(Byte[], Int32, Int32, HashAlgorithmName, DSASignatureFormat)	Calcula o valor de hash dos dados especificados e os assina usando o formato de assinatura especificado. (Herdado de ECDsa)
SignData(ReadOnlySpan<Byte>, HashAlgorithmName)	Calcula o valor de hash dos dados especificados e o assina. (Herdado de ECDsa)
SignData(ReadOnlySpan<Byte>, HashAlgorithmName, DSASignatureFormat)	Calcula o valor de hash dos dados especificados e os assina usando o formato de assinatura especificado. (Herdado de ECDsa)
SignData(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName)	Calcula o valor de hash dos dados especificados e os assina no formato indicado no buffer fornecido. (Herdado de ECDsa)
SignData(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName, DSASignatureFormat)	Calcula o valor de hash dos dados especificados e os assina no formato indicado no buffer fornecido. (Herdado de ECDsa)
SignData(Stream)	Gera uma assinatura para o fluxo de dados especificado, lendo até o final do fluxo.
SignData(Stream, HashAlgorithmName)	Calcula o valor de hash do fluxo especificado usando o algoritmo de hash especificado e assina o valor de hash resultante. (Herdado de ECDsa)
SignData(Stream, HashAlgorithmName, DSASignatureFormat)	Calcula o valor de hash dos dados especificados e os assina usando o formato de assinatura especificado. (Herdado de ECDsa)
SignDataCore(ReadOnlySpan<Byte>, HashAlgorithmName, DSASignatureFormat)	Calcula o valor de hash dos dados especificados e os assina usando o formato de assinatura especificado. (Herdado de ECDsa)
SignDataCore(Stream, HashAlgorithmName, DSASignatureFormat)	Calcula o valor de hash dos dados especificados e os assina usando o formato de assinatura especificado. (Herdado de ECDsa)
SignHash(Byte[])	Gera uma assinatura para o valor de hash especificado.
SignHash(Byte[], DSASignatureFormat)	Calcula a assinatura ECDSA para o valor de hash especificado no formato indicado. (Herdado de ECDsa)
SignHash(ReadOnlySpan<Byte>)	Calcula a assinatura ECDSA para o valor de hash especificado. (Herdado de ECDsa)
SignHash(ReadOnlySpan<Byte>, DSASignatureFormat)	Calcula a assinatura ECDSA para o valor de hash especificado no formato indicado. (Herdado de ECDsa)
SignHash(ReadOnlySpan<Byte>, Span<Byte>)	Calcula a assinatura ECDSA para o valor de hash especificado no buffer fornecido. (Herdado de ECDsa)
SignHash(ReadOnlySpan<Byte>, Span<Byte>, DSASignatureFormat)	Calcula a assinatura ECDSA para o valor de hash especificado no formato indicado no buffer fornecido. (Herdado de ECDsa)
SignHashCore(ReadOnlySpan<Byte>, DSASignatureFormat)	Calcula a assinatura ECDSA para o valor de hash especificado no formato indicado. (Herdado de ECDsa)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
ToXmlString(Boolean)	Esse método é gerado em todos os casos. (Herdado de ECDsa)
ToXmlString(ECKeyXmlFormat)	Obsoleto. Serializa as informações de chave para uma cadeia de caracteres XML usando o formato especificado.
TryExportECPrivateKey(Span<Byte>, Int32)	Tenta exportar a chave atual no formato ECPrivateKey para um buffer fornecido. (Herdado de ECDsa)
TryExportECPrivateKeyPem(Span<Char>, Int32)	Tenta exportar a chave atual no formato ECPrivateKey codificado em PEM para um buffer fornecido. (Herdado de ECAlgorithm)
TryExportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, PbeParameters, Span<Byte>, Int32)	Tenta exportar a chave atual no formato EncryptedPrivateKeyInfo do PKCS n º 8 para um buffer fornecido, usando uma senha baseada em bytes.
TryExportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, PbeParameters, Span<Byte>, Int32)	Tenta exportar a chave atual no formato EncryptedPrivateKeyInfo do PKCS n º 8 para um buffer fornecido, usando uma senha baseada em caracteres.
TryExportEncryptedPkcs8PrivateKeyPem(ReadOnlySpan<Byte>, PbeParameters, Span<Char>, Int32)	Tenta exportar a chave atual no formato PKCS#8 EncryptedPrivateKeyInfo com uma senha baseada em bytes, codificada em PEM. (Herdado de AsymmetricAlgorithm)
TryExportEncryptedPkcs8PrivateKeyPem(ReadOnlySpan<Char>, PbeParameters, Span<Char>, Int32)	Exporta a chave atual no formato PKCS#8 EncryptedPrivateKeyInfo com uma senha baseada em caracteres, codificada em PEM. (Herdado de AsymmetricAlgorithm)
TryExportPkcs8PrivateKey(Span<Byte>, Int32)	Tenta exportar a chave atual no formato PrivateKeyInfo do PKCS n º 8 para um buffer fornecido.
TryExportPkcs8PrivateKeyPem(Span<Char>, Int32)	Tenta exportar a chave atual no formato PKCS#8 PrivateKeyInfo codificado em PEM para um buffer fornecido. (Herdado de AsymmetricAlgorithm)
TryExportSubjectPublicKeyInfo(Span<Byte>, Int32)	Tenta exportar a chave atual no formato SubjectPublicKeyInfo X.509 para um buffer fornecido. (Herdado de ECDsa)
TryExportSubjectPublicKeyInfoPem(Span<Char>, Int32)	Tenta exportar a chave atual no formato SubjectPublicKeyInfo codificado em PEM para um buffer fornecido. (Herdado de AsymmetricAlgorithm)
TryHashData(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName, Int32)	Tenta calcular o valor de hash do intervalo de bytes somente leitura especificado para o destino fornecido usando o algoritmo de hash especificado. (Herdado de ECDsa)
TrySignData(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName, DSASignatureFormat, Int32)	Tenta criar a assinatura ECDSA para os dados especificados no formato indicado no buffer fornecido. (Herdado de ECDsa)
TrySignData(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName, Int32)	Tenta calcular a assinatura digital ECDSA para o intervalo de bytes somente leitura especificado no destino fornecido usando o algoritmo de hash especificado e a chave atual. (Herdado de ECDsa)
TrySignDataCore(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName, DSASignatureFormat, Int32)	Tenta criar a assinatura ECDSA para os dados especificados no formato indicado no buffer fornecido. (Herdado de ECDsa)
TrySignHash(ReadOnlySpan<Byte>, Span<Byte>, DSASignatureFormat, Int32)	Tenta criar a assinatura ECDSA para o valor de hash especificado no formato indicado no buffer fornecido. (Herdado de ECDsa)
TrySignHash(ReadOnlySpan<Byte>, Span<Byte>, Int32)	Tenta calcular a assinatura digital ECDSA para o intervalo de bytes somente leitura especificado que representa um hash de dados no destino fornecido usando a chave atual.
TrySignHashCore(ReadOnlySpan<Byte>, Span<Byte>, DSASignatureFormat, Int32)	Tenta criar a assinatura ECDSA para o valor de hash especificado no formato indicado no buffer fornecido. (Herdado de ECDsa)
VerifyData(Byte[], Byte[])	Verifica a assinatura digital dos dados especificados.
VerifyData(Byte[], Byte[], HashAlgorithmName)	Verifica se uma assinatura digital é adequada para a chave atual e para os dados fornecidos com um algoritmo de hash especificado. (Herdado de ECDsa)
VerifyData(Byte[], Byte[], HashAlgorithmName, DSASignatureFormat)	Verifica se uma assinatura digital é válida para os dados fornecidos. (Herdado de ECDsa)
VerifyData(Byte[], Int32, Int32, Byte[])	Verifica uma assinatura digital para o tamanho especificado dos dados, começando no deslocamento indicado.
VerifyData(Byte[], Int32, Int32, Byte[], HashAlgorithmName)	Verifica se uma assinatura digital é adequada para a chave atual e para a parte dos dados fornecida com um algoritmo de hash especificado. (Herdado de ECDsa)
VerifyData(Byte[], Int32, Int32, Byte[], HashAlgorithmName, DSASignatureFormat)	Verifica se uma assinatura digital é válida para os dados fornecidos. (Herdado de ECDsa)
VerifyData(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, HashAlgorithmName)	Verifica se uma assinatura digital é adequada para a chave atual e para os dados fornecidos com um algoritmo de hash especificado. (Herdado de ECDsa)
VerifyData(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, HashAlgorithmName, DSASignatureFormat)	Verifica se uma assinatura digital é válida para os dados fornecidos. (Herdado de ECDsa)
VerifyData(Stream, Byte[])	Verifica uma assinatura digital do fluxo de dados especificado, lendo até o final do fluxo.
VerifyData(Stream, Byte[], HashAlgorithmName)	Verifica se uma assinatura digital é adequada para a chave atual e para os dados fornecidos com um algoritmo de hash especificado. (Herdado de ECDsa)
VerifyData(Stream, Byte[], HashAlgorithmName, DSASignatureFormat)	Verifica se uma assinatura digital é válida para os dados fornecidos. (Herdado de ECDsa)
VerifyDataCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, HashAlgorithmName, DSASignatureFormat)	Verifica se uma assinatura digital é válida para os dados fornecidos. (Herdado de ECDsa)
VerifyDataCore(Stream, ReadOnlySpan<Byte>, HashAlgorithmName, DSASignatureFormat)	Verifica se uma assinatura digital é válida para os dados fornecidos. (Herdado de ECDsa)
VerifyHash(Byte[], Byte[])	Verifica se uma assinatura digital é adequada para a chave atual e para o hash de dados fornecido.
VerifyHash(Byte[], Byte[], DSASignatureFormat)	Verifica se uma assinatura digital é válida para o hash fornecido. (Herdado de ECDsa)
VerifyHash(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)	Verifica se uma assinatura digital é adequada para a chave atual e para o hash de dados fornecido.
VerifyHash(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, DSASignatureFormat)	Verifica se uma assinatura digital é válida para o hash fornecido. (Herdado de ECDsa)
VerifyHashCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, DSASignatureFormat)	Verifica se uma assinatura digital é válida para o hash fornecido. (Herdado de ECDsa)