A sysadmin's guide to SELinux

A sysadmin's guide to SELinux: 42 answers to the big questions

Get answers to the big questions about life, the universe, and everything else about Security-Enhanced Linux.

Lock
Image credits : 

JanBaby, via Pixabay CC0.

x

Get the newsletter

Join the 85,000 open source advocates who receive our giveaway alerts and article roundups.

"It is an important and popular fact that things are not always what they seem…"
―Douglas Adams, The Hitchhiker's Guide to the Galaxy

Security. Hardening. Compliance. Policy. The Four Horsemen of the SysAdmin Apocalypse. In addition to our daily tasks—monitoring, backup, implementation, tuning, updating, and so forth—we are also in charge of securing our systems. Even those systems where the third-party provider tells us to disable the enhanced security. It seems like a job for Mission Impossible's Ethan Hunt.

Faced with this dilemma, some sysadmins decide to take the blue pill because they think they will never know the answer to the big question of life, the universe, and everything else. And, as we all know, that answer is 42.

In the spirit of The Hitchhiker's Guide to the Galaxy, here are the 42 answers to the big questions about managing and using SELinux with your systems.

  1. SELinux is a LABELING system, which means every process has a LABEL. Every file, directory, and system object has a LABEL. Policy rules control access between labeled processes and labeled objects. The kernel enforces these rules.
  1. The two most important concepts are: Labeling (files, process, ports, etc.) and Type enforcement (which isolates processes from each other based on types).
  1. The correct Label format is user:role:type:level (optional).
  1. The purpose of Multi-Level Security (MLS) enforcement is to control processes (domains) based on the security level of the data they will be using. For example, a secret process cannot read top-secret data.
  1. Multi-Category Security (MCS) enforcement protects similar processes from each other (like virtual machines, OpenShift gears, SELinux sandboxes, containers, etc.).
  1. Kernel parameters for changing SELinux modes at boot:
    • autorelabel=1 → forces the system to relabel
    • selinux=0 → kernel doesn't load any part of the SELinux infrastructure
    • enforcing=0 → boot in permissive mode
  1. If you need to relabel the entire system:
    # touch /.autorelabel
    #reboot

    If the system labeling contains a large amount of errors, you might need to boot in permissive mode in order for the autorelabel to succeed.
  1. To check if SELinux is enabled: # getenforce
  1. To temporarily enable/disable SELinux: # setenforce [1|0]
  1. SELinux status tool: # sestatus
  1. Configuration file: /etc/selinux/config
  1. How does SELinux work? Here's an example of labeling for an Apache Web Server:
    • Binary: /usr/sbin/httpdhttpd_exec_t
    • Configuration directory: /etc/httpdhttpd_config_t
    • Logfile directory: /var/log/httpdhttpd_log_t
    • Content directory: /var/www/htmlhttpd_sys_content_t
    • Startup script: /usr/lib/systemd/system/httpd.servicehttpd_unit_file_d
    • Process: /usr/sbin/httpd -DFOREGROUNDhttpd_t
    • Ports: 80/tcp, 443/tcphttpd_t, http_port_t

A process running in the httpd_t context can interact with an object with the httpd_something_t label.

  1. Many commands accept the argument -Z to view, create, and modify context:
    • ls -Z
    • id -Z
    • ps -Z
    • netstat -Z
    • cp -Z
    • mkdir -Z

