QCA

prompter.h
1 /*
2  Copyright (C) 2007 Justin Karneges <[email protected]>
3 
4  Permission is hereby granted, free of charge, to any person obtaining a copy
5  of this software and associated documentation files (the "Software"), to deal
6  in the Software without restriction, including without limitation the rights
7  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
8  copies of the Software, and to permit persons to whom the Software is
9  furnished to do so, subject to the following conditions:
10 
11  The above copyright notice and this permission notice shall be included in
12  all copies or substantial portions of the Software.
13 
14  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
17  AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
18  AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
19  CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
20 */
21 
22 #ifndef PROMPTER_H
23 #define PROMPTER_H
24 
25 #include <QObject>
26 
27 namespace QCA {
28 class SecureArray;
29 class Event;
30 }
31 
32 class Prompter : public QObject
33 {
34  Q_OBJECT
35 public:
36  Prompter(QObject *parent = nullptr);
37  ~Prompter();
38 
39 protected:
40  // called with every password event, to check for a known value.
41  // reimplement it to provide known/cached passwords.
42  virtual QCA::SecureArray knownPassword(const QCA::Event &event);
43 
44  // called when a user-entered password is submitted. note that this
45  // does not mean the password was correct. to know if the password
46  // was correct, you'll have to match up the event information with
47  // the operation that triggered it.
48  virtual void userSubmitted(const QCA::SecureArray &password, const QCA::Event &event);
49 
50 private:
51  class Private;
52  friend class Private;
53  Private *d;
54 };
55 
56 #endif
An asynchronous event.
Definition: qca_core.h:1390
QCA - the Qt Cryptographic Architecture.
Definition: qca_basic.h:41
Secure array of bytes.
Definition: qca_tools.h:316
This file is part of the KDE documentation.
Documentation copyright © 1996-2021 The KDE developers.
Generated on Sat Sep 25 2021 23:05:35 by doxygen 1.8.11 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.