nKrawall::nMethod Struct Reference

authentication method information More...

#include <nKrawall.h>

Inheritance diagram for nKrawall::nMethod:

[legend]

Collaboration diagram for nKrawall::nMethod:

[legend]

List of all members.

Public Member Functions
void	ScramblePassword (nScrambleInfo const &info, tString const &password, nScrambledPassword &scrambled) const
void	ScrambleSalt (nSalt &salt, tString const &serverIP) const
	extra salt scrambling step, done on client and server, not on authentication server
void	ScrambleWithSalt (nScrambleInfo const &info, nScrambledPassword const &scrambled, nSalt const &salt, nScrambledPassword &result) const
	scramble a password hash with a salt
	nMethod ()
	nMethod (char const *method_, std::istream &properties)
	nMethod (char const *method_, char const *prefix_="", char const *suffix_="")
Static Public Member Functions
static tString	SupportedMethods ()
static tString	BestMethod (tString const &a, tString const &b)
static nMethod const *const *	LocalMethods ()
	fetch NULL-terminated list of locally supported methods
static bool	BestLocalMethod (tString const &supportedOnClient, nMethod &result)
	fetch best local method supported by the client
static bool	Equal (nMethod const &a, nMethod const &b)
	compare two methods
Public Attributes
tString	method
	scrambling method; "bmd5" for old school
tString	prefix
	thing to prepend the password before hashing it
tString	suffix
	thing to append to the password before hashing it

---

Detailed Description

authentication method information

Definition at line 103 of file nKrawall.h.

---

Constructor & Destructor Documentation

nKrawall::nMethod::nMethod

(

)

[inline]

Definition at line 133 of file nKrawall.h.

{}

nKrawall::nMethod::nMethod	(	char const *	method_,
		std::istream &	properties
	)

Definition at line 243 of file nKrawall.cpp.

References method, prefix, tString::ReadLine(), suffix, and tToLower().

