QCA

prompter.h
1/*
2 Copyright (C) 2007 Justin Karneges <justin@affinix.com>
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
27namespace QCA {
28class SecureArray;
29class Event;
30}
31
32class Prompter : public QObject
33{
35public:
36 Prompter(QObject *parent = nullptr);
37 ~Prompter();
38
39protected:
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
50private:
51 class Private;
52 friend class Private;
53 Private *d;
54};
55
56#endif
An asynchronous event.
Definition qca_core.h:1391
Secure array of bytes.
Definition qca_tools.h:317
QCA - the Qt Cryptographic Architecture.
Definition qca_basic.h:41
Q_OBJECTQ_OBJECT
virtual bool event(QEvent *e)
QObject * parent() const const
This file is part of the KDE documentation.
Documentation copyright © 1996-2024 The KDE developers.
Generated on Fri May 24 2024 11:53:51 by doxygen 1.10.0 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.