Pkcs12Info.VerifyMac メソッド

定義

名前空間:

System.Security.Cryptography.Pkcs

アセンブリ:

System.Security.Cryptography.Pkcs.dll

パッケージ:

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

パスワードを使用して AuthenticatedSafe の内容の整合性の検証を試みます。

オーバーロード

VerifyMac(ReadOnlySpan<Char>)	System.ReadOnlySpan{System.Char} によって表されたパスワードを使用して、AuthenticatedSafe の内容の整合性の検証を試みます。
VerifyMac(String)	String によって表されたパスワードを使用して、AuthenticatedSafe の内容の整合性の検証を試みます。

注釈

パスワードが正しくないためのエラーと、内容が変更されたためのエラーを区別することはできません。

通常、パスワードで保護された PFX では、整合性を提供する MAC アルゴリズムと機密性を提供する暗号化アルゴリズムに同じパスワードが使用されますが、ファイル形式では要件が満たされません。 したがって、 への呼び出しDecryptでtrue、このメソッドから返されるパスワードが成功するという保証はありません。

VerifyMac(ReadOnlySpan<Char>)

ソース:

Pkcs12Info.cs

System.ReadOnlySpan{System.Char} によって表されたパスワードを使用して、AuthenticatedSafe の内容の整合性の検証を試みます。

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

パスワードによって AuthenticatedSafe の内容の整合性が正常に検証された場合は true、パスワードが正しくない場合、または内容が変更されている場合は false。

例外

InvalidOperationException

IntegrityMode の値が Password ではありません。

CryptographicException

PKCS#12 PFX の内容によって指定されたハッシュ アルゴリズム オプションは、識別できなかったか、またはこのプラットフォームでサポートされていません。

注釈

PKCS#12 仕様では、パスワードと "空" のパスワードが区別 null され、その違いがこのメソッドの戻り値に反映されます。 ReadOnlySpan<Char>.Empty はパスワードを null 表し、 String.Empty.AsSpan() "空" のパスワードを表します。 これら 2 つの値のいずれかが を返す true場合、もう一方の値は返されません。

VerifyMac(String)

ソース:

Pkcs12Info.cs

String によって表されたパスワードを使用して、AuthenticatedSafe の内容の整合性の検証を試みます。

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

パスワードによって AuthenticatedSafe の内容の整合性が正常に検証された場合は true、パスワードが正しくない場合、または内容が変更されている場合は false。

例外

InvalidOperationException

IntegrityMode の値が Password ではありません。

CryptographicException

PKCS#12 PFX の内容によって指定されたハッシュ アルゴリズム オプションは、識別できなかったか、またはこのプラットフォームでサポートされていません。

注釈

PKCS#12 仕様では、パスワードと "空" のパスワードが区別 null され、その違いがこのメソッドの戻り値に反映されます。 文字列が を null 返す場合は trueを返し String.Empty 、その逆も返します false。