Pkcs12Info.VerifyMac Método

Definición

Espacio de nombres:

System.Security.Cryptography.Pkcs

Ensamblado:

System.Security.Cryptography.Pkcs.dll

Paquete:

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

Intenta verificar la integridad del contenido AuthenticatedSafe con una contraseña.

Sobrecargas

VerifyMac(ReadOnlySpan<Char>)	Intenta verificar la integridad del contenido AuthenticatedSafe con una contraseña representada por System.ReadOnlySpan{System.Char}.
VerifyMac(String)	Intenta verificar la integridad del contenido AuthenticatedSafe con una contraseña representada por String.

Comentarios

No es posible distinguir el error debido a que la contraseña es incorrecta del error debido a que se ha modificado el contenido.

Normalmente, es el caso de que un PFX protegido con contraseña use la misma contraseña para el algoritmo MAC que proporciona integridad y el algoritmo de cifrado que proporciona confidencialidad, pero el formato de archivo no hace que sea un requisito. Por lo tanto, no hay ninguna garantía de que una contraseña que da como resultado una true devolución de este método se realizará correctamente en una llamada a Decrypt.

VerifyMac(ReadOnlySpan<Char>)

Source:

Pkcs12Info.cs

Intenta verificar la integridad del contenido AuthenticatedSafe con una contraseña representada por 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>

La contraseña que se va a usar para intentar verificar la integridad.

Devoluciones

Boolean

true si la contraseña verifica correctamente la integridad del contenido de AuthenticatedSafe; false si la contraseña no es correcta o si se ha alterado el contenido.

Excepciones

InvalidOperationException

El valor IntegrityMode no es Password.

CryptographicException

No se pudo identificar la opción de algoritmo hash especificada por el contenido de PKCS#12 PFX o no es compatible con esta plataforma.

Comentarios

En la especificación PKCS#12, se distingue entre una null contraseña y una contraseña "vacía", y esa diferencia se refleja en el valor devuelto de este método. ReadOnlySpan<Char>.Empty representa la null contraseña y String.Empty.AsSpan() representa la contraseña "vacía". Si uno de esos dos valores devuelve true, el otro no.

VerifyMac(String)

Source:

Pkcs12Info.cs

Intenta verificar la integridad del contenido AuthenticatedSafe con una contraseña representada por 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

La contraseña que se va a usar para intentar verificar la integridad.

Devoluciones

Boolean

true si la contraseña verifica correctamente la integridad del contenido de AuthenticatedSafe; false si la contraseña no es correcta o si se ha alterado el contenido.

Excepciones

InvalidOperationException

El valor IntegrityMode no es Password.

CryptographicException

No se pudo identificar la opción de algoritmo hash especificada por el contenido de PKCS#12 PFX o no es compatible con esta plataforma.

Comentarios

En la especificación PKCS#12, se distingue entre una null contraseña y una contraseña "vacía", y esa diferencia se refleja en el valor devuelto de este método. Si la null cadena devuelve true, String.Empty devuelve falsey viceversa.