diff --git a/protocols/_images/SMB_Connection.png b/protocols/_images/SMB_Connection.png new file mode 100644 index 00000000..5bb1f4cc Binary files /dev/null and b/protocols/_images/SMB_Connection.png differ diff --git a/protocols/_images/SMB_Share.png b/protocols/_images/SMB_Share.png new file mode 100644 index 00000000..13b7ff7f Binary files /dev/null and b/protocols/_images/SMB_Share.png differ diff --git a/protocols/index.md b/protocols/index.md index 819126e7..defdcc4c 100644 --- a/protocols/index.md +++ b/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 | ❌ | ❌ | diff --git a/protocols/smb.md b/protocols/smb.md new file mode 100644 index 00000000..fc70c44c --- /dev/null +++ b/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 \ No newline at end of file