jcifs.smb

Class NtlmContext

java.lang.Object

jcifs.smb.NtlmContext

All Implemented Interfaces:

SSPContext

public class NtlmContext
extends Object
implements SSPContext

For initiating NTLM authentication (including NTLMv2). If you want to add NTLMv2 authentication support to something this is what you want to use. See the code for details. Note that JCIFS does not implement the acceptor side of NTLM authentication.

Field Summary

Fields

Modifier and Type	Field and Description
static org.bouncycastle.asn1.ASN1ObjectIdentifier	NTLMSSP_OID

Constructor Summary

Constructors

Constructor and Description
NtlmContext(CIFSContext tc, NtlmPasswordAuthenticator auth, boolean doSigning)

Method Summary

Modifier and Type	Method and Description
byte[]	calculateMIC(byte[] data)
void	dispose()
int	getFlags()
String	getNetbiosName()
byte[]	getServerChallenge()
byte[]	getSigningKey()
org.bouncycastle.asn1.ASN1ObjectIdentifier[]	getSupportedMechs()
byte[]	initSecContext(byte[] token, int offset, int len)
boolean	isEstablished()
boolean	isMICAvailable()
boolean	isPreferredMech(org.bouncycastle.asn1.ASN1ObjectIdentifier mechanism)
boolean	isSupported(org.bouncycastle.asn1.ASN1ObjectIdentifier mechanism)
void	setTargetName(String targetName)
boolean	supportsIntegrity()
String	toString()
void	verifyMIC(byte[] data, byte[] mic)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

NTLMSSP_OID

public static org.bouncycastle.asn1.ASN1ObjectIdentifier NTLMSSP_OID

Constructor Detail

NtlmContext

public NtlmContext(CIFSContext tc,
                   NtlmPasswordAuthenticator auth,
                   boolean doSigning)

Parameters:

tc - context to use

auth - credentials

doSigning - whether signing is requested

Method Detail

getSupportedMechs

public org.bouncycastle.asn1.ASN1ObjectIdentifier[] getSupportedMechs()

Specified by:

getSupportedMechs in interface SSPContext

Returns:

array of supported mechanism OIDs

See Also:

SSPContext.getSupportedMechs()

toString

public String toString()

Overrides:

toString in class Object

getFlags

public int getFlags()

Specified by:

getFlags in interface SSPContext

Returns:

context flags

See Also:

SSPContext.getFlags()

isSupported

public boolean isSupported(org.bouncycastle.asn1.ASN1ObjectIdentifier mechanism)

Specified by:

isSupported in interface SSPContext

Returns:

whether the specified mechanism is supported

See Also:

SSPContext.isSupported(org.bouncycastle.asn1.ASN1ObjectIdentifier)

isPreferredMech

public boolean isPreferredMech(org.bouncycastle.asn1.ASN1ObjectIdentifier mechanism)

Specified by:

isPreferredMech in interface SSPContext

Returns:

whether the specified mechanism is preferred

See Also:

SSPContext.isPreferredMech(org.bouncycastle.asn1.ASN1ObjectIdentifier)

isEstablished

public boolean isEstablished()

Specified by:

isEstablished in interface SSPContext

Returns:

whether the context is established

getServerChallenge

public byte[] getServerChallenge()

Returns:

the server's challenge

getSigningKey

public byte[] getSigningKey()

Specified by:

getSigningKey in interface SSPContext

Returns:

the signing key for the session

getNetbiosName

public String getNetbiosName()

Specified by:

getNetbiosName in interface SSPContext

Returns:

the name of the remote endpoint

setTargetName

public void setTargetName(String targetName)

Parameters:

targetName - the target's SPN

initSecContext

public byte[] initSecContext(byte[] token,
                             int offset,
                             int len)
                      throws SmbException

Specified by:

initSecContext in interface SSPContext

Returns:

result token

Throws:

SmbException

supportsIntegrity

public boolean supportsIntegrity()

Specified by:

supportsIntegrity in interface SSPContext

Returns:

whether this mechanisms supports integrity

isMICAvailable

public boolean isMICAvailable()

Specified by:

isMICAvailable in interface SSPContext

Returns:

whether MIC can be used

calculateMIC

public byte[] calculateMIC(byte[] data)
                    throws CIFSException

Specified by:

calculateMIC in interface SSPContext

Returns:

MIC

Throws:

CIFSException

verifyMIC

public void verifyMIC(byte[] data,
                      byte[] mic)
               throws CIFSException

Specified by:

verifyMIC in interface SSPContext

Throws:

CIFSException

dispose

public void dispose()
             throws SmbException

Specified by:

dispose in interface SSPContext

Throws:

SmbException

See Also:

SSPContext.dispose()