Fedora 32: Simple Local File-Sharing with Samba

Sharing files with Fedora 32 using Samba is cross-platform, convenient, reliable, and performant.

What is ‘Samba’?

Samba is a high-quality implementation of Server Message Block protocol (SMB) . Originally developed by Microsoft for connecting windows computers together via local-area-networks, it is now extensively used for internal network communications.

Apple used to maintain it’s own independent file sharing called “ Apple Filing Protocol ( AFP ) “, however in recent times , it also has also switched to SMB.

In this guide we provide the minimal instructions to enable:

• Public Folder Sharing (Both Read Only and Read Write)
• User Home Folder Access

Note about this guide: The convention '<strong>~]$</strong>' for a local user command prompt, and '<strong>~]#</strong>' for a super user prompt will be used.

Public Sharing Folder

Having a shared public place where authenticated users on an internal network can access files, or even modify and change files if they are given permission, can be very convenient. This part of the guide walks through the process of setting up a shared folder, ready for sharing with Samba.

Please Note: This guide assumes the public sharing folder is on a Modern Linux Filesystem; other filesystems such as NTFS or FAT32 will not work. Samba uses POSIX Access Control Lists (ACLs).

For those who wish to learn more about Access Control Lists, please consider reading the documentation: "<a href="https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/system_administrators_guide/ch-access_control_lists">Red Hat Enterprise Linux 7: System Administrator's Guide: Chapter 5. Access Control Lists</a>", as it likewise applies to Fedora 32.

In General, this is only an issue for anyone who wishes to share a drive or filesystem that was created outside of the normal Fedora Installation process. (such as a external hard drive).

<em>It is possible for Samba to share filesystem paths that do not support POSIX ACLs, however this is out of the scope of this guide.</em>

Create Folder

For this guide the /srv/public/ folder for sharing will be used.

<strong>Make the Folder (will provide an error if the folder already exists).</strong>
~]# mkdir --verbose /srv/public

<strong>Verify folder exists:</strong>
~]$ ls --directory /srv/public

<strong>Expected Output:</strong>
<em>/srv/public</em>

Set Filesystem Security Context

To have read and write access to the public folder the public_content_rw_t security context will be used for this guide. Those wanting read only may use: public_content_t .

Add /srv/public as “public_content_rw_t” in the system’s local filesystem security context customization registry:

<strong>Add new security filesystem security context:</strong>
~]# semanage fcontext --add --type public_content_rw_t "/srv/public(/.*)?"

<strong></strong><strong>Verifiy new security filesystem security context:</strong>
~]# semanage fcontext --locallist --list

<strong>Expected Output: (should include)</strong>
<em>/srv/public(/.*)? all files system_u:object_r:public_content_rw_t:s0</em>

Now that the folder has been added to the local system’s filesystem security context registry; The restorecon command can be used to ‘restore’ the context to the folder:

<strong>Restore security context to the /srv/public folder:</strong>
$~]# restorecon -Rv /srv/public

<strong>Verify security context was correctly applied:</strong>
~]$ ls --directory --context /srv/public/

<strong>Expected Output:</strong>
<em>unconfined_u:object_r:<strong>public_content_rw_t</strong>:s0 /srv/public/</em>

User Permissions

Creating the Sharing Groups

To allow a user to either have read only , or read and write accesses to the public share folder create two new groups that govern these privileges: public_readonly and public_readwrite .

User accounts can be granted access to read only , or read and write by adding their account to the respective group (and allow login via Samba creating a smb password). This process is demonstrated in the section: “Test Public Sharing (localhost)”.

<strong>Create the public_readonly and public_readwrite groups:</strong>
~]# groupadd public_readonly
~]# groupadd public_readwrite

<strong>Verify successful creation of groups:</strong>
~]$ getent group public_readonly public_readwrite

<strong>Expected Output: (Note: <em>x:1...:</em> number will probability differ on your System)</strong>
<em>public_readonly:x:1009:
public_readwrite:x:1010:</em>

Set Permissions

Now set the appropriate user permissions to the public shared folder:

<strong>Set User and Group Permissions for Folder:</strong>
~]# chmod --verbose 2700 /srv/public
~]# setfacl -m group:public_readonly:r-x /srv/public
~]# setfacl -m default:group:public_readonly:r-x /srv/public
~]# setfacl -m group:public_readwrite:rwx /srv/public
~]# setfacl -m default:group:public_readwrite:rwx /srv/public

<strong>Verify user permissions have been correctly applied:</strong>
~]$ getfacl --absolute-names /srv/public

