@BinaryAuthenticate

Parent Previous Next

@BinaryAuthenticate.

Does a public key authentication of a data blob and a signature blob to verify, that the data bytes have not been tampered with since the signature was created using a secret private key.


Syntax.


 @BinaryAuthenticate(Blob bytes, signature, publicKey; String hashAlgorithm) : Boolean

 


Arguments:


Returns true if authentication succeeds. If it fails, it may throw an error containing an error number from the Microsoft Cryptographic API.


Example:


 Function BytesMatchSignature(Blob bytes, signature, publicKey) : Boolean

 {

   Return @BinaryAuthenticate(bytes, signature, publicKey, "SHA1");

 }



TIP: Authentication uses the Microsoft Cryptographic API (CryptoAPI or CAPI) based on the little endian byte order format. When working with projects involving .NET, Java etc., you may have to convert (reverse) the byte order as demonstrated in the RSA Signature Example.