KNTLM Class Reference

#include <kntlm.h>

Classes
struct	Auth
struct	Blob
struct	Challenge
struct	Negotiate
struct	SecBuf

Public Types
enum	AuthFlag { Force_V1 = 0x1, Force_V2 = 0x2, Add_LM = 0x4 }
enum	Flags {   Negotiate_Unicode = 0x00000001, Negotiate_OEM = 0x00000002, Request_Target = 0x00000004, Negotiate_Sign = 0x00000010,   Negotiate_Seal = 0x00000020, Negotiate_Datagram_Style = 0x00000040, Negotiate_LM_Key = 0x00000080, Negotiate_Netware = 0x00000100,   Negotiate_NTLM = 0x00000200, Negotiate_Domain_Supplied = 0x00001000, Negotiate_WS_Supplied = 0x00002000, Negotiate_Local_Call = 0x00004000,   Negotiate_Always_Sign = 0x00008000, Target_Type_Domain = 0x00010000, Target_Type_Server = 0x00020000, Target_Type_Share = 0x00040000,   Negotiate_NTLM2_Key = 0x00080000, Request_Init_Response = 0x00100000, Request_Accept_Response = 0x00200000, Request_NonNT_Key = 0x00400000,   Negotiate_Target_Info = 0x00800000, Negotiate_128 = 0x20000000, Negotiate_Key_Exchange = 0x40000000, Negotiate_56 = 0x80000000 }

Static Public Member Functions
static bool	getAuth (QByteArray &auth, const QByteArray &challenge, const QString &user, const QString &password, const QString &domain=QString(), const QString &workstation=QString(), AuthFlags authflags=Add_LM)
static QByteArray	getLMResponse (const QString &password, const unsigned char *challenge)
static QByteArray	getLMv2Response (const QString &target, const QString &user, const QString &password, const unsigned char *challenge)
static bool	getNegotiate (QByteArray &negotiate, const QString &domain=QString(), const QString &workstation=QString(), quint32 flags=Negotiate_Unicode|Request_Target|Negotiate_NTLM)
static QByteArray	getNTLMResponse (const QString &password, const unsigned char *challenge)
static QByteArray	getNTLMv2Response (const QString &target, const QString &user, const QString &password, const QByteArray &targetInformation, const unsigned char *challenge)
static QByteArray	lmHash (const QString &password)
static QByteArray	lmResponse (const QByteArray &hash, const unsigned char *challenge)
static QByteArray	lmv2Response (const QByteArray &hash, const QByteArray &clientData, const unsigned char *challenge)
static QByteArray	ntlmHash (const QString &password)
static QByteArray	ntlmv2Hash (const QString &target, const QString &user, const QString &password)

Detailed Description

KNTLM class implements the NTLM authentication protocol.

The KNTLM class is useful for creating the authentication structures which can be used for various servers which implements NTLM type authentication. A comprehensive description of the NTLM authentication protocol can be found at http://davenport.sourceforge.net/ntlm.html The class also contains methods to create the LanManager and NT (MD4) hashes of a password. This class doesn't maintain any state information, so all methods are static.

Definition at line 40 of file kntlm.h.

Member Enumeration Documentation

enum KNTLM::AuthFlag

Enumerator
Force_V1
Force_V2
Add_LM

Definition at line 71 of file kntlm.h.

enum KNTLM::Flags

Enumerator
Negotiate_Unicode
Negotiate_OEM
Request_Target
Negotiate_Sign
Negotiate_Seal
Negotiate_Datagram_Style
Negotiate_LM_Key
Negotiate_Netware
Negotiate_NTLM
Negotiate_Domain_Supplied
Negotiate_WS_Supplied
Negotiate_Local_Call
Negotiate_Always_Sign
Target_Type_Domain
Target_Type_Server
Target_Type_Share
Negotiate_NTLM2_Key
Request_Init_Response
Request_Accept_Response
Request_NonNT_Key
Negotiate_Target_Info
Negotiate_128
Negotiate_Key_Exchange
Negotiate_56

