msgverify
msgverify |
Purpose
Synopsis
function msgverify(mdalg:string, key:string, fname:string, sgf:string):integer
function msgverify(key:string, fname:string, sgf:string):integer
Arguments
mdalg
|
Name of the message digest algorithm to use
|
key
|
Name of the public key file to use
|
fname
|
File to verify
|
sgf
|
Signature used for the verification
|
Return value
1 if the signature is valid,
0 if the verification failed and
-1 in the case of an error.
Further information
1. This function verifies the digital signature of a document by comparing the message digest of the document with the information obtained by decrypting the provided signature with a given RSA public key. Typically this signature has been obtained with the function
msgsign and the appropriate private key.
2. If no message digest algorithm is specified, the default algorithm defined by the control parameter
ssl_digest is used. Note that the same algorithm has to be used for both signing and verifying.
3. If the key file name does not include an explicit path (
e.g.
"somekey"), it is searched for in the default public keys directory located at
getparam("ssl_dir")+"/pubkeys" instead of the current working directory. It is required to prefix the key file name with
"./" in order to access a key file from the current directory (
e.g.
"./somekey").
Related topics
Module