com.linar.jintegra
Class NTLMAuthenticate

java.lang.Object
  extended by com.linar.jintegra.NTLMAuthenticate

public class NTLMAuthenticate
extends java.lang.Object

This class authenticates a domain/user/password using the "NT Challenge-Response" protocol. This means no password is transmitted over the network. It does not use any native code to perform the authentication, and can therefore authenticate identities from any platform (e.g. Windows, Unix, Linux, etc). .

For more information, please see Security/Authentication.


Constructor Summary
NTLMAuthenticate(java.lang.String pdcTcpHost)
           
NTLMAuthenticate(java.lang.String netBiosName, java.lang.String pdcTcpHost)
           
 
Method Summary
static void validate(java.lang.String pdcTcpHost, java.lang.String domain, java.lang.String user, java.lang.String password)
          Attempts to authenticate an NT domain/user/password.
static void validate(java.lang.String netBiosName, java.lang.String pdcTcpHost, java.lang.String domain, java.lang.String user, java.lang.String password)
          Attempts to authenticate an NT domain/user/password.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

NTLMAuthenticate

public NTLMAuthenticate(java.lang.String pdcTcpHost)
                 throws java.net.UnknownHostException,
                        java.io.IOException
Throws:
java.net.UnknownHostException
java.io.IOException

NTLMAuthenticate

public NTLMAuthenticate(java.lang.String netBiosName,
                        java.lang.String pdcTcpHost)
                 throws java.net.UnknownHostException,
                        java.io.IOException
Throws:
java.net.UnknownHostException
java.io.IOException
Method Detail

validate

public static void validate(java.lang.String pdcTcpHost,
                            java.lang.String domain,
                            java.lang.String user,
                            java.lang.String password)
                     throws java.io.IOException
Attempts to authenticate an NT domain/user/password. Works from anywhere that supports Java and requires no native code (just the jintegra.jar runtime). No password is transmitted over the network (J-Integra® implements the NT Challenge-Response mechanism). If the domain/user/password are valid then this method simply returns, otherwise a security exception is thrown.

Parameters:
pdcTcpHost - the IP name of an NT machine against which J-Integra® can perform the authentication
domain - the NT Domain name of the user
user - the NT user name of the user
password - the user's password.
Throws:
java.lang.SecurityException - if the domain/user/password are not correct
java.io.IOException - if there were problems talking to the NT box against which the authentication was to take place.

validate

public static void validate(java.lang.String netBiosName,
                            java.lang.String pdcTcpHost,
                            java.lang.String domain,
                            java.lang.String user,
                            java.lang.String password)
                     throws java.io.IOException
Attempts to authenticate an NT domain/user/password. Works from anywhere that supports Java and requires no native code (just the jintegra.jar runtime). No password is transmitted over the network (J-Integra® implements the NT Challenge-Response mechanism). If the domain/user/password are valid then this method simply returns, otherwise a security exception is thrown.

Parameters:
netBiosName - local machine's NetBIOS name (needed if the user is node-locked)
pdcTcpHost - the IP name of an NT machine against which J-Integra® can perform the authentication
domain - the NT Domain name of the user
user - the NT user name of the user
password - the user's password.
Throws:
java.lang.SecurityException - if the domain/user/password are not correct
java.io.IOException - if there were problems talking to the NT box against which the authentication was to take place.