summaryrefslogtreecommitdiffstats
path: root/tdeio/kssl/ksslsigners.h
diff options
context:
space:
mode:
Diffstat (limited to 'tdeio/kssl/ksslsigners.h')
-rw-r--r--tdeio/kssl/ksslsigners.h172
1 files changed, 172 insertions, 0 deletions
diff --git a/tdeio/kssl/ksslsigners.h b/tdeio/kssl/ksslsigners.h
new file mode 100644
index 000000000..3149e852a
--- /dev/null
+++ b/tdeio/kssl/ksslsigners.h
@@ -0,0 +1,172 @@
+/* This file is part of the KDE project
+ *
+ * Copyright (C) 2001-2003 George Staikos <staikos@kde.org>
+ *
+ * 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 <tqstringlist.h>
+
+#include <tdelibs_export.h>
+
+// ### 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 <staikos@kde.org>
+ * @see KSSL, KSSLCertificate
+ * @short KDE SSL Signer Database
+ */
+class TDEIO_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(TQString 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(TQString 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(TQString 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(TQString 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(TQString subject);
+
+ /**
+ * List the signers in the database.
+ * @return the list of subjects in the database
+ * @see getCert
+ */
+ TQStringList list();
+
+ /**
+ * Get a signer certificate from the database.
+ *
+ * @param subject the subject of the certificate desired
+ * @return the base64 encoded certificate
+ */
+ TQString getCert(TQString 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(TQString subject, bool ssl, bool email, bool code);
+
+private:
+ class KSSLSignersPrivate;
+ KSSLSignersPrivate *d;
+
+ DCOPClient *dcc;
+};
+
+
+#endif