Pkcs12Info.VerifyMac Метод

Определение

Пространство имен:

System.Security.Cryptography.Pkcs

Сборка:

System.Security.Cryptography.Pkcs.dll

Пакет:

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

Пытается проверить целостность содержимого AuthenticatedSafe с помощью пароля.

Перегрузки

VerifyMac(ReadOnlySpan<Char>)	Пытается проверить целостность содержимого AuthenticatedSafe с помощью пароля, представленного System.ReadOnlySpan{System.Char}.
VerifyMac(String)	Пытается проверить целостность содержимого AuthenticatedSafe с помощью пароля, представленного String.

Комментарии

Невозможно отличить ошибку из-за неправильного пароля от ошибки из-за изменения содержимого.

Обычно PFX-файл, защищенный паролем, использует один и тот же пароль для алгоритма MAC, обеспечивающего целостность, и алгоритм шифрования, обеспечивающий конфиденциальность, но формат файла не делает это требованием. Таким образом, нет никакой гарантии, что пароль, который приведет к возврату true из этого метода, будет успешно выполнен при вызове Decrypt.

VerifyMac(ReadOnlySpan<Char>)

Исходный код:

Pkcs12Info.cs

Пытается проверить целостность содержимого AuthenticatedSafe с помощью пароля, представленного 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

Параметры

password

ReadOnlySpan<Char>

Пароль, используемый для проверки целостности.

Возвращаемое значение

Boolean

Значение true, если пароль успешно проверяет целостность содержимого AuthenticatedSafe. Значение false, если пароль неправильный и содержимое было изменено.

Исключения

InvalidOperationException

Значение IntegrityMode не является типом Password.

CryptographicException

Вариант хэш-алгоритма, заданный содержимым PFX PKCS#12, не может быть определен или не поддерживается этой платформой.

Комментарии

В спецификации PKCS#12 проводится различие между паролем null и "пустым" паролем, и это различие отражается в возвращаемом значении этого метода. ReadOnlySpan<Char>.Empty представляет null пароль и String.Empty.AsSpan() "пустой" пароль. Если одно из этих двух значений возвращает true, другое не будет.

VerifyMac(String)

Исходный код:

Pkcs12Info.cs

Пытается проверить целостность содержимого AuthenticatedSafe с помощью пароля, представленного 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

Параметры

password

String

Пароль, используемый для проверки целостности.

Возвращаемое значение

Boolean

Значение true, если пароль успешно проверяет целостность содержимого AuthenticatedSafe. Значение false, если пароль неправильный и содержимое было изменено.

Исключения

InvalidOperationException

Значение IntegrityMode не является типом Password.

CryptographicException

Вариант хэш-алгоритма, заданный содержимым PFX PKCS#12, не может быть определен или не поддерживается этой платформой.

Комментарии

В спецификации PKCS#12 проводится различие между паролем null и "пустым" паролем, и это различие отражается в возвращаемом значении этого метода. null Если строка возвращает true, то String.Empty возвращает false, и наоборот.