Merge pull request #408 from iterate-ch/issue/407

SMB protocol support

protocols/index.md

@@ -8,6 +8,7 @@ profiles/index
 cdn/index
 ftp
 sftp/index
+smb
 webdav/index
 webdav/nextcloud
 s3/index
@@ -83,6 +84,9 @@ Files.com is Smart Cloud Storage for modern teams
 ### [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 @@ Protocols with limited support for modification dates only allow to set the modi
 | 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