File indexing completed on 2024-11-10 12:20:05
0001 /* This file is part of the KDE project 0002 * 0003 * Copyright (C) 2001-2003 George Staikos <staikos@kde.org> 0004 * 0005 * This library is free software; you can redistribute it and/or 0006 * modify it under the terms of the GNU Library General Public 0007 * License as published by the Free Software Foundation; either 0008 * version 2 of the License, or (at your option) any later version. 0009 * 0010 * This library is distributed in the hope that it will be useful, 0011 * but WITHOUT ANY WARRANTY; without even the implied warranty of 0012 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 0013 * Library General Public License for more details. 0014 * 0015 * You should have received a copy of the GNU Library General Public License 0016 * along with this library; see the file COPYING.LIB. If not, write to 0017 * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, 0018 * Boston, MA 02110-1301, USA. 0019 */ 0020 0021 #ifndef _KSSLCERTCHAIN_H 0022 #define _KSSLCERTCHAIN_H 0023 0024 #include <QList> 0025 0026 class QString; 0027 class KSSL; 0028 class KSSLCertChainPrivate; 0029 class QStringList; 0030 0031 #include <ksslcertificate.h> 0032 0033 /** 0034 * KDE Certificate Chain Representation Class 0035 * 0036 * This class provides a representation for an X.509 certificate chain. 0037 * 0038 * @author George Staikos <staikos@kde.org> 0039 * @see KSSL, KSSLCertificate, KSSLPeerInfo 0040 * @short KDE X.509 Certificate Chain 0041 */ 0042 class KDELIBS4SUPPORT_DEPRECATED_EXPORT KSSLCertChain 0043 { 0044 friend class KSSL; 0045 friend class KSSLPeerInfo; 0046 0047 public: 0048 /** 0049 * Construct a KSSLCertChain object 0050 */ 0051 KSSLCertChain(); 0052 0053 /** 0054 * Destroy this KSSLCertChain object 0055 */ 0056 ~KSSLCertChain(); 0057 0058 /** 0059 * Determine if this represents a valid certificate chain 0060 * 0061 * @return true if it is a valid certificate chain 0062 */ 0063 bool isValid(); 0064 0065 /** 0066 * Do a deep copy of the certificate chain. 0067 * 0068 * @return pointer to a new certificate chain object 0069 * 0070 * This is an expensive operation, and you are responsible for deleting 0071 * the returned object yourself. 0072 */ 0073 KSSLCertChain *replicate(); 0074 0075 /** 0076 * Set the raw chain from OpenSSL 0077 * @internal 0078 */ 0079 void setChain(void *stack_of_x509); 0080 0081 /** 0082 * Set the certificate chain as a pointer list of KSSL certificates. 0083 * 0084 * @param chain the certificate chain 0085 * @see KSSLCertificate 0086 */ 0087 void setChain(const QList<KSSLCertificate *> &chain); 0088 0089 /** 0090 * Set the certificate chain as a list of base64 encoded X.509 0091 * certificates. 0092 * 0093 * @param chain the certificate chain 0094 */ 0095 void setCertChain(const QStringList &chain); 0096 0097 /** 0098 * Obtain a copy of the certificate chain. 0099 * The caller is responsible for deleting all certificates in the chain. 0100 * 0101 * @return a deep copy of the certificate chain. 0102 * @see KSSLCertificate 0103 */ 0104 QList<KSSLCertificate *> getChain() const; 0105 0106 /** 0107 * Determine the number of entries (depth) of the chain. 0108 * 0109 * @return the number of entries in the certificate chain 0110 */ 0111 int depth(); 0112 0113 /** 0114 * Read the raw chain in OpenSSL format 0115 * @internal 0116 */ 0117 void *rawChain(); 0118 0119 private: 0120 KSSLCertChainPrivate *const d; 0121 void *_chain; 0122 }; 0123 0124 #endif 0125