Rogue Wave banner
Previous fileTop of DocumentContentsIndex pageNext file
Secure Communication Module User's Guide
Rogue Wave web site:  Home Page  |  Main Documentation Page

5.3 sing Encrypted Keys

Private keys are sensitive pieces of information. With the private key of a system, attackers could read every encrypted message sent to that system and could also forge messages that would appear to have come from the real owner of the private key.

Unencrypted private keys should not be stored on any media device that is not physically secure.

To protect against stolen private keys, you can encrypt them with a passphrase at their time of creation. Passphrases should not be stored on or near a computer that contains encrypted keys.

When RWAsymmetricKey loads a key and finds that it is encrypted, it invokes the password callback function. The password callback function is specified using the RWPasswordCallback parameter in the RWAsymmetricKey constructor. The password callback function sends the password to the cryptographic library.

In an interactive system, you could write the callback so that it presents the user with a dialog box that prompts for a password, and then returns that password to the system.

If an encrypted key is loaded, but a password callback is not specified, the exception RWUnableToReadPrivateKeyError is thrown. An exception is also thrown when the password supplied to the system through the callback is incorrect. For more information, see RWAsymmetricKey in the SourcePro C++ API Reference Guide.

See Section 5.5.1, "Password Callback," for details on writing the callback function.

Previous fileTop of DocumentContentsNo linkNext file

Copyright © Rogue Wave Software, Inc. All Rights Reserved.

The Rogue Wave name and logo, and SourcePro, are registered trademarks of Rogue Wave Software. All other trademarks are the property of their respective owners.
Provide feedback to Rogue Wave about its documentation.