Main Page | Namespace List | Class Hierarchy | Alphabetical List | Class List | Directories | File List | Namespace Members | Class Members | File Members

SecurePlayLibrary::SPSecurityManagerInterface Class Reference

#include <SPSecurityManagerInterface.h>

Inheritance diagram for SecurePlayLibrary::SPSecurityManagerInterface:

SecurePlayLibrary::SPSSecurityManagerClass List of all members.

Detailed Description

This is the interface for the security manager class.
Author:
IT GlobalSecure
See also:
SecurePlay License Information


Public Member Functions

virtual ~SPSecurityManagerInterface ()
virtual bool onIncomingTransaction (SPMessageClass *messobj)=0
virtual vector< byte > SPcreateBHash (string input, string gameid)=0
virtual vector< byte > SPcreateBSignature (string senderID, vector< byte > input, string gameid)=0
virtual string SPcreateHash (string input, string gameid)=0
virtual string SPcreateSignature (string senderID, string input, string gameid)=0
virtual vector< string > SPdecrypt (vector< string > input, string senderID, vector< string > recvrs, string gameID, string messageID)=0
virtual vector< string > SPencrypt (vector< string > input, string senderID, vector< string > recvrs, string gameID, string messageID)=0
virtual bool SPverifySignature (vector< byte > sigToVerify, string senderID, vector< byte > testhash, string gameid)=0
virtual bool SPverifySignature (string signature, string senderID, string testhash, string gameid)=0
virtual bool SPsetGame (SPGameInterface *game, string gameID)=0

Constructor & Destructor Documentation

virtual SecurePlayLibrary::SPSecurityManagerInterface::~SPSecurityManagerInterface (   )  [inline, virtual]
 

Virtual Destructor.

Member Function Documentation

virtual bool SecurePlayLibrary::SPSecurityManagerInterface::onIncomingTransaction (  SPMessageClass *  messobj  )  [pure virtual]
 

This method handles incoming messages.

Parameters:
messobj SPMessageClass* - incoming message
Returns:
bool - TRUE: if message processed, FALSE: if not.

Implemented in SecurePlayLibrary::SPSSecurityManagerClass.

virtual vector<byte> SecurePlayLibrary::SPSecurityManagerInterface::SPcreateBHash (  string  input,
string  gameid
)  [pure virtual]
 

This is a wrapper function for creating a hash of a string. This reference implementation includes a MD5 hash.

Parameters:
input string
Returns:
string - Hash of input

Implemented in SecurePlayLibrary::SPSSecurityManagerClass.

virtual vector<byte> SecurePlayLibrary::SPSecurityManagerInterface::SPcreateBSignature (  string  senderID,
vector< byte >  input,
string  gameid
)  [pure virtual]
 

This is a wrapper function for creating a digital signature based on an existing hashed string and a Sender ID. The reference implementation currently uses an MD5 function to approximate performance of a real signature. The included signature function is a sample function - REPLACE with a function that meets your specific security requirements.

Parameters:
senderID string
input vector<byte>
gameid string
Returns:
vector<byte> - digital signature of hashstring signed by senderID.

Implemented in SecurePlayLibrary::SPSSecurityManagerClass.

virtual string SecurePlayLibrary::SPSecurityManagerInterface::SPcreateHash (  string  input,
string  gameid
)  [pure virtual]
 

This is a wrapper function for creating a hash of a string. This reference implementation includes a MD5 hash.

Parameters:
input string
Returns:
string - Hash of input

Implemented in SecurePlayLibrary::SPSSecurityManagerClass.

virtual string SecurePlayLibrary::SPSecurityManagerInterface::SPcreateSignature (  string  senderID,
string  input,
string  gameid
)  [pure virtual]
 

This is a wrapper function for creating a digital signature based on an existing hashed string and a Sender ID. The reference implementation currently uses an MD5 function to approximate performance of a real signature. The included signature function is a sample function - REPLACE with a function that meets your specific security requirements.

Parameters:
senderID string
input string
gameid string
Returns:
string - digital signature of hashstring signed by senderID.

