AesGcm.Encrypt Método

Definición

Espacio de nombres:

System.Security.Cryptography

Ensamblados:

netstandard.dll, System.Security.Cryptography.dll

Sobrecargas

Encrypt(Byte[], Byte[], Byte[], Byte[], Byte[])	Cifra el texto no cifrado en el búfer de destino de texto cifrado y genera la etiqueta de autenticación en un búfer independiente.
Encrypt(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Span<Byte>, ReadOnlySpan<Byte>)	Cifra el texto no cifrado en el búfer de destino de texto cifrado y genera la etiqueta de autenticación en un búfer independiente.

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

Source:

AesGcm.cs

Cifra el texto no cifrado en el búfer de destino de texto cifrado y genera la etiqueta de autenticación en un búfer independiente.

C#

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

Parámetros

nonce

Byte[]

Nonce asociado a este mensaje, que debe ser un valor único para cada operación con la misma clave.

plaintext

Byte[]

Contenido que se va a cifrar.

ciphertext

Byte[]

Matriz de bytes que va a recibir los contenidos cifrados.

tag

Byte[]

Matriz de bytes que va a recibir la etiqueta de autenticación generada.

associatedData

Byte[]

Datos adicionales asociados a este mensaje, que también se deben proporcionar durante el descifrado.

Excepciones

ArgumentException

El parámetro plaintext y ciphertext no tienen la misma longitud.

o bien

NonceByteSizes no permite la longitud del parámetro nonce.

o bien

TagByteSizes no permite la longitud del parámetro tag.

ArgumentNullException

nonce, ciphertext, tag o el parámetro plaintext es null.

CryptographicException

Se ha producido un error en la operación de cifrado.

Comentarios

Las garantías de seguridad del modo de algoritmo AES-GCM requieren que el mismo valor nonce nunca se use dos veces con la misma clave.

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

Source:

AesGcm.cs

Cifra el texto no cifrado en el búfer de destino de texto cifrado y genera la etiqueta de autenticación en un búfer independiente.

C#

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

Parámetros

nonce

ReadOnlySpan<Byte>

Nonce asociado a este mensaje, que debe ser un valor único para cada operación con la misma clave.

plaintext

ReadOnlySpan<Byte>

Contenido que se va a cifrar.

ciphertext

Span<Byte>

Matriz de bytes que va a recibir los contenidos cifrados.

tag

Span<Byte>

Matriz de bytes que va a recibir la etiqueta de autenticación generada.

associatedData

ReadOnlySpan<Byte>

Datos adicionales asociados a este mensaje, que también se deben proporcionar durante el descifrado.

Excepciones

ArgumentException

El parámetro plaintext y ciphertext no tienen la misma longitud.

o bien

NonceByteSizes no permite la longitud del parámetro nonce.

o bien

TagByteSizes no permite la longitud del parámetro tag.

CryptographicException

Se ha producido un error en la operación de cifrado.

Comentarios

Las garantías de seguridad del modo de algoritmo AES-GCM requieren que el mismo valor nonce nunca se use dos veces con la misma clave.