Module jcifs

Package org.codelibs.jcifs.smb.impl

Class NtlmPasswordAuthentication

java.lang.Object

org.codelibs.jcifs.smb.impl.NtlmPasswordAuthenticator

org.codelibs.jcifs.smb.impl.NtlmPasswordAuthentication

All Implemented Interfaces:

Serializable, Cloneable, Principal, Credentials, CredentialsInternal

@Deprecated
public class NtlmPasswordAuthentication
extends NtlmPasswordAuthenticator

Deprecated.

use NtlmPasswordAuthenticator instead

This class stores and encrypts NTLM user credentials. The default credentials are retrieved from the org.codelibs.jcifs.smb.impl.client.domain, org.codelibs.jcifs.smb.impl.client.username, and org.codelibs.jcifs.smb.impl.client.password properties.

Read jCIFS Exceptions and NtlmAuthenticator for related information.

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.codelibs.jcifs.smb.impl.NtlmPasswordAuthenticator

NtlmPasswordAuthenticator.AuthenticationType

Constructor Summary

Constructors

Constructor	Description
NtlmPasswordAuthentication(String domain, String username, byte[] challenge, byte[] ansiHash, byte[] unicodeHash)	Deprecated. Create an NtlmPasswordAuthentication object with raw password hashes.
NtlmPasswordAuthentication(CIFSContext tc)	Deprecated. Construct anonymous credentials
NtlmPasswordAuthentication(CIFSContext tc, String userInfo)	Deprecated. Create an NtlmPasswordAuthentication object from the userinfo component of an SMB URL like "domain;user:pass".
NtlmPasswordAuthentication(CIFSContext tc, String domain, String username, String password)	Deprecated. Create an NtlmPasswordAuthentication object from a domain, username, and password.

Method Summary

Modifier and Type	Method	Description
boolean	areHashesExternal()	Deprecated. Check whether the password hashes are externally supplied.
NtlmPasswordAuthentication	clone()	Deprecated. Create a copy of the credentials.
protected static void	cloneInternal(NtlmPasswordAuthentication to, NtlmPasswordAuthentication from)	Deprecated. Clone internal fields from one NtlmPasswordAuthentication to another.
boolean	equals(Object obj)	Deprecated. Compares two NtlmPasswordAuthentication objects for equality.
byte[]	getAnsiHash(CIFSContext tc, byte[] chlng)	Deprecated. Computes the 24 byte ANSI password hash given the 8 byte server challenge.
protected CIFSContext	getContext()	Deprecated. Get the CIFS context associated with this authentication.
byte[]	getUnicodeHash(CIFSContext tc, byte[] chlng)	Deprecated. Computes the 24 byte Unicode password hash given the 8 byte server challenge.
byte[]	getUserSessionKey(CIFSContext tc, byte[] chlng)	Deprecated. Returns the effective user session key.
void	getUserSessionKey(CIFSContext tc, byte[] chlng, byte[] dest, int offset)	Deprecated. Calculates the effective user session key.

Methods inherited from class org.codelibs.jcifs.smb.impl.NtlmPasswordAuthenticator

cloneInternal, createContext, getName, getNTHash, getPassword, getSigningKey, getSpecifiedUserDomain, getSubject, getUserDomain, getUsername, guessAuthenticationType, hashCode, isAnonymous, isGuest, isPreferredMech, refresh, toString, unwrap

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.security.Principal

implies

Constructor Details

NtlmPasswordAuthentication

public NtlmPasswordAuthentication(CIFSContext tc)

Deprecated.

Construct anonymous credentials

Parameters:

tc - the CIFS context to use

NtlmPasswordAuthentication

public NtlmPasswordAuthentication(CIFSContext tc,
 String userInfo)

Deprecated.

Create an NtlmPasswordAuthentication object from the userinfo component of an SMB URL like "domain;user:pass". This constructor is used internally be jCIFS when parsing SMB URLs.

Parameters:

tc - the CIFS context to use

userInfo - the user information string in the format "domain;user:pass"

NtlmPasswordAuthentication

public NtlmPasswordAuthentication(CIFSContext tc,
 String domain,
 String username,
 String password)

Deprecated.

Create an NtlmPasswordAuthentication object from a domain, username, and password. Parameters that are null will be substituted with org.codelibs.jcifs.smb.impl.client.domain, org.codelibs.jcifs.smb.impl.client.username, org.codelibs.jcifs.smb.impl.client.password property values.

Parameters:

tc - context to use

domain - the authentication domain

username - the username to authenticate with

password - the password to authenticate with

