Pkcs12Info.VerifyMac Método

Definição

Namespace:

System.Security.Cryptography.Pkcs

Assembly:

System.Security.Cryptography.Pkcs.dll

Pacote:

System.Security.Cryptography.Pkcs v9.0.0-preview.6.24327.7

Tenta verificar a integridade do conteúdo AuthenticatedSafe com uma senha.

Sobrecargas

VerifyMac(ReadOnlySpan<Char>)	Tenta verificar a integridade do conteúdo AuthenticatedSafe com uma senha representada por um System.ReadOnlySpan{System.Char}.
VerifyMac(String)	Tenta verificar a integridade do conteúdo AuthenticatedSafe com uma senha representada por um String.

Comentários

Não é possível distinguir o erro devido à senha estar incorreta do erro devido ao conteúdo ter sido alterado.

Geralmente, é o caso de um PFX protegido por senha usar a mesma senha para o algoritmo MAC que fornece integridade e o algoritmo de criptografia fornecendo confidencialidade, mas o formato de arquivo não torna isso um requisito. Portanto, não há nenhuma garantia de que uma senha que resulte em um true retorno desse método terá êxito em uma chamada para Decrypt.

VerifyMac(ReadOnlySpan<Char>)

Origem:

Pkcs12Info.cs

Tenta verificar a integridade do conteúdo AuthenticatedSafe com uma senha representada por um System.ReadOnlySpan{System.Char}.

public:
 bool VerifyMac(ReadOnlySpan<char> password);

public bool VerifyMac (ReadOnlySpan<char> password);

member this.VerifyMac : ReadOnlySpan<char> -> bool

Public Function VerifyMac (password As ReadOnlySpan(Of Char)) As Boolean

Parâmetros

password

ReadOnlySpan<Char>

A senha a ser usada para tentar verificar a integridade.

Retornos

Boolean

true se a senha verificar a integridade do conteúdo de AuthenticatedSafe com êxito; false se a senha não estiver correta ou se o conteúdo tiver sido alterado.

Exceções

InvalidOperationException

O valor IntegrityMode não é um Password.

CryptographicException

A opção de algoritmo de hash especificada pelo conteúdo PFX PKCS nº 12 não pôde ser identificada ou não é compatível nesta plataforma.

Comentários

Na especificação PKCS#12, uma distinção é feita entre uma null senha e uma senha "vazia", e essa diferença é refletida no valor retornado desse método. ReadOnlySpan<Char>.Empty representa a null senha e String.Empty.AsSpan() representa a senha "vazia". Se um desses dois valores retornar true, o outro não.

VerifyMac(String)

Origem:

Pkcs12Info.cs

Tenta verificar a integridade do conteúdo AuthenticatedSafe com uma senha representada por um String.

public:
 bool VerifyMac(System::String ^ password);

public bool VerifyMac (string? password);

member this.VerifyMac : string -> bool

Public Function VerifyMac (password As String) As Boolean

Parâmetros

password

String

A senha a ser usada para tentar verificar a integridade.

Retornos

Boolean

true se a senha verificar a integridade do conteúdo de AuthenticatedSafe com êxito; false se a senha não estiver correta ou se o conteúdo tiver sido alterado.

Exceções

InvalidOperationException

O valor IntegrityMode não é um Password.

CryptographicException

A opção de algoritmo de hash especificada pelo conteúdo PFX PKCS nº 12 não pôde ser identificada ou não é compatível nesta plataforma.

Comentários

Na especificação PKCS#12, uma distinção é feita entre uma null senha e uma senha "vazia", e essa diferença é refletida no valor retornado desse método. Se a cadeia null de caracteres retornar true, retornará String.Emptyfalsee vice-versa.