ChaCha20Poly1305.Decrypt Metodo

Definizione

Spazio dei nomi:

System.Security.Cryptography

Assembly:

System.Security.Cryptography.dll

Overload

Decrypt(Byte[], Byte[], Byte[], Byte[], Byte[])	Decrittografa il testo crittografato nel buffer di destinazione fornito se il tag di autenticazione può essere convalidato.
Decrypt(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, ReadOnlySpan<Byte>)	Decrittografa il testo crittografato nel buffer di destinazione fornito se il tag di autenticazione può essere convalidato.

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

Origine:

ChaCha20Poly1305.cs

Decrittografa il testo crittografato nel buffer di destinazione fornito se il tag di autenticazione può essere convalidato.

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)

Parametri

nonce

Byte[]

Il nonce associato a questo messaggio, che deve corrispondere al valore specificato durante la crittografia.

ciphertext

Byte[]

Contenuto crittografato da decrittografare.

tag

Byte[]

Tag di autenticazione generato per questo messaggio durante la crittografia.

plaintext

Byte[]

Matrice di byte per ricevere il contenuto decrittografato.

associatedData

Byte[]

Dati aggiuntivi associati a questo messaggio, che devono corrispondere al valore specificato durante la crittografia.

Eccezioni

ArgumentException

Il parametro plaintext e il ciphertext non hanno la stessa lunghezza.

-o-

La lunghezza del parametro nonce non è di 12 byte (96 bit).

-o-

La lunghezza del parametro tag non è di 16 byte (128 bit).

ArgumentNullException

Il parametro nonce, ciphertext, tago plaintext è null.

CryptographicException

Operazione di decrittografia non riuscita. Prima di .NET 8, indica che non è stato possibile verificare il valore del tag.

AuthenticationTagMismatchException

.NET 8 e versioni successive: non è stato possibile verificare il valore del tag.

Commenti

Se tag non può essere convalidato (usando la chiave, nonce, ciphertexte i valori di associatedData), plaintext viene cancellato.

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

Origine:

ChaCha20Poly1305.cs

Decrittografa il testo crittografato nel buffer di destinazione fornito se il tag di autenticazione può essere convalidato.

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)

Parametri

nonce

ReadOnlySpan<Byte>

Il nonce associato a questo messaggio, che deve corrispondere al valore specificato durante la crittografia.

ciphertext

ReadOnlySpan<Byte>

Contenuto crittografato da decrittografare.

tag

ReadOnlySpan<Byte>

Tag di autenticazione generato per questo messaggio durante la crittografia.

plaintext

Span<Byte>

Matrice di byte per ricevere il contenuto decrittografato.

associatedData

ReadOnlySpan<Byte>

Dati aggiuntivi associati a questo messaggio, che devono corrispondere al valore specificato durante la crittografia.

Eccezioni

ArgumentException

Il parametro plaintext e il ciphertext non hanno la stessa lunghezza.

-o-

La lunghezza del parametro nonce non è di 12 byte (96 bit).

-o-

La lunghezza del parametro tag non è di 16 byte (128 bit).

CryptographicException

Operazione di decrittografia non riuscita. Prima di .NET 8, indica che non è stato possibile verificare il valore del tag.

AuthenticationTagMismatchException

.NET 8 e versioni successive: non è stato possibile verificare il valore del tag.

Commenti

Se tag non può essere convalidato (usando la chiave, nonce, ciphertexte i valori di associatedData), plaintext viene cancellato.