NtlmPasswordAuthentication

public NtlmPasswordAuthentication(String domain,
 String username,
 byte[] challenge,
 byte[] ansiHash,
 byte[] unicodeHash)

Deprecated.

Create an NtlmPasswordAuthentication object with raw password hashes. This is used exclusively by the org.codelibs.jcifs.smb.http.NtlmSsp class which is in turn used by NTLM HTTP authentication functionality.

Parameters:

domain - the authentication domain

username - the username to authenticate with

challenge - the server challenge bytes

ansiHash - the ANSI password hash

unicodeHash - the Unicode password hash

Method Details

getContext

protected CIFSContext getContext()

Deprecated.

Get the CIFS context associated with this authentication.

Returns:

the CIFS context

clone

public NtlmPasswordAuthentication clone()

Deprecated.

Description copied from interface: CredentialsInternal

Create a copy of the credentials.

Specified by:

clone in interface CredentialsInternal

Overrides:

clone in class NtlmPasswordAuthenticator

Returns:

a copy of the credentials

cloneInternal

protected static void cloneInternal(NtlmPasswordAuthentication to,
 NtlmPasswordAuthentication from)

Deprecated.

Clone internal fields from one NtlmPasswordAuthentication to another.

Parameters:

to - the target authentication object to copy to

from - the source authentication object to copy from

equals

public boolean equals(Object obj)

Deprecated.

Compares two NtlmPasswordAuthentication objects for equality. Two NtlmPasswordAuthentication objects are equal if their caseless domain and username fields are equal and either both hashes are external and they are equal or both internally supplied passwords are equal. If one NtlmPasswordAuthentication object has external hashes (meaning negotiated via NTLM HTTP Authentication) and the other does not they will not be equal. This is technically not correct however the server 8 byte challenge would be required to compute and compare the password hashes but that it not available with this method.

Specified by:

equals in interface Principal

Overrides:

equals in class NtlmPasswordAuthenticator

See Also:

• Object.equals(java.lang.Object)

areHashesExternal

public boolean areHashesExternal()

Deprecated.

Check whether the password hashes are externally supplied.

Returns:

whether the hashes are externally supplied

getAnsiHash

public byte[] getAnsiHash(CIFSContext tc,
 byte[] chlng)
                   throws GeneralSecurityException

Deprecated.

Computes the 24 byte ANSI password hash given the 8 byte server challenge.

Overrides:

getAnsiHash in class NtlmPasswordAuthenticator

Parameters:

tc - the CIFS context

chlng - the server challenge

Returns:

the hash for the given challenge

Throws:

GeneralSecurityException - if a security error occurs

See Also:

• NtlmPasswordAuthenticator.getAnsiHash(org.codelibs.jcifs.smb.CIFSContext, byte[])

getUnicodeHash

public byte[] getUnicodeHash(CIFSContext tc,
 byte[] chlng)
                      throws GeneralSecurityException

Deprecated.

Computes the 24 byte Unicode password hash given the 8 byte server challenge.

Overrides:

getUnicodeHash in class NtlmPasswordAuthenticator

Parameters:

tc - the CIFS context

chlng - the server challenge

Returns:

the hash for the given challenge

Throws:

GeneralSecurityException - if a security error occurs

See Also:

• NtlmPasswordAuthenticator.getUnicodeHash(org.codelibs.jcifs.smb.CIFSContext, byte[])

getUserSessionKey

public byte[] getUserSessionKey(CIFSContext tc,
 byte[] chlng)

Deprecated.

Returns the effective user session key.

Overrides:

getUserSessionKey in class NtlmPasswordAuthenticator

Parameters:

tc - the CIFS context

chlng - The server challenge.

Returns:

A byte[] containing the effective user session key, used in SMB MAC signing and NTLMSSP signing and sealing.

See Also:

• NtlmPasswordAuthenticator.getUserSessionKey(org.codelibs.jcifs.smb.CIFSContext, byte[])

getUserSessionKey

public void getUserSessionKey(CIFSContext tc,
 byte[] chlng,
 byte[] dest,
 int offset)
                       throws SmbException

Deprecated.

Calculates the effective user session key.

Overrides:

getUserSessionKey in class NtlmPasswordAuthenticator

Parameters:

tc - context to use

chlng - The server challenge.

dest - The destination array in which the user session key will be placed.

offset - The offset in the destination array at which the session key will start.

Throws:

SmbException - if an SMB error occurs

See Also:

• NtlmPasswordAuthenticator.getUserSessionKey(org.codelibs.jcifs.smb.CIFSContext, byte[], byte[], int)