Class SMBSessionBuilder

java.lang.Object

com.hierynomus.smbj.connection.SMBSessionBuilder

public class SMBSessionBuilder
extends Object

[MS-SMB2] 3.2.5.3.1 Handling a New Authentication

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	SMBSessionBuilder.BuilderContext
static interface	SMBSessionBuilder.SessionFactory

Field Summary

Fields

Modifier and Type	Field	Description
(package private) static final String	AES_128_CMAC_ALGORITHM
private final SmbConfig	config
private final Connection	connection
private final ConnectionContext	connectionContext
(package private) static final String	HMAC_SHA256_ALGORITHM
(package private) static final byte[]	KDF_APP_CONTEXT
(package private) static final byte[]	KDF_APP_LABEL
(package private) static final byte[]	KDF_APP_LABEL_SMB311
(package private) static final byte[]	KDF_DEC_CONTEXT
(package private) static final byte[]	KDF_DEC_LABEL_SMB311
(package private) static final byte[]	KDF_ENC_CONTEXT
(package private) static final byte[]	KDF_ENC_LABEL_SMB311
(package private) static final byte[]	KDF_ENCDEC_LABEL
(package private) static final byte[]	KDF_SIGN_CONTEXT
(package private) static final byte[]	KDF_SIGN_LABEL
(package private) static final byte[]	KDF_SIGN_LABEL_SMB311
private static final org.slf4j.Logger	logger
private final SessionTable	preauthSessionTable
private final SMBSessionBuilder.SessionFactory	sessionFactory
private final SessionTable	sessionTable

Constructor Summary

Constructors

Constructor	Description
SMBSessionBuilder(Connection connection, SmbConfig config, SMBSessionBuilder.SessionFactory sessionFactory)

Method Summary

Modifier and Type	Method	Description
private SecretKey	deriveKey(SecretKey derivationKey, byte[] label, byte[] context, String algorithm)
private void	deriveKeys(SMB2SessionSetup response, SMB2Dialect dialect, SessionContext context)
Session	establish(AuthenticationContext authContext)	Establish a new session on the connection using the passed credentials.
private Authenticator	getAuthenticator(AuthenticationContext context)
private SMBSessionBuilder.BuilderContext	initiateSessionSetup(SMBSessionBuilder.BuilderContext ctx, byte[] securityContext)
private SMBSessionBuilder.BuilderContext	newContext(AuthenticationContext authContext, Authenticator authenticator)
private Session	newSession(SMBSessionBuilder.BuilderContext ctx)
private void	processAuthenticationToken(SMBSessionBuilder.BuilderContext ctx, byte[] inputToken)
private Session	setupSession(SMBSessionBuilder.BuilderContext ctx)
private void	updatePreauthIntegrityValue(SMBSessionBuilder.BuilderContext ctx, SessionContext sessionContext, SMB2Packet packet)
private void	validateAndSetSigning(SMBSessionBuilder.BuilderContext ctx, SessionContext context)

Methods inherited from class Object

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

Field Details

KDF_ENC_LABEL_SMB311

static final byte[] KDF_ENC_LABEL_SMB311

KDF_DEC_LABEL_SMB311

static final byte[] KDF_DEC_LABEL_SMB311

KDF_ENCDEC_LABEL

static final byte[] KDF_ENCDEC_LABEL

KDF_ENC_CONTEXT

static final byte[] KDF_ENC_CONTEXT

KDF_DEC_CONTEXT

static final byte[] KDF_DEC_CONTEXT

KDF_SIGN_CONTEXT

static final byte[] KDF_SIGN_CONTEXT

KDF_SIGN_LABEL

static final byte[] KDF_SIGN_LABEL

KDF_SIGN_LABEL_SMB311

static final byte[] KDF_SIGN_LABEL_SMB311

KDF_APP_CONTEXT

static final byte[] KDF_APP_CONTEXT

KDF_APP_LABEL

static final byte[] KDF_APP_LABEL

KDF_APP_LABEL_SMB311

static final byte[] KDF_APP_LABEL_SMB311

HMAC_SHA256_ALGORITHM

static final String HMAC_SHA256_ALGORITHM

See Also:

• Constant Field Values

AES_128_CMAC_ALGORITHM

static final String AES_128_CMAC_ALGORITHM

See Also:

• Constant Field Values

logger

private static final org.slf4j.Logger logger

config

private final SmbConfig config

connectionContext

private final ConnectionContext connectionContext

sessionFactory

private final SMBSessionBuilder.SessionFactory sessionFactory

sessionTable

private final SessionTable sessionTable

preauthSessionTable

private final SessionTable preauthSessionTable

connection

private final Connection connection

Constructor Details

SMBSessionBuilder

public SMBSessionBuilder(Connection connection,
 SmbConfig config,
 SMBSessionBuilder.SessionFactory sessionFactory)

Method Details

establish

public Session establish(AuthenticationContext authContext)

Establish a new session on the connection using the passed credentials.

Returns:

a (new) Session that is authenticated for the user.

newContext

private SMBSessionBuilder.BuilderContext newContext(AuthenticationContext authContext,
 Authenticator authenticator)

setupSession

private Session setupSession(SMBSessionBuilder.BuilderContext ctx)
                      throws IOException

Throws:

IOException

newSession

private Session newSession(SMBSessionBuilder.BuilderContext ctx)

processAuthenticationToken

private void processAuthenticationToken(SMBSessionBuilder.BuilderContext ctx,
 byte[] inputToken)
                                 throws IOException

Throws:

IOException

initiateSessionSetup

private SMBSessionBuilder.BuilderContext initiateSessionSetup(SMBSessionBuilder.BuilderContext ctx,
 byte[] securityContext)
                                                       throws TransportException

Throws:

TransportException

getAuthenticator

private Authenticator getAuthenticator(AuthenticationContext context)
                                throws SpnegoException

Throws:

SpnegoException

validateAndSetSigning

private void validateAndSetSigning(SMBSessionBuilder.BuilderContext ctx,
 SessionContext context)

updatePreauthIntegrityValue

private void updatePreauthIntegrityValue(SMBSessionBuilder.BuilderContext ctx,
 SessionContext sessionContext,
 SMB2Packet packet)

deriveKeys

private void deriveKeys(SMB2SessionSetup response,
 SMB2Dialect dialect,
 SessionContext context)

deriveKey

private SecretKey deriveKey(SecretKey derivationKey,
 byte[] label,
 byte[] context,
 String algorithm)