Implemented in SecurePlayLibrary::SPSSecurityManagerClass.

virtual vector<string> SecurePlayLibrary::SPSecurityManagerInterface::SPdecrypt (  vector< string >  input,
string  senderID,
vector< string >  recvrs,
string  gameID,
string  messageID
)  [pure virtual]
 

This is a placeholder for an decryption function. An actual encryption function is the responsibility of the game implementer.

Parameters:
input vector<string> - input message body to be decrypted
senderID string - sender id
recvrs vector<string> - receiver id list
gameID string - game id
messageID string - message id
Returns:
vector<string> - string array of decrypted messagebody.

Implemented in SecurePlayLibrary::SPSSecurityManagerClass.

virtual vector<string> SecurePlayLibrary::SPSecurityManagerInterface::SPencrypt (  vector< string >  input,
string  senderID,
vector< string >  recvrs,
string  gameID,
string  messageID
)  [pure virtual]
 

This is a placeholder for an encryption function. An actual encryption function is the responsibility of the game implementer.

Parameters:
input vector<string> - message body to be encrypted
senderID string - sender id
recvrs vector<string> - receiver id list
gameID string - game id
messageID string - message id
Returns:
vector<string> - Encrypted message body

Implemented in SecurePlayLibrary::SPSSecurityManagerClass.

virtual bool SecurePlayLibrary::SPSecurityManagerInterface::SPsetGame (  SPGameInterface *  game,
string  gameID
)  [pure virtual]
 

This method sets the game object associated with the Security Manager. Note, it may be possible in certain implementations to associate multiple games with one security manager.

Parameters:
game SPGameInterface*
gameID string
Returns:
bool - TRUE, if successful, FALSE, if not.

Implemented in SecurePlayLibrary::SPSSecurityManagerClass.

virtual bool SecurePlayLibrary::SPSecurityManagerInterface::SPverifySignature (  string  signature,
string  senderID,
string  testhash,
string  gameid
)  [pure virtual]
 

This is a wrapper for a digital signature verification function. CAREFUL CHOICE OF ACTUAL DIGITAL SIGNATURES AND VERIFICATION IS CRITICAL. SELECTION OF APPROPRIATE FUNCTIONS AND IMPLEMENTATION MAY HAVE A SUBSTANTIAL IMPACT ON THE SECURITY AND PERFORMANCE OF A GAME IMPLEMENTATION.

Parameters:
signature string
senderID string
testhash string
Returns:
bool - TRUE, if verification Successful, FALSE, if not.

Implemented in SecurePlayLibrary::SPSSecurityManagerClass.

virtual bool SecurePlayLibrary::SPSecurityManagerInterface::SPverifySignature (  vector< byte >  sigToVerify,
string  senderID,
vector< byte >  testhash,
string  gameid
)  [pure virtual]
 

This is a wrapper for a digital signature verification function. CAREFUL CHOICE OF ACTUAL DIGITAL SIGNATURES AND VERIFICATION IS CRITICAL. SELECTION OF APPROPRIATE FUNCTIONS AND IMPLEMENTATION MAY HAVE A SUBSTANTIAL IMPACT ON THE SECURITY AND PERFORMANCE OF A GAME IMPLEMENTATION.

Parameters:
sigToVerify vector<byte>
senderID string
testhash string
Returns:
bool - TRUE, if verification Successful, FALSE, if not.

Implemented in SecurePlayLibrary::SPSSecurityManagerClass.

The documentation for this class was generated from the following file: 2006 Copyright Filed by IT GlobalSecure, Inc. All Rights Reserved. Not to be used without authorization by Author. SecurePlay, IT GlobalSecure, and IT Armor are registered trademarks by IT GlobalSecure, Inc. Software protected by software license, and one or more the following U.S. and International patent numbers: U.S. Patent 6,030,288, U.S. Patent 6,165,072, European Patent Office EP1016049A1,and World Intellectual Property Organization WO9912135C1 and additional filings worldwide.