webadm_selinux(8)

📦
version 20250627+git412.dbf877ab7 · 4 versions
, in opensuse-leap 16.0

💖 NAME 💖

Okay bestie, this is the webadm_selinux(8) page — the webadm SELinux Policy documentation — and we’re getting into it. ✨

webadm_r — Web administrator role. — Security Enhanced Linux Policy. 👑

🌸 DESCRIPTION 🌸

SELinux supports Roles Based Access Control (RBAC). Some Linux roles are login roles, while other roles need to be transitioned into. 🔐

Note: Examples in this man page will use the staff_u SELinux user.

Non login roles are usually used for administrative tasks. For example, tasks that require root privileges. Roles control which types a user can run processes with. Roles often have default types assigned to them.

The default type for the webadm_r role is webadm_t. 💅

The newrole program is used to transition directly to this role:

newrole -r webadm_r -t webadm_t

sudo is the preferred method to do transition from one role to another. You setup sudo to transition to webadm_r by adding a similar line to the /etc/sudoers file:

USERNAME ALL=(ALL) ROLE=webadm_r TYPE=webadm_t COMMAND

sudo will run COMMAND as staff_u:webadm_r:webadm_t:LEVEL. 🫶

When using a non login role, you need to setup SELinux so that your SELinux user can reach webadm_r role.

Execute the following to see all of the assigned SELinux roles:

semanage user -l

You need to add webadm_r to the staff_u user. You could setup the staff_u user to be able to use the webadm_r role with a command like:

$ semanage user -m -R 'staff_r system_r webadm_r' staff_u

✨ BOOLEANS ✨

SELinux policy is customizable based on least access required. The webadm policy is extremely flexible and has several booleans that allow you to manipulate the policy and run webadm with the tightest access possible. 🎀

  • webadm_manage_user_files — If you want to determine whether webadm can manage generic user files, you must turn on the webadm_manage_user_files boolean. Disabled by default.
setsebool -P webadm_manage_user_files 1
  • webadm_read_user_files — If you want to determine whether webadm can read generic user files, you must turn on the webadm_read_user_files boolean. Disabled by default.
setsebool -P webadm_read_user_files 1
  • deny_execmem — If you want to deny user domains applications to map a memory region as both executable and writable, you must turn on the deny_execmem boolean.
⚠️ This is dangerous, and the executable should be reported in bugzilla. Disabled by default.
setsebool -P deny_execmem 1
  • deny_ptrace — If you want to deny any process from ptracing or debugging any other processes, you must turn on the deny_ptrace boolean. Disabled by default.
setsebool -P deny_ptrace 1
  • fips_mode — If you want to allow all domains to execute in fips_mode, you must turn on the fips_mode boolean. Enabled by default.
setsebool -P fips_mode 1
  • selinuxuser_execstack — If you want to allow unconfined executables to make their stack executable, you must turn on the selinuxuser_execstack boolean.
⚠️ This should never, ever be necessary. Probably indicates a badly coded executable, but could indicate an attack. This executable should be reported in bugzilla. Disabled by default.
setsebool -P selinuxuser_execstack 1

🎀 MANAGED FILES 🎀

The SELinux process type webadm_t can manage files labeled with the following file types. The paths listed are the default paths for these file types. Note the processes UID still need to have DAC permissions. 🗂️

httpd_config_t

/etc/httpd(/.*)?
/etc/nginx(/.*)?
/etc/apache(2)?(/.*)?
/etc/cherokee(/.*)?
/etc/lighttpd(/.*)?
/etc/apache-ssl(2)?(/.*)?
/var/lib/openshift/.httpd.d(/.*)?
/etc/opt/rh/rh-nginx18/nginx(/.*)?
/var/lib/stickshift/.httpd.d(/.*)?
/etc/vhosts
/etc/thttpd.conf

httpd_lock_t

httpd_log_t

/srv/([^/]*/)?www/logs(/.*)?
/var/www(/.*)?/logs(/.*)?
/var/log/glpi(/.*)?
/var/log/cacti(/.*)?
/var/log/httpd(/.*)?
/var/log/nginx(/.*)?
/var/log/apache(2)?(/.*)?
/var/log/php-fpm.log
/var/log/horizon(/.*)?
/var/log/php-fpm(/.*)?
/var/log/cherokee(/.*)?
/var/log/lighttpd(/.*)?
/var/log/suphp.log.*
/var/log/thttpd.log.*
/var/log/apache-ssl(2)?(/.*)?
/var/log/cgiwrap.log.*
/var/www/stickshift/[^/]*/log(/.*)?
/var/log/graphite-web(/.*)?
/var/www/miq/vmdb/log(/.*)?
/var/log/roundcubemail(/.*)?
/var/log/php_errors.log.*
/var/log/dirsrv/admin-serv(/.*)?
/var/opt/rh/rh-nginx18/log(/.*)?
/var/lib/openshift/.log/httpd(/.*)?
/var/www/openshift/console/log(/.*)?
/var/www/openshift/broker/httpd/logs(/.*)?
/var/www/openshift/console/httpd/logs(/.*)?

httpd_modules_t

/usr/lib/httpd(/.*)?
/usr/lib/apache(/.*)?
/usr/lib/cherokee(/.*)?
/usr/lib/lighttpd(/.*)?
/usr/lib/apache2/modules(/.*)?

httpd_php_tmp_t

httpd_script_exec_type

httpd_suexec_tmp_t

httpd_tmp_t

/run/user/apache(/.*)?
/var/www/openshift/console/tmp(/.*)?

httpd_var_run_t

/run/mod_.*
/run/wsgi.*
/run/httpd.*
/run/nginx.*
/run/apache.*
/run/php-fpm(/.*)?
/run/fcgiwrap(/.*)?
/run/lighttpd(/.*)?
/var/lib/php/session(/.*)?
/run/dirsrv/admin-serv.*
/var/lib/php/wsdlcache(/.*)?
/var/opt/rh/rh-nginx18/run/nginx(/.*)?
/var/www/openshift/broker/httpd/run(/.*)?
/var/www/openshift/console/httpd/run(/.*)?
/opt/dirsrv/var/run/dirsrv/dsgw/cookies(/.*)?
/run/thttpd.pid
/run/gcache_port
/run/cherokee.pid

httpdcontent

systemd_passwd_var_run_t

/run/systemd/ask-password(/.*)?
/run/systemd/ask-password-block(/.*)?

user_home_t

/home/[^/]+/.+

webadm_tmp_t

💅 COMMANDS 💅

  • semanage fcontext — can also be used to manipulate default file context mappings.
  • semanage permissive — can also be used to manipulate whether or not a process type is permissive.
  • semanage module — can also be used to enable/disable/install/remove policy modules.
  • semanage boolean — can also be used to manipulate the booleans.
  • system-config-selinux — is a GUI tool available to customize SELinux policy settings.

🦋 AUTHOR 🦋

This manual page was auto-generated using sepolicy manpage .

🌈 SEE ALSO 🌈

Okay bye bestie — footer credits are mgrepl@redhat.com, manual tag webadm, and page webadm_selinux(8). No date is printed on this page, so I’m not inventing one, periodt. 💖

📦 where this page comes from