Contexts are set when files are created based on their parent directory's context (with a few exceptions). RPMs can set contexts as part of installation.

  1. There are four key causes of SELinux errors, which are further explained in items 15-21 below:
    • Labeling problems
    • Something SELinux needs to know
    • A bug in an SELinux policy/app
    • Your information may be compromised
  1. Labeling problem: If your files in /srv/myweb are not labeled correctly, access might be denied. Here are some ways to fix this:
    • If you know the label:
      # semanage fcontext -a -t httpd_sys_content_t '/srv/myweb(/.*)?'
    • If you know the file with the equivalent labeling:
      # semanage fcontext -a -e /srv/myweb /var/www
    • Restore the context (for both cases):
      # restorecon -vR /srv/myweb
  1. Labeling problem: If you move a file instead of copying it, the file keeps its original context. To fix these issues:
    • Change the context command with the label:
      # chcon -t httpd_system_content_t /var/www/html/index.html
    • Change the context command with the reference label:
      # chcon --reference /var/www/html/ /var/www/html/index.html
    • Restore the context (for both cases): # restorecon -vR /var/www/html/
  1. If SELinux needs to know HTTPD listens on port 8585, tell SELinux:
    # semanage port -a -t http_port_t -p tcp 8585
  1. SELinux needs to know booleans allow parts of SELinux policy to be changed at runtime without any knowledge of SELinux policy writing. For example, if you want httpd to send email, enter: # setsebool -P httpd_can_sendmail 1
  1. SELinux needs to know booleans are just off/on settings for SELinux:
    • To see all booleans: # getsebool -a
    • To see the description of each one: # semanage boolean -l
    • To set a boolean execute: # setsebool [_boolean_] [1|0]
    • To configure it permanently, add -P. For example:
      # setsebool httpd_enable_ftp_server 1 -P
  1. SELinux policies/apps can have bugs, including:
    • Unusual code paths
    • Configurations
    • Redirection of stdout
    • Leaked file descriptors
    • Executable memory
    • Badly built libraries
    Open a ticket (do not file a Bugzilla report; there are no SLAs with Bugzilla).
  1. Your information may be compromised if you have confined domains trying to:
    • Load kernel modules
    • Turn off the enforcing mode of SELinux
    • Write to etc_t/shadow_t
    • Modify iptables rules
  1. SELinux tools for the development of policy modules:
    # yum -y install setroubleshoot setroubleshoot-server
    Reboot or restart auditd after you install.
  1. Use journalctl for listing all logs related to setroubleshoot:
    # journalctl -t setroubleshoot --since=14:20
  1. Use journalctl for listing all logs related to a particular SELinux label. For example:
    # journalctl _SELINUX_CONTEXT=system_u:system_r:policykit_t:s0
  1. Use setroubleshoot log when an SELinux error occurs and suggest some possible solutions. For example, from journalctl:
    Jun 14 19:41:07 web1 setroubleshoot: SELinux is preventing httpd from getattr access on the file /var/www/html/index.html. For complete message run: sealert -l 12fd8b04-0119-4077-a710-2d0e0ee5755e

    # sealert -l 12fd8b04-0119-4077-a710-2d0e0ee5755e
    SELinux is preventing httpd from getattr access on the file /var/www/html/index.html.

    ***** Plugin restorecon (99.5 confidence) suggests ************************

    If you want to fix the label,
    /var/www/html/index.html default label should be httpd_syscontent_t.
    Then you can restorecon.
    Do
    # /sbin/restorecon -v /var/www/html/index.html
  1. Logging: SELinux records information all over the place:
    • /var/log/messages
    • /var/log/audit/audit.log
    • /var/lib/setroubleshoot/setroubleshoot_database.xml
  1. Logging: Looking for SELinux errors in the audit log:
    # ausearch -m AVC,USER_AVC,SELINUX_ERR -ts today
  1. To search for SELinux Access Vector Cache (AVC) messages for a particular service:
    # ausearch -m avc -c httpd
  1. The audit2allow utility gathers information from logs of denied operations and then generates SELinux policy-allow rules. For example:
    • To produce a human-readable description of why the access was denied: # audit2allow -w -a
    • To view the type enforcement rule that allows the denied access: # audit2allow -a
    • To create a custom module: # audit2allow -a -M mypolicy
      The -M option creates a type enforcement file (.te) with the name specified and compiles the rule into a policy package (.pp): mypolicy.pp mypolicy.te
    • To install the custom module: # semodule -i mypolicy.pp
  1. To configure a single process (domain) to run permissive: # semanage permissive -a httpd_t
  1. If you no longer want a domain to be permissive: # semanage permissive -d httpd_t
  1. To disable all permissive domains: # semodule -d permissivedomains
  1. Enabling SELinux MLS policy: # yum install selinux-policy-mls
    In /etc/selinux/config:
    SELINUX=permissive
    SELINUXTYPE=mls
    Make sure SELinux is running in permissive mode: # setenforce 0
    Use the fixfiles script to ensure that files are relabeled upon the next reboot:
    # fixfiles -F onboot # reboot
  1. Create a user with a specific MLS range: # useradd -Z staff_u john
    Using the useradd command, map the new user to an existing SELinux user (in this case, staff_u).
  1. To view the mapping between SELinux and Linux users: # semanage login -l
  1. Define a specific range for a user: # semanage login --modify --range s2:c100 john
  1. To correct the label on the user's home directory (if needed): # chcon -R -l s2:c100 /home/john
  1. To list the current categories: # chcat -L
  1. To modify the categories or to start creating your own, modify the file as follows:
    /etc/selinux/_<selinuxtype>_/setrans.conf
  1. To run a command or script in a specific file, role, and user context:
    # runcon -t initrc_t -r system_r -u user_u yourcommandhere
    • -t is the file context
    • -r is the role context
    • -u is the user context
  1. Containers running with SELinux disabled:
    • With Podman: # podman run --security-opt label=disable
    • With Docker: # docker run --security-opt label=disable
  1. If you need to give a container full access to the system:
    • With Podman: # podman run --privileged
    • With Docker: # docker run --privileged

And with this, you already know the answer. So please: Don't panic, and turn on SELinux.

Sources:

About the author

Alex Callejas - Alex Callejas is a Technical Account Manager of Red Hat in the LATAM region, based in Mexico City. With more than 10 years of experience as SysAdmin, he has strong expertise on Infrastructure Hardening. Enthusiast of the Open Source, supports the community sharing his knowledge in different events of public access and universities. Geek by nature, Linux by choice, Fedora of course.