{
    method = method_;
    
    while ( !properties.eof() )
    {
        tString property;
        properties >> property;
        tToLower( property );

        std::ws( properties );
        if ( property == "prefix" )
        {
            prefix.ReadLine( properties );
        }
        else if ( property == "suffix" )
        {
            suffix.ReadLine( properties );
        }

    }

Here is the call graph for this function:

nKrawall::nMethod::nMethod	(	char const *	method_,
		char const *	prefix_ = "",
		char const *	suffix_ = ""
	)

Definition at line 266 of file nKrawall.cpp.

    : method( method_ ),
      prefix( prefix_ ),
      suffix( suffix_ )
{

---

Member Function Documentation

tString nKrawall::nMethod::SupportedMethods

(

)

[static]

Definition at line 97 of file nKrawall.cpp.

References sn_GetSupportedMethods().

{
    std::ostringstream s;

    std::vector< tString > methods;
    sn_GetSupportedMethods( methods);
    
    bool first = false;
    for( std::vector< tString >::iterator iter = methods.begin(); iter != methods.end(); ++iter )
    {
        if ( !first )
        {
            s << ", ";
        }
        s << *iter;

        first = false;
    }

    return tString( s.str().c_str() );

Here is the call graph for this function:

tString nKrawall::nMethod::BestMethod	(	tString const &	a,
		tString const &	b
	)			[static]

Definition at line 126 of file nKrawall.cpp.

References sn_BothHave(), and sn_GetSupportedMethods().

{
    tString ret;
    
    // iterate through methods, starting from best, and return the first that fits
    std::vector< tString > methods;
    sn_GetSupportedMethods( methods);
    for( std::vector< tString >::iterator iter = methods.begin(); iter != methods.end(); ++iter )
    {
        if ( sn_BothHave( a, b, *iter ) )
        {
            return *iter;
        }
    }

    return tString("");

Here is the call graph for this function:

void nKrawall::nMethod::ScramblePassword	(	nScrambleInfo const &	info,
		tString const &	password,
		nScrambledPassword &	scrambled
	)			const

Definition at line 201 of file nKrawall.cpp.

References nKrawall::BrokenScramblePassword(), method, prefix, nKrawall::ScramblePassword(), sn_Replace(), suffix, and tASSERT.

Referenced by PasswordCallback().

{
    if ( method == "bmd5" )
    {
        nKrawall::BrokenScramblePassword( password, scramble );
    }
    else // must be "md5"
    {
        tASSERT( method == "md5" );
        nKrawall::ScramblePassword( sn_Replace(info,prefix) + password + sn_Replace(info,suffix), scramble );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

void nKrawall::nMethod::ScrambleSalt	(	nSalt &	salt,
		tString const &	serverIP
	)			const

extra salt scrambling step, done on client and server, not on authentication server

Definition at line 215 of file nKrawall.cpp.

{
    if ( method != "bmd5" )
    {
        // just some random operation
        nSalt tmp;
        nKrawall::ScramblePassword( serverIP, tmp );
        nKrawall::ScrambleWithSalt2( salt, tmp, salt );
    }

void nKrawall::nMethod::ScrambleWithSalt	(	nScrambleInfo const &	info,
		nScrambledPassword const &	scrambled,
		nSalt const &	salt,
		nScrambledPassword &	result
	)			const

scramble a password hash with a salt

Definition at line 227 of file nKrawall.cpp.

References con, method, nKrawall::ScrambleWithSalt2(), and sn_IsSupportedMethod().

{
    // sanity check
    if ( !sn_IsSupportedMethod( method ) )
    {
        memset( &result, sizeof(result), 0);
        con << tColoredStringProxy(1,0,0) << "INTERNAL ERROR OR PHARMING ATTEMPT:" <<  tColoredStringProxy(1,1,1) << " unsupported hash method " << method << " selected.\n";
        return;
    }

    // nothing fancy heere
    nKrawall::ScrambleWithSalt2( scrambled, salt, result );

Here is the call graph for this function:

nKrawall::nMethod const *const * nKrawall::nMethod::LocalMethods

(

)

[static]

fetch NULL-terminated list of locally supported methods

Definition at line 52 of file nKrawallPrivate.cpp.

References NULL, sn_bmd5, and sn_md5.

{
    static nMethod const * methods[] =
    {
        &sn_md5,
        &sn_bmd5,
        NULL
    };

    return methods;
}

bool nKrawall::nMethod::BestLocalMethod	(	tString const &	supportedOnClient,
		nMethod &	result
	)			[static]

fetch best local method supported by the client

Definition at line 145 of file nKrawall.cpp.

{
    nMethod const * const * run = LocalMethods();

    while ( * run )
    {
        if ( sn_IsSupportedMethod( (*run)->method ) && tIsInList( supportedOnClient, (*run)->method ) )
        {
            result = **run;
            return true;
        }
        
        ++run;
    }

    return false;

bool nKrawall::nMethod::Equal	(	nMethod const &	a,
		nMethod const &	b
	)			[static]

compare two methods

Definition at line 163 of file nKrawall.cpp.

References method, prefix, and suffix.

{
    return a.method == b.method && a.prefix == b.prefix && a.suffix == b.suffix;

---

Member Data Documentation

tString nKrawall::nMethod::method

scrambling method; "bmd5" for old school

Definition at line 105 of file nKrawall.h.

Referenced by Equal(), nAuthentication::HandlePasswordRequest(), nMethod(), PasswordCallback(), ScramblePassword(), and ScrambleWithSalt().

tString nKrawall::nMethod::prefix

thing to prepend the password before hashing it

Definition at line 106 of file nKrawall.h.

Referenced by Equal(), nAuthentication::HandlePasswordRequest(), nMethod(), PasswordCallback(), and ScramblePassword().

tString nKrawall::nMethod::suffix

thing to append to the password before hashing it

Definition at line 107 of file nKrawall.h.

Referenced by Equal(), nAuthentication::HandlePasswordRequest(), nMethod(), PasswordCallback(), and ScramblePassword().

---

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

• src/network/nKrawall.h
• src/network/nKrawall.cpp
• src/network/nKrawallPrivate.cpp

---