CGatewaySecurity Klassenreferenz

Von CTCPIPComm abgeleitete Klasse, die die Zugriffsberechtigung auf den Gateway-Servern implementiert. Mehr...

#include <GatewaySecurity.h>

Klassendiagramm für CGatewaySecurity:

Aufstellung aller Elemente

Öffentliche Methoden
	CGatewaySecurity (bool bRunAsService)
	Konstruktor.
	CGatewaySecurity ()
	Konstruktor.
virtual	~CGatewaySecurity ()
	Destruktor.
virtual void	ConnectIndication (void)
	Von der Basisklasse CTCPIPComm abgeleitete virtuelle Methode, die anzeigt, dass eine Verbindung aufgebaut ist.
virtual void	DisconnectIndication (void)
	Von der Basisklasse CTCPIPComm abgeleitete virtuelle Methode, die anzeigt, dass eine Verbindung abgebaut ist.
virtual void	Receive (void *pData, long DataLen)
	Von der Basisklasse CTCPIPComm abgeleitete virtuelle Methode, die Daten von TCP/IP empfängt.
bool	StartProcessing (void)
	Startet die Security-Funktionalität.
bool	StopProcessing (void)
	Stoppt die Security-Funktionalität.
virtual void	AddTrace (const char *lpszMsg, CTraceObject::eTraceLevel eLevel=CTraceObject::MT_ERROR)
	Macht eine Trace-Ausgabe auf dem angeforderten Trace-Level.
void	SetParameterInput (const char *lpszIniFilename, const char *lpszRegKey, bool bRunAsService)
	Legt die Eingabe für die Parameter fest.
void	ReadParameters (void)
	Liest Parameter.
bool	GetSecurityPortActive (void) const
	Überprüft, ob die Security aktiviert ist.
bool	GetSecurityRunning (void) const
	Überprüft, ob die Security-Port bereits gestartet ist.
bool	VerifyRemotePartner (const char *lpszIPAddress)
	Überprüft, ob der Zugriff des Remote Partner erlaubt ist.
Private Methoden
void	AddValidAddress (const char *lpszValidAddress)
	Speichert die IP-Adresse, die sich erfolgreich authentifiziert hat.
void	RemoveOldAddresses (void)
	Löscht veraltete IP-Adressen aus dem Vektor mit den Remote-Partnern ( die IP-Addresse ist nur 10 Sekunden gültig ).
bool	CheckPassPhrase (const char *lpszPassword)
	Überprüft die PassPhrase eines remote-Partners.
void	ReadIniParameters (const char *pszIniFilename=NULL)
	Liest Security-Parameter aus der angegebenen Konfigurationsdatei.
void	ReadRegParameters (const char *pszRegKey=NULL)
	Liest Securtiy-Parameter aus der Registry.
Private Attribute
bool	m_bRunAsService
	RunningMode: NT-Service oder Console-Application.
short	m_nTCPPort
	Parametrierung TCPIP: Port.
std::string	m_sIPAddress
	Parametrierung TCPIP: IP-Adresse.
std::string	m_sFilePath
	Pfad der Ini-Datei für Konfiguration (Console-Mode).
std::string	m_sRegKey
	Registry-Schluessel für Konfiguaration (Service-Mode).
bool	m_bWaitForParameters
	Kennzeichen, ob Security-Parameter bereits eingelesen wurden.
bool	m_bSecurityRunning
	Ist Security-Port bereits gestartet?
bool	m_bSecurityPortActive
	Kennzeichen, ob Security verwendet wird.
std::string	m_sGlobalPassword
	Authenfication - Password.
std::string	m_sRemotePassword
	Aktuelles Password des Remote-Partners, der sich connektiert hat.
std::vector< struct sValidAddress >	m_oaRemotePartner
	Vektor mit den bereits authenfizierten Remote-Partnern.
CMutex	m_oLockRemote
	Zugriffs-Sicherung auf Vektor mit den Remote-Addressen.

