UniBasic Commands Reference - Rocket Software

generateKey
Syntax
generateKey(priveKey, pubKey, format, keyLoc, algorithm, keyLength, passPhrase,
paramFile)
Note: This function is case-sensitive. If you want it to be case-insensitive, you
must compile your programs using the BASIC command with the -i option.
Description
The generateKey() function generates a public key cryptography key pair and
encrypts the private key. You should then put it into an external key file protected by
the provided pass phrase. UniData SSL sessions can use the protected private key
later to secure communication. The public key will not be encrypted.
The generated private key will be in PKCS #8 form and is encoded in either PEM or
DER format specified by format. The generated public key is in traditional form. If
keyLoc is 1, the resulted key is put into a dynamic array in privKey and pubKey.
Otherwise, they are put into OS level files specified by privKey and pubKey.
To make sure the private key is protected, you must provide a pass phrase. UniData
uses a one-way hash function to derive a symmetric key from the pass phrase to
encrypt the generated key. When installing the private key into a security context with
the setPrivateKey() function, or generating a certificate request with the generate-
CertRequest() function, you must provide this pass phrase to gain access to the
private key.
For detailed information about the generateKey function, see UniBasic Extensions.
1-284 UniBasic Commands Reference