ECDsaCng Classe

Definizione

Spazio dei nomi:

System.Security.Cryptography

Assembly:

System.Security.Cryptography.dll

Origine:

Cng.NotSupported.cs

Fornisce un'implementazione CNG (Cryptography Next Generation) dell'algoritmo ECDSA (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

Ereditarietà

Object

AsymmetricAlgorithm

ECAlgorithm

ECDsa

ECDsaCng

Esempio

Nell'esempio seguente viene illustrato come usare la ECDsaCng classe per firmare un messaggio e come usare la firma per verificare che il messaggio non sia stato modificato.

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

Commenti

Questa classe deve essere usata direttamente quando si esegue l'interoperabilità della piattaforma con la libreria CNG di Windows. Quando l'interoperabilità della piattaforma non è necessaria, è consigliabile usare i ECDsa.Create metodi factory anziché un'implementazione derivata specifica.

Costruttori

ECDsaCng()	Inizializza una nuova istanza della classe ECDsaCng con una coppia di chiavi casuale.
ECDsaCng(CngKey)	Inizializza una nuova istanza della classe ECDsaCng usando l'oggetto CngKey specificato.
ECDsaCng(ECCurve)	Inizializza una nuova istanza della classe ECDsaCng la cui coppia di chiavi pubblica/privata viene generata per la curva specificata.
ECDsaCng(Int32)	Inizializza una nuova istanza della classe ECDsaCng con le dimensioni della chiave di destinazione specificate.

Campi

KeySizeValue	Rappresenta la dimensione in bit del modulo della chiave usato dall'algoritmo asimmetrico. (Ereditato da AsymmetricAlgorithm)
LegalKeySizesValue	Specifica le dimensioni delle chiavi supportate dall'algoritmo asimmetrico. (Ereditato da AsymmetricAlgorithm)

Proprietà

HashAlgorithm	Ottiene o imposta l'algoritmo hash da utilizzare per la firma e la verifica dei dati.
Key	Ottiene o imposta la chiave da usare per la firma e la verifica dei dati.
KeyExchangeAlgorithm	Ottiene il nome dell'algoritmo di scambio delle chiavi. (Ereditato da ECDsa)
KeySize	Ottiene o imposta la dimensione in bit del modulo della chiave usato dall'algoritmo asimmetrico.
LegalKeySizes	Ottiene le dimensioni in bit della chiave supportate dal setter della proprietà KeySize.
SignatureAlgorithm	Ottiene il nome dell'algoritmo di firma. (Ereditato da ECDsa)

Metodi

Clear()	Rilascia tutte le risorse usate dalla classe AsymmetricAlgorithm. (Ereditato da AsymmetricAlgorithm)
Dispose()	Rilascia tutte le risorse usate dall'istanza corrente della classe AsymmetricAlgorithm. (Ereditato da AsymmetricAlgorithm)
Dispose(Boolean)	Rilascia le risorse non gestite usate dalla classe AsymmetricAlgorithm e facoltativamente le risorse gestite. (Ereditato da AsymmetricAlgorithm)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
ExportECPrivateKey()	Esporta la chiave corrente nel formato ECPrivateKey. (Ereditato da ECDsa)
ExportECPrivateKeyPem()	Esporta la chiave corrente nel formato ECPrivateKey, con codifica PEM. (Ereditato da ECAlgorithm)
ExportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, PbeParameters)	Esporta la chiave corrente nel formato PKCS#8 EncryptedPrivateKeyInfo con una password basata su byte.
ExportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, PbeParameters)	Esporta la chiave corrente nel formato PKCS#8 EncryptedPrivateKeyInfo con una password basata su caratteri.
ExportEncryptedPkcs8PrivateKeyPem(ReadOnlySpan<Byte>, PbeParameters)	Esporta la chiave corrente nel formato PKCS#8 EncryptedPrivateKeyInfo con una password basata su byte, con codifica PEM. (Ereditato da AsymmetricAlgorithm)
ExportEncryptedPkcs8PrivateKeyPem(ReadOnlySpan<Char>, PbeParameters)	Esporta la chiave corrente nel formato PKCS#8 EncryptedPrivateKeyInfo con una password basata su caratteri, con codifica PEM. (Ereditato da AsymmetricAlgorithm)
ExportExplicitParameters(Boolean)	Esporta la chiave e i parametri della curva esplicita usati dall'oggetto ECC (Elliptic Curve Cryptography) in un oggetto ECParameters.
ExportParameters(Boolean)	Esporta la chiave usata dall'oggetto ECC (Elliptic Curve Cryptography) in un oggetto ECParameters. Se la chiave è stata creata come curva denominata, il campo Curve contiene i parametri della curva denominata; in caso contrario, contiene i parametri espliciti.
ExportPkcs8PrivateKey()	Esporta la chiave corrente nel formato PKCS#8 PrivateKeyInfo. (Ereditato da AsymmetricAlgorithm)
ExportPkcs8PrivateKeyPem()	Esporta la chiave corrente nel formato PKCS#8 PrivateKeyInfo, con codifica PEM. (Ereditato da AsymmetricAlgorithm)
ExportSubjectPublicKeyInfo()	Esporta la parte della chiave pubblica della chiave corrente nel formato X.509 SubjectPublicKeyInfo. (Ereditato da AsymmetricAlgorithm)
ExportSubjectPublicKeyInfoPem()	Esporta la parte pubblica della chiave pubblica della chiave corrente nel formato X.509 SubjectPublicKeyInfo, codificato con PEM. (Ereditato da AsymmetricAlgorithm)
FromXmlString(String)	Questo metodo genera in tutti i casi. (Ereditato da ECDsa)
FromXmlString(String, ECKeyXmlFormat)	Obsoleti. Deserializza le informazioni sulla chiave da una stringa XML utilizzando il formato specificato.
GenerateKey(ECCurve)	Genera una nuova coppia di chiavi pubblica/privata temporanea per la curva specificata, sostituendo la chiave corrente.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetMaxSignatureSize(DSASignatureFormat)	Ottiene le dimensioni massime, in byte, per una firma prodotta da questa chiave nel formato indicato. (Ereditato da ECDsa)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
HashData(Byte[], Int32, Int32, HashAlgorithmName)	Quando sottoposto a override in una classe derivata, calcola il valore hash della parte specificata di una matrice di byte usando l'algoritmo hash specificato. (Ereditato da ECDsa)
HashData(Stream, HashAlgorithmName)	Quando sottoposto a override in una classe derivata, calcola il valore hash del flusso binario specificato usando l'algoritmo hash specificato. (Ereditato da ECDsa)
ImportECPrivateKey(ReadOnlySpan<Byte>, Int32)	Importa la coppia di chiavi pubblica/privata da una struttura ECPrivateKey, sostituendo le chiavi per questo oggetto. (Ereditato da ECDsa)
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32)	Importa la coppia di chiavi pubblica/privata da una struttura PKCS#8 EncryptedPrivateKeyInfo dopo la decrittografia con una password basata su byte, sostituendo le chiavi per questo oggetto.
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Int32)	Importa la coppia di chiavi pubblica/privata da una struttura PKCS#8 EncryptedPrivateKeyInfo dopo la decrittografia con una password basata su caratteri, sostituendo le chiavi per questo oggetto.
ImportFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)	Importa una chiave privata con codifica PEM crittografata RFC 7468, sostituendo le chiavi per questo oggetto. (Ereditato da ECDsa)
ImportFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	Importa una chiave privata con codifica PEM crittografata RFC 7468, sostituendo le chiavi per questo oggetto. (Ereditato da ECDsa)
ImportFromPem(ReadOnlySpan<Char>)	Importa una chiave con codifica PEM RFC 7468, sostituendo le chiavi per questo oggetto. (Ereditato da ECDsa)
ImportParameters(ECParameters)	Sostituisce la chiave esistente usata dall'istanza corrente creando un nuovo oggetto CngKey per la struttura di parametri.
ImportPkcs8PrivateKey(ReadOnlySpan<Byte>, Int32)	Importa la coppia di chiavi pubblica/privata da una struttura PKCS#8 PrivateKeyInfo dopo la decrittografia, sostituendo le chiavi per questo oggetto.
ImportSubjectPublicKeyInfo(ReadOnlySpan<Byte>, Int32)	Importa la chiave pubblica da una struttura X.509 SubjectPublicKeyInfo dopo la decrittografia, sostituendo le chiavi per questo oggetto. (Ereditato da ECDsa)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
SignData(Byte[])	Genera una firma per i dati specificati.
SignData(Byte[], HashAlgorithmName)	Calcola il valore hash della matrice di byte specificata usando l'algoritmo hash specificato e firma il valore hash risultante. (Ereditato da ECDsa)
SignData(Byte[], HashAlgorithmName, DSASignatureFormat)	Calcola il valore hash dei dati specificati e li firma usando il formato di firma specificato. (Ereditato da ECDsa)
SignData(Byte[], Int32, Int32)	Genera una firma digitale per la lunghezza dei dati specificata, iniziando dall'offset specificato.
SignData(Byte[], Int32, Int32, HashAlgorithmName)	Calcola il valore hash di una parte della matrice di byte specificata usando l'algoritmo hash specificato e firma il valore hash risultante. (Ereditato da ECDsa)
SignData(Byte[], Int32, Int32, HashAlgorithmName, DSASignatureFormat)	Calcola il valore hash dei dati specificati e li firma usando il formato di firma specificato. (Ereditato da ECDsa)
SignData(ReadOnlySpan<Byte>, HashAlgorithmName)	Calcola il valore hash dei dati specificati e lo firma. (Ereditato da ECDsa)
SignData(ReadOnlySpan<Byte>, HashAlgorithmName, DSASignatureFormat)	Calcola il valore hash dei dati specificati e li firma usando il formato di firma specificato. (Ereditato da ECDsa)
SignData(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName)	Calcola il valore hash dei dati specificati e lo firma nel formato indicato nel buffer specificato. (Ereditato da ECDsa)
SignData(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName, DSASignatureFormat)	Calcola il valore hash dei dati specificati e lo firma nel formato indicato nel buffer specificato. (Ereditato da ECDsa)
SignData(Stream)	Genera una firma per il flusso di dati specificato, leggendo fino alla fine del flusso.
SignData(Stream, HashAlgorithmName)	Calcola il valore hash del flusso specificato usando l'algoritmo hash specificato e firma il valore hash risultante. (Ereditato da ECDsa)
SignData(Stream, HashAlgorithmName, DSASignatureFormat)	Calcola il valore hash dei dati specificati e li firma usando il formato di firma specificato. (Ereditato da ECDsa)
SignDataCore(ReadOnlySpan<Byte>, HashAlgorithmName, DSASignatureFormat)	Calcola il valore hash dei dati specificati e li firma usando il formato di firma specificato. (Ereditato da ECDsa)
SignDataCore(Stream, HashAlgorithmName, DSASignatureFormat)	Calcola il valore hash dei dati specificati e li firma usando il formato di firma specificato. (Ereditato da ECDsa)
SignHash(Byte[])	Genera una firma per il valore hash specificato.
SignHash(Byte[], DSASignatureFormat)	Calcola la firma ECDSA del valore hash specificato nel formato indicato. (Ereditato da ECDsa)
SignHash(ReadOnlySpan<Byte>)	Calcola la firma ECDSA per il valore hash specificato. (Ereditato da ECDsa)
SignHash(ReadOnlySpan<Byte>, DSASignatureFormat)	Calcola la firma ECDSA del valore hash specificato nel formato indicato. (Ereditato da ECDsa)
SignHash(ReadOnlySpan<Byte>, Span<Byte>)	Calcola la firma ECDSA per il valore hash specificato nel buffer specificato. (Ereditato da ECDsa)
SignHash(ReadOnlySpan<Byte>, Span<Byte>, DSASignatureFormat)	Calcola la firma ECDSA per il valore hash specificato nel formato indicato nel buffer specificato. (Ereditato da ECDsa)
SignHashCore(ReadOnlySpan<Byte>, DSASignatureFormat)	Calcola la firma ECDSA del valore hash specificato nel formato indicato. (Ereditato da ECDsa)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
ToXmlString(Boolean)	Questo metodo genera in tutti i casi. (Ereditato da ECDsa)
ToXmlString(ECKeyXmlFormat)	Obsoleti. Serializza le informazioni sulla chiave in una stringa XML utilizzando il formato specificato.
TryExportECPrivateKey(Span<Byte>, Int32)	Tenta di esportare la chiave corrente nel formato ECPrivateKey in un buffer specificato. (Ereditato da ECDsa)
TryExportECPrivateKeyPem(Span<Char>, Int32)	Tenta di esportare la chiave corrente nel formato ECPrivateKey con codifica PEM in un buffer fornito. (Ereditato da ECAlgorithm)
TryExportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, PbeParameters, Span<Byte>, Int32)	Tenta di esportare la chiave corrente nel formato PKCS#8 EncryptedPrivateKeyInfo in un buffer specificato, usando una password basata su byte.
TryExportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, PbeParameters, Span<Byte>, Int32)	Tenta di esportare la chiave corrente nel formato PKCS#8 EncryptedPrivateKeyInfo in un buffer specificato, usando una password basata su caratteri.
TryExportEncryptedPkcs8PrivateKeyPem(ReadOnlySpan<Byte>, PbeParameters, Span<Char>, Int32)	Tenta di esportare la chiave corrente nel formato PKCS#8 EncryptedPrivateKeyInfo con una password basata su byte, con codifica PEM. (Ereditato da AsymmetricAlgorithm)
TryExportEncryptedPkcs8PrivateKeyPem(ReadOnlySpan<Char>, PbeParameters, Span<Char>, Int32)	Esporta la chiave corrente nel formato PKCS#8 EncryptedPrivateKeyInfo con una password basata su caratteri, con codifica PEM. (Ereditato da AsymmetricAlgorithm)
TryExportPkcs8PrivateKey(Span<Byte>, Int32)	Tenta di esportare la chiave corrente nel formato PKCS#8 PrivateKeyInfo in un buffer specificato.
TryExportPkcs8PrivateKeyPem(Span<Char>, Int32)	Tenta di esportare la chiave corrente nel formato PKCS#8 PrivateKeyInfo con codifica PEM in un buffer fornito. (Ereditato da AsymmetricAlgorithm)
TryExportSubjectPublicKeyInfo(Span<Byte>, Int32)	Tenta di esportare la chiave corrente nel formato X.509 SubjectPublicKeyInfo in un buffer specificato. (Ereditato da ECDsa)
TryExportSubjectPublicKeyInfoPem(Span<Char>, Int32)	Tenta di esportare la chiave corrente nel formato X.509 SoggettoPublicKeyInfo con codifica PEM in un buffer fornito. (Ereditato da AsymmetricAlgorithm)
TryHashData(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName, Int32)	Tenta di calcolare il valore hash dell'intervallo di sola lettura specificato di byte nella destinazione specificata usando l'algoritmo hash specificato. (Ereditato da ECDsa)
TrySignData(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName, DSASignatureFormat, Int32)	Cerca di creare la firma ECDSA per i dati specificati nel formato indicato nel buffer specificato. (Ereditato da ECDsa)
TrySignData(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName, Int32)	Tenta di calcolare la firma digitale ECDSA per l'intervallo di sola lettura specificato di byte nella destinazione specificata usando l'algoritmo hash specificato e la chiave corrente. (Ereditato da ECDsa)
TrySignDataCore(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName, DSASignatureFormat, Int32)	Cerca di creare la firma ECDSA per i dati specificati nel formato indicato nel buffer specificato. (Ereditato da ECDsa)
TrySignHash(ReadOnlySpan<Byte>, Span<Byte>, DSASignatureFormat, Int32)	Cerca di creare la firma ECDSA per il valore hash specificato nel formato indicato nel buffer specificato. (Ereditato da ECDsa)
TrySignHash(ReadOnlySpan<Byte>, Span<Byte>, Int32)	Tenta di calcolare la firma digitale ECDSA per l'intervallo di sola lettura specificato di byte che rappresenta un hash di dati nella destinazione specificata usando la chiave corrente.
TrySignHashCore(ReadOnlySpan<Byte>, Span<Byte>, DSASignatureFormat, Int32)	Cerca di creare la firma ECDSA per il valore hash specificato nel formato indicato nel buffer specificato. (Ereditato da ECDsa)
VerifyData(Byte[], Byte[])	Verifica la firma digitale dei dati specificati.
VerifyData(Byte[], Byte[], HashAlgorithmName)	Verifica che una firma digitale sia appropriata per la chiave corrente e i dati specificati con un algoritmo hash specificato. (Ereditato da ECDsa)
VerifyData(Byte[], Byte[], HashAlgorithmName, DSASignatureFormat)	Verifica che una firma digitale sia valida per i dati specificati. (Ereditato da ECDsa)
VerifyData(Byte[], Int32, Int32, Byte[])	Verifica che una firma possieda la lunghezza dei dati specificata, iniziando dall'offset specificato.
VerifyData(Byte[], Int32, Int32, Byte[], HashAlgorithmName)	Verifica che una firma digitale sia appropriata per la chiave corrente e la parte di dati specificata con un algoritmo hash specificato. (Ereditato da ECDsa)
VerifyData(Byte[], Int32, Int32, Byte[], HashAlgorithmName, DSASignatureFormat)	Verifica che una firma digitale sia valida per i dati specificati. (Ereditato da ECDsa)
VerifyData(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, HashAlgorithmName)	Verifica che una firma digitale sia appropriata per la chiave corrente e i dati specificati con un algoritmo hash specificato. (Ereditato da ECDsa)
VerifyData(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, HashAlgorithmName, DSASignatureFormat)	Verifica che una firma digitale sia valida per i dati specificati. (Ereditato da ECDsa)
VerifyData(Stream, Byte[])	Verifica la firma digitale del flusso di dati specificato, leggendo fino alla fine del flusso.
VerifyData(Stream, Byte[], HashAlgorithmName)	Verifica che una firma digitale sia appropriata per la chiave corrente e i dati specificati con un algoritmo hash specificato. (Ereditato da ECDsa)
VerifyData(Stream, Byte[], HashAlgorithmName, DSASignatureFormat)	Verifica che una firma digitale sia valida per i dati specificati. (Ereditato da ECDsa)
VerifyDataCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, HashAlgorithmName, DSASignatureFormat)	Verifica che una firma digitale sia valida per i dati specificati. (Ereditato da ECDsa)
VerifyDataCore(Stream, ReadOnlySpan<Byte>, HashAlgorithmName, DSASignatureFormat)	Verifica che una firma digitale sia valida per i dati specificati. (Ereditato da ECDsa)
VerifyHash(Byte[], Byte[])	Verifica che una firma digitale sia appropriata per la chiave corrente e l'hash dei dati specificato.
VerifyHash(Byte[], Byte[], DSASignatureFormat)	Verifica che una firma digitale sia valida per l'hash specificato. (Ereditato da ECDsa)
VerifyHash(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)	Verifica che una firma digitale sia appropriata per la chiave corrente e l'hash dei dati specificato.
VerifyHash(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, DSASignatureFormat)	Verifica che una firma digitale sia valida per l'hash specificato. (Ereditato da ECDsa)
VerifyHashCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, DSASignatureFormat)	Verifica che una firma digitale sia valida per l'hash specificato. (Ereditato da ECDsa)