Class Gost3412_2015_MCryptoServiceProvider

Реализация провайдера ключа по ГОСТ 34.12-2015 М

Inheritance
object
SymmetricAlgorithm
Gost3412_2015_M
Gost3412_2015_MCryptoServiceProvider
Implements
Inherited Members
Namespace: CryptoPro.Security.Cryptography
Assembly: CryptoPro.Security.Cryptography.dll
Syntax
public sealed class Gost3412_2015_MCryptoServiceProvider : Gost3412_2015_M, IDisposable

Constructors

Gost3412_2015_MCryptoServiceProvider()

Создаёт экземпляр провайдера со стандартыми параметрами и случайным ключом.

Declaration
public Gost3412_2015_MCryptoServiceProvider()

Gost3412_2015_MCryptoServiceProvider(CpCspParameters)

Создаёт экземпляр провайдера с указанными параметрами.

Declaration
public Gost3412_2015_MCryptoServiceProvider(CpCspParameters parameters)
Parameters
Type Name Description
CpCspParameters parameters

Gost3412_2015_MCryptoServiceProvider(nint, nint)

Создание объекта симметричного шифрования по HANDLE ключа.

Declaration
public Gost3412_2015_MCryptoServiceProvider(nint keyHandle, nint providerHandle)
Parameters
Type Name Description
nint keyHandle

HANDLE симметричного ключа.
nint providerHandle

HANDLE провайдера.
Remarks

При создании объекта симметричного шифрования параметры ключа устанавливаются в свои значения по умолчанию:

Параметр Значение
IV null
Mode CFB
Padding None
KeySize 256
FeedbackSize 64
BlockSize 64

Класс становится владельцем ДУБЛЯ ключа и закрывает HANDLE при закрытии класса, HANDLE провайдера не дублируется, но увеличивается счетчик его использования (DangerousAddRef).

Exceptions
Type Condition
ArgumentException

Параметр keyHandle содержит ключ не алгоритма ГОСТ 34.12.2015 Магма.

Properties

CipherOid

Параметры шифрования

Declaration
public string CipherOid { get; set; }
Property Value
Type Description
string

Key

Получение или установка ключа используемого для симметричного шифрования.

Declaration
public override byte[] Key { get; set; }
Property Value
Type Description
byte[]

Симметричный ключ в чистом виде.
Overrides
Remarks

Если ключ не был задан, то при получении ключа он будет сгенерирован функцией GenerateKey().

Размер ключа должен быть равен BlockSizeValue, т.е. 256 бит.

Exceptions
Type Condition
ArgumentException

При установке ключа неправильного размера.
CryptographicException

При запрете импорта (экспорта) "чистых" ключей при установке (получении).

Methods

ComputeHash(HashAlgorithm)

Хэширует секретный ключ.

Declaration
public override byte[] ComputeHash(HashAlgorithm hash)
Parameters
Type Name Description
HashAlgorithm hash

Класс, реализующий функцию хэширования.
Returns
Type Description
byte[]

Хэш-значение секретного ключа
Overrides

CreateDecryptor()

Creates a symmetric decryptor object with the current Key property and initialization vector (IV).

Declaration
public override ICryptoTransform CreateDecryptor()
Returns
Type Description
ICryptoTransform

A symmetric decryptor object.
Overrides

CreateDecryptor(byte[], byte[])

When overridden in a derived class, creates a symmetric decryptor object with the specified Key property and initialization vector (IV).

Declaration
public override ICryptoTransform CreateDecryptor(byte[] rgbKey, byte[] rgbIV)
Parameters
Type Name Description
byte[] rgbKey

The secret key to use for the symmetric algorithm.
byte[] rgbIV

The initialization vector to use for the symmetric algorithm.
Returns
Type Description
ICryptoTransform

A symmetric decryptor object.
Overrides

CreateEncryptor()

Creates a symmetric encryptor object with the current Key property and initialization vector (IV).

Declaration
public override ICryptoTransform CreateEncryptor()
Returns
Type Description
ICryptoTransform

A symmetric encryptor object.
Overrides

CreateEncryptor(byte[], byte[])

When overridden in a derived class, creates a symmetric encryptor object with the specified Key property and initialization vector (IV).

Declaration
public override ICryptoTransform CreateEncryptor(byte[] rgbKey, byte[] rgbIV)
Parameters
Type Name Description
byte[] rgbKey

The secret key to use for the symmetric algorithm.
byte[] rgbIV

The initialization vector to use for the symmetric algorithm.
Returns
Type Description
ICryptoTransform

A symmetric encryptor object.
Overrides

Dispose(bool)

Releases the unmanaged resources used by the SymmetricAlgorithm and optionally releases the managed resources.

Declaration
protected override void Dispose(bool disposing)
Parameters
Type Name Description
bool disposing

true to release both managed and unmanaged resources; false to release only unmanaged resources.
Overrides

GenerateIV()

When overridden in a derived class, generates a random initialization vector (IV) to use for the algorithm.

Declaration
public override void GenerateIV()
Overrides

GenerateKey()

When overridden in a derived class, generates a random key (Key) to use for the algorithm.

Declaration
public override void GenerateKey()
Overrides

Unwrap(byte[])

Импортирует (расшифровывает) секретный ключ.

Declaration
public override SymmetricAlgorithm Unwrap(byte[] wrapped)
Parameters
Type Name Description
byte[] wrapped

Зашифрованный секретный ключ.
Returns
Type Description
SymmetricAlgorithm
Overrides

Wrap(Gost3412_2015_M, GostKeyWrapMethod)

Экспортирует (шифрует) секретный ключ.

Declaration
public override byte[] Wrap(Gost3412_2015_M prov, GostKeyWrapMethod method)
Parameters
Type Name Description
Gost3412_2015_M prov

Шифруемый ключ.
GostKeyWrapMethod method

Алгоритм экспорта ключа.
Returns
Type Description
byte[]

Зашифрованный симметричный ключ
Overrides

Implements