From ce4a32fe52ef09d8f5ff1dd22c001110902b60a2 Mon Sep 17 00:00:00 2001 From: toma Date: Wed, 25 Nov 2009 17:56:58 +0000 Subject: Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdelibs@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- kio/kssl/ksslsigners.h | 172 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 172 insertions(+) create mode 100644 kio/kssl/ksslsigners.h (limited to 'kio/kssl/ksslsigners.h') diff --git a/kio/kssl/ksslsigners.h b/kio/kssl/ksslsigners.h new file mode 100644 index 000000000..3cabf639c --- /dev/null +++ b/kio/kssl/ksslsigners.h @@ -0,0 +1,172 @@ +/* This file is part of the KDE project + * + * Copyright (C) 2001-2003 George Staikos + * + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Library General Public + * License as published by the Free Software Foundation; either + * version 2 of the License, or (at your option) any later version. + * + * This library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Library General Public License for more details. + * + * You should have received a copy of the GNU Library General Public License + * along with this library; see the file COPYING.LIB. If not, write to + * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, + * Boston, MA 02110-1301, USA. + */ + + +#ifndef _INCLUDE_KSSLSIGNERS_H +#define _INCLUDE_KSSLSIGNERS_H + +class KSSLCertificate; +class DCOPClient; + +#include + +#include + +// ### KDE4 - Fix constness +/** + * KDE SSL Signer Database + * + * This class is used to manipulate the KDE SSL signer database. It + * communicates to the KDE SSL daemon via dcop for backend integration. + * + * @author George Staikos + * @see KSSL, KSSLCertificate + * @short KDE SSL Signer Database + */ +class KIO_EXPORT KSSLSigners { +public: + /** + * Construct a KSSLSigner object. + */ + KSSLSigners(); + + /** + * Destroy this KSSLSigner object. + */ + ~KSSLSigners(); + + /** + * Add a signer to the database. + * + * @param cert the signer's certificate + * @param ssl allow it to sign for SSL + * @param email allow it to sign for S/MIME + * @param code allow it to sign for code signing + * @return true on success + */ + bool addCA(KSSLCertificate& cert, bool ssl, bool email, bool code); + + /** + * Add a signer to the database. + * + * @param cert the signer's certificate in base64 form + * @param ssl allow it to sign for SSL + * @param email allow it to sign for S/MIME + * @param code allow it to sign for code signing + * @return true on success + */ + bool addCA(QString cert, bool ssl, bool email, bool code); + + /** + * Regenerate the signer-root file from the user's settings. + * @return true on success + */ + bool regenerate(); + + /** + * Determine if a certificate can be used for SSL certificate signing + * @param cert the certificate + * @return true if it can be used for SSL + */ + bool useForSSL(KSSLCertificate& cert); + + /** + * Determine if a certificate can be used for SSL certificate signing + * @param subject the certificate subject + * @return true if it can be used for SSL + */ + bool useForSSL(QString subject); + + /** + * Determine if a certificate can be used for S/MIME certificate signing + * @param cert the certificate + * @return true if it can be used for S/MIME + */ + bool useForEmail(KSSLCertificate& cert); + + /** + * Determine if a certificate can be used for S/MIME certificate signing + * @param subject the certificate subject + * @return true if it can be used for S/MIME + */ + bool useForEmail(QString subject); + + /** + * Determine if a certificate can be used for code certificate signing + * @param cert the certificate + * @return true if it can be used for code + */ + bool useForCode(KSSLCertificate& cert); + + /** + * Determine if a certificate can be used for code certificate signing + * @param subject the certificate subject + * @return true if it can be used for code + */ + bool useForCode(QString subject); + + /** + * Remove a certificate signer from the database + * @param cert the certificate to remove + * @return true on success + */ + bool remove(KSSLCertificate& cert); + + /** + * Remove a certificate signer from the database + * @param subject the subject of the certificate to remove + * @return true on success + */ + bool remove(QString subject); + + /** + * List the signers in the database. + * @return the list of subjects in the database + * @see getCert + */ + QStringList list(); + + /** + * Get a signer certificate from the database. + * + * @param subject the subject of the certificate desired + * @return the base64 encoded certificate + */ + QString getCert(QString subject); + + /** + * Set the use of a particular entry in the certificate signer database. + * @param subject the subject of the certificate in question + * @param ssl allow this for SSL certificate signing + * @param email allow this for S/MIME certificate signing + * @param code allow this for code certificate signing + * @return true on success + */ + bool setUse(QString subject, bool ssl, bool email, bool code); + +private: + class KSSLSignersPrivate; + KSSLSignersPrivate *d; + + DCOPClient *dcc; +}; + + +#endif -- cgit v1.2.1