ruby_smb 2.0.10 → 3.0.0

data/spec/lib/ruby_smb/dcerpc/wkssvc/netr_wksta_get_info_response_spec.rb

@@ -0,0 +1,410 @@
+RSpec.describe RubySMB::Dcerpc::Wkssvc::WkstaInfo102 do
+  subject(:packet) { described_class.new }
+
+  it { is_expected.to respond_to :wki102_platform_id }
+  it { is_expected.to respond_to :wki102_computername }
+  it { is_expected.to respond_to :wki102_langroup }
+  it { is_expected.to respond_to :wki102_ver_major }
+  it { is_expected.to respond_to :wki102_ver_minor }
+  it { is_expected.to respond_to :wki102_lanroot }
+  it { is_expected.to respond_to :wki102_logged_on_users }
+
+  it 'is little endian' do
+    expect(described_class.fields.instance_variable_get(:@hints)[:endian]).to eq :little
+  end
+  it 'it is a Ndr::NdrStruct' do
+    expect(described_class).to be < RubySMB::Dcerpc::Ndr::NdrStruct
+  end
+  describe '#wki102_platform_id' do
+    it 'is a NdrUint32 structure' do
+      expect(packet.wki102_platform_id).to be_a RubySMB::Dcerpc::Ndr::NdrUint32
+    end
+  end
+  describe '#wki102_computername' do
+    it 'is a Ndr::NdrWideStringzPtr' do
+      expect(packet.wki102_computername).to be_a(RubySMB::Dcerpc::Ndr::NdrWideStringzPtr)
+    end
+  end
+  describe '#wki102_langroup' do
+    it 'is a Ndr::NdrWideStringzPtr' do
+      expect(packet.wki102_langroup).to be_a(RubySMB::Dcerpc::Ndr::NdrWideStringzPtr)
+    end
+  end
+  describe '#wki102_ver_major' do
+    it 'is a NdrUint32 structure' do
+      expect(packet.wki102_ver_major).to be_a RubySMB::Dcerpc::Ndr::NdrUint32
+    end
+  end
+  describe '#wki102_ver_minor' do
+    it 'is a NdrUint32 structure' do
+      expect(packet.wki102_ver_minor).to be_a RubySMB::Dcerpc::Ndr::NdrUint32
+    end
+  end
+  describe '#wki102_lanroot' do
+    it 'is a Ndr::NdrWideStringzPtr' do
+      expect(packet.wki102_lanroot).to be_a(RubySMB::Dcerpc::Ndr::NdrWideStringzPtr)
+    end
+  end
+  describe '#wki102_logged_on_users' do
+    it 'is a NdrUint32 structure' do
+      expect(packet.wki102_logged_on_users).to be_a RubySMB::Dcerpc::Ndr::NdrUint32
+    end
+  end
+  it 'reads itself' do
+    new_class = described_class.new(
+      wki102_platform_id: 500,
+      wki102_computername: 'MYCOMPUTER',
+      wki102_langroup: 'MYDOMAIN',
+      wki102_ver_major: 6,
+      wki102_ver_minor: 2,
+      wki102_lanroot: 'MYLANROOT',
+      wki102_logged_on_users: 4,
+    )
+    expect(packet.read(new_class.to_binary_s)).to eq(
+      {
+        wki102_platform_id: 500,
+        wki102_computername: 'MYCOMPUTER'.encode('utf-16le'),
+        wki102_langroup: 'MYDOMAIN'.encode('utf-16le'),
+        wki102_ver_major: 6,
+        wki102_ver_minor: 2,
+        wki102_lanroot: 'MYLANROOT'.encode('utf-16le'),
+        wki102_logged_on_users: 4,
+      }
+    )
+  end
+end
+
+RSpec.describe RubySMB::Dcerpc::Wkssvc::PwkstaInfo102 do
+  subject(:packet) { described_class.new }
+
+  it 'is a WkstaInfo102' do
+    expect(packet).to be_a(RubySMB::Dcerpc::Wkssvc::WkstaInfo102)
+  end
+  it 'is a NDR Pointer' do
+    expect(described_class).to be_a(RubySMB::Dcerpc::Ndr::PointerClassPlugin)
+  end
+  it 'reads itself' do
+    new_class = described_class.new(
+      wki102_platform_id: 500,
+      wki102_computername: 'MYCOMPUTER',
+      wki102_langroup: 'MYDOMAIN',
+      wki102_ver_major: 6,
+      wki102_ver_minor: 2,
+      wki102_lanroot: 'MYLANROOT',
+      wki102_logged_on_users: 4,
+    )
+    expect(packet.read(new_class.to_binary_s)).to eq(
+      {
+        wki102_platform_id: 500,
+        wki102_computername: 'MYCOMPUTER'.encode('utf-16le'),
+        wki102_langroup: 'MYDOMAIN'.encode('utf-16le'),
+        wki102_ver_major: 6,
+        wki102_ver_minor: 2,
+        wki102_lanroot: 'MYLANROOT'.encode('utf-16le'),
+        wki102_logged_on_users: 4,
+      }
+    )
+  end
+end
+
+RSpec.describe RubySMB::Dcerpc::Wkssvc::WkstaInfo101 do
+  subject(:packet) { described_class.new }
+
+  it { is_expected.to respond_to :wki101_platform_id }
+  it { is_expected.to respond_to :wki101_computername }
+  it { is_expected.to respond_to :wki101_langroup }
+  it { is_expected.to respond_to :wki101_ver_major }
+  it { is_expected.to respond_to :wki101_ver_minor }
+  it { is_expected.to respond_to :wki101_lanroot }
+
+  it 'is little endian' do
+    expect(described_class.fields.instance_variable_get(:@hints)[:endian]).to eq :little
+  end
+  it 'it is a Ndr::NdrStruct' do
+    expect(described_class).to be < RubySMB::Dcerpc::Ndr::NdrStruct
+  end
+  describe '#wki101_platform_id' do
+    it 'is a NdrUint32 structure' do
+      expect(packet.wki101_platform_id).to be_a RubySMB::Dcerpc::Ndr::NdrUint32
+    end
+  end
+  describe '#wki101_computername' do
+    it 'is a Ndr::NdrWideStringzPtr' do
+      expect(packet.wki101_computername).to be_a(RubySMB::Dcerpc::Ndr::NdrWideStringzPtr)
+    end
+  end
+  describe '#wki101_langroup' do
+    it 'is a Ndr::NdrWideStringzPtr' do
+      expect(packet.wki101_langroup).to be_a(RubySMB::Dcerpc::Ndr::NdrWideStringzPtr)
+    end
+  end
+  describe '#wki101_ver_major' do
+    it 'is a NdrUint32 structure' do
+      expect(packet.wki101_ver_major).to be_a RubySMB::Dcerpc::Ndr::NdrUint32
+    end
+  end
+  describe '#wki101_ver_minor' do
+    it 'is a NdrUint32 structure' do
+      expect(packet.wki101_ver_minor).to be_a RubySMB::Dcerpc::Ndr::NdrUint32
+    end
+  end
+  describe '#wki101_lanroot' do
+    it 'is a Ndr::NdrWideStringzPtr' do
+      expect(packet.wki101_lanroot).to be_a(RubySMB::Dcerpc::Ndr::NdrWideStringzPtr)
+    end
+  end
+  it 'reads itself' do
+    new_class = described_class.new(
+      wki101_platform_id: 500,
+      wki101_computername: 'MYCOMPUTER',
+      wki101_langroup: 'MYDOMAIN',
+      wki101_ver_major: 6,
+      wki101_ver_minor: 2,
+      wki101_lanroot: 'MYLANROOT'
+    )
+    expect(packet.read(new_class.to_binary_s)).to eq(
+      {
+        wki101_platform_id: 500,
+        wki101_computername: 'MYCOMPUTER'.encode('utf-16le'),
+        wki101_langroup: 'MYDOMAIN'.encode('utf-16le'),
+        wki101_ver_major: 6,
+        wki101_ver_minor: 2,
+        wki101_lanroot: 'MYLANROOT'.encode('utf-16le')
+      }
+    )
+  end
+end
+
+RSpec.describe RubySMB::Dcerpc::Wkssvc::PwkstaInfo101 do
+  subject(:packet) { described_class.new }
+
+  it 'is a WkstaInfo101' do
+    expect(packet).to be_a(RubySMB::Dcerpc::Wkssvc::WkstaInfo101)
+  end
+  it 'is a NDR Pointer' do
+    expect(described_class).to be_a(RubySMB::Dcerpc::Ndr::PointerClassPlugin)
+  end
+  it 'reads itself' do
+    new_class = described_class.new(
+      wki101_platform_id: 500,
+      wki101_computername: 'MYCOMPUTER',
+      wki101_langroup: 'MYDOMAIN',
+      wki101_ver_major: 6,
+      wki101_ver_minor: 2,
+      wki101_lanroot: 'MYLANROOT'
+    )
+    expect(packet.read(new_class.to_binary_s)).to eq(
+      {
+        wki101_platform_id: 500,
+        wki101_computername: 'MYCOMPUTER'.encode('utf-16le'),
+        wki101_langroup: 'MYDOMAIN'.encode('utf-16le'),
+        wki101_ver_major: 6,
+        wki101_ver_minor: 2,
+        wki101_lanroot: 'MYLANROOT'.encode('utf-16le')
+      }
+    )
+  end
+end
+
+RSpec.describe RubySMB::Dcerpc::Wkssvc::WkstaInfo100 do
+  subject(:packet) { described_class.new }
+
+  it { is_expected.to respond_to :wki100_platform_id }
+  it { is_expected.to respond_to :wki100_computername }
+  it { is_expected.to respond_to :wki100_langroup }
+  it { is_expected.to respond_to :wki100_ver_major }
+  it { is_expected.to respond_to :wki100_ver_minor }
+
+  it 'is little endian' do
+    expect(described_class.fields.instance_variable_get(:@hints)[:endian]).to eq :little
+  end
+  it 'it is a Ndr::NdrStruct' do
+    expect(described_class).to be < RubySMB::Dcerpc::Ndr::NdrStruct
+  end
+  describe '#wki100_platform_id' do
+    it 'is a NdrUint32 structure' do
+      expect(packet.wki100_platform_id).to be_a RubySMB::Dcerpc::Ndr::NdrUint32
+    end
+  end
+  describe '#wki100_computername' do
+    it 'is a Ndr::NdrWideStringzPtr' do
+      expect(packet.wki100_computername).to be_a(RubySMB::Dcerpc::Ndr::NdrWideStringzPtr)
+    end
+  end
+  describe '#wki100_langroup' do
+    it 'is a Ndr::NdrWideStringzPtr' do
+      expect(packet.wki100_langroup).to be_a(RubySMB::Dcerpc::Ndr::NdrWideStringzPtr)
+    end
+  end
+  describe '#wki100_ver_major' do
+    it 'is a NdrUint32 structure' do
+      expect(packet.wki100_ver_major).to be_a RubySMB::Dcerpc::Ndr::NdrUint32
+    end
+  end
+  describe '#wki100_ver_minor' do
+    it 'is a NdrUint32 structure' do
+      expect(packet.wki100_ver_minor).to be_a RubySMB::Dcerpc::Ndr::NdrUint32
+    end
+  end
+
+  it 'reads itself' do
+    new_class = described_class.new(
+      wki100_platform_id: 500,
+      wki100_computername: 'MYCOMPUTER',
+      wki100_langroup: 'MYDOMAIN',
+      wki100_ver_major: 6,
+      wki100_ver_minor: 2
+    )
+    expect(packet.read(new_class.to_binary_s)).to eq(
+      {
+        wki100_platform_id: 500,
+        wki100_computername: 'MYCOMPUTER'.encode('utf-16le'),
+        wki100_langroup: 'MYDOMAIN'.encode('utf-16le'),
+        wki100_ver_major: 6,
+        wki100_ver_minor: 2
+      }
+    )
+  end
+end
+
+RSpec.describe RubySMB::Dcerpc::Wkssvc::PwkstaInfo100 do
+  subject(:packet) { described_class.new }
+
+  it 'is a WkstaInfo100' do
+    expect(packet).to be_a(RubySMB::Dcerpc::Wkssvc::WkstaInfo100)
+  end
+  it 'is a NDR Pointer' do
+    expect(described_class).to be_a(RubySMB::Dcerpc::Ndr::PointerClassPlugin)
+  end
+  it 'reads itself' do
+    new_class = described_class.new(
+      wki100_platform_id: 500,
+      wki100_computername: 'MYCOMPUTER',
+      wki100_langroup: 'MYDOMAIN',
+      wki100_ver_major: 6,
+      wki100_ver_minor: 2
+    )
+    expect(packet.read(new_class.to_binary_s)).to eq(
+      {
+        wki100_platform_id: 500,
+        wki100_computername: 'MYCOMPUTER'.encode('utf-16le'),
+        wki100_langroup: 'MYDOMAIN'.encode('utf-16le'),
+        wki100_ver_major: 6,
+        wki100_ver_minor: 2
+      }
+    )
+  end
+end
+
+RSpec.describe RubySMB::Dcerpc::Wkssvc::LpwkstaInfo do
+  subject(:packet) { described_class.new }
+
+  it { is_expected.to respond_to :level }
+  it { is_expected.to respond_to :info }
+
+  it 'is little endian' do
+    expect(described_class.fields.instance_variable_get(:@hints)[:endian]).to eq :little
+  end
+  it 'it is a Ndr::NdrStruct' do
+    expect(described_class).to be < RubySMB::Dcerpc::Ndr::NdrStruct
+  end
+  describe '#level' do
+    it 'is a NdrUint32 structure' do
+      expect(packet.level).to be_a RubySMB::Dcerpc::Ndr::NdrUint32
+    end
+  end
+  describe '#info' do
+    it 'is a BinData:Choice structure' do
+      expect(packet.info).to be_a BinData::Choice
+    end
+    it 'selects a structure according to :level value' do
+      packet.level = RubySMB::Dcerpc::Wkssvc::WKSTA_INFO_100
+      expect(packet.info.send(:current_choice)).to be_a(RubySMB::Dcerpc::Wkssvc::WkstaInfo100)
+    end
+  end
+  it 'reads itself' do
+    new_class = described_class.new(
+      level: RubySMB::Dcerpc::Wkssvc::WKSTA_INFO_100,
+      info: {
+        wki100_platform_id: 500,
+        wki100_computername: 'MYCOMPUTER',
+        wki100_langroup: 'MYDOMAIN',
+        wki100_ver_major: 6,
+        wki100_ver_minor: 2
+      }
+    )
+    expect(packet.read(new_class.to_binary_s)).to eq(
+      {
+        level: RubySMB::Dcerpc::Wkssvc::WKSTA_INFO_100,
+        info: {
+          wki100_platform_id: 500,
+          wki100_computername: 'MYCOMPUTER'.encode('utf-16le'),
+          wki100_langroup: 'MYDOMAIN'.encode('utf-16le'),
+          wki100_ver_major: 6,
+          wki100_ver_minor: 2
+        }
+      }
+    )
+  end
+end
+
+RSpec.describe RubySMB::Dcerpc::Wkssvc::NetrWkstaGetInfoResponse do
+  subject(:packet) { described_class.new }
+
+  it { is_expected.to respond_to :wksta_info }
+  it { is_expected.to respond_to :error_status }
+  it { is_expected.to respond_to :opnum }
+
+  it 'is little endian' do
+    expect(described_class.fields.instance_variable_get(:@hints)[:endian]).to eq :little
+  end
+  it 'is a BinData::Record' do
+    expect(packet).to be_a(BinData::Record)
+  end
+  describe '#wksta_info' do
+    it 'is a LpwkstaInfo structure' do
+      expect(packet.wksta_info).to be_a RubySMB::Dcerpc::Wkssvc::LpwkstaInfo
+    end
+  end
+  describe '#error_status' do
+    it 'is a NdrUint32 structure' do
+      expect(packet.error_status).to be_a RubySMB::Dcerpc::Ndr::NdrUint32
+    end
+  end
+  describe '#initialize_instance' do
+    it 'sets #opnum to NETR_WKSTA_GET_INFO constant' do
+      expect(packet.opnum).to eq(RubySMB::Dcerpc::Wkssvc::NETR_WKSTA_GET_INFO)
+    end
+  end
+  it 'reads itself' do
+    new_class = described_class.new(
+      wksta_info: {
+        level: RubySMB::Dcerpc::Wkssvc::WKSTA_INFO_100,
+        info: {
+          wki100_platform_id: 500,
+          wki100_computername: 'MYCOMPUTER',
+          wki100_langroup: 'MYDOMAIN',
+          wki100_ver_major: 6,
+          wki100_ver_minor: 2
+        }
+      },
+      error_status: 0
+    )
+    expect(packet.read(new_class.to_binary_s)).to eq(
+      {
+        wksta_info: {
+          level: RubySMB::Dcerpc::Wkssvc::WKSTA_INFO_100,
+          info: {
+            wki100_platform_id: 500,
+            wki100_computername: 'MYCOMPUTER'.encode('utf-16le'),
+            wki100_langroup: 'MYDOMAIN'.encode('utf-16le'),
+            wki100_ver_major: 6,
+            wki100_ver_minor: 2
+          }
+        },
+        error_status: 0
+      }
+    )
+  end
+end
+

