Class NTLMResponses

java.lang.Object
org.apache.mina.proxy.handlers.http.ntlm.NTLMResponses
public class NTLMResponses extends Object
NTLMResponses.java - Calculates the various Type 3 responses. Needs an MD4, MD5 and DES crypto provider (Please note that default provider doesn't provide MD4). Copyright (c) 2003 Eric Glass Permission to use, copy, modify, and distribute this document for any purpose and without any fee is hereby granted, provided that the above copyright notice and this list of conditions appear in all copies.
Since:
MINA 2.0.0-M3
See Also:

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final byte[]
    LM_HASH_MAGIC_CONSTANT
    LAN Manager magic constant used in LM Response calculation

  • Constructor Summary

    Constructors
    Modifier
    Constructor
    Description
    private
    NTLMResponses()
     

  • Method Summary

    Modifier and Type
    Method
    Description
    private static byte[]
    createBlob(byte[] targetInformation, byte[] clientNonce, long time)
    Creates the NTLMv2 blob from the given target information block and client nonce.
    private static Key
    createDESKey(byte[] bytes, int offset)
    Creates a DES encryption key from the given key material.
    static byte[]
    getLMResponse(String password, byte[] challenge)
    Calculates the LM Response for the given challenge, using the specified password.
    static byte[]
    getLMv2Response(String target, String user, String password, byte[] challenge, byte[] clientNonce)
    Calculates the LMv2 Response for the given challenge, using the specified authentication target, username, password, and client challenge.
    static byte[]
    getNTLM2SessionResponse(String password, byte[] challenge, byte[] clientNonce)
    Calculates the NTLM2 Session Response for the given challenge, using the specified password and client nonce.
    static byte[]
    getNTLMResponse(String password, byte[] challenge)
    Calculates the NTLM Response for the given challenge, using the specified password.
    static byte[]
    getNTLMv2Response(String target, String user, String password, byte[] targetInformation, byte[] challenge, byte[] clientNonce)
    Calculates the NTLMv2 Response for the given challenge, using the specified authentication target, username, password, target information block, and client nonce.
    static byte[]
    getNTLMv2Response(String target, String user, String password, byte[] targetInformation, byte[] challenge, byte[] clientNonce, long time)
    Calculates the NTLMv2 Response for the given challenge, using the specified authentication target, username, password, target information block, and client nonce.
    static byte[]
    hmacMD5(byte[] data, byte[] key)
    Calculates the HMAC-MD5 hash of the given data using the specified hashing key.
    private static byte[]
    lmHash(String password)
    Creates the LM Hash of the user's password.
    private static byte[]
    lmResponse(byte[] hash, byte[] challenge)
    Creates the LM Response from the given hash and Type 2 challenge.
    private static byte[]
    lmv2Response(byte[] hash, byte[] clientData, byte[] challenge)
    Creates the LMv2 Response from the given hash, client data, and Type 2 challenge.
    private static byte[]
    ntlmHash(String password)
    Creates the NTLM Hash of the user's password.
    private static byte[]
    ntlmv2Hash(String target, String user, String password)
    Creates the NTLMv2 Hash of the user's password.
    private static void
    oddParity(byte[] bytes)
    Applies odd parity to the given byte array.

    Methods inherited from class Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Field Details

    • LM_HASH_MAGIC_CONSTANT

      public static final byte[] LM_HASH_MAGIC_CONSTANT
      LAN Manager magic constant used in LM Response calculation

  • Constructor Details

    • NTLMResponses

      private NTLMResponses()

  • Method Details

    • getLMResponse

      public static byte[] getLMResponse(String password, byte[] challenge) throws Exception
      Calculates the LM Response for the given challenge, using the specified password.
      Parameters:
      password - The user's password.
      challenge - The Type 2 challenge from the server.
      Returns:
      The LM Response.
      Throws:
      Exception - If something went wrong

    • getNTLMResponse

      public static byte[] getNTLMResponse(String password, byte[] challenge) throws Exception
      Calculates the NTLM Response for the given challenge, using the specified password.
      Parameters:
      password - The user's password.
      challenge - The Type 2 challenge from the server.
      Returns:
      The NTLM Response.
      Throws:
      Exception - If something went wrong

    • getNTLMv2Response

      public static byte[] getNTLMv2Response(String target, String user, String password, byte[] targetInformation, byte[] challenge, byte[] clientNonce) throws Exception
      Calculates the NTLMv2 Response for the given challenge, using the specified authentication target, username, password, target information block, and client nonce.
      Parameters:
      target - The authentication target (i.e., domain).
      user - The username.
      password - The user's password.
      targetInformation - The target information block from the Type 2 message.
      challenge - The Type 2 challenge from the server.
      clientNonce - The random 8-byte client nonce.
      Returns:
      The NTLMv2 Response.
      Throws:
      Exception - If something went wrong

    • getNTLMv2Response

      public static byte[] getNTLMv2Response(String target, String user, String password, byte[] targetInformation, byte[] challenge, byte[] clientNonce, long time) throws Exception
      Calculates the NTLMv2 Response for the given challenge, using the specified authentication target, username, password, target information block, and client nonce.
      Parameters:
      target - The authentication target (i.e., domain).
      user - The username.
      password - The user's password.
      targetInformation - The target information block from the Type 2 message.
      challenge - The Type 2 challenge from the server.
      clientNonce - The random 8-byte client nonce.
      time - The time stamp.
      Returns:
      The NTLMv2 Response.
      Throws:
      Exception - If something went wrong

    • getLMv2Response

      public static byte[] getLMv2Response(String target, String user, String password, byte[] challenge, byte[] clientNonce) throws Exception
      Calculates the LMv2 Response for the given challenge, using the specified authentication target, username, password, and client challenge.
      Parameters:
      target - The authentication target (i.e., domain).
      user - The username.
      password - The user's password.
      challenge - The Type 2 challenge from the server.
      clientNonce - The random 8-byte client nonce.
      Returns:
      The LMv2 Response.
      Throws:
      Exception - If something went wrong

    • getNTLM2SessionResponse

      public static byte[] getNTLM2SessionResponse(String password, byte[] challenge, byte[] clientNonce) throws Exception
      Calculates the NTLM2 Session Response for the given challenge, using the specified password and client nonce.
      Parameters:
      password - The user's password.
      challenge - The Type 2 challenge from the server.
      clientNonce - The random 8-byte client nonce.
      Returns:
      The NTLM2 Session Response. This is placed in the NTLM response field of the Type 3 message; the LM response field contains the client nonce, null-padded to 24 bytes.
      Throws:
      Exception - If something went wrong

    • lmHash

      private static byte[] lmHash(String password) throws GeneralSecurityException
      Creates the LM Hash of the user's password.
      Parameters:
      password - The password.
      Returns:
      The LM Hash of the given password, used in the calculation of the LM Response.
      Throws:
      GeneralSecurityException - if an encryption problem occurs.

    • ntlmHash

      private static byte[] ntlmHash(String password) throws Exception
      Creates the NTLM Hash of the user's password.
      Parameters:
      password - The password.
      Returns:
      The NTLM Hash of the given password, used in the calculation of the NTLM Response and the NTLMv2 and LMv2 Hashes.
      Throws:
      Exception

    • ntlmv2Hash

      private static byte[] ntlmv2Hash(String target, String user, String password) throws Exception
      Creates the NTLMv2 Hash of the user's password.
      Parameters:
      target - The authentication target (i.e., domain).
      user - The username.
      password - The password.
      Returns:
      The NTLMv2 Hash, used in the calculation of the NTLMv2 and LMv2 Responses.
      Throws:
      Exception

    • lmResponse

      private static byte[] lmResponse(byte[] hash, byte[] challenge) throws Exception
      Creates the LM Response from the given hash and Type 2 challenge.
      Parameters:
      hash - The LM or NTLM Hash.
      challenge - The server challenge from the Type 2 message.
      Returns:
      The response (either LM or NTLM, depending on the provided hash).
      Throws:
      Exception

    • lmv2Response

      private static byte[] lmv2Response(byte[] hash, byte[] clientData, byte[] challenge) throws Exception
      Creates the LMv2 Response from the given hash, client data, and Type 2 challenge.
      Parameters:
      hash - The NTLMv2 Hash.
      clientData - The client data (blob or client nonce).
      challenge - The server challenge from the Type 2 message.
      Returns:
      The response (either NTLMv2 or LMv2, depending on the client data).
      Throws:
      Exception

    • createBlob

      private static byte[] createBlob(byte[] targetInformation, byte[] clientNonce, long time)
      Creates the NTLMv2 blob from the given target information block and client nonce.
      Parameters:
      targetInformation - The target information block from the Type 2 message.
      clientNonce - The random 8-byte client nonce.
      time - the time stamp.
      Returns:
      The blob, used in the calculation of the NTLMv2 Response.

    • hmacMD5

      public static byte[] hmacMD5(byte[] data, byte[] key) throws Exception
      Calculates the HMAC-MD5 hash of the given data using the specified hashing key.
      Parameters:
      data - The data for which the hash will be calculated.
      key - The hashing key.
      Returns:
      The HMAC-MD5 hash of the given data.
      Throws:
      Exception - If something went wrong

    • createDESKey

      private static Key createDESKey(byte[] bytes, int offset)
      Creates a DES encryption key from the given key material.
      Parameters:
      bytes - A byte array containing the DES key material.
      offset - The offset in the given byte array at which the 7-byte key material starts.
      Returns:
      A DES encryption key created from the key material starting at the specified offset in the given byte array.

    • oddParity

      private static void oddParity(byte[] bytes)
      Applies odd parity to the given byte array.
      Parameters:
      bytes - The data whose parity bits are to be adjusted for odd parity.