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)

Static Public Member Functions
static Security *	ref ()

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