data/spec/lib/ruby_smb/dcerpc/wkssvc_spec.rb

@@ -0,0 +1,70 @@
+RSpec.describe RubySMB::Dcerpc::Wkssvc do
+  let(:wkssvc) do
+    RubySMB::SMB1::Pipe.new(
+      tree: double('Tree'),
+      response: RubySMB::SMB1::Packet::NtCreateAndxResponse.new,
+      name: 'wkssvc'
+    )
+  end
+
+  describe '#netr_wksta_get_info' do
+    let(:wkst_netr_wksta_get_info_request) { double('NetrWkstaGetInfoRequest') }
+    let(:response) { double('Response') }
+    let(:wkst_netr_wksta_get_info_response) { double('NetrWkstaGetInfoResponse') }
+    let(:info) { double('info') }
+    before :example do
+      allow(described_class::NetrWkstaGetInfoRequest).to receive(:new).and_return(wkst_netr_wksta_get_info_request)
+      allow(wkssvc).to receive(:dcerpc_request).and_return(response)
+      allow(described_class::NetrWkstaGetInfoResponse).to receive(:read).and_return(wkst_netr_wksta_get_info_response)
+      allow(wkst_netr_wksta_get_info_response).to receive(:error_status).and_return(WindowsError::Win32::ERROR_SUCCESS)
+      allow(wkst_netr_wksta_get_info_response).to receive_message_chain(:wksta_info, :info => info)
+    end
+
+    it 'sets the request with the expected values' do
+      wkssvc.netr_wksta_get_info
+      expect(described_class::NetrWkstaGetInfoRequest).to have_received(:new).with(
+        server_name: "\x00",
+        level: described_class::WKSTA_INFO_100
+      )
+    end
+    it 'send the expected request structure' do
+      wkssvc.netr_wksta_get_info
+      expect(wkssvc).to have_received(:dcerpc_request).with(wkst_netr_wksta_get_info_request)
+    end
+    context 'when an IOError occurs while parsing the response' do
+      it 'raises a RubySMB::Dcerpc::Error::InvalidPacket' do
+        allow(described_class::NetrWkstaGetInfoResponse).to receive(:read).and_raise(IOError)
+        expect { wkssvc.netr_wksta_get_info }.to raise_error(RubySMB::Dcerpc::Error::InvalidPacket)
+      end
+    end
+    context 'when the response error status is not WindowsError::Win32::ERROR_SUCCESS' do
+      it 'raises a RubySMB::Dcerpc::Error::WinregError' do
+        allow(wkst_netr_wksta_get_info_response).to receive(:error_status).and_return(WindowsError::Win32::ERROR_INVALID_DATA)
+        expect { wkssvc.netr_wksta_get_info }.to raise_error(RubySMB::Dcerpc::Error::WkssvcError)
+      end
+    end
+    it 'returns the expected handler' do
+      expect(wkssvc.netr_wksta_get_info).to eq(info)
+    end
+    context 'with a real binary stream' do
+      it 'returns the expected value' do
+        raw_response =
+          "d\x00\x00\x00\x00\x00\x02\x00\xF4\x01\x00\x00\x04\x00\x02\x00\b"\
+          "\x00\x02\x00\x06\x00\x00\x00\x02\x00\x00\x00\x0F\x00\x00\x00\x00"\
+          "\x00\x00\x00\x0F\x00\x00\x00W\x00I\x00N\x00-\x00A\x00B\x00C\x00D"\
+          "\x00E\x00F\x00C\x007\x006\x008\x00\x00\x00\x00\x00\x06\x00\x00"\
+          "\x00\x00\x00\x00\x00\x06\x00\x00\x00M\x00Y\x00L\x00A\x00B\x00\x00"\
+          "\x00\x00\x00\x00\x00"
+        allow(wkssvc).to receive(:dcerpc_request).and_return(raw_response)
+        allow(described_class::NetrWkstaGetInfoResponse).to receive(:read).and_call_original
+        expect(wkssvc.netr_wksta_get_info).to eq({
+          wki100_platform_id: 500,
+          wki100_computername: "WIN-ABCDEFC768".encode('utf-16le'),
+          wki100_langroup: "MYLAB".encode('utf-16le'),
+          wki100_ver_major: 6,
+          wki100_ver_minor: 2
+        })
+      end
+    end
+  end
+end

