IBR-DTNSuite  0.10
Public Member Functions | Static Public Member Functions | Static Public Attributes | List of all members
dtn::security::SecurityCertificateManager Class Reference

This class is a manager to handle certificates. More...

#include <SecurityCertificateManager.h>

Inheritance diagram for dtn::security::SecurityCertificateManager:
Inheritance graph
Collaboration diagram for dtn::security::SecurityCertificateManager:
Collaboration graph

Public Member Functions

 SecurityCertificateManager ()
 
virtual ~SecurityCertificateManager ()
 
virtual void onConfigurationChanged (const dtn::daemon::Configuration &conf) throw ()
 
bool isInitialized ()
 checks if this class has already been initialized with a certificate and private key More...
 
const X509 * getCert () const
 retrieve the saved certificate More...
 
const EVP_PKEY * getPrivateKey () const
 retrieve the saved private key More...
 
const ibrcommon::File & getTrustedCAPath () const
 retrieve the saved directory holding trusted certificates More...
 
virtual void initialize () throw ()
 
virtual void startup () throw ()
 
virtual void terminate () throw ()
 
virtual const std::string getName () const
 
- Public Member Functions inherited from dtn::daemon::Component
virtual ~Component ()=0
 

Static Public Member Functions

static void validateSubject (X509 *certificate, const std::string &cn) throw (SecurityCertificateException)
 Validates if the CommonName in the given X509 certificate corresponds to the given EID. More...
 

Static Public Attributes

static const std::string TAG = "SecurityCertificateManager"
 

Detailed Description

This class is a manager to handle certificates.

Definition at line 53 of file SecurityCertificateManager.h.

Constructor & Destructor Documentation

dtn::security::SecurityCertificateManager::SecurityCertificateManager ( )

Definition at line 36 of file SecurityCertificateManager.cpp.

dtn::security::SecurityCertificateManager::~SecurityCertificateManager ( )
virtual

Definition at line 41 of file SecurityCertificateManager.cpp.

Member Function Documentation

const X509 * dtn::security::SecurityCertificateManager::getCert ( ) const

retrieve the saved certificate

Returns
The certificate.
Warning
Check isInitialized() first, before calling this function

Definition at line 49 of file SecurityCertificateManager.cpp.

const std::string dtn::security::SecurityCertificateManager::getName ( ) const
virtual

Return an identifier for this component

Returns

Implements dtn::daemon::Component.

Definition at line 142 of file SecurityCertificateManager.cpp.

References TAG.

const EVP_PKEY * dtn::security::SecurityCertificateManager::getPrivateKey ( ) const

retrieve the saved private key

Returns
The private key as an EVP_PKEY pointer (OpenSSL).
Warning
Check isInitialized() first, before calling this function

Definition at line 54 of file SecurityCertificateManager.cpp.

const ibrcommon::File & dtn::security::SecurityCertificateManager::getTrustedCAPath ( ) const

retrieve the saved directory holding trusted certificates

Returns
The directory

Definition at line 59 of file SecurityCertificateManager.cpp.

void dtn::security::SecurityCertificateManager::initialize ( ) throw ()
virtual

Set up the component. At this stage no other components should be used.

Implements dtn::daemon::Component.

Definition at line 112 of file SecurityCertificateManager.cpp.

References dtn::daemon::Configuration::getInstance(), IBRCOMMON_LOGGER_ENDL, IBRCOMMON_LOGGER_TAG, ibrcommon::LogLevel::info, onConfigurationChanged(), and TAG.

Here is the call graph for this function:

bool dtn::security::SecurityCertificateManager::isInitialized ( )

checks if this class has already been initialized with a certificate and private key

Returns
true if it is initialized, false otherwise

Definition at line 44 of file SecurityCertificateManager.cpp.

void dtn::security::SecurityCertificateManager::onConfigurationChanged ( const dtn::daemon::Configuration &  conf) throw ()
virtual

Listen for changes of the configuration

Implements dtn::daemon::Configuration::OnChangeListener.

Definition at line 64 of file SecurityCertificateManager.cpp.

References ibrcommon::LogLevel::error, ibrcommon::File::getPath(), IBRCOMMON_LOGGER_ENDL, IBRCOMMON_LOGGER_TAG, ibrcommon::File::isDirectory(), and TAG.

Referenced by initialize().

Here is the call graph for this function:

void dtn::security::SecurityCertificateManager::startup ( ) throw ()
virtual

Start up the component. At this stage all other components are ready.

Implements dtn::daemon::Component.

Definition at line 128 of file SecurityCertificateManager.cpp.

References dtn::daemon::Configuration::getInstance(), and ibrcommon::TLSStream::init().

Here is the call graph for this function:

void dtn::security::SecurityCertificateManager::terminate ( ) throw ()
virtual

Terminate the component and do some cleanup stuff. All other components still exists, but may not serve signals.

Implements dtn::daemon::Component.

Definition at line 136 of file SecurityCertificateManager.cpp.

void dtn::security::SecurityCertificateManager::validateSubject ( X509 *  certificate,
const std::string &  cn 
) throw (SecurityCertificateException)
static

Validates if the CommonName in the given X509 certificate corresponds to the given EID.

Parameters
certificateThe Certificate.
eidThe EID of the sender.
Returns
returns true if the EID fits, false otherwise

Definition at line 148 of file SecurityCertificateManager.cpp.

References ibrcommon::LogLevel::error, IBRCOMMON_LOGGER_ENDL, IBRCOMMON_LOGGER_TAG, and TAG.

Referenced by dtn::net::TCPConnection::initiateExtendedHandshake().

Member Data Documentation

const std::string dtn::security::SecurityCertificateManager::TAG = "SecurityCertificateManager"
static

Definition at line 55 of file SecurityCertificateManager.h.

Referenced by getName(), initialize(), onConfigurationChanged(), and validateSubject().

The documentation for this class was generated from the following files: