AesGcm.Decrypt Methode

  • Referenz

Definition

Namespace:
System.Security.Cryptography
Assembly:
System.Security.Cryptography.Algorithms.dll
Assembly:
System.Security.Cryptography.dll
Assembly:
netstandard.dll

Überlädt

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

Entschlüsselt den Chiffretext in den angegebenen Zielpuffer, wenn das Authentifizierungstag validiert werden kann.
Decrypt(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, ReadOnlySpan<Byte>)

Entschlüsselt den Chiffretext in den angegebenen Zielpuffer, wenn das Authentifizierungstag validiert werden kann.

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

Entschlüsselt den Chiffretext in den angegebenen Zielpuffer, wenn das Authentifizierungstag validiert werden kann.

public void Decrypt (byte[] nonce, byte[] ciphertext, byte[] tag, byte[] plaintext, byte[]? associatedData = default);
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)

Parameter

nonce
Byte[]

Die dieser Nachricht zugeordneten Nonce, die mit dem Wert übereinstimmen muss, der während der Verschlüsselung bereitgestellt wird.

ciphertext
Byte[]

Der verschlüsselte Inhalt, der entschlüsselt werden soll.

tag
Byte[]

Das Authentifizierungstag, das während der Verschlüsselung für diese Nachricht produziert wird.

plaintext
Byte[]

Das Bytearray, das den entschlüsselten Inhalt empfangen soll.

associatedData
Byte[]

Die dieser Nachricht zugeordneten zusätzlichen Daten, die mit dem Wert übereinstimmen müssen, der während der Verschlüsselung bereitgestellt wird.

Ausnahmen

ArgumentException

Die Parameter plaintext und ciphertext weisen nicht die gleiche Länge auf.

- oder -

Die Länge des nonce-Parameters wird von NonceByteSizes nicht zugelassen.

- oder -

Die Länge des tag-Parameters wird von TagByteSizes nicht zugelassen.

ArgumentNullException

Der Parameter nonce, ciphertext,tag oder plaintext ist null.

CryptographicException

Der Tagwert konnte nicht verifiziert werden, oder der Entschlüsselungsvorgang ist anderweitig fehlgeschlagen.

Hinweise

Wenn tag nicht überprüft werden kann (mithilfe des Schlüssels, nonce``ciphertext, des Werts und associatedData der Werte), wird dann plaintext gelöscht.

Gilt für

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

Entschlüsselt den Chiffretext in den angegebenen Zielpuffer, wenn das Authentifizierungstag validiert werden kann.

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)

Parameter

nonce
ReadOnlySpan<Byte>

Die dieser Nachricht zugeordneten Nonce, die mit dem Wert übereinstimmen muss, der während der Verschlüsselung bereitgestellt wird.

ciphertext
ReadOnlySpan<Byte>

Der verschlüsselte Inhalt, der entschlüsselt werden soll.

tag
ReadOnlySpan<Byte>

Das Authentifizierungstag, das während der Verschlüsselung für diese Nachricht produziert wird.

plaintext
Span<Byte>

Die Bytespanne, die den entschlüsselten Inhalt empfangen soll.

associatedData
ReadOnlySpan<Byte>

Die dieser Nachricht zugeordneten zusätzlichen Daten, die mit dem Wert übereinstimmen müssen, der während der Verschlüsselung bereitgestellt wird.

Ausnahmen

ArgumentException

Die Parameter plaintext und ciphertext weisen nicht die gleiche Länge auf.

- oder -

Die Länge des nonce-Parameters wird von NonceByteSizes nicht zugelassen.

- oder -

Die Länge des tag-Parameters wird von TagByteSizes nicht zugelassen.

CryptographicException

Der Tagwert konnte nicht verifiziert werden, oder der Entschlüsselungsvorgang ist anderweitig fehlgeschlagen.

Hinweise

Wenn tag nicht überprüft werden kann (mithilfe des Schlüssels, nonce``ciphertext, des Werts und associatedData der Werte), wird dann plaintext gelöscht.

Gilt für