dcmtls/include/dcmtk/dcmtls/tlslayer.h

/*
 *
 *  Copyright (C) 1998-2010, OFFIS e.V.
 *  All rights reserved.  See COPYRIGHT file for details.
 *
 *  This software and supporting documentation were developed by
 *
 *    OFFIS e.V.
 *    R&D Division Health
 *    Escherweg 2
 *    D-26121 Oldenburg, Germany
 *
 *
 *  Module: dcmtls
 *
 *  Author: Marco Eichelberg
 *
 *  Purpose:
 *    classes: DcmTLSTransportLayer
 *
 *  Last Update:      $Author: joergr $
 *  Update Date:      $Date: 2010-10-14 13:17:27 $
 *  CVS/RCS Revision: $Revision: 1.9 $
 *  Status:           $State: Exp $
 *
 *  CVS/RCS Log at end of file
 *
 */

#ifndef TLSLAYER_H
#define TLSLAYER_H

#include "dcmtk/config/osconfig.h"    /* make sure OS specific configuration is included first */
#include "dcmtk/dcmnet/dcmlayer.h"    /* for DcmTransportLayer */
#include "dcmtk/ofstd/ofstream.h"    /* for ostream */
#include "dcmtk/oflog/oflog.h"

#ifdef WITH_OPENSSL
BEGIN_EXTERN_C
#include <openssl/ssl.h>
END_EXTERN_C

OFLogger DCM_dcmtlsGetLogger();

#define DCMTLS_TRACE(msg) OFLOG_TRACE(DCM_dcmtlsGetLogger(), msg)
#define DCMTLS_DEBUG(msg) OFLOG_DEBUG(DCM_dcmtlsGetLogger(), msg)
#define DCMTLS_INFO(msg)  OFLOG_INFO(DCM_dcmtlsGetLogger(), msg)
#define DCMTLS_WARN(msg)  OFLOG_WARN(DCM_dcmtlsGetLogger(), msg)
#define DCMTLS_ERROR(msg) OFLOG_ERROR(DCM_dcmtlsGetLogger(), msg)
#define DCMTLS_FATAL(msg) OFLOG_FATAL(DCM_dcmtlsGetLogger(), msg)

enum DcmCertificateVerification
{
  DCV_requireCertificate,

  DCV_checkCertificate,

  DCV_ignoreCertificate
};


class DcmTLSTransportLayer: public DcmTransportLayer
{
public:

  DcmTLSTransportLayer(int networkRole, const char *randFile);

  virtual ~DcmTLSTransportLayer();

  virtual DcmTransportConnection *createConnection(int openSocket, OFBool useSecureLayer);

  DcmTransportLayerStatus setPrivateKeyFile(const char *fileName, int fileType);

  DcmTransportLayerStatus setCertificateFile(const char *fileName, int fileType);

  OFBool checkPrivateKeyMatchesCertificate();

  DcmTransportLayerStatus addTrustedCertificateFile(const char *fileName, int fileType);

  DcmTransportLayerStatus addTrustedCertificateDir(const char *pathName, int fileType);

  DcmTransportLayerStatus setCipherSuites(const char *suites);

  static unsigned long getNumberOfCipherSuites();

  static const char *getTLSCipherSuiteName(unsigned long idx);

  static const char *getOpenSSLCipherSuiteName(unsigned long idx);

  static const char *findOpenSSLCipherSuiteName(const char *tlsCipherSuiteName);

  OFBool canWriteRandomSeed() { return canWriteRandseed; }

  OFBool writeRandomSeed(const char *randFile);

  void seedPRNG(const char *randFile);

  void addPRNGseed(void *buf, size_t bufSize);

  void setCertificateVerification(DcmCertificateVerification vtype);

  void setPrivateKeyPasswd(const char *thePasswd);

  void setPrivateKeyPasswdFromConsole();

  OFBool setTempDHParameters(const char *filename);

  static OFString dumpX509Certificate(X509 *peerCertificate);

private:

  DcmTLSTransportLayer(const DcmTLSTransportLayer&);

  DcmTLSTransportLayer& operator=(const DcmTLSTransportLayer&);

  SSL_CTX *transportLayerContext;

  OFBool canWriteRandseed;

  OFString privateKeyPasswd;

};

#endif /* WITH_OPENSSL */

#endif

/*
 *  $Log: tlslayer.h,v $
 *  Revision 1.9  2010-10-14 13:17:27  joergr
 *  Updated copyright header. Added reference to COPYRIGHT file.
 *
 *  Revision 1.8  2009-11-18 12:11:19  uli
 *  Switched to logging mechanism provided by the "new" oflog module.
 *
 *  Revision 1.7  2006-08-15 16:02:55  meichel
 *  Updated the code in module dcmtls to correctly compile when
 *    all standard C++ classes remain in namespace std.
 *
 *  Revision 1.6  2005/12/08 16:05:38  meichel
 *  Changed include path schema for all DCMTK header files
 *
 *  Revision 1.5  2003/12/05 10:38:55  joergr
 *  Removed leading underscore characters from preprocessor symbols (reserved
 *  symbols).
 *
 *  Revision 1.4  2003/07/04 13:28:32  meichel
 *  Added include for ofstream.h, to make sure ofstream is correctly defined
 *
 *  Revision 1.3  2001/06/01 15:51:12  meichel
 *  Updated copyright header
 *
 *  Revision 1.2  2000/10/10 12:13:31  meichel
 *  Added routines for printing certificates and connection parameters.
 *
 *  Revision 1.1  2000/08/10 14:50:26  meichel
 *  Added initial OpenSSL support.
 *
 *
 */

---

Generated on 6 Jan 2011 for OFFIS DCMTK Version 3.6.0 by Doxygen 1.5.1