MLKem.Decapsulate Método

Definição

Namespace:

System.Security.Cryptography

Assembly:

System.Security.Cryptography.dll

Descapsula um segredo compartilhado de um texto criptografado fornecido.

Sobrecargas

Nome	Description
Decapsulate(Byte[])	Descapsula um segredo compartilhado de um texto criptografado fornecido.
Decapsulate(ReadOnlySpan<Byte>, Span<Byte>)	Descapsula um segredo compartilhado de um texto criptografado fornecido.

Decapsulate(Byte[])

Origem:

MLKem.cs

Descapsula um segredo compartilhado de um texto criptografado fornecido.

public:
 cli::array <System::Byte> ^ Decapsulate(cli::array <System::Byte> ^ ciphertext);

public byte[] Decapsulate(byte[] ciphertext);

member this.Decapsulate : byte[] -> byte[]

Public Function Decapsulate (ciphertext As Byte()) As Byte()

Parâmetros

ciphertext

Byte[]

O texto criptografado.

Retornos

Byte[]

O segredo compartilhado.

Exceções

CryptographicException

Ocorreu um erro durante a descapsulação.

ArgumentException

ciphertext não é o tamanho correto.

ArgumentNullException

ciphertext é null.

ObjectDisposedException

O objeto já foi descartado.

Comentários

A descapsulação só pode descapsular um segredo compartilhado criado com a chave de encapsulamento correspondente da chave de decapsulação. Se uma chave diferente for usada, ML-KEM executará a rejeição implícita.

A rejeição implícita significa que um erro não será retornado. Em vez disso, o segredo compartilhado será um resultado determinístico, mas incorreto.

Detectar o uso incorreto de chaves é uma preocupação para os consumidores do algoritmo ML-KEM.

Para obter mais informações, consulte FIPS 203, Seção 6.3.

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

Origem:

MLKem.cs

Descapsula um segredo compartilhado de um texto criptografado fornecido.

public:
 void Decapsulate(ReadOnlySpan<System::Byte> ciphertext, Span<System::Byte> sharedSecret);

public void Decapsulate(ReadOnlySpan<byte> ciphertext, Span<byte> sharedSecret);

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

Public Sub Decapsulate (ciphertext As ReadOnlySpan(Of Byte), sharedSecret As Span(Of Byte))

Parâmetros

ciphertext

ReadOnlySpan<Byte>

O texto criptografado.

sharedSecret

Span<Byte>

O buffer para receber o segredo compartilhado.

Exceções

CryptographicException

Ocorreu um erro durante a descapsulação.

ArgumentException

ciphertext não é o tamanho correto.

- ou -

sharedSecret não é o tamanho correto.

ObjectDisposedException

O objeto já foi descartado.

Comentários

A descapsulação só pode descapsular um segredo compartilhado criado com a chave de encapsulamento correspondente da chave de decapsulação. Se uma chave diferente for usada, ML-KEM executará a rejeição implícita.

A rejeição implícita significa que um erro não será retornado. Em vez disso, o segredo compartilhado será um resultado determinístico, mas incorreto.

Detectar o uso incorreto de chaves é uma preocupação para os consumidores do algoritmo ML-KEM.

Para obter mais informações, consulte FIPS 203, Seção 6.3.