TouchSocketPro.Smb 4.3.4

TouchSocketPro.Smb

TouchSocketPro.Smb provides TouchSocket-style native SMB2 components. It implements TCP framing, SMB2 negotiate/session setup, NTLMv2 authentication, tree connect, echo, file handles, directory queries, and basic file operations without an SMB protocol package dependency. Connection, authentication, share selection, timeout, and transport settings are stored in TouchSocketConfig, matching the setup flow used by TouchSocketPro.Ssh.

var client = new SmbClient();
await client.SetupAsync(new TouchSocketConfig()
    .SetRemoteIPHost("192.168.1.10:445")
    .SetSmbClientOption(option =>
    {
        option.DomainName = domainName;
        option.UserName = userName;
        option.Password = password;
        option.ShareName = "Shared";
    }));

await client.ConnectAsync();
var result = await client.ListDirectoryAsync("");
await client.CloseAsync();

var service = new SmbService();
await service.SetupAsync(new TouchSocketConfig()
    .SetListenIPHosts(445)
    .SetSmbServiceOption(new SmbServiceOption
    {
        ServerName = "TouchSocketSmb"
    })
    .ConfigurePlugins(pluginManager =>
    {
        pluginManager.Add(new SmbPasswordPlugin());
    }));

service.AddShare("Shared", @"D:\Shared");
await service.StartAsync();

sealed class SmbPasswordPlugin : PluginBase, ISmbConnectingPlugin
{
    public Task OnSmbConnecting(SmbSessionClient client, SmbConnectingEventArgs e)
    {
        e.IsPermitOperation = TryGetPassword(e.DomainName, e.UserName, out var password)
            && e.VerifyPassword(password);
        return Task.CompletedTask;
    }
}

SMB session lifecycle plugins follow the connection shape separately from file-system access. ISmbConnectingPlugin is raised during SMB authentication, ISmbConnectedPlugin is raised after authentication succeeds, ISmbClosingPlugin is raised before an active close, and ISmbClosedPlugin is raised after the session closes.

sealed class SmbSessionPlugin : PluginBase,
    ISmbConnectedPlugin,
    ISmbClosingPlugin,
    ISmbClosedPlugin
{
    public Task OnSmbConnected(SmbSessionClient client, SmbConnectedEventArgs e)
    {
        LogConnected(e.DomainName, e.UserName, e.Workstation);
        return Task.CompletedTask;
    }

    public Task OnSmbClosing(SmbSessionClient client, ClosingEventArgs e)
    {
        LogClosing(e.Message);
        return Task.CompletedTask;
    }

    public Task OnSmbClosed(SmbSessionClient client, ClosedEventArgs e)
    {
        LogClosed(e.Message, e.Exception);
        return Task.CompletedTask;
    }
}

SMB access lifecycle plugins are intentionally aggregated. Use ISmbAccessingPlugin for pre-access validation and ISmbAccessedPlugin for post-access auditing, then branch by SmbAccessType for share, file, and directory operations.

sealed class SmbAccessPlugin : PluginBase, ISmbAccessingPlugin, ISmbAccessedPlugin
{
    public Task OnSmbAccessing(SmbSessionClient client, SmbAccessingEventArgs e)
    {
        if (e.AccessType == SmbAccessType.Write && IsReadOnly(e.ShareName, e.Path))
        {
            e.IsPermitOperation = false;
            e.Message = "The path is read-only.";
        }

        return Task.CompletedTask;
    }

    public Task OnSmbAccessed(SmbSessionClient client, SmbAccessedEventArgs e)
    {
        LogAccess(e.AccessType, e.ShareName, e.Path, e.Result);
        return Task.CompletedTask;
    }
}