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.
Main Page | Class Hierarchy | Class List | Class Members

SecurePlayLibrary::SPSecurityManagerInterface Class Reference

#include <SPSecurityManagerInterface.h>

Inheritance diagram for SecurePlayLibrary::SPSecurityManagerInterface:

SecurePlayLibrary::SPSSecurityManager_SecLiteClass List of all members.

Public Member Functions

virtual bool onIncomingTransaction (SPMessageClass *messobj)=0
virtual vector< SPbyte > SPcreateBHash (string input, string gameid)=0
virtual vector< SPbyte > SPcreateBSignature (string senderID, vector< SPbyte > 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< SPbyte > sigToVerify, string senderID, vector< SPbyte > testhash, string gameid)=0
virtual bool SPverifySignature (string signature, string senderID, string testhash, string gameid)=0
virtual bool SPsetGame (SPGameInterface *game, string gameID)=0

Detailed Description

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

Member Function Documentation

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

Implemented in SecurePlayLibrary::SPSSecurityManager_SecLiteClass.

virtual vector<SPbyte> 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:
str - String - Hash of input

Implemented in SecurePlayLibrary::SPSSecurityManager_SecLiteClass.

virtual vector<SPbyte> SecurePlayLibrary::SPSecurityManagerInterface::SPcreateBSignature (  string  senderID,
vector< SPbyte >  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 byte[]
gameid String
Returns:
realSig - byte[] - digital signature of hashstring signed by senderID.

Implemented in SecurePlayLibrary::SPSSecurityManager_SecLiteClass.

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:
str - String - Hash of input

Implemented in SecurePlayLibrary::SPSSecurityManager_SecLiteClass.

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:
str - String - digital signature of hashstring signed by senderID.

Implemented in SecurePlayLibrary::SPSSecurityManager_SecLiteClass.

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 String[] - input message body to be decrypted
senderID String - sender id
recvrs String[] - receiver id list
gameID String - game id
messageID String - message id
Returns:
mess - String[] - String array of decrypted messagebody.

Implemented in SecurePlayLibrary::SPSSecurityManager_SecLiteClass.

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 String[] - message body to be encrypted
senderID String - sender id
recvrs String[] - receiver id list
gameID String - game id
messageID String - message id
Returns:
mess - String[] - Encrypted message body

Implemented in SecurePlayLibrary::SPSSecurityManager_SecLiteClass.

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 
gameID 
Returns:
boolean

Implemented in SecurePlayLibrary::SPSSecurityManager_SecLiteClass.

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:
true - Boolean - TRUE, if verification Successful, FALSE, if not.

Implemented in SecurePlayLibrary::SPSSecurityManager_SecLiteClass.

virtual bool SecurePlayLibrary::SPSecurityManagerInterface::SPverifySignature (  vector< SPbyte >  sigToVerify,
string  senderID,
vector< SPbyte >  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 byte[]
senderID String
testhash String
Returns:
true - Boolean - TRUE, if verification Successful, FALSE, if not.

Implemented in SecurePlayLibrary::SPSSecurityManager_SecLiteClass.

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.