AesGcm.Decrypt Metoda

Definicja

Przestrzeń nazw:

System.Security.Cryptography

Zestaw:

System.Security.Cryptography.dll

Przeciążenia

Decrypt(Byte[], Byte[], Byte[], Byte[], Byte[])	Odszyfrowuje tekst szyfrowania do udostępnionego buforu docelowego, jeśli można zweryfikować tag uwierzytelniania.
Decrypt(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, ReadOnlySpan<Byte>)	Odszyfrowuje tekst szyfrowania do udostępnionego buforu docelowego, jeśli można zweryfikować tag uwierzytelniania.

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

Źródło:

AesGcm.cs

Odszyfrowuje tekst szyfrowania do udostępnionego buforu docelowego, jeśli można zweryfikować tag uwierzytelniania.

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)

Parametry

nonce

Byte[]

Wartość niezwiązana z tym komunikatem, która musi być zgodna z wartością podaną podczas szyfrowania.

ciphertext

Byte[]

Zaszyfrowana zawartość do odszyfrowywania.

tag

Byte[]

Tag uwierzytelniania wygenerowany dla tego komunikatu podczas szyfrowania.

plaintext

Byte[]

Tablica bajtów do odbierania odszyfrowanej zawartości.

associatedData

Byte[]

Dodatkowe dane skojarzone z tym komunikatem, które muszą być zgodne z wartością podaną podczas szyfrowania.

Wyjątki

ArgumentException

Parametr plaintext i ciphertext nie mają tej samej długości.

-lub-

Długość parametru nonce nie jest dozwolona przez NonceByteSizes.

-lub-

Długość parametru tag nie jest dozwolona przez TagByteSizes.

ArgumentNullException

Parametr nonce, ciphertext, taglub plaintext jest null.

CryptographicException

Operacja odszyfrowywania nie powiodła się. Przed platformą .NET 8 wskazuje, że nie można zweryfikować wartości tagu.

AuthenticationTagMismatchException

.NET 8 i nowsze wersje: nie można zweryfikować wartości tagu.

Uwagi

Jeśli nie można zweryfikować tag (przy użyciu klucza nonce, ciphertexti wartości associatedData), plaintext zostanie wyczyszczone.

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

Źródło:

AesGcm.cs

Odszyfrowuje tekst szyfrowania do udostępnionego buforu docelowego, jeśli można zweryfikować tag uwierzytelniania.

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)

Parametry

nonce

ReadOnlySpan<Byte>

Wartość niezwiązana z tym komunikatem, która musi być zgodna z wartością podaną podczas szyfrowania.

ciphertext

ReadOnlySpan<Byte>

Zaszyfrowana zawartość do odszyfrowywania.

tag

ReadOnlySpan<Byte>

Tag uwierzytelniania wygenerowany dla tego komunikatu podczas szyfrowania.

plaintext

Span<Byte>

Zakres bajtów do odbierania odszyfrowanej zawartości.

associatedData

ReadOnlySpan<Byte>

Dodatkowe dane skojarzone z tym komunikatem, które muszą być zgodne z wartością podaną podczas szyfrowania.

Wyjątki

ArgumentException

Parametr plaintext i ciphertext nie mają tej samej długości.

-lub-

Długość parametru nonce nie jest dozwolona przez NonceByteSizes.

-lub-

Długość parametru tag nie jest dozwolona przez TagByteSizes.

CryptographicException

Operacja odszyfrowywania nie powiodła się. Przed platformą .NET 8 wskazuje, że nie można zweryfikować wartości tagu.

AuthenticationTagMismatchException

.NET 8 i nowsze wersje: nie można zweryfikować wartości tagu.

Uwagi

Jeśli nie można zweryfikować tag (przy użyciu klucza nonce, ciphertexti wartości associatedData), plaintext zostanie wyczyszczone.