ChaCha20Poly1305.Encrypt Metoda

Definicja

Przestrzeń nazw:

System.Security.Cryptography

Zestaw:

System.Security.Cryptography.dll

Przeciążenia

Encrypt(Byte[], Byte[], Byte[], Byte[], Byte[])	Szyfruje zwykły tekst w buforze docelowym szyfrowania i generuje tag uwierzytelniania do oddzielnego buforu.
Encrypt(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Span<Byte>, ReadOnlySpan<Byte>)	Szyfruje zwykły tekst w buforze docelowym szyfrowania i generuje tag uwierzytelniania do oddzielnego buforu.

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

Źródło:

ChaCha20Poly1305.cs

Szyfruje zwykły tekst w buforze docelowym szyfrowania i generuje tag uwierzytelniania do oddzielnego buforu.

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)

Parametry

nonce

Byte[]

Wartość niezwiązana z tym komunikatem, która powinna być unikatową wartością dla każdej operacji z tym samym kluczem.

plaintext

Byte[]

Zawartość do zaszyfrowania.

ciphertext

Byte[]

Tablica bajtów do odbierania zaszyfrowanej zawartości.

tag

Byte[]

Tablica bajtów do odbierania wygenerowanego tagu uwierzytelniania.

associatedData

Byte[]

Dodatkowe dane skojarzone z tą wiadomością, które muszą być również udostępniane podczas odszyfrowywania.

Wyjątki

ArgumentException

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

-lub-

Długość parametru nonce nie wynosi 12 bajtów (96 bitów).

-lub-

Długość parametru tag nie wynosi 16 bajtów (128 bitów).

ArgumentNullException

Parametr nonce, ciphertext, taglub plaintext ma wartość null.

CryptographicException

Operacja szyfrowania nie powiodła się.

Uwagi

Gwarancje bezpieczeństwa trybu algorytmu ChaCha20/Poly1305 wymagają, aby ta sama wartość nonce nigdy nie była używana dwukrotnie z tym samym kluczem.

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

Źródło:

ChaCha20Poly1305.cs

Szyfruje zwykły tekst w buforze docelowym szyfrowania i generuje tag uwierzytelniania do oddzielnego buforu.

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)

Parametry

nonce

ReadOnlySpan<Byte>

Wartość niezwiązana z tym komunikatem, która powinna być unikatową wartością dla każdej operacji z tym samym kluczem.

plaintext

ReadOnlySpan<Byte>

Zawartość do zaszyfrowania.

ciphertext

Span<Byte>

Tablica bajtów do odbierania zaszyfrowanej zawartości.

tag

Span<Byte>

Tablica bajtów do odbierania wygenerowanego tagu uwierzytelniania.

associatedData

ReadOnlySpan<Byte>

Dodatkowe dane skojarzone z tą wiadomością, które muszą być również udostępniane podczas odszyfrowywania.

Wyjątki

ArgumentException

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

-lub-

Długość parametru nonce nie wynosi 12 bajtów (96 bitów).

-lub-

Długość parametru tag nie wynosi 16 bajtów (128 bitów).

ArgumentNullException

Parametr nonce, ciphertext, taglub plaintext ma wartość null.

CryptographicException

Operacja szyfrowania nie powiodła się.

Uwagi

Gwarancje bezpieczeństwa trybu algorytmu ChaCha20/Poly1305 wymagają, aby ta sama wartość nonce nigdy nie była używana dwukrotnie z tym samym kluczem.