<strong>Expected Output:</strong>
<em>file: /srv/public
owner: root
group: root
flags: -s-
user::rwx
group::---
group:public_readonly:r-x
group:public_readwrite:rwx
mask::rwx
other::---
default:user::rwx
default:group::---
default:group:public_readonly:r-x
default:group:public_readwrite:rwx
default:mask::rwx
default:other::---</em>

Samba

Installation

~]# dnf install samba

Hostname (systemwide)

Samba will use the name of the computer when sharing files; it is good to set a hostname so that the computer can be found easily on the local network.

<strong>View Your Current Hostname:</strong>
~]$ hostnamectl status

If you wish to change your hostname to something more descriptive, use the command:

<strong>Modify your system's hostname (example):</strong>
~]# hostnamectl set-hostname "simple-samba-server"

For a more complete overview of the <strong>hostnamectl</strong> command, please read the previous Fedora Magazine Article: "<a href="https://fedoramagazine.org/set-hostname-fedora/">How to set the hostname on Fedora</a>".

Firewall

Configuring your firewall is a complex and involved task. This guide will just have the most minimal manipulation of the firewall to enable Samba to pass through.

For those who are interested in learning more about configuring firewalls; please consider reading the documentation: "<a href="https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/securing_networks/using-and-configuring-firewalls_securing-networks">Red Hat Enterprise Linux 8: Securing networks: Chapter 5. Using and configuring firewall</a>", as it generally applies to Fedora 32 as well.

<strong>Allow Samba access through the firewall:</strong>
~]# firewall-cmd --add-service=samba --permanent
~]# firewall-cmd --reload

<strong>Verify Samba is included in your active firewall:</strong>
~]$ firewall-cmd --list-services

<strong>Output (should include):</strong>
<em>samba</em>

Configuration

Remove Default Configuration

The stock configuration that is included with Fedora 32 is not required for this simple guide. In particular it includes support for sharing printers with Samba.

For this guide make a backup of the default configuration and create a new configuration file from scratch.

<strong>Create a backup copy of the existing Samba Configuration:</strong>
~]# cp --verbose --no-clobber /etc/samba/smb.conf /etc/samba/smb.conf.fedora0

<strong>Empty the configuration file:</strong>
~]# > /etc/samba/smb.conf

Samba Configuration

Please Note: This configuration file does not contain any global definitions; the defaults provided by Samba are good for purposes of this guide.

<strong>Edit the Samba Configuration File with Vim:</strong>
~]# vim /etc/samba/smb.conf

Add the following to /etc/samba/smb.conf file:

# smb.conf - Samba Configuration File

# The name of the share is in square brackets [],
#   this will be shared as //hostname/sharename

# There are a three exceptions:
#   the [global] section;
#   the [homes] section, that is dynamically set to the username;
#   the [printers] section, same as [homes], but for printers.

# path: the physical filesystem path (or device)
# comment: a label on the share, seen on the network.
# read only: disable writing, defaults to true.

# For a full list of configuration options,
#   please read the manual: "man smb.conf".

[global]

[public]
path = /srv/public
comment = Public Folder
read only = No

Write Permission

By default Samba is not granted permission to modify any file of the system. Modify system’s security configuration to allow Samba to modify any filesystem path that has the security context of public_content_rw_t .

For convenience, Fedora has a built-in SELinux Boolean for this purpose called: smbd_anon_write , setting this to true will enable Samba to write in any filesystem path that has been set to the security context of public_content_rw_t .

For those who are wishing Samba only have a read-only access to their public sharing folder, they may choose skip this step and not set this boolean.

There are many more SELinux boolean that are available for Samba. For those who are interested, please read the documentation: "<a href="https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/selinux_users_and_administrators_guide/sect-managing_confined_services-samba-booleans">Red Hat Enterprise Linux 7: SELinux User's and Administrator's Guide: 15.3. Samba Booleans</a>", it also apply to Fedora 32 without any adaptation.

<strong>Set SELinux Boolean allowing Samba to write to filesystem paths set with the security context <em>public_content_rw_t</em>:</strong>
~]# setsebool -P smbd_anon_write=1

<strong>Verify bool has been correctly set:</strong>
$ getsebool smbd_anon_write

<strong>Expected Output:</strong>
<em>smbd_anon_write --> on</em>

Samba Services

The Samba service is divided into two parts that we need to start.

Samba ‘smb’ Service

The Samba “Server Message Block” (SMB) services is for sharing files and printers over the local network.

Manual: “ smbd – server to provide SMB/CIFS services to clients “

Enable and Start Services

For those who are interested in learning more about configuring, enabling, disabling, and managing services, please consider studying the documentation: "<a href="https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/system_administrators_guide/sect-managing_services_with_systemd-services">Red Hat Enterprise Linux 7: System Administrator's Guide: 10.2. Managing System Services</a>".