data/spec/lib/ruby_smb/field/string16_spec.rb

@@ -0,0 +1,22 @@
+RSpec.describe RubySMB::Field::String16 do
+  subject(:field) { described_class.new }
+
+  it 'is a BinData::String' do
+    expect(field).to be_a BinData::String
+  end
+
+  it 'converts to utf-16le when assigning a String' do
+    expect(field.assign('Test'.encode('ASCII-8BIT')).encoding).to be Encoding::UTF_16LE
+  end
+
+  it 'makes sure snapshot returns a utf-16le string' do
+    field.new('Test'.encode('ASCII-8BIT'))
+    expect(field.snapshot.encoding).to be Encoding::UTF_16LE
+  end
+
+  it 'makes sure read operation returns a utf-16le string' do
+    field.read('Test'.encode('ASCII-8BIT'))
+    expect(field.snapshot.encoding).to be Encoding::UTF_16LE
+  end
+
+end

data/spec/lib/ruby_smb/gss/provider/ntlm/account_spec.rb

@@ -0,0 +1,32 @@
+RSpec.describe RubySMB::Gss::Provider::NTLM::Account do
+  let(:username) { 'RubySMB' }
+  let(:password) { 'password' }
+  let(:domain) { 'WORKGROUP' }
+  subject(:account) { RubySMB::Gss::Provider::NTLM::Account.new(username, password, domain) }
+
+  it { is_expected.to respond_to :username }
+  it { is_expected.to respond_to :password }
+  it { is_expected.to respond_to :domain }
+
+  it 'sets the username correct' do
+    expect(account.username).to eq username
+  end
+
+  it 'sets the password correctly' do
+    expect(account.password).to eq password
+  end
+
+  it 'sets the domain correctly' do
+    expect(account.domain).to eq domain
+  end
+
+  describe '#to_s' do
+    it 'converts to a string' do
+      expect(account.to_s).to be_a String
+    end
+
+    it 'formats the username and domain correctly' do
+      expect(account.to_s).to eq "#{domain}\\#{username}"
+    end
+  end
+end

