1nova_api_selinux(8) SELinux Policy nova_api nova_api_selinux(8)
2
6 nova_api_selinux - Security Enhanced Linux Policy for the nova_api pro‐
7 cesses
8
10 Security-Enhanced Linux secures the nova_api processes via flexible
11 mandatory access control.
12 The nova_api processes execute with the nova_api_t SELinux type. You
14 can check if you have these processes running by executing the ps com‐
15 mand with the -Z qualifier.
16 For example:
18 ps -eZ | grep nova_api_t
20
24 The nova_api_t SELinux type can be entered via the file_type,
25 nova_api_exec_t, unlabeled_t, proc_type, filesystem_type,
26 mtrr_device_t, sysctl_type file types.
27 The default entrypoint paths for the nova_api_t domain are the follow‐
29 ing:
30 all files on the system, /usr/bin/nova-api, /usr//bin/nova-api-meta‐
32 data, /dev/cpu/mtrr
33
35 SELinux defines process types (domains) for each process running on the
36 system
37 You can see the context of a process using the -Z option to ps
39 Policy governs the access confined processes have to files. SELinux
41 nova_api policy is very flexible allowing users to setup their nova_api
42 processes in as secure a method as possible.
43 The following process types are defined for nova_api:
45 nova_api_t
47 Note: semanage permissive -a nova_api_t can be used to make the process
49 type nova_api_t permissive. SELinux does not deny access to permissive
50 process types, but the AVC (SELinux denials) messages are still gener‐
51 ated.
52
55 SELinux policy is customizable based on least access required.
56 nova_api policy is extremely flexible and has several booleans that
57 allow you to manipulate the policy and run nova_api with the tightest
58 access possible.
59 If you want to allow all daemons to write corefiles to /, you must turn
63 on the allow_daemons_dump_core boolean. Disabled by default.
64 setsebool -P allow_daemons_dump_core 1
66 If you want to allow all daemons to use tcp wrappers, you must turn on
70 the allow_daemons_use_tcp_wrapper boolean. Disabled by default.
71 setsebool -P allow_daemons_use_tcp_wrapper 1
73 If you want to allow all daemons the ability to read/write terminals,
77 you must turn on the allow_daemons_use_tty boolean. Disabled by
78 default.
79 setsebool -P allow_daemons_use_tty 1
81 If you want to allow all domains to use other domains file descriptors,
85 you must turn on the allow_domain_fd_use boolean. Enabled by default.
86 setsebool -P allow_domain_fd_use 1
88 If you want to allow unconfined executables to make their heap memory
92 executable. Doing this is a really bad idea. Probably indicates a
93 badly coded executable, but could indicate an attack. This executable
94 should be reported in bugzilla, you must turn on the allow_execheap
95 boolean. Disabled by default.
96 setsebool -P allow_execheap 1
98 If you want to allow unconfined executables to map a memory region as
102 both executable and writable, this is dangerous and the executable
103 should be reported in bugzilla), you must turn on the allow_execmem
104 boolean. Enabled by default.
105 setsebool -P allow_execmem 1
107 If you want to allow all unconfined executables to use libraries
111 requiring text relocation that are not labeled textrel_shlib_t), you
112 must turn on the allow_execmod boolean. Enabled by default.
113 setsebool -P allow_execmod 1
115 If you want to allow unconfined executables to make their stack exe‐
119 cutable. This should never, ever be necessary. Probably indicates a
120 badly coded executable, but could indicate an attack. This executable
121 should be reported in bugzilla), you must turn on the allow_execstack
122 boolean. Enabled by default.
123 setsebool -P allow_execstack 1
125 If you want to allow sysadm to debug or ptrace all processes, you must
129 turn on the allow_ptrace boolean. Disabled by default.
130 setsebool -P allow_ptrace 1
132 If you want to enable cluster mode for daemons, you must turn on the
136 daemons_enable_cluster_mode boolean. Disabled by default.
137 setsebool -P daemons_enable_cluster_mode 1
139 If you want to allow all domains to have the kernel load modules, you
143 must turn on the domain_kernel_load_modules boolean. Disabled by
144 default.
145 setsebool -P domain_kernel_load_modules 1
147 If you want to allow all domains to execute in fips_mode, you must turn
151 on the fips_mode boolean. Enabled by default.
152 setsebool -P fips_mode 1
154 If you want to enable reading of urandom for all domains, you must turn
158 on the global_ssp boolean. Disabled by default.
159 setsebool -P global_ssp 1
161 If you want to enable support for upstart as the init program, you must
165 turn on the init_upstart boolean. Enabled by default.
166 setsebool -P init_upstart 1
168 If you want to allow certain domains to map low memory in the kernel,
172 you must turn on the mmap_low_allowed boolean. Disabled by default.
173 setsebool -P mmap_low_allowed 1
175 If you want to boolean to determine whether the system permits loading
179 policy, setting enforcing mode, and changing boolean values. Set this
180 to true and you have to reboot to set it back, you must turn on the
181 secure_mode_policyload boolean. Disabled by default.
182 setsebool -P secure_mode_policyload 1
184 If you want to support X userspace object manager, you must turn on the
188 xserver_object_manager boolean. Disabled by default.
189 setsebool -P xserver_object_manager 1
191
195 The SELinux process type nova_api_t can manage files labeled with the
196 following file types. The paths listed are the default paths for these
197 file types. Note the processes UID still need to have DAC permissions.
198 file_type
200 all files on the system
202
205 SELinux requires files to have an extended attribute to define the file
206 type.
207 You can see the context of a file using the -Z option to ls
209 Policy governs the access confined processes have to these files.
211 SELinux nova_api policy is very flexible allowing users to setup their
212 nova_api processes in as secure a method as possible.
213 STANDARD FILE CONTEXT
215 SELinux defines the file context types for the nova_api, if you wanted
217 to store files with these types in a diffent paths, you need to execute
218 the semanage command to sepecify alternate labeling and then use
219 restorecon to put the labels on disk.
220 semanage fcontext -a -t nova_api_tmp_t '/srv/mynova_api_content(/.*)?'
222 restorecon -R -v /srv/mynova_api_content
223 Note: SELinux often uses regular expressions to specify labels that
225 match multiple files.
226 The following file types are defined for nova_api:
228 nova_api_exec_t
232 - Set files with the nova_api_exec_t type, if you want to transition an
234 executable to the nova_api_t domain.
235 Paths:
238 /usr/bin/nova-api, /usr//bin/nova-api-metadata
239 nova_api_initrc_exec_t
242 - Set files with the nova_api_initrc_exec_t type, if you want to tran‐
244 sition an executable to the nova_api_initrc_t domain.
245 Paths:
248 /etc/rc.d/etc/init.d/openstack-nova-api,
249 /etc/rc.d/etc/init.d/openstack-nova-metadata-api
250 nova_api_tmp_t
253 - Set files with the nova_api_tmp_t type, if you want to store nova api
255 temporary files in the /tmp directories.
256 Note: File context can be temporarily modified with the chcon command.
260 If you want to permanently change the file context you need to use the
261 semanage fcontext command. This will modify the SELinux labeling data‐
262 base. You will need to use restorecon to apply the labels.
263
266 semanage fcontext can also be used to manipulate default file context
267 mappings.
268 semanage permissive can also be used to manipulate whether or not a
270 process type is permissive.
271 semanage module can also be used to enable/disable/install/remove pol‐
273 icy modules.
274 semanage boolean can also be used to manipulate the booleans
276 system-config-selinux is a GUI tool available to customize SELinux pol‐
279 icy settings.
280
283 This manual page was auto-generated using sepolicy manpage .
284
287 selinux(8), nova_api(8), semanage(8), restorecon(8), chcon(1) , setse‐
288 bool(8)
289nova_api 15-06-03 nova_api_selinux(8)