Authenticate the use of Encrypted Variables

$authenticate digest

This command is used to authenticate the use of encrypted variables in a special recipient template file for use with the Copia SMTP Gateway.  When the generated digest is valid,  a variable named SECRETx may be expanded as the passphrase of an $email_decrypt_keyfile command.

The parameter on this command is used as follows:

digesta digest computed automatically from the contents of the file.  This parameter is always generated (by COPIAEDIT), never entered manually.

When an template is to be authenticated, you should enter this command, without parameters, as the first line of the file.  On saving the file, you will be prompted for the password assigned by the administrator in the CFHWL configurator.  Provided that the password is correct (and that a password is present in the configuration file) the digest will automatically be added (and displayed) as the file is saved.  If you edit an authenticated file, a new digest will be computed in the same way when you save it.

When the SMTP Gateway processes the template, any expansions of a SECRETx in the absence of authentication will cause the operation to fail.

Example:

$authenticate E0CA61A65F5CC162182207CF3E5BF18BAF4FC95A