ECDsaCng Класс

Определение

Пространство имен:

System.Security.Cryptography

Сборка:

System.Security.Cryptography.dll

Исходный код:

Cng.NotSupported.cs

Предоставляет реализацию алгоритма цифровых подписей на основе эллиптических кривых (ECDSA) на платформе криптографии следующего поколения (CNG).

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

Наследование

Object

AsymmetricAlgorithm

ECAlgorithm

ECDsa

ECDsaCng

Примеры

В следующем примере показано, как использовать ECDsaCng класс для подписи сообщения и как использовать сигнатуру для проверки того, что сообщение не было изменено.

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

Комментарии

Этот класс следует использовать непосредственно при выполнении взаимодействия платформы с библиотекой Windows CNG. Если взаимодействие с платформой не требуется, следует использовать ECDsa.Create фабричные методы вместо конкретной производной реализации.

Конструкторы

ECDsaCng()	Инициализирует новый экземпляр класса ECDsaCng с парой случайных пар ключей.
ECDsaCng(CngKey)	Инициализирует новый экземпляр класса ECDsaCng, используя указанный объект CngKey.
ECDsaCng(ECCurve)	Инициализирует новый экземпляр класса ECDsaCng, пара открытого и закрытого ключей которого создается на основе указанной кривой.
ECDsaCng(Int32)	Инициализирует новый экземпляр класса ECDsaCng с указанным размером целевого ключа.

Поля

KeySizeValue	Представляет размер модуля ключа (в битах), используемого алгоритмом асимметричного шифрования. (Унаследовано от AsymmetricAlgorithm)
LegalKeySizesValue	Задает размеры ключа, которые поддерживаются алгоритмом асимметричного шифрования. (Унаследовано от AsymmetricAlgorithm)

Свойства

HashAlgorithm	Получает или задает хэш-алгоритм, используемый при подписывании и проверке данных.
Key	Возвращает или задает ключ, используемый при подписании и проверке данных.
KeyExchangeAlgorithm	Получает имя алгоритма обмена ключами. (Унаследовано от ECDsa)
KeySize	Получает или задает размер модуля ключа (в битах), используемого алгоритмом асимметричного шифрования.
LegalKeySizes	Возвращает размеры ключа (в битах), которые поддерживаются методом задания свойства KeySize.
SignatureAlgorithm	Получает имя алгоритма подписи. (Унаследовано от ECDsa)

Методы