data/spec/lib/ruby_smb/gss/provider/ntlm/authenticator_spec.rb

@@ -0,0 +1,101 @@
+RSpec.describe RubySMB::Gss::Provider::NTLM::Authenticator do
+  let(:username) { 'RubySMB' }
+  let(:domain) { 'WORKGROUP' }
+  let(:password) { 'password' }
+  let(:provider) { RubySMB::Gss::Provider::NTLM.new.tap { |provider| provider.put_account(username, password, domain: domain) } }
+  let(:authenticator) { described_class.new(provider, nil) }
+  let(:type1_msg) do
+    Net::NTLM::Message::Type1.new.tap do |msg|
+      msg.domain = domain
+    end
+  end
+  let(:type3_msg) do
+    Net::NTLM::Message::Type2.new.response(user: username, password: '', domain: domain)
+  end
+
+  describe '#initialize' do
+    it 'defaults to a null session key' do
+      expect(authenticator.session_key).to be_nil
+    end
+
+    it 'defaults to a null server challenge' do
+      expect(authenticator.server_challenge).to be_nil
+    end
+  end
+
+  describe '#process' do
+    it 'should handle an empty GSS buffer' do
+      result = authenticator.process
+      expect(result).to be_a RubySMB::Gss::Provider::Result
+      expect(result.nt_status).to eq WindowsError::NTStatus::STATUS_SUCCESS
+      expect(result.buffer).to_not be_empty
+      expect(result.identity).to be_nil
+    end
+
+    it 'should handle an embedded NTLM type 1 message' do
+      expect(authenticator).to receive(:process_ntlm_type1).and_call_original
+      result = authenticator.process(RubySMB::Gss.gss_type1(type1_msg.serialize))
+      expect(result).to be_a RubySMB::Gss::Provider::Result
+      expect(result.nt_status).to eq WindowsError::NTStatus::STATUS_MORE_PROCESSING_REQUIRED
+      expect(result.buffer).to_not be_empty
+      expect(result.identity).to be_nil
+      expect(authenticator.session_key).to be_nil
+    end
+
+    it 'should handle an embedded NTLM type 3 message' do
+      authenticator.server_challenge = Random.new.bytes(8)
+      expect(authenticator).to receive(:process_ntlm_type3).and_call_original
+      result = authenticator.process(RubySMB::Gss.gss_type3(type3_msg.serialize))
+      expect(result).to be_a RubySMB::Gss::Provider::Result
+      expect(result.nt_status).to eq WindowsError::NTStatus::STATUS_LOGON_FAILURE
+      expect(result.buffer).to be_nil
+      expect(result.identity).to be_nil
+      expect(authenticator.session_key).to be_nil
+    end
+  end
+
+  describe '#process_ntlm_type1' do
+    it 'should process a NTLM type 1 message and return a type2 message' do
+      expect(authenticator.process_ntlm_type1(type1_msg)).to be_a Net::NTLM::Message::Type2
+    end
+  end
+
+  describe '#process_ntlm_type3' do
+    it 'should process a NTLM type 3 message and return an error code' do
+      expect(authenticator.process_ntlm_type3(type3_msg)).to be_a WindowsError::ErrorCode
+      expect(authenticator.process_ntlm_type3(type3_msg)).to eq WindowsError::NTStatus::STATUS_LOGON_FAILURE
+    end
+  end
+
+  describe '#reset!' do
+    it 'should clear the server challenge' do
+      authenticator.instance_variable_set(:@server_challenge, Random.new.bytes(8))
+      authenticator.reset!
+      expect(authenticator.instance_variable_get(:@server_challenge)).to be_nil
+    end
+
+    it 'should clear the session key' do
+      authenticator.instance_variable_set(:@session_key, Random.new.bytes(16))
+      authenticator.reset!
+      expect(authenticator.instance_variable_get(:@session_key)).to be_nil
+    end
+  end
+
+  describe 'a full Net-NTLMv2 authentication exchange' do
+    let(:type2_msg) { authenticator.process_ntlm_type1(type1_msg)}
+
+    it 'should respond to a correct password with STATUS_SUCCESS' do
+      type3_msg = type2_msg.response({user: username, domain: domain, password: password}, ntlmv2: true)
+      type3_msg.user.force_encoding('UTF-16LE')
+      type3_msg.domain.force_encoding('UTF-16LE')
+      expect(authenticator.process_ntlm_type3(type3_msg)).to eq WindowsError::NTStatus::STATUS_SUCCESS
+    end
+
+    it 'should respond to an incorrect password with STATUS_LOGON_FAILURE' do
+      type3_msg = type2_msg.response({user: username, domain: domain, password: password + rand(0x41..0x5b).chr}, ntlmv2: true)
+      type3_msg.user.force_encoding('UTF-16LE')
+      type3_msg.domain.force_encoding('UTF-16LE')
+      expect(authenticator.process_ntlm_type3(type3_msg)).to eq WindowsError::NTStatus::STATUS_LOGON_FAILURE
+    end
+  end
+end

