Pkcs12Info.VerifyMac Méthode

Définition

Espace de noms:

System.Security.Cryptography.Pkcs

Assembly:

System.Security.Cryptography.Pkcs.dll

Tente de vérifier l’intégrité du contenu AuthenticatedSafe avec un mot de passe.

Surcharges

VerifyMac(ReadOnlySpan<Char>)	Tente de vérifier l’intégrité du contenu AuthenticatedSafe avec un mot de passe représenté par un System.ReadOnlySpan{System.Char}.
VerifyMac(String)	Tente de vérifier l’intégrité du contenu AuthenticatedSafe avec un mot de passe représenté par un String.

Remarques

Il n’est pas possible de distinguer l’erreur, car le mot de passe est incorrect de l’erreur en raison de la modification du contenu.

Il est généralement le cas qu’un PFX protégé par mot de passe utilise le même mot de passe pour l’algorithme MAC fournissant l’intégrité et l’algorithme de chiffrement assurant la confidentialité, mais le format de fichier n’en fait pas une exigence. Par conséquent, il n’existe aucune garantie qu’un mot de passe qui entraîne un true retour de cette méthode réussira lors d’un appel à Decrypt.

VerifyMac(ReadOnlySpan<Char>)

Tente de vérifier l’intégrité du contenu AuthenticatedSafe avec un mot de passe représenté par un 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

Paramètres

password

ReadOnlySpan<Char>

Mot de passe à utiliser pour tenter de vérifier l’intégrité.

Retours

Boolean

true si le mot de passe vérifie correctement l’intégrité du contenu AuthenticatedSafe ; false si le mot de passe n’est pas correct ou si le contenu a été altéré.

Exceptions

InvalidOperationException

La valeur IntegrityMode n’est pas Password.

CryptographicException

L’option d’algorithme de hachage spécifiée par le contenu PFX PKCS#12 n’a pas pu être identifiée ou n’est pas prise en charge par cette plateforme.

Remarques

Dans la spécification PKCS#12, une distinction est faite entre un null mot de passe et un mot de passe « vide », et cette différence est reflétée dans la valeur de retour de cette méthode. ReadOnlySpan<Char>.Empty représente le null mot de passe et String.Empty.AsSpan() le mot de passe « vide ». Si l’une de ces deux valeurs retourne true, l’autre ne le sera pas.

VerifyMac(String)

Tente de vérifier l’intégrité du contenu AuthenticatedSafe avec un mot de passe représenté par un 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

Paramètres

password

String

Mot de passe à utiliser pour tenter de vérifier l’intégrité.

Retours

Boolean

true si le mot de passe vérifie correctement l’intégrité du contenu AuthenticatedSafe ; false si le mot de passe n’est pas correct ou si le contenu a été altéré.

Exceptions

InvalidOperationException

La valeur IntegrityMode n’est pas Password.

CryptographicException

L’option d’algorithme de hachage spécifiée par le contenu PFX PKCS#12 n’a pas pu être identifiée ou n’est pas prise en charge par cette plateforme.

Remarques

Dans la spécification PKCS#12, une distinction est faite entre un null mot de passe et un mot de passe « vide », et cette différence est reflétée dans la valeur de retour de cette méthode. Si la null chaîne retourne true, String.Empty retourne false, et vice versa.