Definition at line 44 of file kntlm.h.

Member Function Documentation

bool KNTLM::getAuth ( QByteArray &  auth, const QByteArray &  challenge, const QString &  user, const QString &  password, const QString &  domain = QString(), const QString &  workstation = QString(), AuthFlags  authflags = Add_LM  )

static

Creates the type 3 message which should be sent to the server after the challenge (type 2) received.

Parameters

auth	- a buffer where the Type 3 message will returned.
challenge	- the Type 2 message returned by the server.
user	- user's name.
password	- user's password.
domain	- the target domain. If left empty, it will be extracted from the challenge.
workstation	- the user's workstation.
authflags	- AuthFlags flags that changes the response generation behavior. Force_V1 or Force_V2 forces (NT)LMv1 or (NT)LMv2 responses generation, otherwise it's autodetected from the challenge. Add_LM adds LMv1 or LMv2 responses additional to the NTLM response.

Returns

true if auth filled with the Type 3 message, false if an error occurred (challenge data invalid, NTLMv2 authentication forced, but the challenge data says no NTLMv2 supported, or no NTLM supported at all, and Add_LM not specified).

Definition at line 220 of file kntlm.cpp.

QByteArray KNTLM::getLMResponse ( const QString &  password, const unsigned char *  challenge  )

static

Returns the LanManager response from the password and the server challenge.

Definition at line 307 of file kntlm.cpp.

QByteArray KNTLM::getLMv2Response ( const QString &  target, const QString &  user, const QString &  password, const unsigned char *  challenge  )

static

Calculates the LMv2 response.

Definition at line 385 of file kntlm.cpp.

bool KNTLM::getNegotiate ( QByteArray &  negotiate, const QString &  domain = QString(), const QString &  workstation = QString(), quint32  flags = Negotiate_Unicode | Request_Target | Negotiate_NTLM  )

static

Creates the initial message (type 1) which should be sent to the server.

Parameters

negotiate	- a buffer where the Type 1 message will returned.
domain	- the domain name which should be send with the message.
workstation	- the workstation name which should be send with the message.
flags	- various flags, in most cases the defaults will good.

Returns

true if creating the structure succeeds, false otherwise.

Definition at line 198 of file kntlm.cpp.

QByteArray KNTLM::getNTLMResponse ( const QString &  password, const unsigned char *  challenge  )

static

Returns the NTLM response from the password and the server challenge.

Definition at line 358 of file kntlm.cpp.

QByteArray KNTLM::getNTLMv2Response ( const QString &  target, const QString &  user, const QString &  password, const QByteArray &  targetInformation, const unsigned char *  challenge  )

static

Calculates the NTLMv2 response.

Definition at line 376 of file kntlm.cpp.

QByteArray KNTLM::lmHash ( const QString &  password )

static

Calculates the LanManager hash of the specified password.

Definition at line 319 of file kntlm.cpp.

QByteArray KNTLM::lmResponse ( const QByteArray &  hash, const unsigned char *  challenge  )

static

Calculates the LanManager response from the LanManager hash and the server challenge.

Definition at line 340 of file kntlm.cpp.

QByteArray KNTLM::lmv2Response ( const QByteArray &  hash, const QByteArray &  clientData, const unsigned char *  challenge  )

static

Calculates the LMv2 response.

Definition at line 405 of file kntlm.cpp.

QByteArray KNTLM::ntlmHash ( const QString &  password )

static

Returns the NTLM hash (MD4) from the password.

Definition at line 368 of file kntlm.cpp.

QByteArray KNTLM::ntlmv2Hash ( const QString &  target, const QString &  user, const QString &  password  )

static

Returns the NTLMv2 hash.

Definition at line 398 of file kntlm.cpp.

---

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

• kntlm.h
• kntlm.cpp