Clear()	Освобождает все ресурсы, используемые классом AsymmetricAlgorithm. (Унаследовано от AsymmetricAlgorithm)
Dispose()	Освобождает все ресурсы, используемые текущим экземпляром класса AsymmetricAlgorithm. (Унаследовано от AsymmetricAlgorithm)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые классом AsymmetricAlgorithm (при необходимости освобождает и управляемые ресурсы). (Унаследовано от AsymmetricAlgorithm)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
ExportECPrivateKey()	Экспортирует текущий ключ в формате ECPrivateKey. (Унаследовано от ECDsa)
ExportECPrivateKeyPem()	Экспортирует текущий ключ в формате ECPrivateKey в кодировке PEM. (Унаследовано от ECAlgorithm)
ExportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, PbeParameters)	Экспортирует текущий ключ в формате PKCS #8 EncryptedPrivateKeyInfo с паролем, основанным на байтах.
ExportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, PbeParameters)	Экспортирует текущий ключ в формате PKCS #8 EncryptedPrivateKeyInfo с паролем, основанным на символах.
ExportEncryptedPkcs8PrivateKeyPem(ReadOnlySpan<Byte>, PbeParameters)	Экспортирует текущий ключ в формате PKCS#8 EncryptedPrivateKeyInfo с паролем на основе байтов в кодировке PEM. (Унаследовано от AsymmetricAlgorithm)
ExportEncryptedPkcs8PrivateKeyPem(ReadOnlySpan<Char>, PbeParameters)	Экспортирует текущий ключ в формате PKCS#8 EncryptedPrivateKeyInfo с паролем на основе символов в кодировке PEM. (Унаследовано от AsymmetricAlgorithm)
ExportExplicitParameters(Boolean)	Экспортирует ключ и параметры явной кривой, используемые объектом шифрования на основе эллиптических кривых (ECC), в объект ECParameters.
ExportParameters(Boolean)	Экспортирует ключ, используемый объектом шифрования на основе эллиптических кривых (ECC), в объект ECParameters. Если ключ был создан как именованная кривая, поле Curve содержит параметры именованной кривой; в противном случае оно содержит параметры явной кривой.
ExportPkcs8PrivateKey()	Экспортирует текущий ключ в формате PKCS#8 PrivateKeyInfo. (Унаследовано от AsymmetricAlgorithm)
ExportPkcs8PrivateKeyPem()	Экспортирует текущий ключ в формате PKCS#8 PrivateKeyInfo в кодировке PEM. (Унаследовано от AsymmetricAlgorithm)
ExportSubjectPublicKeyInfo()	Экспортирует открытую часть текущего ключа в формате X.509 SubjectPublicKeyInfo. (Унаследовано от AsymmetricAlgorithm)
ExportSubjectPublicKeyInfoPem()	Экспортирует часть текущего ключа с открытым ключом в формате X.509 SubjectPublicKeyInfo в кодировке PEM. (Унаследовано от AsymmetricAlgorithm)
FromXmlString(String)	Этот метод выдает исключение во всех случаях. (Унаследовано от ECDsa)
FromXmlString(String, ECKeyXmlFormat)	Устаревшие.. Выполняет десериализацию данных ключа из XML-строки, используя указанный формат.
GenerateKey(ECCurve)	Создает новую пару открытого и закрытого эфемерных ключей для указанной кривой, заменяя текущий ключ.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetMaxSignatureSize(DSASignatureFormat)	Получает самый крупный размер в байтах для сигнатуры, созданной этим ключом в указанном формате. (Унаследовано от ECDsa)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
HashData(Byte[], Int32, Int32, HashAlgorithmName)	При переопределении в производном классе вычисляет хэш-значение указанного фрагмента массива байтов с помощью заданного алгоритма хэширования. (Унаследовано от ECDsa)
HashData(Stream, HashAlgorithmName)	При переопределении в производном классе вычисляет хэш-значение указанного двоичного потока с помощью заданного алгоритма хэширования. (Унаследовано от ECDsa)
ImportECPrivateKey(ReadOnlySpan<Byte>, Int32)	Импортирует пару открытого и закрытого ключей из структуры ECPrivateKey и заменяет ключи для этого объекта. (Унаследовано от ECDsa)
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32)	Импортирует пару из открытого и закрытого ключей из структуры PKCS#8 EncryptedPrivateKeyInfo после расшифровки с помощью пароля на основе байтов, заменяя ключи для этого объекта.
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Int32)	Импортирует пару из открытого и закрытого ключей из структуры PKCS#8 EncryptedPrivateKeyInfo после расшифровки с помощью пароля на основе символов, заменяя ключи для этого объекта.
ImportFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)	Импортирует зашифрованный закрытый ключ в формате RFC 7468 в кодировке PEM, заменяя ключи для этого объекта. (Унаследовано от ECDsa)
ImportFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	Импортирует зашифрованный закрытый ключ в формате RFC 7468 в кодировке PEM, заменяя ключи для этого объекта. (Унаследовано от ECDsa)
ImportFromPem(ReadOnlySpan<Char>)	Импортирует зашифрованный ключ в формате RFC 7468 в кодировке PEM, заменив ключи для этого объекта. (Унаследовано от ECDsa)
ImportParameters(ECParameters)	Заменяет существующий ключ, с которым работает текущий экземпляр, создавая новый объект CngKey для структуры параметров.
ImportPkcs8PrivateKey(ReadOnlySpan<Byte>, Int32)	Импортирует пару из открытого и закрытого ключей из структуры PKCS#8 PrivateKeyInfo после расшифровки, заменяя ключи для этого объекта.
ImportSubjectPublicKeyInfo(ReadOnlySpan<Byte>, Int32)	Импортирует открытый ключ из структуры X.509 SubjectPublicKeyInfo после расшифровки, заменяя ключи для этого объекта. (Унаследовано от ECDsa)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
SignData(Byte[])	Создает подпись для указанных данных.
SignData(Byte[], HashAlgorithmName)	Вычисляет хэш-значение заданного массива байтов с помощью указанного алгоритма хэширования и подписывает результирующее хэш-значение. (Унаследовано от ECDsa)
SignData(Byte[], HashAlgorithmName, DSASignatureFormat)	Вычисляет хэш-значение указанных данных и подписывает его с помощью указанного формата сигнатуры. (Унаследовано от ECDsa)
SignData(Byte[], Int32, Int32)	Создает цифровую подпись для фрагмента данных указанной длины, начиная с указанной позиции.
SignData(Byte[], Int32, Int32, HashAlgorithmName)	Вычисляет хэш-значение фрагмента заданного массива байтов с помощью указанного алгоритма хэширования и подписывает результирующее хэш-значение. (Унаследовано от ECDsa)
SignData(Byte[], Int32, Int32, HashAlgorithmName, DSASignatureFormat)	Вычисляет хэш-значение указанных данных и подписывает его с помощью указанного формата сигнатуры. (Унаследовано от ECDsa)
SignData(ReadOnlySpan<Byte>, HashAlgorithmName)	Вычисляет хэш-значение указанных данных и подписывает его. (Унаследовано от ECDsa)
SignData(ReadOnlySpan<Byte>, HashAlgorithmName, DSASignatureFormat)	Вычисляет хэш-значение указанных данных и подписывает его с помощью указанного формата сигнатуры. (Унаследовано от ECDsa)
SignData(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName)	Вычисляет хэш-значение указанных данных и подписывает его в указанном формате в предоставленный буфер. (Унаследовано от ECDsa)
SignData(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName, DSASignatureFormat)	Вычисляет хэш-значение указанных данных и подписывает его в указанном формате в предоставленный буфер. (Унаследовано от ECDsa)
SignData(Stream)	Создает подпись для указанного потока данных, перемещая позицию чтения в конец потока.
SignData(Stream, HashAlgorithmName)	Вычисляет хэш-значение заданного потока с помощью указанного алгоритма хэширования и подписывает результирующее хэш-значение. (Унаследовано от ECDsa)
SignData(Stream, HashAlgorithmName, DSASignatureFormat)	Вычисляет хэш-значение указанных данных и подписывает его с помощью указанного формата сигнатуры. (Унаследовано от ECDsa)
SignDataCore(ReadOnlySpan<Byte>, HashAlgorithmName, DSASignatureFormat)	Вычисляет хэш-значение указанных данных и подписывает его с помощью указанного формата сигнатуры. (Унаследовано от ECDsa)
SignDataCore(Stream, HashAlgorithmName, DSASignatureFormat)	Вычисляет хэш-значение указанных данных и подписывает его с помощью указанного формата сигнатуры. (Унаследовано от ECDsa)
SignHash(Byte[])	Создает подпись для указанного хэш-значения.
SignHash(Byte[], DSASignatureFormat)	Вычисляет подпись ECDSA для указанного хэш-значения в указанном формате. (Унаследовано от ECDsa)
SignHash(ReadOnlySpan<Byte>)	Вычисляет подпись ECDSA для указанного хэш-значения. (Унаследовано от ECDsa)
SignHash(ReadOnlySpan<Byte>, DSASignatureFormat)	Вычисляет подпись ECDSA для указанного хэш-значения в указанном формате. (Унаследовано от ECDsa)
SignHash(ReadOnlySpan<Byte>, Span<Byte>)	Вычисляет подпись ECDSA для указанного хэш-значения в предоставленном буфере. (Унаследовано от ECDsa)
SignHash(ReadOnlySpan<Byte>, Span<Byte>, DSASignatureFormat)	Вычисляет подпись ECDSA для указанного хэш-значения в указанном формате в предоставленном буфере. (Унаследовано от ECDsa)
SignHashCore(ReadOnlySpan<Byte>, DSASignatureFormat)	Вычисляет подпись ECDSA для указанного хэш-значения в указанном формате. (Унаследовано от ECDsa)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
ToXmlString(Boolean)	Этот метод выдает исключение во всех случаях. (Унаследовано от ECDsa)
ToXmlString(ECKeyXmlFormat)	Устаревшие.. Выполняет сериализацию данных ключа в XML-строку, используя указанный формат.
TryExportECPrivateKey(Span<Byte>, Int32)	Пытается экспортировать текущий ключ в формате ECPrivateKey в предоставленный буфер. (Унаследовано от ECDsa)
TryExportECPrivateKeyPem(Span<Char>, Int32)	Пытается экспортировать текущий ключ в формате ECPrivateKey в кодировке PEM в предоставленный буфер. (Унаследовано от ECAlgorithm)
TryExportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, PbeParameters, Span<Byte>, Int32)	Пытается экспортировать текущий ключ в формате PKCS#8 EncryptedPrivateKeyInfo в предоставленный буфер с использованием пароля на основе байтов.
TryExportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, PbeParameters, Span<Byte>, Int32)	Пытается экспортировать текущий ключ в формате PKCS#8 EncryptedPrivateKeyInfo в предоставленный буфер с использованием пароля на основе символов.
TryExportEncryptedPkcs8PrivateKeyPem(ReadOnlySpan<Byte>, PbeParameters, Span<Char>, Int32)	Пытается экспортировать текущий ключ в формате PKCS#8 EncryptedPrivateKeyInfo с паролем на основе байтов в кодировке PEM. (Унаследовано от AsymmetricAlgorithm)
TryExportEncryptedPkcs8PrivateKeyPem(ReadOnlySpan<Char>, PbeParameters, Span<Char>, Int32)	Экспортирует текущий ключ в формате PKCS#8 EncryptedPrivateKeyInfo с паролем на основе символов в кодировке PEM. (Унаследовано от AsymmetricAlgorithm)
TryExportPkcs8PrivateKey(Span<Byte>, Int32)	Пытается экспортировать текущий ключ в формате PKCS#8 PrivateKeyInfo в предоставленный буфер.
TryExportPkcs8PrivateKeyPem(Span<Char>, Int32)	Пытается экспортировать текущий ключ в формате PKCS#8 PrivateKeyInfo в формате PEM в предоставленный буфер. (Унаследовано от AsymmetricAlgorithm)
TryExportSubjectPublicKeyInfo(Span<Byte>, Int32)	Пытается экспортировать текущий ключ в формате X.509 SubjectPublicKeyInfo в предоставленный буфер. (Унаследовано от ECDsa)
TryExportSubjectPublicKeyInfoPem(Span<Char>, Int32)	Пытается экспортировать текущий ключ в формате X.509 SubjectPublicKeyInfo в формате PEM в предоставленный буфер. (Унаследовано от AsymmetricAlgorithm)
TryHashData(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName, Int32)	Пытается с помощью указанного алгоритма хэширования вычислить хэш-значение указанного диапазона байтов только для чтения и записать результат в предоставленное назначение. (Унаследовано от ECDsa)
TrySignData(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName, DSASignatureFormat, Int32)	Пытается создать подпись ECDSA для указанных данных в указанном формате в предоставленном буфере. (Унаследовано от ECDsa)
TrySignData(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName, Int32)	Пытается с помощью указанного алгоритма хэширования и используемого ключа вычислить цифровую подпись ECDSA указанного диапазона байтов только для чтения и записать результат в предоставленное назначение. (Унаследовано от ECDsa)
TrySignDataCore(ReadOnlySpan<Byte>, Span<Byte>, HashAlgorithmName, DSASignatureFormat, Int32)	Пытается создать подпись ECDSA для указанных данных в указанном формате в предоставленном буфере. (Унаследовано от ECDsa)
TrySignHash(ReadOnlySpan<Byte>, Span<Byte>, DSASignatureFormat, Int32)	Пытается создать подпись ECDSA для указанного хэш-значения в указанном формате в предоставленном буфере. (Унаследовано от ECDsa)
TrySignHash(ReadOnlySpan<Byte>, Span<Byte>, Int32)	Пытается с помощью используемого ключа вычислить цифровую подпись ECDSA указанного диапазона байтов только для чтения, представляющего собой хэш данных, и записать результат в предоставленное назначение.
TrySignHashCore(ReadOnlySpan<Byte>, Span<Byte>, DSASignatureFormat, Int32)	Пытается создать подпись ECDSA для указанного хэш-значения в указанном формате в предоставленном буфере. (Унаследовано от ECDsa)
VerifyData(Byte[], Byte[])	Проверяет цифровую подпись указанных данных.
VerifyData(Byte[], Byte[], HashAlgorithmName)	Проверяет, подходит ли цифровая подпись для текущего ключа и заданных данных, с помощью указанного хэш-алгоритма. (Унаследовано от ECDsa)
VerifyData(Byte[], Byte[], HashAlgorithmName, DSASignatureFormat)	Проверяет допустимость цифровой подписи для предоставленных данных. (Унаследовано от ECDsa)
VerifyData(Byte[], Int32, Int32, Byte[])	Проверяет подпись для фрагмента данных указанной длины, начиная с указанной позиции.
VerifyData(Byte[], Int32, Int32, Byte[], HashAlgorithmName)	Проверяет, подходит ли цифровая подпись для используемого ключа и предоставленного фрагмента данных, с помощью указанного хэш-алгоритма. (Унаследовано от ECDsa)
VerifyData(Byte[], Int32, Int32, Byte[], HashAlgorithmName, DSASignatureFormat)	Проверяет допустимость цифровой подписи для предоставленных данных. (Унаследовано от ECDsa)
VerifyData(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, HashAlgorithmName)	Проверяет, подходит ли цифровая подпись для текущего ключа и заданных данных, с помощью указанного хэш-алгоритма. (Унаследовано от ECDsa)
VerifyData(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, HashAlgorithmName, DSASignatureFormat)	Проверяет допустимость цифровой подписи для предоставленных данных. (Унаследовано от ECDsa)
VerifyData(Stream, Byte[])	Проверяет цифровую подпись для указанного потока данных, перемещая позицию чтения в конец потока.
VerifyData(Stream, Byte[], HashAlgorithmName)	Проверяет, подходит ли цифровая подпись для текущего ключа и заданных данных, с помощью указанного хэш-алгоритма. (Унаследовано от ECDsa)
VerifyData(Stream, Byte[], HashAlgorithmName, DSASignatureFormat)	Проверяет допустимость цифровой подписи для предоставленных данных. (Унаследовано от ECDsa)
VerifyDataCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, HashAlgorithmName, DSASignatureFormat)	Проверяет допустимость цифровой подписи для предоставленных данных. (Унаследовано от ECDsa)
VerifyDataCore(Stream, ReadOnlySpan<Byte>, HashAlgorithmName, DSASignatureFormat)	Проверяет допустимость цифровой подписи для предоставленных данных. (Унаследовано от ECDsa)
VerifyHash(Byte[], Byte[])	Проверяет, подходит ли цифровая подпись для используемого ключа и заданного хэша данных.
VerifyHash(Byte[], Byte[], DSASignatureFormat)	Проверяет допустимость цифровой подписи для предоставленного хэша. (Унаследовано от ECDsa)
VerifyHash(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)	Проверяет, подходит ли цифровая подпись для используемого ключа и заданного хэша данных.
VerifyHash(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, DSASignatureFormat)	Проверяет допустимость цифровой подписи для предоставленного хэша. (Унаследовано от ECDsa)
VerifyHashCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, DSASignatureFormat)	Проверяет допустимость цифровой подписи для предоставленного хэша. (Унаследовано от ECDsa)