SMB protocol support

protocols/index.md

@@ -8,6 +8,7 @@
 cdn/index
 ftp
 sftp/index
+smb
 webdav/index
 webdav/nextcloud
 s3/index
@@ -28,22 +29,22 @@
 
 All major server and cloud storage protocols are supported to connect to just about any server or cloud storage. Support for the listed protocols and [connection profiles](profiles/index.md) is available in [Cyberduck](../cyberduck/index.md), [Cyberduck CLI](../cli/index.md) and [Mountain Duck](../mountainduck/index.md).
 
 ### [FTP](ftp.md)
 With support for secure TLS connections and custom origin [Amazon CloudFront (Content Delivery Network) distribution](../protocols/cdn/cloudfront) option.
 
 ### [Amazon S3](s3/index.md)
 Transfer files to your S3 account and browse the S3 buckets and files in a hierarchical way. Supports Amazon Web Services (AWS) and many third party providers.
 
 - [S3 providers](s3/index.md#third-party-providers)
 
 ### [Google Cloud Storage](googlecloudstorage.md)
 
 Transfer files to your Google Storage account and browse files, manage ACLs and bucket configurations.
 
 ### [Backblaze B2](b2.md)
 Backblaze B2 Cloud Storage is ¼ of the price of Amazon S3
 
 ### [WebDAV](webdav/index.md)
 Connect to any WebDAV compliant server using both HTTP and HTTP/SSL and custom origin [Amazon CloudFront (Content Delivery Network) distribution](cdn/cloudfront.md) option.
 
 - [WebDAV providers](webdav/index.md#providers)
@@ -83,6 +84,9 @@
 ### [iRODS](irods.md)
 The Integrated Rule-Oriented Data System (iRODS) is an open source data management software used by research organizations and government agencies worldwide.
 
+### [SMB](smb.md)
+SMB (Server Message Block) is used to access Windows File Shares.
+
 ### [Spectra BlackPearl Deep Storage Gateway](spectra.md)
 
 ### Local Disk
@@ -145,6 +149,7 @@
 | Nextcloud            | ❌ | ✅ |
 | ownCloud             | ❌	| ✅ |
 | S3                   | ❌ | ✅ |
+| SMB                  | ❌ | ✅ |
 | Windows Azure        | ❌ | ❌ |
 | OpenStack Object Storage        | ❌ | ❌ |
 

protocols/smb.md

@@ -0,0 +1,59 @@
+SMB
+====
+
+```{image} _images/ftp.png
+:alt: FTP Drive Icon
+:width: 128px
+```
+
+```{contents} Content
+:depth: 2
+:local:
+```
+
+
+> [SMB (Server Message Block)](https://en.wikipedia.org/wiki/Server_Message_Block) is used to access Windows File Shares or a Samba Linux Server.
+
+## Connecting
+
+```{important}
+* Cyberduck [9.0.0](https://cyberduck.io/changelog/) or later required
+* Mountain Duck [5.0.0](https://mountainduck.io/changelog/) or later required
+```
+
+To connect to a SMB server, choose _SMB (Server Message Block)_.
+
+```{image} _images/SMB_Connection.png
+:alt: SMB Connection
+:width: 700px
+```
+
+### Authentication
+Username and password must be provided for authentication using NTLM. The optional domain name defaults to `WORKGROUP` and can be customized as part of the username in the format `REALM\username` in the _Username_ input field when adding a bookmark. Depending on the server setup this can be
+- `COMPUTERNAME\username`
+- `NETBIOSDOMAINNAME\username`
+
+### Share Name
+To connect to a specific share, you can configure a _Path_ in the bookmark. When omitted an attempt is made to list all available shares from the server. On failure retrieving share names from the server, a prompt is displayed to enter the share name when connecting.
+
+```{image} _images/SMB_Share.png
+:alt: SMB Share Input
+:width: 700px
+```
+
+### Interoperability
+
+SMB protocol support has been tested with connections to the following server implementations
+- Windows 2016 Server (`SMB_3_1_1` dialect)
+- Windows 2022 Server (`SMB_3_1_1` dialect)
+- Linux Samba (`SMB_3_1_1` dialect)
+- macOS 13.5 (22G74) (`SMB_3_0_2` dialect)
+
+### Cyberduck CLI
+
+You can list shares with [Cyberduck CLI](https://duck.sh/) using
+
+	duck --list smb:/server/share/
+
+## Limitations
+- Copying or moving files between shares is not supported