KNS::Security Class Reference

#include <security.h>

Inheritance diagram for KNS::Security:

Public Types
enum	Results {   MD5_OK = 1, SIGNED_OK = 2, SIGNED_BAD = 4, TRUSTED = 8,   UNKNOWN = 16, SIGNED_BAD_CLEAR = 27, BAD_PASSPHRASE = 32 }

Public Slots
void	readKeys ()
void	readSecretKeys ()
void	slotCheckValidity ()
void	slotSignFile ()

Signals
void	fileSigned (int result)
void	validityResult (int result)

Public Member Functions
	~Security ()
void	checkValidity (const QString &fileName)
KeyStruct	signatureKey ()
void	signFile (const QString &fileName)
Public Member Functions inherited from QObject
	QObject (QObject *parent)
	QObject (QObject *parent, const char *name)
virtual	~QObject ()
bool	blockSignals (bool block)
QObject *	child (const char *objName, const char *inheritsClass, bool recursiveSearch) const
const QObjectList &	children () const
const char *	className () const
bool	connect (const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type) const
void	deleteLater ()
void	destroyed (QObject *obj)
bool	disconnect (const QObject *receiver, const char *method)
bool	disconnect (const char *signal, const QObject *receiver, const char *method)
void	dumpObjectInfo ()
void	dumpObjectTree ()
QList< QByteArray >	dynamicPropertyNames () const
virtual bool	event (QEvent *e)
virtual bool	eventFilter (QObject *watched, QEvent *event)
T	findChild (const QString &name) const
QList< T >	findChildren (const QRegExp &regExp) const
QList< T >	findChildren (const QString &name) const
bool	inherits (const char *className) const
void	insertChild (QObject *object)
void	installEventFilter (QObject *filterObj)
bool	isA (const char *className) const
bool	isWidgetType () const
void	killTimer (int id)
virtual const QMetaObject *	metaObject () const
void	moveToThread (QThread *targetThread)
const char *	name () const
const char *	name (const char *defaultName) const
QString	objectName () const
QObject *	parent () const
QVariant	property (const char *name) const
void	removeChild (QObject *object)
void	removeEventFilter (QObject *obj)
void	setName (const char *name)
void	setObjectName (const QString &name)
void	setParent (QObject *parent)
bool	setProperty (const char *name, const QVariant &value)
bool	signalsBlocked () const
int	startTimer (int interval)
QThread *	thread () const

Static Public Member Functions
static Security *	ref ()
Static Public Member Functions inherited from QObject
bool	connect (const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type)
bool	connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type)
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)
QString	tr (const char *sourceText, const char *disambiguation, int n)
QString	trUtf8 (const char *sourceText, const char *disambiguation, int n)

Additional Inherited Members
Protected Member Functions inherited from QObject
bool	checkConnectArgs (const char *signal, const QObject *object, const char *method)
virtual void	childEvent (QChildEvent *event)
virtual void	connectNotify (const char *signal)
virtual void	customEvent (QEvent *event)
virtual void	disconnectNotify (const char *signal)
int	receivers (const char *signal) const
QObject *	sender () const
int	senderSignalIndex () const
virtual void	timerEvent (QTimerEvent *event)
Static Protected Member Functions inherited from QObject
QByteArray	normalizeSignalSlot (const char *signalSlot)
Properties inherited from QObject
	objectName

Detailed Description

Handles security related issues, like signing, verifying.

It is a private class, not meant to be used by third party applications.

Author

Andras Mantia amant.nosp@m.ia@k.nosp@m.de.or.nosp@m.g

Definition at line 47 of file knewstuff2/core/security.h.

Member Enumeration Documentation

enum KNS::Security::Results

Enumerator
MD5_OK
SIGNED_OK	The MD5 sum check is OK.
SIGNED_BAD	The file is signed with a good signature.
TRUSTED	The file is signed with a bad signature.
UNKNOWN	The signature is trusted.
SIGNED_BAD_CLEAR	The key is unknown.
BAD_PASSPHRASE	used to clear the SIGNED_BAD flag

Definition at line 84 of file knewstuff2/core/security.h.

Constructor & Destructor Documentation

Security::~Security

(

)

Definition at line 51 of file knewstuff2/core/security.cpp.

Member Function Documentation

void Security::checkValidity

(

const QString &

fileName

)

Verifies the integrity and the signature of a tarball file.

Parameters

fileName

the file to be verified. It should be a tar.gz (.tgz) file. The directory where the file is should contain a "signature" and a "md5sum" file, otherwise verification will fail. The method is asynchronous and the result is signalled with validityResult.

Definition at line 216 of file knewstuff2/core/security.cpp.

void KNS::Security::fileSigned ( int  result )

signal

Sent when the signing is done.

Returns

the result of the operation. See Results

void Security::readKeys ( )

slot

Reads the available public keys.

Definition at line 55 of file knewstuff2/core/security.cpp.

void Security::readSecretKeys ( )

slot

Reads the available secret keys.

Definition at line 82 of file knewstuff2/core/security.cpp.

static Security* KNS::Security::ref ( )

inlinestatic

Definition at line 51 of file knewstuff2/core/security.h.

KeyStruct KNS::Security::signatureKey ( )

inline

Get the key used for signing.

This method is valid only if:

• the checkValidity was called
• the result of the validity check does not have the UNKNOWN bit set

Returns

the key used for signing the file

Definition at line 80 of file knewstuff2/core/security.h.

void Security::signFile

(

const QString &

fileName

)

Creates a signature and an md5sum file for the fileName and packs everything into a gzipped tarball.

Parameters

fileName

the file with full path to sign

The method is asynchronous and the result is signalled with fileSigned.

Definition at line 285 of file knewstuff2/core/security.cpp.

void Security::slotCheckValidity ( )

slot

Verifies the integrity and the signature of a tarball file (see m_fileName).

Definition at line 222 of file knewstuff2/core/security.cpp.

void Security::slotSignFile ( )

slot

Creates a signature and an md5sum file for the m_fileName and packs everything into a gzipped tarball.

Definition at line 291 of file knewstuff2/core/security.cpp.

void KNS::Security::validityResult ( int  result )

signal

Sent when the validity check is done.

Returns

the result of the check. See Results

---

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

• knewstuff2/core/security.h
• knewstuff2/core/security.cpp