ChaCha20Poly1305.Decrypt Método

Definição

Namespace:

System.Security.Cryptography

Assembly:

System.Security.Cryptography.dll

Sobrecargas

Decrypt(Byte[], Byte[], Byte[], Byte[], Byte[])	Descriptografa o texto criptografado no buffer de destino fornecido se a marca de autenticação puder ser validada.
Decrypt(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, ReadOnlySpan<Byte>)	Descriptografa o texto criptografado no buffer de destino fornecido se a marca de autenticação puder ser validada.

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

Origem:

ChaCha20Poly1305.cs

Descriptografa o texto criptografado no buffer de destino fornecido se a marca de autenticação puder ser validada.

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)

Parâmetros

nonce

Byte[]

O nonce associado a essa mensagem, que deve corresponder ao valor fornecido durante a criptografia.

ciphertext

Byte[]

O conteúdo criptografado a ser descriptografado.

tag

Byte[]

A marca de autenticação produzida para essa mensagem durante a criptografia.

plaintext

Byte[]

A matriz de bytes para receber o conteúdo descriptografado.

associatedData

Byte[]

Dados extras associados a essa mensagem, que devem corresponder ao valor fornecido durante a criptografia.

Exceções

ArgumentException

O parâmetro plaintext e o ciphertext não têm o mesmo comprimento.

-ou-

O comprimento do parâmetro nonce não é de 12 bytes (96 bits).

-ou-

O comprimento do parâmetro tag não é de 16 bytes (128 bits).

ArgumentNullException

O parâmetro nonce, ciphertext, tagou plaintext é null.

CryptographicException

Falha na operação de descriptografia. Antes do .NET 8, indica que o valor da marca não pôde ser verificado.

AuthenticationTagMismatchException

.NET 8 e versões posteriores: o valor da marca não pôde ser verificado.

Comentários

Se tag não puder ser validado (usando os valores de chave, nonce, ciphertexte associatedData), plaintext será desmarcada.

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

Origem:

ChaCha20Poly1305.cs

Descriptografa o texto criptografado no buffer de destino fornecido se a marca de autenticação puder ser validada.

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)

Parâmetros

nonce

ReadOnlySpan<Byte>

O nonce associado a essa mensagem, que deve corresponder ao valor fornecido durante a criptografia.

ciphertext

ReadOnlySpan<Byte>

O conteúdo criptografado a ser descriptografado.

tag

ReadOnlySpan<Byte>

A marca de autenticação produzida para essa mensagem durante a criptografia.

plaintext

Span<Byte>

A matriz de bytes para receber o conteúdo descriptografado.

associatedData

ReadOnlySpan<Byte>

Dados extras associados a essa mensagem, que devem corresponder ao valor fornecido durante a criptografia.

Exceções

ArgumentException

O parâmetro plaintext e o ciphertext não têm o mesmo comprimento.

-ou-

O comprimento do parâmetro nonce não é de 12 bytes (96 bits).

-ou-

O comprimento do parâmetro tag não é de 16 bytes (128 bits).

CryptographicException

Falha na operação de descriptografia. Antes do .NET 8, indica que o valor da marca não pôde ser verificado.

AuthenticationTagMismatchException

.NET 8 e versões posteriores: o valor da marca não pôde ser verificado.

Comentários

Se tag não puder ser validado (usando os valores de chave, nonce, ciphertexte associatedData), plaintext será desmarcada.