---

Ausführliche Beschreibung

Von CTCPIPComm abgeleitete Klasse, die die Zugriffsberechtigung auf den Gateway-Servern implementiert.

Autor:

: Axel Schmidt

Revision

1.3

---

Beschreibung der Konstruktoren und Destruktoren

CGatewaySecurity::CGatewaySecurity (  bool  bRunAsService  )

Konstruktor. Parameter: bRunAsService  Läuft die Anwendung als Windows Service

---

Dokumentation der Elementfunktionen

void CGatewaySecurity::AddTrace (  const char *  lpszMsg, CTraceObject::eTraceLevel  eLevel = CTraceObject::MT_ERROR )  [virtual]

Macht eine Trace-Ausgabe auf dem angeforderten Trace-Level. Die Standard-Logik der Basisklasse CTraceObject wird geändert. Parameter: lpszMsg  Trace-Ausgabe eLevel  zu pruefende Trace-Level Rückgabe: true, false aktiv Erneute Implementation von CTraceObject.

void CGatewaySecurity::AddValidAddress (  const char *  lpszValidAddress  )  [private]

Speichert die IP-Adresse, die sich erfolgreich authentifiziert hat. Parameter: lpszValidAddress  IP-Address

bool CGatewaySecurity::CheckPassPhrase (  const char *  lpszPassword  )  [private]

Überprüft die PassPhrase eines remote-Partners. Parameter: lpszPassword  lfd. Zeichen des Passwords Rückgabe: false, falls Password falsch

bool CGatewaySecurity::GetSecurityPortActive (  void   )  const

Überprüft, ob die Security aktiviert ist. Rückgabe: true/false

bool CGatewaySecurity::GetSecurityRunning (  void   )  const

Überprüft, ob die Security-Port bereits gestartet ist. Rückgabe: true/false

void CGatewaySecurity::ReadIniParameters (  const char *  pszIniFilename = NULL  )  [private]

Liest Security-Parameter aus der angegebenen Konfigurationsdatei. Parameter: nServerNr  lfd. Nr des Gateway-Servers pszIniFilename  Konfigurationsdatei

void CGatewaySecurity::ReadRegParameters (  const char *  pszRegKey = NULL  )  [private]

Liest Securtiy-Parameter aus der Registry. Parameter: nServerNr  lfd. Nr des Gateway-Servers pszRegKey  Name des Registry-Schlüssel

void CGatewaySecurity::Receive (  void *  pData, long  DataLen )  [virtual]

Von der Basisklasse CTCPIPComm abgeleitete virtuelle Methode, die Daten von TCP/IP empfängt. Parameter: pData  Zeiger auf den empfangenen Datenbereich. DataLen  Länge dieses Datenbereiches. Implementiert CTCPIPCommReceive.

void CGatewaySecurity::SetParameterInput (  const char *  lpszIniFilename, const char *  lpszRegKey, bool  bRunAsService )

Legt die Eingabe für die Parameter fest. Parameter: lpszIniFilename  Name der INI-Datei (Service-Mode) lpszRegKey  Name des Basis-Registrier-Schlüssels (Console-Mode) bRunAsService  Läuft die Anwendung als Windows Service

bool CGatewaySecurity::StartProcessing (  void   )

Startet die Security-Funktionalität. Rückgabe: true, falls keine Fehler aufgetreten sind

bool CGatewaySecurity::StopProcessing (  void   )

Stoppt die Security-Funktionalität. Rückgabe: true, falls keine Fehler aufgetreten sind

bool CGatewaySecurity::VerifyRemotePartner (  const char *  lpszIPAddress  )

Überprüft, ob der Zugriff des Remote Partner erlaubt ist. Parameter: lpszIPAddress  IP-Address des Remote Partners Rückgabe: true/false

---

Die Dokumentation für diese Klasse wurde erzeugt aufgrund der Dateien:

• GatewaySecurity.h
• GatewaySecurity.cpp

---