ChaCha20Poly1305.Encrypt Methode

Definition

Namespace:

System.Security.Cryptography

Assembly:

System.Security.Cryptography.dll

Überlädt

Encrypt(Byte[], Byte[], Byte[], Byte[], Byte[])	Entschlüsselt den Klartext als Chiffretext in den Zielpuffer und generiert das Authentifizierungstag in einem separaten Puffer.
Encrypt(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Span<Byte>, ReadOnlySpan<Byte>)	Entschlüsselt den Klartext als Chiffretext in den Zielpuffer und generiert das Authentifizierungstag in einem separaten Puffer.

Encrypt(Byte[], Byte[], Byte[], Byte[], Byte[])

Quelle:

ChaCha20Poly1305.cs

Entschlüsselt den Klartext als Chiffretext in den Zielpuffer und generiert das Authentifizierungstag in einem separaten Puffer.

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

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

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

Parameter

nonce

Byte[]

Die der Nachricht zugeordnete Nonce, bei der es sich für jeden Vorgang mit demselben Schlüssel um einen eindeutigen Wert handeln sollte.

plaintext

Byte[]

Der zu verschlüsselnde Inhalt.

ciphertext

Byte[]

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

tag

Byte[]

Das Bytearray, das das generierte Authentifizierungstag empfangen soll.

associatedData

Byte[]

Die dieser Nachricht zugeordneten zusätzlichen Daten, die ebenfalls bei der Entschlüsselung bereitgestellt werden müssen.

Ausnahmen

ArgumentException

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

- oder -

Die nonce Parameterlänge beträgt nicht 12 Bytes (96 Bits).

Oder

Die tag Parameterlänge beträgt nicht 16 Bytes (128 Bits).

ArgumentNullException

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

CryptographicException

Der Verschlüsselungsvorgang ist fehlgeschlagen.

Hinweise

Die Sicherheitsgarantien des ChaCha20/Poly1305-Algorithmusmodus erfordern, dass derselbe Noncewert nie zweimal mit demselben Schlüssel verwendet wird.

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

Quelle:

ChaCha20Poly1305.cs

Entschlüsselt den Klartext als Chiffretext in den Zielpuffer und generiert das Authentifizierungstag in einem separaten Puffer.

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

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

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

Parameter

nonce

ReadOnlySpan<Byte>

Die der Nachricht zugeordnete Nonce, bei der es sich für jeden Vorgang mit demselben Schlüssel um einen eindeutigen Wert handeln sollte.

plaintext

ReadOnlySpan<Byte>

Der zu verschlüsselnde Inhalt.

ciphertext

Span<Byte>

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

tag

Span<Byte>

Das Bytearray, das das generierte Authentifizierungstag empfangen soll.

associatedData

ReadOnlySpan<Byte>

Die dieser Nachricht zugeordneten zusätzlichen Daten, die ebenfalls bei der Entschlüsselung bereitgestellt werden müssen.

Ausnahmen

ArgumentException

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

- oder -

Die nonce Parameterlänge beträgt nicht 12 Bytes (96 Bits).

Oder

Die tag Parameterlänge beträgt nicht 16 Bytes (128 Bits).

ArgumentNullException

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

CryptographicException

Der Verschlüsselungsvorgang ist fehlgeschlagen.

Hinweise

Die Sicherheitsgarantien des ChaCha20/Poly1305-Algorithmusmodus erfordern, dass derselbe Noncewert nie zweimal mit demselben Schlüssel verwendet wird.