Kleo::KeyResolver Class Reference

#include <keyresolver.h>

Inheritance diagram for Kleo::KeyResolver:

Classes
struct	Solution

Signals
void	keysResolved (bool success, bool sendUnencrypted)

Public Member Functions
	KeyResolver (bool encrypt, bool sign, GpgME::Protocol protocol=GpgME::UnknownProtocol, bool allowMixed=true)
Solution	result () const
void	setDialogWindowFlags (Qt::WindowFlags flags)
void	setMinimumValidity (int validity)
void	setOverrideKeys (const QMap< GpgME::Protocol, QMap< QString, QStringList > > &overrides)
void	setPreferredProtocol (GpgME::Protocol proto)
void	setRecipients (const QStringList &addresses)
void	setSender (const QString &sender)
void	setSigningKeys (const QStringList &fingerprints)
void	start (bool showApproval, QWidget *parentWidget=nullptr)
Public Member Functions inherited from QObject
	QObject (QObject *parent)
QBindable< QString >	bindableObjectName ()
bool	blockSignals (bool block)
const QObjectList &	children () const const
QMetaObject::Connection	connect (const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type) const const
void	deleteLater ()
void	destroyed (QObject *obj)
bool	disconnect (const char *signal, const QObject *receiver, const char *method) const const
bool	disconnect (const QObject *receiver, const char *method) const const
void	dumpObjectInfo () const const
void	dumpObjectTree () const const
QList< QByteArray >	dynamicPropertyNames () const const
virtual bool	event (QEvent *e)
virtual bool	eventFilter (QObject *watched, QEvent *event)
T	findChild (const QString &name, Qt::FindChildOptions options) const const
QList< T >	findChildren (const QRegularExpression &re, Qt::FindChildOptions options) const const
QList< T >	findChildren (const QString &name, Qt::FindChildOptions options) const const
QList< T >	findChildren (Qt::FindChildOptions options) const const
bool	inherits (const char *className) const const
void	installEventFilter (QObject *filterObj)
bool	isQuickItemType () const const
bool	isWidgetType () const const
bool	isWindowType () const const
void	killTimer (int id)
virtual const QMetaObject *	metaObject () const const
void	moveToThread (QThread *targetThread)
QString	objectName () const const
void	objectNameChanged (const QString &objectName)
QObject *	parent () const const
QVariant	property (const char *name) const const
	Q_CLASSINFO (Name, Value)
	Q_EMIT Q_EMIT
	Q_ENUM (...)
	Q_ENUM_NS (...)
	Q_ENUMS (...)
	Q_FLAG (...)
	Q_FLAG_NS (...)
	Q_FLAGS (...)
	Q_GADGET Q_GADGET
	Q_GADGET_EXPORT (EXPORT_MACRO)
	Q_INTERFACES (...)
	Q_INVOKABLE Q_INVOKABLE
	Q_MOC_INCLUDE Q_MOC_INCLUDE
	Q_NAMESPACE Q_NAMESPACE
	Q_NAMESPACE_EXPORT (EXPORT_MACRO)
	Q_OBJECT Q_OBJECT
	Q_PROPERTY (...)
	Q_REVISION Q_REVISION
	Q_SET_OBJECT_NAME (Object)
	Q_SIGNAL Q_SIGNAL
	Q_SIGNALS Q_SIGNALS
	Q_SLOT Q_SLOT
	Q_SLOTS Q_SLOTS
T	qobject_cast (const QObject *object)
T	qobject_cast (QObject *object)
	QT_NO_NARROWING_CONVERSIONS_IN_CONNECT QT_NO_NARROWING_CONVERSIONS_IN_CONNECT
void	removeEventFilter (QObject *obj)
void	setObjectName (const QString &name)
void	setObjectName (QAnyStringView name)
void	setParent (QObject *parent)
bool	setProperty (const char *name, const QVariant &value)
bool	setProperty (const char *name, QVariant &&value)
bool	signalsBlocked () const const
int	startTimer (int interval, Qt::TimerType timerType)
int	startTimer (std::chrono::milliseconds interval, Qt::TimerType timerType)
QThread *	thread () const const

Additional Inherited Members
Public Types inherited from QObject
typedef	QObjectList
Properties inherited from QObject
	objectName
Static Public Member Functions inherited from QObject
QMetaObject::Connection	connect (const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type)
QMetaObject::Connection	connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type)
QMetaObject::Connection	connect (const QObject *sender, PointerToMemberFunction signal, const QObject *context, Functor functor, Qt::ConnectionType type)
QMetaObject::Connection	connect (const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method, Qt::ConnectionType type)
QMetaObject::Connection	connect (const QObject *sender, PointerToMemberFunction signal, Functor functor)
bool	disconnect (const QMetaObject::Connection &connection)
bool	disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *method)
bool	disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method)
bool	disconnect (const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method)
QString	tr (const char *sourceText, const char *disambiguation, int n)
Protected Member Functions inherited from QObject
virtual void	childEvent (QChildEvent *event)
virtual void	connectNotify (const QMetaMethod &signal)
virtual void	customEvent (QEvent *event)
virtual void	disconnectNotify (const QMetaMethod &signal)
bool	isSignalConnected (const QMetaMethod &signal) const const
int	receivers (const char *signal) const const
QObject *	sender () const const
int	senderSignalIndex () const const
virtual void	timerEvent (QTimerEvent *event)

