neutron_selinux(8)

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

💖 neutron_selinux — the manual page, but make it make sense

okay bestie, so this is neutron_selinux(8), the neutron_selinux manual page. yes the name is the same as the file, that's just how manpages do. anyway, it's all about how SELinux (the bouncer of your Linux box) handles the neutron processes. let's get into it 🫶

✨ NAME ✨

neutron_selinux — the Security Enhanced Linux Policy for the neutron processes. that's it, that's the whole name section. iconic brevity 💅

🌸 DESCRIPTION 🌸

Security-Enhanced Linux keeps the neutron processes on lock via flexible mandatory access control. like, it's not vibes-based security, it's policy-based security 🔥

The neutron processes run with the neutron_t SELinux type. wanna check if you've got these processes running? just run the ps command with the -Z qualifier, no cap.

for example:

ps -eZ | grep neutron_t

see? easy. iykyk 💖

🦋 ENTRYPOINTS 🦋

so the neutron_t SELinux type can be entered via the neutron_exec_t file type. that's the doorway ✨

The default entrypoint paths for the neutron_t domain are literally these:

/usr/bin/neutron-server, /usr/bin/quantum-server, /usr/bin/neutron-
l3-agent, /usr/bin/neutron-rootwrap, /usr/bin/quantum-l3-agent,
/usr/bin/neutron-ryu-agent, /usr/bin/quantum-ryu-agent,
/usr/bin/neutron-dhcp-agent, /usr/bin/quantum-dhcp-agent,
/usr/bin/neutron-lbaas-agent, /usr/bin/neutron-ovs-cleanup,
/usr/bin/quantum-ovs-cleanup, /usr/bin/neutron-netns-cleanup,
/usr/bin/neutron-metadata-agent, /usr/bin/neutron-linuxbridge-agent,
/usr/bin/neutron-ns-metadata-proxy, /usr/bin/neutron-openvswitch-agent,
/usr/bin/quantum-linuxbridge-agent, /usr/bin/quantum-openvswitch-agent

(all those neutron-/quantum- line breaks are just the manpage wrapping, the real paths are whole 💀)

👑 PROCESS TYPES 👑

SELinux defines process types (domains) for each process running on the system. one process, one little domain, very main character energy 👑

you can see the context of a process using the -Z option to ps 🫶

Policy governs the access confined processes have to files. the SELinux neutron policy is very flexible, letting users set up their neutron processes in as secure a method as possible. tightest access possible, periodt.

The following process types are defined for neutron:

neutron_t
Note: semanage permissive -a neutron_t can be used to make the process type neutron_t permissive. SELinux does not deny access to permissive process types, but the AVC (SELinux denials) messages are still generated. so like, it stops blocking but it's still watching 🙈

🎀 BOOLEANS 🎀

SELinux policy is customizable based on least access required. the neutron policy is extremely flexible and has several booleans that let you manipulate the policy and run neutron with the tightest access possible. toggles, bestie. toggles 💅

  • neutron_can_network — turn this on if you want to determine whether neutron can connect to all TCP ports. disabled by default.
setsebool -P neutron_can_network 1
  • daemons_dontaudit_scheduling — turn this on if you want to dontaudit all daemons scheduling requests (setsched, sys_nice). enabled by default.
setsebool -P daemons_dontaudit_scheduling 1
  • fips_mode — turn this on if you want to allow all domains to execute in fips_mode. enabled by default.
setsebool -P fips_mode 1
  • kerberos_enabled — turn this on if you want to allow confined applications to run with kerberos. enabled by default.
setsebool -P kerberos_enabled 1
  • nis_enabled — turn this on if you want to allow the system to run with NIS. disabled by default.
setsebool -P nis_enabled 1

🌈 PORT TYPES 🌈

SELinux defines port types to represent TCP and UDP ports, because ports need labels too, obvi.

you can see the types associated with a port by running:

semanage port -l

Policy governs the access confined processes have to these ports. the SELinux neutron policy is very flexible, letting users set up their neutron processes in as secure a method as possible ✨

The following port types are defined for neutron:

neutron_port_t

Default Defined Ports:

tcp 8775,9696,9697

three little ports, living their best life 🍓

💜 MANAGED FILES 💜

The SELinux process type neutron_t can manage files labeled with the following file types. the paths listed are the default paths for these file types. note: the process's UID still needs to have DAC permissions — SELinux said yes doesn't mean the UID said yes, ok? 😭

cluster_conf_t

/etc/cluster(/.*)?

cluster_var_lib_t

/var/lib/pcsd(/.*)?
/var/lib/cluster(/.*)?
/var/lib/openais(/.*)?
/var/lib/pengine(/.*)?
/var/lib/corosync(/.*)?
/usr/lib/heartbeat(/.*)?
/var/lib/heartbeat(/.*)?
/var/lib/pacemaker(/.*)?

cluster_var_run_t

/run/crm(/.*)?
/run/cman_.*
/run/rsctmp(/.*)?
/run/aisexec.*
/run/heartbeat(/.*)?
/run/pcsd-ruby.socket
/run/corosync-qnetd(/.*)?
/run/corosync-qdevice(/.*)?
/run/pcsd.socket
/run/corosync.pid
/run/cpglockd.pid
/run/rgmanager.pid
/run/cluster/rgmanager.sk

faillog_t

/var/log/btmp.*
/run/faillock(/.*)?
/var/log/faillog.*
/var/log/tallylog.*

ifconfig_var_run_t

/run/netns

initrc_var_run_t

/run/sysconfig(/.*)?
/run/utmp
/run/keymap
/run/numlock-on
/run/setleds-on
/run/runlevel.dir
/run/setmixer_flag
/run/bootsplashctl

