Filter
Top Products
CCA Release 2.54 Digital_Signature_Verify
Digital_Signature_Verify (CSNDDSV)
Platform/
Product
OS/2 AIX Win NT/
2000
OS/400
IBM 4758-2/23 X X X X
The Digital_Signature_Verify verb is used to verify a digital signature.
Provide the digital signature, the public key, the hash formatting method, and the
hash of the data to be validated. The hash quantity may be created through use of
the One_Way_Hash or the MDC_Generate verbs.
For RSA, the hash formatting method is selected through keywords in the rule
array. The supplied hash information is formatted and compared to the public-key
ciphered digital signature.
If the digital signature is validated, the verb returns a return code of zero. If the
digital signature is not validated, and there are no other problems, the verb returns
a return code of 4 and reason code of 429 (decimal).
Restrictions
Not all CCA implementations support each formatting method.
Format
CSNDDSV
return_code Output Integer
reason_code Output Integer
exit_data_length In/Output Integer
exit_data In/Output String exit_data_length bytes
rule_array_count Input Integer zero or one
rule_array Input String
array
rule_array_count * 8 bytes
PKA_public_key_identifier_length Input Integer
PKA_public_key_identifier Input String PKA_public_key_identifier_length
bytes
hash_length Input Integer
hash Input String hash_length bytes
signature_field_length Input Integer
signature_field Input String signature_field_length bytes
Parameters
For the definitions of the return_code, reason_code, exit_data_length, and exit_data
parameters, see “Parameters Common to All Verbs” on page 1-11.
rule_array_count
The rule_array_count parameter is a pointer to an integer variable containing
the number of elements in the rule_array variable. The value must be zero or
one.
rule_array
The rule_array parameter is a pointer to a string variable containing an array of
keywords. The keywords are eight bytes in length, and must be left-justified
and padded on the right with space characters. The rule_array keywords are
shown below:
Chapter 4. Hashing and Digital Signatures 4-7