kdelibs/kio/kssl/ksslcertchain.h
2014-11-13 01:04:59 +02:00

126 lines
3 KiB
C++

/* 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 _KSSLCERTCHAIN_H
#define _KSSLCERTCHAIN_H
#include <QtCore/QList>
#include <kdemacros.h>
class QString;
class KSSL;
class KSSLCertChainPrivate;
class QStringList;
#include <ksslcertificate.h>
/**
* KDE Certificate Chain Representation Class
*
* This class provides a representation for an X.509 certificate chain.
*
* @author George Staikos <staikos@kde.org>
* @see KSSL, KSSLCertificate, KSSLPeerInfo
* @short KDE X.509 Certificate Chain
*/
class KIO_EXPORT KSSLCertChain {
friend class KSSL;
friend class KSSLPeerInfo;
public:
/**
* Construct a KSSLCertChain object
*/
KSSLCertChain();
/**
* Destroy this KSSLCertChain object
*/
~KSSLCertChain();
/**
* Determine if this represents a valid certificate chain
*
* @return true if it is a valid certificate chain
*/
bool isValid();
/**
* Do a deep copy of the certificate chain.
*
* @return pointer to a new certificate chain object
*
* This is an expensive operation, and you are responsible for deleting
* the returned object yourself.
*/
KSSLCertChain *replicate();
/**
* Set the raw chain from OpenSSL
* @internal
*/
void setChain(void *stack_of_x509);
/**
* Set the certificate chain as a pointer list of KSSL certificates.
*
* @param chain the certificate chain
* @see KSSLCertificate
*/
void setChain(const QList<KSSLCertificate *>& chain);
/**
* Set the certificate chain as a list of base64 encoded X.509
* certificates.
*
* @param chain the certificate chain
*/
void setCertChain(const QStringList& chain);
/**
* Obtain a copy of the certificate chain.
* The caller is responsible for deleting all certificates in the chain.
*
* @return a deep copy of the certificate chain.
* @see KSSLCertificate
*/
QList<KSSLCertificate *> getChain() const;
/**
* Determine the number of entries (depth) of the chain.
*
* @return the number of entries in the certificate chain
*/
int depth();
/**
* Read the raw chain in OpenSSL format
* @internal
*/
void *rawChain();
private:
KSSLCertChainPrivate* const d;
void *_chain;
};
#endif