krb5_host_rcache_t

/var/tmp/krb5_0.rcache2
/var/cache/krb5rcache(/.*)?
/var/tmp/nfs_0
/var/tmp/DNS_25
/var/tmp/host_0
/var/tmp/imap_0
/var/tmp/HTTP_23
/var/tmp/HTTP_48
/var/tmp/ldap_55
/var/tmp/ldap_487
/var/tmp/ldapmap1_0

krb5_keytab_t

/var/kerberos/krb5(/.*)?
/etc/krb5.keytab
/etc/krb5kdc/kadm5.keytab
/var/kerberos/krb5kdc/kadm5.keytab

lastlog_t

/var/log/lastlog.*
/var/lib/lastlog(/.*)?

neutron_tmp_t

(no default paths listed, it's just vibes 💀)

neutron_var_lib_t

/var/lib/neutron(/.*)?
/var/lib/quantum(/.*)?

neutron_var_run_t

/run/neutron(/.*)?
/run/quantum(/.*)?

root_t

/sysroot/.aleph-version.json
/sysroot/ostree/deploy/.*-atomic/deploy(/.*)?
/
/initrd
/var/lib/ntp

security_t

/selinux

wtmpdb_journal_t

/var/lib/wtmpdb/wtmp.db-journal

🧚 FILE CONTEXTS 🧚

SELinux requires files to have an extended attribute to define the file type. yes, files have labels now, we love a labeled file ✨

you can see the context of a file using the -Z option to ls.

Policy governs the access confined processes have to these files. the SELinux neutron policy is very flexible, letting users set up their neutron processes in as secure a method as possible.

📁 STANDARD FILE CONTEXT 📁

SELinux defines the file context types for neutron. if you wanted to store files with these types in different paths, you need to run the semanage command to specify alternate labeling, and then use restorecon to put the labels on disk. two-step process, bestie, don't skip step two 🫶

semanage fcontext -a -t neutron_exec_t '/srv/neutron/content(/.*)?'
restorecon -R -v /srv/myneutron_content
Note: SELinux often uses regular expressions to specify labels that match multiple files. regex girlies rise 🙈

The following file types are defined for neutron:

neutron_exec_t

  • Set files with the neutron_exec_t type if you want to transition an executable to the neutron_t domain.

Paths:

/usr/bin/neutron-server, /usr/bin/quantum-server, /usr/bin/neutron-
l3-agent, /usr/bin/neutron-rootwrap, /usr/bin/quantum-l3-agent,
/usr/bin/neutron-ryu-agent, /usr/bin/quantum-ryu-agent,
/usr/bin/neutron-dhcp-agent, /usr/bin/quantum-dhcp-agent,
/usr/bin/neutron-lbaas-agent, /usr/bin/neutron-ovs-cleanup,
/usr/bin/quantum-ovs-cleanup, /usr/bin/neutron-netns-cleanup,
/usr/bin/neutron-metadata-agent, /usr/bin/neutron-linuxbridge-
agent, /usr/bin/neutron-ns-metadata-proxy, /usr/bin/neutron-
openvswitch-agent, /usr/bin/quantum-linuxbridge-agent,
/usr/bin/quantum-openvswitch-agent

neutron_initrc_exec_t

  • Set files with the neutron_initrc_exec_t type if you want to transition an executable to the neutron_initrc_t domain.

Paths:

/etc/rc.d/init.d/neutron.*, /etc/rc.d/init.d/quantum.*

neutron_log_t

  • Set files with the neutron_log_t type if you want to treat the data as neutron log data, usually stored under the /var/log directory.

Paths:

/var/log/neutron(/.*)?, /var/log/quantum(/.*)?

neutron_tmp_t

  • Set files with the neutron_tmp_t type if you want to store neutron temporary files in the /tmp directories. (no default paths listed here either, that's just how it is 💀)

neutron_unit_file_t

  • Set files with the neutron_unit_file_t type if you want to treat the files as neutron unit content.

Paths:

/usr/lib/systemd/system/neutron.*,
/usr/lib/systemd/system/quantum.*

neutron_var_lib_t

  • Set files with the neutron_var_lib_t type if you want to store the neutron files under the /var/lib directory.

Paths:

/var/lib/neutron(/.*)?, /var/lib/quantum(/.*)?

neutron_var_run_t

  • Set files with the neutron_var_run_t type if you want to store the neutron files under the /run or /var/run directory.

Paths:

/run/neutron(/.*)?, /run/quantum(/.*)?
Note: file context can be temporarily modified with the chcon command. if you want to permanently change the file context you need to use the semanage fcontext command. this modifies the SELinux labeling database. and then you'll need to use restorecon to apply the labels. chcon is giving temporary tattoo, semanage is giving full sleeve 💅

⭐ COMMANDS ⭐

so these are the tools that also exist and can do stuff, keep them in your back pocket:

  • 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 port can also be used to manipulate the port definitions.
  • semanage boolean can also be used to manipulate the booleans.
  • system-config-selinux is a GUI tool available to customize SELinux policy settings. a whole GUI, for the girlies who don't do terminal 🎀

🌟 AUTHOR 🌟

This manual page was auto-generated using sepolicy manpage. (a robot wrote this, i just gave it a personality 💖)

🦄 SEE ALSO 🦄

selinux(8), neutron(8), semanage(8), restorecon(8), chcon(1), sepolicy(8), setsebool(8)

go read those next, bestie, they're literally the whole ecosystem 🌈

okay that's the whole page!! source/version is neutron, dated 26-10-06, and the page itself is neutron_selinux(8) — that's the sign-off, muah 💋 go label some files responsibly, mwah 💜

📦 where this page comes from