1 /* selinux.c SELinux security checks for D-BUS
3 * Author: Matthew Rickard <mjricka@epoch.ncsc.mil>
5 * Licensed under the Academic Free License version 2.1
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 2 of the License, or
10 * (at your option) any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
22 #include <dbus/dbus-internals.h>
23 #include <dbus/dbus-string.h>
28 #include "config-parser.h"
34 #include <selinux/selinux.h>
35 #include <selinux/avc.h>
36 #include <selinux/av_permissions.h>
37 #include <selinux/flask.h>
40 #endif /* HAVE_SELINUX */
42 #define BUS_SID_FROM_SELINUX(sid) ((BusSELinuxID*) (sid))
43 #define SELINUX_SID_FROM_BUS(sid) ((security_id_t) (sid))
46 /* Store the value telling us if SELinux is enabled in the kernel. */
47 static dbus_bool_t selinux_enabled = FALSE;
49 /* Store an avc_entry_ref to speed AVC decisions. */
50 static struct avc_entry_ref aeref;
52 /* Store the SID of the bus itself to use as the default. */
53 static security_id_t bus_sid = SECSID_WILD;
55 /* Thread to listen for SELinux status changes via netlink. */
56 static pthread_t avc_notify_thread;
58 /* Prototypes for AVC callback functions. */
59 static void log_callback (const char *fmt, ...);
60 static void *avc_create_thread (void (*run) (void));
61 static void avc_stop_thread (void *thread);
62 static void *avc_alloc_lock (void);
63 static void avc_get_lock (void *lock);
64 static void avc_release_lock (void *lock);
65 static void avc_free_lock (void *lock);
67 /* AVC callback structures for use in avc_init. */
68 static const struct avc_memory_callback mem_cb =
70 .func_malloc = dbus_malloc,
71 .func_free = dbus_free
73 static const struct avc_log_callback log_cb =
75 .func_log = log_callback,
78 static const struct avc_thread_callback thread_cb =
80 .func_create_thread = avc_create_thread,
81 .func_stop_thread = avc_stop_thread
83 static const struct avc_lock_callback lock_cb =
85 .func_alloc_lock = avc_alloc_lock,
86 .func_get_lock = avc_get_lock,
87 .func_release_lock = avc_release_lock,
88 .func_free_lock = avc_free_lock
90 #endif /* HAVE_SELINUX */
93 * Log callback to log denial messages from the AVC.
94 * This is used in avc_init. Logs to both standard
97 * @param fmt the format string
98 * @param variable argument list
102 log_callback (const char *fmt, ...)
106 vsyslog (LOG_INFO, fmt, ap);
111 * On a policy reload we need to reparse the SELinux configuration file, since
112 * this could have changed. Send a SIGHUP to reload all configs.
115 policy_reload_callback (u_int32_t event, security_id_t ssid,
116 security_id_t tsid, security_class_t tclass,
117 access_vector_t perms, access_vector_t *out_retained)
119 if (event == AVC_CALLBACK_RESET)
120 return raise (SIGHUP);
126 * Create thread to notify the AVC of enforcing and policy reload
127 * changes via netlink.
129 * @param run the thread run function
130 * @return pointer to the thread
133 avc_create_thread (void (*run) (void))
137 rc = pthread_create (&avc_notify_thread, NULL, (void *(*) (void *)) run, NULL);
140 _dbus_warn ("Failed to start AVC thread: %s\n", _dbus_strerror (rc));
143 return &avc_notify_thread;
146 /* Stop AVC netlink thread. */
148 avc_stop_thread (void *thread)
150 pthread_cancel (*(pthread_t *) thread);
153 /* Allocate a new AVC lock. */
155 avc_alloc_lock (void)
157 pthread_mutex_t *avc_mutex;
159 avc_mutex = dbus_new (pthread_mutex_t, 1);
160 if (avc_mutex == NULL)
162 _dbus_warn ("Could not create mutex: %s\n", _dbus_strerror (errno));
165 pthread_mutex_init (avc_mutex, NULL);
170 /* Acquire an AVC lock. */
172 avc_get_lock (void *lock)
174 pthread_mutex_lock (lock);
177 /* Release an AVC lock. */
179 avc_release_lock (void *lock)
181 pthread_mutex_unlock (lock);
184 /* Free an AVC lock. */
186 avc_free_lock (void *lock)
188 pthread_mutex_destroy (lock);
191 #endif /* HAVE_SELINUX */
194 * Return whether or not SELinux is enabled; must be
195 * called after bus_selinux_init.
198 bus_selinux_enabled (void)
201 return selinux_enabled;
204 #endif /* HAVE_SELINUX */
208 * Do early initialization; determine whether SELinux is enabled.
211 bus_selinux_pre_init (void)
215 _dbus_assert (bus_sid == SECSID_WILD);
217 /* Determine if we are running an SELinux kernel. */
218 r = is_selinux_enabled ();
221 _dbus_warn ("Could not tell if SELinux is enabled: %s\n",
222 _dbus_strerror (errno));
226 selinux_enabled = r != 0;
234 * Initialize the user space access vector cache (AVC) for D-BUS and set up
238 bus_selinux_full_init (void)
243 _dbus_assert (bus_sid == SECSID_WILD);
245 if (!selinux_enabled)
247 _dbus_verbose ("SELinux not enabled in this kernel.\n");
251 _dbus_verbose ("SELinux is enabled in this kernel.\n");
253 avc_entry_ref_init (&aeref);
254 if (avc_init ("avc", &mem_cb, &log_cb, &thread_cb, &lock_cb) < 0)
256 _dbus_warn ("Failed to start Access Vector Cache (AVC).\n");
261 openlog ("dbus", LOG_PERROR, LOG_USER);
262 _dbus_verbose ("Access Vector Cache (AVC) started.\n");
265 if (avc_add_callback (policy_reload_callback, AVC_CALLBACK_RESET,
266 NULL, NULL, 0, 0) < 0)
268 _dbus_warn ("Failed to add policy reload callback: %s\n",
269 _dbus_strerror (errno));
275 bus_sid = SECSID_WILD;
277 if (getcon (&bus_context) < 0)
279 _dbus_verbose ("Error getting context of bus: %s\n",
280 _dbus_strerror (errno));
284 if (avc_context_to_sid (bus_context, &bus_sid) < 0)
286 _dbus_verbose ("Error getting SID from bus context: %s\n",
287 _dbus_strerror (errno));
288 freecon (bus_context);
292 freecon (bus_context);
297 #endif /* HAVE_SELINUX */
301 * Decrement SID reference count.
303 * @param sid the SID to decrement
306 bus_selinux_id_unref (BusSELinuxID *sid)
309 if (!selinux_enabled)
312 _dbus_assert (sid != NULL);
314 sidput (SELINUX_SID_FROM_BUS (sid));
315 #endif /* HAVE_SELINUX */
319 bus_selinux_id_ref (BusSELinuxID *sid)
322 if (!selinux_enabled)
325 _dbus_assert (sid != NULL);
327 sidget (SELINUX_SID_FROM_BUS (sid));
328 #endif /* HAVE_SELINUX */
332 * Determine if the SELinux security policy allows the given sender
333 * security context to go to the given recipient security context.
334 * This function determines if the requested permissions are to be
335 * granted from the connection to the message bus or to another
336 * optionally supplied security identifier (e.g. for a service
337 * context). Currently these permissions are either send_msg or
338 * acquire_svc in the dbus class.
340 * @param sender_sid source security context
341 * @param override_sid is the target security context. If SECSID_WILD this will
342 * use the context of the bus itself (e.g. the default).
343 * @param target_class is the target security class.
344 * @param requested is the requested permissions.
345 * @returns #TRUE if security policy allows the send.
349 bus_selinux_check (BusSELinuxID *sender_sid,
350 BusSELinuxID *override_sid,
351 security_class_t target_class,
352 access_vector_t requested)
354 if (!selinux_enabled)
357 /* Make the security check. AVC checks enforcing mode here as well. */
358 if (avc_has_perm (SELINUX_SID_FROM_BUS (sender_sid),
360 SELINUX_SID_FROM_BUS (override_sid) :
361 SELINUX_SID_FROM_BUS (bus_sid),
362 target_class, requested, &aeref, NULL) < 0)
364 _dbus_verbose ("SELinux denying due to security policy.\n");
370 #endif /* HAVE_SELINUX */
373 * Returns true if the given connection can acquire a service,
374 * assuming the given security ID is needed for that service.
376 * @param connection connection that wants to own the service
377 * @param service_sid the SID of the service from the table
378 * @returns #TRUE if acquire is permitted.
381 bus_selinux_allows_acquire_service (DBusConnection *connection,
382 BusSELinuxID *service_sid)
385 BusSELinuxID *connection_sid;
387 if (!selinux_enabled)
390 connection_sid = bus_connection_get_selinux_id (connection);
392 return bus_selinux_check (connection_sid,
398 #endif /* HAVE_SELINUX */
402 * Check if SELinux security controls allow the message to be sent to a
403 * particular connection based on the security context of the sender and
404 * that of the receiver. The destination connection need not be the
405 * addressed recipient, it could be an "eavesdropper"
407 * @param sender the sender of the message.
408 * @param proposed_recipient the connection the message is to be sent to.
409 * @returns whether to allow the send
412 bus_selinux_allows_send (DBusConnection *sender,
413 DBusConnection *proposed_recipient)
416 BusSELinuxID *recipient_sid;
417 BusSELinuxID *sender_sid;
419 if (!selinux_enabled)
422 sender_sid = bus_connection_get_selinux_id (sender);
423 /* A NULL proposed_recipient means the bus itself. */
424 if (proposed_recipient)
425 recipient_sid = bus_connection_get_selinux_id (proposed_recipient);
427 recipient_sid = BUS_SID_FROM_SELINUX (bus_sid);
429 return bus_selinux_check (sender_sid, recipient_sid,
430 SECCLASS_DBUS, DBUS__SEND_MSG);
433 #endif /* HAVE_SELINUX */
437 * Gets the security context of a connection to the bus. It is up to
438 * the caller to freecon() when they are done.
440 * @param connection the connection to get the context of.
441 * @param con the location to store the security context.
442 * @returns #TRUE if context is successfully obtained.
446 bus_connection_read_selinux_context (DBusConnection *connection,
451 if (!selinux_enabled)
454 _dbus_assert (connection != NULL);
456 if (!dbus_connection_get_unix_fd (connection, &fd))
458 _dbus_verbose ("Failed to get file descriptor of socket.\n");
462 if (getpeercon (fd, con) < 0)
464 _dbus_verbose ("Error getting context of socket peer: %s\n",
465 _dbus_strerror (errno));
469 _dbus_verbose ("Successfully read connection context.\n");
472 #endif /* HAVE_SELINUX */
475 * Read the SELinux ID from the connection.
477 * @param connection the connection to read from
478 * @returns the SID if successfully determined, #NULL otherwise.
481 bus_selinux_init_connection_id (DBusConnection *connection,
488 if (!selinux_enabled)
491 if (!bus_connection_read_selinux_context (connection, &con))
493 dbus_set_error (error, DBUS_ERROR_FAILED,
494 "Failed to read an SELinux context from connection");
495 _dbus_verbose ("Error getting peer context.\n");
499 _dbus_verbose ("Converting context to SID to store on connection\n");
501 if (avc_context_to_sid (con, &sid) < 0)
506 dbus_set_error (error, DBUS_ERROR_FAILED,
507 "Error getting SID from context: %s\n",
508 _dbus_strerror (errno));
510 _dbus_warn ("Error getting SID from context: %s\n",
511 _dbus_strerror (errno));
518 return BUS_SID_FROM_SELINUX (sid);
521 #endif /* HAVE_SELINUX */
526 * Function for freeing hash table data. These SIDs
527 * should no longer be referenced.
530 bus_selinux_id_table_free_value (BusSELinuxID *sid)
533 /* NULL sometimes due to how DBusHashTable works */
535 bus_selinux_id_unref (sid);
536 #endif /* HAVE_SELINUX */
540 * Creates a new table mapping service names to security ID.
541 * A security ID is a "compiled" security context, a security
542 * context is just a string.
544 * @returns the new table or #NULL if no memory
547 bus_selinux_id_table_new (void)
549 return _dbus_hash_table_new (DBUS_HASH_STRING,
550 (DBusFreeFunction) dbus_free,
551 (DBusFreeFunction) bus_selinux_id_table_free_value);
555 * Hashes a service name and service context into the service SID
556 * table as a string and a SID.
558 * @param service_name is the name of the service.
559 * @param service_context is the context of the service.
560 * @param service_table is the table to hash them into.
561 * @return #FALSE if not enough memory
564 bus_selinux_id_table_insert (DBusHashTable *service_table,
565 const char *service_name,
566 const char *service_context)
573 if (!selinux_enabled)
579 key = _dbus_strdup (service_name);
583 if (avc_context_to_sid ((char *) service_context, &sid) < 0)
585 _dbus_assert (errno == ENOMEM);
589 if (!_dbus_hash_table_insert_string (service_table,
591 BUS_SID_FROM_SELINUX (sid)))
594 _dbus_verbose ("Parsed \tservice: %s \n\t\tcontext: %s\n",
598 /* These are owned by the hash, so clear them to avoid unref */
605 if (sid != SECSID_WILD)
614 #endif /* HAVE_SELINUX */
619 * Find the security identifier associated with a particular service
620 * name. Return a pointer to this SID, or #NULL/SECSID_WILD if the
621 * service is not found in the hash table. This should be nearly a
622 * constant time operation. If SELinux support is not available,
623 * always return NULL.
625 * @param service_table the hash table to check for service name.
626 * @param service_name the name of the service to look for.
627 * @returns the SELinux ID associated with the service
630 bus_selinux_id_table_lookup (DBusHashTable *service_table,
631 const DBusString *service_name)
636 sid = SECSID_WILD; /* default context */
638 if (!selinux_enabled)
641 _dbus_verbose ("Looking up service SID for %s\n",
642 _dbus_string_get_const_data (service_name));
644 sid = _dbus_hash_table_lookup_string (service_table,
645 _dbus_string_get_const_data (service_name));
647 if (sid == SECSID_WILD)
648 _dbus_verbose ("Service %s not found\n",
649 _dbus_string_get_const_data (service_name));
651 _dbus_verbose ("Service %s found\n",
652 _dbus_string_get_const_data (service_name));
654 return BUS_SID_FROM_SELINUX (sid);
655 #endif /* HAVE_SELINUX */
660 * Copy security ID table mapping from one table into another.
662 * @param dest the table to copy into
663 * @param override the table to copy from
664 * @returns #FALSE if out of memory
668 bus_selinux_id_table_copy_over (DBusHashTable *dest,
669 DBusHashTable *override)
676 _dbus_hash_iter_init (override, &iter);
677 while (_dbus_hash_iter_next (&iter))
679 key = _dbus_hash_iter_get_string_key (&iter);
680 sid = _dbus_hash_iter_get_value (&iter);
682 key_copy = _dbus_strdup (key);
683 if (key_copy == NULL)
686 if (!_dbus_hash_table_insert_string (dest,
690 dbus_free (key_copy);
694 bus_selinux_id_ref (sid);
699 #endif /* HAVE_SELINUX */
702 * Creates the union of the two tables (each table maps a service
703 * name to a security ID). In case of the same service name in
704 * both tables, the security ID from "override" will be used.
706 * @param base the base table
707 * @param override the table that takes precedence in the merge
708 * @returns the new table, or #NULL if out of memory
711 bus_selinux_id_table_union (DBusHashTable *base,
712 DBusHashTable *override)
714 DBusHashTable *combined_table;
716 combined_table = bus_selinux_id_table_new ();
718 if (combined_table == NULL)
722 if (!selinux_enabled)
723 return combined_table;
725 if (!bus_selinux_id_table_copy_over (combined_table, base))
727 _dbus_hash_table_unref (combined_table);
731 if (!bus_selinux_id_table_copy_over (combined_table, override))
733 _dbus_hash_table_unref (combined_table);
736 #endif /* HAVE_SELINUX */
738 return combined_table;
742 * Get the SELinux policy root. This is used to find the D-BUS
743 * specific config file within the policy.
746 bus_selinux_get_policy_root (void)
749 return selinux_policy_root ();
752 #endif /* HAVE_SELINUX */
756 * For debugging: Print out the current hash table of service SIDs.
759 bus_selinux_id_table_print (DBusHashTable *service_table)
761 #ifdef DBUS_ENABLE_VERBOSE_MODE
765 if (!selinux_enabled)
768 _dbus_verbose ("Service SID Table:\n");
769 _dbus_hash_iter_init (service_table, &iter);
770 while (_dbus_hash_iter_next (&iter))
772 const char *key = _dbus_hash_iter_get_string_key (&iter);
773 security_id_t sid = _dbus_hash_iter_get_value (&iter);
774 _dbus_verbose ("The key is %s\n", key);
775 _dbus_verbose ("The context is %s\n", sid->ctx);
776 _dbus_verbose ("The refcount is %d\n", sid->refcnt);
778 #endif /* HAVE_SELINUX */
779 #endif /* DBUS_ENABLE_VERBOSE_MODE */
783 #ifdef DBUS_ENABLE_VERBOSE_MODE
786 * Print out some AVC statistics.
789 bus_avc_print_stats (void)
791 struct avc_cache_stats cstats;
793 if (!selinux_enabled)
796 _dbus_verbose ("AVC Statistics:\n");
797 avc_cache_stats (&cstats);
799 _dbus_verbose ("AVC Cache Statistics:\n");
800 _dbus_verbose ("Entry lookups: %d\n", cstats.entry_lookups);
801 _dbus_verbose ("Entry hits: %d\n", cstats.entry_hits);
802 _dbus_verbose ("Entry misses %d\n", cstats.entry_misses);
803 _dbus_verbose ("Entry discards: %d\n", cstats.entry_discards);
804 _dbus_verbose ("CAV lookups: %d\n", cstats.cav_lookups);
805 _dbus_verbose ("CAV hits: %d\n", cstats.cav_hits);
806 _dbus_verbose ("CAV probes: %d\n", cstats.cav_probes);
807 _dbus_verbose ("CAV misses: %d\n", cstats.cav_misses);
809 #endif /* HAVE_SELINUX */
810 #endif /* DBUS_ENABLE_VERBOSE_MODE */
814 * Destroy the AVC before we terminate.
817 bus_selinux_shutdown (void)
820 if (!selinux_enabled)
824 bus_sid = SECSID_WILD;
826 #ifdef DBUS_ENABLE_VERBOSE_MODE
827 bus_avc_print_stats ();
828 #endif /* DBUS_ENABLE_VERBOSE_MODE */
831 #endif /* HAVE_SELINUX */