wxWidgets/samples/secretstore/secretstore.cpp
Vadim Zeitlin 2fffbde096 Change wxSecretStore API to allow retrieving the username
The old API didn't make any sense for the most common case when both the
user name and password need to be stored, as it required providing the
user name as input, which couldn't work (but somehow this went
unnoticed for more than a year...).

Fix this by returning the username, and not only the password, from
Load() instead of taking it as parameter and removing this parameter
from Delete() as well.

Also improve the documentation, notably include a simple example of
using this class.

Notice that this is a backwards-incompatible change, but the old API was
really badly broken and didn't appear in 3.1.0 yet, so the breakage is
both unavoidable and, hopefully, shouldn't affect much code.
Nevertheless, a special wxHAS_SECRETSTORE_LOAD_USERNAME symbol is added
to allow testing for it if necessary.
2017-07-17 18:26:20 +02:00

236 lines
6.3 KiB
C++

/////////////////////////////////////////////////////////////////////////////
// Name: secretstore.cpp
// Purpose: wxWidgets sample showing the use of wxSecretStore class
// Author: Vadim Zeitlin
// Created: 2016-05-27
// Copyright: (c) 2016 Vadim Zeitlin <vadim@wxwidgets.org>
// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
// ============================================================================
// declarations
// ============================================================================
// ----------------------------------------------------------------------------
// headers
// ----------------------------------------------------------------------------
// For compilers that support precompilation, includes "wx/wx.h".
#include "wx/wxprec.h"
#ifdef __BORLANDC__
#pragma hdrstop
#endif
#include "wx/secretstore.h"
#include "wx/init.h"
#include "wx/crt.h"
#include "wx/log.h"
bool Save(wxSecretStore& store, const wxString& service, const wxString& user)
{
char password[4096];
wxPrintf("Enter the password for %s/%s (echoing NOT disabled): ",
service, user);
if ( !wxFgets(password, WXSIZEOF(password), stdin) )
{
wxFprintf(stderr, "Password not stored.\n");
return false;
}
size_t size = wxStrlen(password);
if ( size )
{
// Strip trailing new line.
--size;
password[size] = 0;
}
wxSecretValue secret(size, password);
// The password data was copied into wxSecretValue, don't leave it lying
// around in the stack unnecessarily.
wxSecretValue::Wipe(size, password);
if ( !store.Save(service, user, secret) )
{
wxFprintf(stderr,
"Failed to save the password for %s/%s.\n",
service, user);
return false;
}
wxPrintf("Password for %s/%s saved.\n",
service, user);
return true;
}
bool Load(wxSecretStore& store, const wxString& service)
{
wxString user;
wxSecretValue secret;
if ( !store.Load(service, user, secret) )
{
wxFprintf(stderr, "Failed to load the password for %s.\n", service);
return false;
}
// Create a temporary variable just to make it possible to wipe it after
// using it.
wxString str(secret.GetAsString());
const size_t size = secret.GetSize();
wxPrintf("Password for %s/%s is %zu bytes long: \"%s\"\n",
service, user, size, str);
wxSecretValue::WipeString(str);
return true;
}
bool Delete(wxSecretStore& store, const wxString& service)
{
if ( !store.Delete(service) )
{
wxFprintf(stderr, "Password for %s not deleted.\n", service);
return false;
}
wxPrintf("Stored password for %s deleted.\n", service);
return true;
}
static bool PrintResult(bool ok)
{
wxPuts(ok ? "ok" : "ERROR");
return ok;
}
bool SelfTest(wxSecretStore& store, const wxString& service)
{
wxPrintf("Running the tests...\n");
const wxString userTest("test");
const wxSecretValue secret1(6, "secret");
wxPrintf("Storing the password:\t");
bool ok = store.Save(service, userTest, secret1);
if ( !PrintResult(ok) )
{
// The rest of the tests will probably fail too, no need to continue.
wxPrintf("Bailing out.\n");
return false;
}
wxPrintf("Loading the password:\t");
wxSecretValue secret;
wxString user;
ok = PrintResult(store.Load(service, user, secret) &&
user == userTest &&
secret == secret1);
// Overwriting the password should work.
const wxSecretValue secret2(6, "privet");
wxPrintf("Changing the password:\t");
if ( PrintResult(store.Save(service, user, secret2)) )
{
wxPrintf("Reloading the password:\t");
if ( !PrintResult(store.Load(service, user, secret) &&
secret == secret2) )
ok = false;
}
else
ok = false;
wxPrintf("Deleting the password:\t");
if ( !PrintResult(store.Delete(service)) )
ok = false;
// This is supposed to fail now.
wxPrintf("Deleting it again:\t");
if ( !PrintResult(!store.Delete(service)) )
ok = false;
// And loading should fail too.
wxPrintf("Loading after deleting:\t");
if ( !PrintResult(!store.Load(service, user, secret)) )
ok = false;
if ( ok )
wxPrintf("All tests passed!\n");
return ok;
}
int main(int argc, char **argv)
{
// To complement the standard EXIT_{SUCCESS,FAILURE}.
const int EXIT_SYNTAX = 2;
wxInitializer initializer;
if ( !initializer )
{
fprintf(stderr, "Failed to initialize the wxWidgets library, aborting.");
return EXIT_FAILURE;
}
if ( argc < 2 ||
argc != (argv[1] == wxString("save") ? 4 : 3) )
{
wxFprintf(stderr,
"Usage: %s save <service> <user>\n"
" or %s {load|delete|selftest} <service>\n"
"\n"
"Sample showing wxSecretStore class functionality.\n"
"Specify one of the commands to perform the corresponding\n"
"function call. The \"service\" argument is mandatory for\n"
"all commands, \"save\" also requires \"user\" and will\n"
"prompt for password.\n",
argv[0], argv[0]);
return EXIT_SYNTAX;
}
wxSecretStore store = wxSecretStore::GetDefault();
if ( !store.IsOk() )
{
wxFprintf(stderr, "Failed to create default secret store.\n");
return EXIT_FAILURE;
}
const wxString operation = argv[1];
const wxString service = argv[2];
bool ok;
if ( operation == "save" )
{
ok = Save(store, service, argv[3]);
}
else if ( operation == "load" )
{
ok = Load(store, service);
}
else if ( operation == "delete" )
{
ok = Delete(store, service);
}
else if ( operation == "selftest" )
{
ok = SelfTest(store, service);
}
else
{
wxFprintf(stderr,
"Unknown operation \"%s\", expected \"save\", \"load\" or "
"\"delete\".\n",
operation);
return EXIT_SYNTAX;
}
return ok ? EXIT_SUCCESS : EXIT_FAILURE;
}