smbj - SMB2/SMB3 library for Java

To get started, have a look at one of the examples. Hopefully you will find the API pleasant to work with :)

Getting SMBJ

To get SMBJ, you have two options:

1. Add a dependency to SMBJ to your project.

2. Build SMBJ yourself.

And, if you want, you can also run the SMBJ examples.

Binary releases of SMBJ are not provided here, but you can download it straight from the Maven Central repository if you want to.

Depending on SMBJ

If you’re building your project using Maven, you can add the following dependency to the pom.xml:

<dependency>
  <groupId>com.hierynomus</groupId>
  <artifactId>smbj</artifactId>
  <version>0.0.3</version>
</dependency>

If your project is built using another build tool that uses the Maven Central repository, translate this dependency into the format used by your build tool.

Building SMBJ

1. Clone the SMBJ repository.

2. Ensure you have Java7 installed with the Unlimited strength Java Cryptography Extensions (JCE).

3. Run the command ./gradlew clean build.

Specifications

The implementation is based on the following specifications:

• [MS-SMB2]: Server Message Block (SMB) Protocol Versions 2 and 3

• [MS-SPNG]: Simple and Protected GSS-API Negotiation Mechanism (SPNEGO) Extension

• [MS-NLMP]: NT LAN Manager (NTLM) Authentication Protocol

• [MS-DTYP]: Windows Data Types

• [MS-ERREF]: Windows Error Codes

• [MS-FSCC]: File System Control Codes