data/spec/lib/ruby_smb/gss/provider/ntlm/os_version_spec.rb

@@ -0,0 +1,32 @@
+RSpec.describe RubySMB::Gss::Provider::NTLM::OSVersion do
+  subject(:os_version) { RubySMB::Gss::Provider::NTLM::OSVersion.new }
+
+  it { is_expected.to respond_to :major }
+  it { is_expected.to respond_to :minor }
+  it { is_expected.to respond_to :build }
+  it { is_expected.to respond_to :ntlm_revision }
+
+  describe '#initialize' do
+    it 'defaults to an NTLM revision of 15' do
+      expect(os_version.ntlm_revision).to eq 15
+    end
+  end
+
+  describe '#read' do
+    it 'reads a packed version correctly' do
+      # Version 6.1 (Build 7601); NTLM Current Revision 15
+      os_version = RubySMB::Gss::Provider::NTLM::OSVersion.read("\x06\x01\xb1\x1d\x00\x00\x00\x0f")
+      expect(os_version.major).to eq 6
+      expect(os_version.minor).to eq 1
+      expect(os_version.build).to eq 7601
+      expect(os_version.ntlm_revision).to eq 15
+    end
+  end
+
+  describe '#to_s' do
+    it 'creates a string representation of the OS version' do
+      expect(os_version.to_s).to be_a String
+      expect(os_version.to_s).to match /Version \d+\.\d+ \(Build \d+\); NTLM Current Revision \d+/
+    end
+  end
+end