ChaCha20Poly1305.Decrypt Метод

Определение

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

System.Security.Cryptography

Сборка:

System.Security.Cryptography.dll

Расшифровывает зашифрованный текст в предоставленный буфер назначения, если тег проверки подлинности можно проверить.

Перегрузки

Имя	Описание
Decrypt(Byte[], Byte[], Byte[], Byte[], Byte[])	Расшифровывает зашифрованный текст в предоставленный буфер назначения, если тег проверки подлинности можно проверить.
Decrypt(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, ReadOnlySpan<Byte>)	Расшифровывает зашифрованный текст в предоставленный буфер назначения, если тег проверки подлинности можно проверить.

Decrypt(Byte[], Byte[], Byte[], Byte[], Byte[])

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

ChaCha20Poly1305.cs

Расшифровывает зашифрованный текст в предоставленный буфер назначения, если тег проверки подлинности можно проверить.

public void Decrypt(byte[] nonce, byte[] ciphertext, byte[] tag, byte[] plaintext, byte[]? associatedData = default);

member this.Decrypt : byte[] * byte[] * byte[] * byte[] * byte[] -> unit

Public Sub Decrypt (nonce As Byte(), ciphertext As Byte(), tag As Byte(), plaintext As Byte(), Optional associatedData As Byte() = Nothing)

Параметры

nonce

Byte[]

Nonce, связанный с этим сообщением, который должен соответствовать значению, предоставленному во время шифрования.

ciphertext

Byte[]

Зашифрованное содержимое для расшифровки.

tag

Byte[]

Тег проверки подлинности, созданный для этого сообщения во время шифрования.

plaintext

Byte[]

Массив байтов для получения расшифрованного содержимого.

associatedData

Byte[]

Дополнительные данные, связанные с этим сообщением, которые должны соответствовать значению, предоставленному во время шифрования.

Исключения

ArgumentException

Параметр plaintext и ciphertext длина этого параметра не совпадают.

–или–

Длина nonce параметра не составляет 12 байт (96 бит).

–или–

Длина tag параметра не составляет 16 байт (128 бит).

ArgumentNullException

Параметр nonce, , ciphertexttagили plaintext параметрnull.

CryptographicException

Не удалось выполнить операцию расшифровки. До .NET 8 указывает, что значение тега не удалось проверить.

AuthenticationTagMismatchException

.NET 8 и более поздних версий: значение тега не удалось проверить.

Комментарии

Если tag не удается проверить (с помощью ключа, nonceciphertextи associatedData значений), plaintext то удаляется.

Decrypt(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, ReadOnlySpan<Byte>)

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

ChaCha20Poly1305.cs

Расшифровывает зашифрованный текст в предоставленный буфер назначения, если тег проверки подлинности можно проверить.

public void Decrypt(ReadOnlySpan<byte> nonce, ReadOnlySpan<byte> ciphertext, ReadOnlySpan<byte> tag, Span<byte> plaintext, ReadOnlySpan<byte> associatedData = default);

member this.Decrypt : ReadOnlySpan<byte> * ReadOnlySpan<byte> * ReadOnlySpan<byte> * Span<byte> * ReadOnlySpan<byte> -> unit

Public Sub Decrypt (nonce As ReadOnlySpan(Of Byte), ciphertext As ReadOnlySpan(Of Byte), tag As ReadOnlySpan(Of Byte), plaintext As Span(Of Byte), Optional associatedData As ReadOnlySpan(Of Byte) = Nothing)

Параметры

nonce

ReadOnlySpan<Byte>

Nonce, связанный с этим сообщением, который должен соответствовать значению, предоставленному во время шифрования.

ciphertext

ReadOnlySpan<Byte>

Зашифрованное содержимое для расшифровки.

tag

ReadOnlySpan<Byte>

Тег проверки подлинности, созданный для этого сообщения во время шифрования.

plaintext

Span<Byte>

Массив байтов для получения расшифрованного содержимого.

associatedData

ReadOnlySpan<Byte>

Дополнительные данные, связанные с этим сообщением, которые должны соответствовать значению, предоставленному во время шифрования.

Исключения

ArgumentException

Параметр plaintext и ciphertext длина этого параметра не совпадают.

–или–

Длина nonce параметра не составляет 12 байт (96 бит).

–или–

Длина tag параметра не составляет 16 байт (128 бит).

CryptographicException

Не удалось выполнить операцию расшифровки. До .NET 8 указывает, что значение тега не удалось проверить.

AuthenticationTagMismatchException

.NET 8 и более поздних версий: значение тега не удалось проверить.

Комментарии

Если tag не удается проверить (с помощью ключа, nonceciphertextи associatedData значений), plaintext то удаляется.