QtKeychain
==========

QtKeychain is a Qt API to securely write and read passwords. The passwords are stored in the platform's keychain service.
In case there is no such service available, QtKeychain will report an error. It will not store any data unencrypted.

Currently, the following platforms are supported:

Mac OS X
--------

Passwords are stored in the OS X Keychain.

Linux (and other Unixes)
------------------------

If running, KWallet (via D-Bus) is used.
Support for the GNOME Keyring via freedesktop.org's 
[Secret Storage D-Bus specification](http://freedesktop.org/wiki/Specifications/secret-storage-spec "Secret Storage specification") is planned but not yet implemented.

Windows
-------

Windows does not provide secure storage. QtKeychain uses the Windows API function [CryptProtectData](http://msdn.microsoft.com/en-us/library/windows/desktop/aa380261%28v=vs.85%29.aspx "CryptProtectData function") to encrypt the password with the user's logon credentials.
The encrypted data is then persisted via QSettings.


QtKeychain
==========

QtKeychain is a Qt API to securely write and read passwords. The passwords are stored in the platform's keychain service.
In case there is no such service available, QtKeychain will report an error. It will not store any data unencrypted.

Currently, the following platforms are supported:

 * **Mac OS X:** Passwords are stored in the OS X Keychain.

 * **Linux/Unix:** If running, KWallet (via D-Bus) is used.
Support for the GNOME Keyring via freedesktop.org's
[Secret Storage D-Bus specification](http://freedesktop.org/wiki/Specifications/secret-storage-spec "Secret Storage specification") is planned but not yet implemented.

 * **Windows:** Windows does not provide a service for secure storage. QtKeychain uses the Windows API function [CryptProtectData](http://msdn.microsoft.com/en-us/library/windows/desktop/aa380261%28v=vs.85%29.aspx "CryptProtectData function") to encrypt the password with the user's logon credentials. The encrypted data is then persisted via QSettings.

**License:** QtKeychain is available under the [Modified BSD License](http://www.gnu.org/licenses/license-list.html#ModifiedBSD). See the file COPYING for details.

Restructure README, add license information.
Restructure README, add license information.