Detailed Description

Class to find Keys for E-Mail signing and encryption.

The KeyResolver uses the Keycache to find keys for signing or encryption.

Overrides can be provided for address book integration.

If no override key(s) are provided for an address and no KeyGroup for this address is found, then the key with a uid that matches the address and has the highest validity is used. If both keys have the same validity, then the key with the newest subkey is used.

The KeyResolver also supports groups so the number of encryption keys does not necessarily need to match the amount of sender addresses. For this reason maps are used to map addresses to lists of keys.

The keys can be OpenPGP keys and S/MIME (CMS) keys. As a caller you need to partition the keys by their protocol and send one message for each protocol for the recipients and signed by the signing keys.

Definition at line 57 of file keyresolver.h.

Constructor & Destructor Documentation

KeyResolver()

KeyResolver::KeyResolver ( bool encrypt, bool sign, GpgME::Protocol protocol = GpgME::UnknownProtocol, bool allowMixed = true )

explicit

Creates a new key resolver object.

Parameters

encrypt	Should encryption keys be selected.
sign	Should signing keys be selected.
protocol	A specific key protocol (OpenPGP, S/MIME) for selection. Default: Both protocols.
allowMixed	Specify if multiple message formats may be resolved.

Definition at line 172 of file keyresolver.cpp.

Member Function Documentation

keysResolved

void Kleo::KeyResolver::keysResolved ( bool success, bool sendUnencrypted )

signal

Emitted when key resolution finished.

Parameters

success	The general result. If true continue sending, if false abort.
sendUnencrypted	If there could be no key found for one of the recipients the user was queried if the mail should be sent out unencrypted. sendUnencrypted is true if the user agreed to this.

result()

KeyResolver::Solution KeyResolver::result

(

)

const

Get the result of the resolution.

Returns

the resolved keys for signing and encryption.

Definition at line 199 of file keyresolver.cpp.

setDialogWindowFlags()

void KeyResolver::setDialogWindowFlags

(

Qt::WindowFlags

flags

)

Set window flags for a possible dialog.

Definition at line 204 of file keyresolver.cpp.

setMinimumValidity()

void KeyResolver::setMinimumValidity

(

int

validity

)

Set the minimum user id validity for autoresolution.

The default value is marginal

Parameters

validity

int representation of a GpgME::UserID::Validity.

Definition at line 214 of file keyresolver.cpp.

setOverrideKeys()

void KeyResolver::setOverrideKeys

(

const QMap< GpgME::Protocol, QMap< QString, QStringList > > &

overrides

)

Set up possible override keys for recipients addresses.

The keys for the fingerprints are looked up and used when found.

Overrides for GpgME::UnknownProtocol are used regardless of the protocol. Overrides for a specific protocol are only used for this protocol. Overrides for GpgME::UnknownProtocol takes precedence over overrides for a specific protocol.

Parameters

overrides

A map of <protocol> -> (<address> <fingerprints>)

Definition at line 189 of file keyresolver.cpp.

setPreferredProtocol()

void KeyResolver::setPreferredProtocol

(

GpgME::Protocol

proto

)

Set the protocol that is preferred to be displayed first when it is not clear from the keys.

E.g. if both OpenPGP and S/MIME can be resolved.

Definition at line 209 of file keyresolver.cpp.

setRecipients()

void KeyResolver::setRecipients

(

const QStringList &

addresses

)

Set the list of recipient addresses.

Parameters

addresses

A list of (not necessarily normalized) email addresses

Definition at line 179 of file keyresolver.cpp.

setSender()

void KeyResolver::setSender

(

const QString &

sender

)

Set the sender's address.

This address is added to the list of recipients (for encryption to self) and it is used for signing key resolution, if the signing keys are not explicitly set through setSigningKeys.

Parameters

sender

The sender of this message.

Definition at line 184 of file keyresolver.cpp.

setSigningKeys()

void KeyResolver::setSigningKeys

(

const QStringList &

fingerprints

)

Set explicit signing keys to use.

Definition at line 194 of file keyresolver.cpp.

start()

void KeyResolver::start	(	bool	showApproval,
		QWidget *	parentWidget = nullptr )

Starts the key resolving procedure.

Emits keysResolved on success or error.

Parameters

showApproval	If set to true a dialog listing the keys will always be shown.
parentWidget	Optional, a Widget to use as parent for dialogs.

Definition at line 152 of file keyresolver.cpp.

---

The documentation for this class was generated from the following files:

• keyresolver.h
• keyresolver.cpp