<strong>Enable and start smb and nmb services:</strong>
~]# systemctl enable smb.service
~]# systemctl start smb.service

<strong>Verify smb service:</strong>
~]# systemctl status smb.service

Test Public Sharing (localhost)

To demonstrate allowing and removing access to the public shared folder, create a new user called samba_test_user , this user will be granted permissions first to read the public folder, and then access to read and write the public folder.

The same process demonstrated here can be used to grant access to your public shared folder to other users of your computer.

The samba_test_user will be created as a locked user account, disallowing normal login to the computer.

<strong>Create 'samba_test_user</strong>'<strong>, and lock the account.</strong>
~]# useradd samba_test_user
~]# passwd --lock samba_test_user

<strong>Set a Samba Password for this Test User (such as 'test')</strong>:
~]# smbpasswd -a samba_test_user

Test Read Only access to the Public Share:

<strong>Add samba_test_user to the public_readonly group:</strong>
~]# gpasswd --add samba_test_user public_readonly

<strong>Login to the local Samba Service (public folder)</strong>:
~]$ smbclient --user=samba_test_user //localhost/public

<strong>First, the <em>ls</em> command should succeed,
Second, the <em>mkdir</em> command should not work,
and finally, <em>exit</em>:</strong>
smb: \> ls
smb: \> mkdir error
smb: \> exit

<strong>Remove samba_test_user from the public_readonly group:</strong>
gpasswd --delete samba_test_user public_readonly

Test Read and Write access to the Public Share:

<strong>Add samba_test_user to the public_readwrite group:</strong>
~]# gpasswd --add samba_test_user public_readwrite

<strong>Login to the local Samba Service (public folder):</strong>
~]$ smbclient --user=samba_test_user //localhost/public

<strong>First, the <em>ls</em> command should succeed,
Second, the <em>mkdir</em> command should work,
Third, the rmdir command should work,
and finally, <em>exit</em>:</strong>
smb: \> ls
smb: \> mkdir success
smb: \> rmdir success
smb: \> exit

<strong>Remove samba_test_user from the public_readwrite group:
</strong>~]# gpasswd --delete samba_test_user public_readwrite

After testing is completed, for security, disable the samba_test_user ‘s ability to login in via samba.

<strong>Disable samba_test_user login via samba:</strong>
~]# smbpasswd -d samba_test_user

Home Folder Sharing

In this last section of the guide; Samba will be configured to share a user home folder.

For example: If the user bob has been registered with smbpasswd , bob’s home directory /home/bob , would become the share //server-name/bob .

This share will only be available for bob, and no other users.

This is a very convenient way of accessing your own local files; however naturally it carries at a security risk.

Setup Home Folder Sharing

Give Samba Permission for Public Folder Sharing

<strong>Set SELinux Boolean allowing Samba to read and write to home folders:</strong>
~]# setsebool -P samba_enable_home_dirs=1

<strong>Verify bool has been correctly set:</strong>
$ getsebool samba_enable_home_dirs

<strong>Expected Output:</strong>
<em>samba_enable_home_dirs --> on</em>

Add Home Sharing to the Samba Configuration

Append the following to the systems smb.conf file:

# The home folder dynamically links to the user home.

# If 'bob' user uses Samba:
# The homes section is used as the template for a new virtual share:

# [homes]
# ...   (various options)

# A virtual section for 'bob' is made:
# Share is modified: [homes] -> [bob]
# Path is added: path = /home/bob
# Any option within the [homes] section is appended.

# [bob]
#       path = /home/bob
# ...   (copy of various options)


# here is our share,
# same as is included in the Fedora default configuration.

[homes]
        comment = Home Directories
        valid users = %S, %D%w%S
        browseable = No
        read only = No
        inherit acls = Yes

Reload Samba Configuration

<strong>Tell Samba to reload it's configuration:</strong>
~]# smbcontrol all reload-config

Test Home Directory Sharing

<strong>Switch to samba_test_user and create a folder in it's home directory:</strong>
~]# su samba_test_user
samba_test_user:~]$ cd ~
samba_test_user:~]$ mkdir --verbose test_folder
samba_test_user:~]$ exit

<strong>Enable samba_test_user to login via Samba:</strong>
~]# smbpasswd -e samba_test_user

<strong>Login to the local Samba Service (samba_test_user home folder):</strong>
$ smbclient --user=samba_test_user //localhost/samba_test_user

<strong>Test (all commands should complete without error):</strong>
smb: \> ls
smb: \> ls test_folder
smb: \> rmdir test_folder
smb: \> mkdir home_success
smb: \> rmdir home_success
smb: \> exit

<strong>Disable samba_test_user</strong> <strong>from login in via Samba</strong>:
~]# smbpasswd -d samba_test_user