1 // SPDX-License-Identifier: GPL-2.0-only 2 /* 3 * AppArmor security module 4 * 5 * This file contains AppArmor policy manipulation functions 6 * 7 * Copyright (C) 1998-2008 Novell/SUSE 8 * Copyright 2009-2010 Canonical Ltd. 9 * 10 * AppArmor policy is based around profiles, which contain the rules a 11 * task is confined by. Every task in the system has a profile attached 12 * to it determined either by matching "unconfined" tasks against the 13 * visible set of profiles or by following a profiles attachment rules. 14 * 15 * Each profile exists in a profile namespace which is a container of 16 * visible profiles. Each namespace contains a special "unconfined" profile, 17 * which doesn't enforce any confinement on a task beyond DAC. 18 * 19 * Namespace and profile names can be written together in either 20 * of two syntaxes. 21 * :namespace:profile - used by kernel interfaces for easy detection 22 * namespace://profile - used by policy 23 * 24 * Profile names can not start with : or @ or ^ and may not contain \0 25 * 26 * Reserved profile names 27 * unconfined - special automatically generated unconfined profile 28 * inherit - special name to indicate profile inheritance 29 * null-XXXX-YYYY - special automatically generated learning profiles 30 * 31 * Namespace names may not start with / or @ and may not contain \0 or : 32 * Reserved namespace names 33 * user-XXXX - user defined profiles 34 * 35 * a // in a profile or namespace name indicates a hierarchical name with the 36 * name before the // being the parent and the name after the child. 37 * 38 * Profile and namespace hierarchies serve two different but similar purposes. 39 * The namespace contains the set of visible profiles that are considered 40 * for attachment. The hierarchy of namespaces allows for virtualizing 41 * the namespace so that for example a chroot can have its own set of profiles 42 * which may define some local user namespaces. 43 * The profile hierarchy severs two distinct purposes, 44 * - it allows for sub profiles or hats, which allows an application to run 45 * subprograms under its own profile with different restriction than it 46 * self, and not have it use the system profile. 47 * eg. if a mail program starts an editor, the policy might make the 48 * restrictions tighter on the editor tighter than the mail program, 49 * and definitely different than general editor restrictions 50 * - it allows for binary hierarchy of profiles, so that execution history 51 * is preserved. This feature isn't exploited by AppArmor reference policy 52 * but is allowed. NOTE: this is currently suboptimal because profile 53 * aliasing is not currently implemented so that a profile for each 54 * level must be defined. 55 * eg. /bin/bash///bin/ls as a name would indicate /bin/ls was started 56 * from /bin/bash 57 * 58 * A profile or namespace name that can contain one or more // separators 59 * is referred to as an hname (hierarchical). 60 * eg. /bin/bash//bin/ls 61 * 62 * An fqname is a name that may contain both namespace and profile hnames. 63 * eg. :ns:/bin/bash//bin/ls 64 * 65 * NOTES: 66 * - locking of profile lists is currently fairly coarse. All profile 67 * lists within a namespace use the namespace lock. 68 * FIXME: move profile lists to using rcu_lists 69 */ 70 71 #include <linux/slab.h> 72 #include <linux/spinlock.h> 73 #include <linux/string.h> 74 #include <linux/cred.h> 75 #include <linux/rculist.h> 76 #include <linux/user_namespace.h> 77 78 #include "include/apparmor.h" 79 #include "include/capability.h" 80 #include "include/cred.h" 81 #include "include/file.h" 82 #include "include/ipc.h" 83 #include "include/match.h" 84 #include "include/path.h" 85 #include "include/policy.h" 86 #include "include/policy_ns.h" 87 #include "include/policy_unpack.h" 88 #include "include/resource.h" 89 90 int unprivileged_userns_apparmor_policy = 1; 91 92 const char *const aa_profile_mode_names[] = { 93 "enforce", 94 "complain", 95 "kill", 96 "unconfined", 97 "user", 98 }; 99 100 101 /** 102 * __add_profile - add a profiles to list and label tree 103 * @list: list to add it to (NOT NULL) 104 * @profile: the profile to add (NOT NULL) 105 * 106 * refcount @profile, should be put by __list_remove_profile 107 * 108 * Requires: namespace lock be held, or list not be shared 109 */ 110 static void __add_profile(struct list_head *list, struct aa_profile *profile) 111 { 112 struct aa_label *l; 113 114 AA_BUG(!list); 115 AA_BUG(!profile); 116 AA_BUG(!profile->ns); 117 AA_BUG(!mutex_is_locked(&profile->ns->lock)); 118 119 list_add_rcu(&profile->base.list, list); 120 /* get list reference */ 121 aa_get_profile(profile); 122 l = aa_label_insert(&profile->ns->labels, &profile->label); 123 AA_BUG(l != &profile->label); 124 aa_put_label(l); 125 } 126 127 /** 128 * __list_remove_profile - remove a profile from the list it is on 129 * @profile: the profile to remove (NOT NULL) 130 * 131 * remove a profile from the list, warning generally removal should 132 * be done with __replace_profile as most profile removals are 133 * replacements to the unconfined profile. 134 * 135 * put @profile list refcount 136 * 137 * Requires: namespace lock be held, or list not have been live 138 */ 139 static void __list_remove_profile(struct aa_profile *profile) 140 { 141 AA_BUG(!profile); 142 AA_BUG(!profile->ns); 143 AA_BUG(!mutex_is_locked(&profile->ns->lock)); 144 145 list_del_rcu(&profile->base.list); 146 aa_put_profile(profile); 147 } 148 149 /** 150 * __remove_profile - remove old profile, and children 151 * @profile: profile to be replaced (NOT NULL) 152 * 153 * Requires: namespace list lock be held, or list not be shared 154 */ 155 static void __remove_profile(struct aa_profile *profile) 156 { 157 AA_BUG(!profile); 158 AA_BUG(!profile->ns); 159 AA_BUG(!mutex_is_locked(&profile->ns->lock)); 160 161 /* release any children lists first */ 162 __aa_profile_list_release(&profile->base.profiles); 163 /* released by free_profile */ 164 aa_label_remove(&profile->label); 165 __aafs_profile_rmdir(profile); 166 __list_remove_profile(profile); 167 } 168 169 /** 170 * __aa_profile_list_release - remove all profiles on the list and put refs 171 * @head: list of profiles (NOT NULL) 172 * 173 * Requires: namespace lock be held 174 */ 175 void __aa_profile_list_release(struct list_head *head) 176 { 177 struct aa_profile *profile, *tmp; 178 list_for_each_entry_safe(profile, tmp, head, base.list) 179 __remove_profile(profile); 180 } 181 182 /** 183 * aa_free_data - free a data blob 184 * @ptr: data to free 185 * @arg: unused 186 */ 187 static void aa_free_data(void *ptr, void *arg) 188 { 189 struct aa_data *data = ptr; 190 191 kfree_sensitive(data->data); 192 kfree_sensitive(data->key); 193 kfree_sensitive(data); 194 } 195 196 static void free_attachment(struct aa_attachment *attach) 197 { 198 int i; 199 200 for (i = 0; i < attach->xattr_count; i++) 201 kfree_sensitive(attach->xattrs[i]); 202 kfree_sensitive(attach->xattrs); 203 aa_destroy_policydb(&attach->xmatch); 204 } 205 206 static void free_ruleset(struct aa_ruleset *rules) 207 { 208 int i; 209 210 aa_destroy_policydb(&rules->file); 211 aa_destroy_policydb(&rules->policy); 212 aa_free_cap_rules(&rules->caps); 213 aa_free_rlimit_rules(&rules->rlimits); 214 215 for (i = 0; i < rules->secmark_count; i++) 216 kfree_sensitive(rules->secmark[i].label); 217 kfree_sensitive(rules->secmark); 218 kfree_sensitive(rules); 219 } 220 221 struct aa_ruleset *aa_alloc_ruleset(gfp_t gfp) 222 { 223 struct aa_ruleset *rules; 224 225 rules = kzalloc(sizeof(*rules), gfp); 226 if (rules) 227 INIT_LIST_HEAD(&rules->list); 228 229 return rules; 230 } 231 232 /** 233 * aa_free_profile - free a profile 234 * @profile: the profile to free (MAYBE NULL) 235 * 236 * Free a profile, its hats and null_profile. All references to the profile, 237 * its hats and null_profile must have been put. 238 * 239 * If the profile was referenced from a task context, free_profile() will 240 * be called from an rcu callback routine, so we must not sleep here. 241 */ 242 void aa_free_profile(struct aa_profile *profile) 243 { 244 struct aa_ruleset *rule, *tmp; 245 struct rhashtable *rht; 246 247 AA_DEBUG("%s(%p)\n", __func__, profile); 248 249 if (!profile) 250 return; 251 252 /* free children profiles */ 253 aa_policy_destroy(&profile->base); 254 aa_put_profile(rcu_access_pointer(profile->parent)); 255 256 aa_put_ns(profile->ns); 257 kfree_sensitive(profile->rename); 258 kfree_sensitive(profile->disconnected); 259 260 free_attachment(&profile->attach); 261 262 /* 263 * at this point there are no tasks that can have a reference 264 * to rules 265 */ 266 list_for_each_entry_safe(rule, tmp, &profile->rules, list) { 267 list_del_init(&rule->list); 268 free_ruleset(rule); 269 } 270 kfree_sensitive(profile->dirname); 271 272 if (profile->data) { 273 rht = profile->data; 274 profile->data = NULL; 275 rhashtable_free_and_destroy(rht, aa_free_data, NULL); 276 kfree_sensitive(rht); 277 } 278 279 kfree_sensitive(profile->hash); 280 aa_put_loaddata(profile->rawdata); 281 aa_label_destroy(&profile->label); 282 283 kfree_sensitive(profile); 284 } 285 286 /** 287 * aa_alloc_profile - allocate, initialize and return a new profile 288 * @hname: name of the profile (NOT NULL) 289 * @proxy: proxy to use OR null if to allocate a new one 290 * @gfp: allocation type 291 * 292 * Returns: refcount profile or NULL on failure 293 */ 294 struct aa_profile *aa_alloc_profile(const char *hname, struct aa_proxy *proxy, 295 gfp_t gfp) 296 { 297 struct aa_profile *profile; 298 struct aa_ruleset *rules; 299 300 /* freed by free_profile - usually through aa_put_profile */ 301 profile = kzalloc(struct_size(profile, label.vec, 2), gfp); 302 if (!profile) 303 return NULL; 304 305 if (!aa_policy_init(&profile->base, NULL, hname, gfp)) 306 goto fail; 307 if (!aa_label_init(&profile->label, 1, gfp)) 308 goto fail; 309 310 INIT_LIST_HEAD(&profile->rules); 311 312 /* allocate the first ruleset, but leave it empty */ 313 rules = aa_alloc_ruleset(gfp); 314 if (!rules) 315 goto fail; 316 list_add(&rules->list, &profile->rules); 317 318 /* update being set needed by fs interface */ 319 if (!proxy) { 320 proxy = aa_alloc_proxy(&profile->label, gfp); 321 if (!proxy) 322 goto fail; 323 } else 324 aa_get_proxy(proxy); 325 profile->label.proxy = proxy; 326 327 profile->label.hname = profile->base.hname; 328 profile->label.flags |= FLAG_PROFILE; 329 profile->label.vec[0] = profile; 330 331 /* refcount released by caller */ 332 return profile; 333 334 fail: 335 aa_free_profile(profile); 336 337 return NULL; 338 } 339 340 /* TODO: profile accounting - setup in remove */ 341 342 /** 343 * __strn_find_child - find a profile on @head list using substring of @name 344 * @head: list to search (NOT NULL) 345 * @name: name of profile (NOT NULL) 346 * @len: length of @name substring to match 347 * 348 * Requires: rcu_read_lock be held 349 * 350 * Returns: unrefcounted profile ptr, or NULL if not found 351 */ 352 static struct aa_profile *__strn_find_child(struct list_head *head, 353 const char *name, int len) 354 { 355 return (struct aa_profile *)__policy_strn_find(head, name, len); 356 } 357 358 /** 359 * __find_child - find a profile on @head list with a name matching @name 360 * @head: list to search (NOT NULL) 361 * @name: name of profile (NOT NULL) 362 * 363 * Requires: rcu_read_lock be held 364 * 365 * Returns: unrefcounted profile ptr, or NULL if not found 366 */ 367 static struct aa_profile *__find_child(struct list_head *head, const char *name) 368 { 369 return __strn_find_child(head, name, strlen(name)); 370 } 371 372 /** 373 * aa_find_child - find a profile by @name in @parent 374 * @parent: profile to search (NOT NULL) 375 * @name: profile name to search for (NOT NULL) 376 * 377 * Returns: a refcounted profile or NULL if not found 378 */ 379 struct aa_profile *aa_find_child(struct aa_profile *parent, const char *name) 380 { 381 struct aa_profile *profile; 382 383 rcu_read_lock(); 384 do { 385 profile = __find_child(&parent->base.profiles, name); 386 } while (profile && !aa_get_profile_not0(profile)); 387 rcu_read_unlock(); 388 389 /* refcount released by caller */ 390 return profile; 391 } 392 393 /** 394 * __lookup_parent - lookup the parent of a profile of name @hname 395 * @ns: namespace to lookup profile in (NOT NULL) 396 * @hname: hierarchical profile name to find parent of (NOT NULL) 397 * 398 * Lookups up the parent of a fully qualified profile name, the profile 399 * that matches hname does not need to exist, in general this 400 * is used to load a new profile. 401 * 402 * Requires: rcu_read_lock be held 403 * 404 * Returns: unrefcounted policy or NULL if not found 405 */ 406 static struct aa_policy *__lookup_parent(struct aa_ns *ns, 407 const char *hname) 408 { 409 struct aa_policy *policy; 410 struct aa_profile *profile = NULL; 411 char *split; 412 413 policy = &ns->base; 414 415 for (split = strstr(hname, "//"); split;) { 416 profile = __strn_find_child(&policy->profiles, hname, 417 split - hname); 418 if (!profile) 419 return NULL; 420 policy = &profile->base; 421 hname = split + 2; 422 split = strstr(hname, "//"); 423 } 424 if (!profile) 425 return &ns->base; 426 return &profile->base; 427 } 428 429 /** 430 * __create_missing_ancestors - create place holders for missing ancestores 431 * @ns: namespace to lookup profile in (NOT NULL) 432 * @hname: hierarchical profile name to find parent of (NOT NULL) 433 * @gfp: type of allocation. 434 * 435 * Requires: ns mutex lock held 436 * 437 * Return: unrefcounted parent policy on success or %NULL if error creating 438 * place holder profiles. 439 */ 440 static struct aa_policy *__create_missing_ancestors(struct aa_ns *ns, 441 const char *hname, 442 gfp_t gfp) 443 { 444 struct aa_policy *policy; 445 struct aa_profile *parent, *profile = NULL; 446 char *split; 447 448 AA_BUG(!ns); 449 AA_BUG(!hname); 450 451 policy = &ns->base; 452 453 for (split = strstr(hname, "//"); split;) { 454 parent = profile; 455 profile = __strn_find_child(&policy->profiles, hname, 456 split - hname); 457 if (!profile) { 458 const char *name = kstrndup(hname, split - hname, 459 gfp); 460 if (!name) 461 return NULL; 462 profile = aa_alloc_null(parent, name, gfp); 463 kfree(name); 464 if (!profile) 465 return NULL; 466 if (!parent) 467 profile->ns = aa_get_ns(ns); 468 } 469 policy = &profile->base; 470 hname = split + 2; 471 split = strstr(hname, "//"); 472 } 473 if (!profile) 474 return &ns->base; 475 return &profile->base; 476 } 477 478 /** 479 * __lookupn_profile - lookup the profile matching @hname 480 * @base: base list to start looking up profile name from (NOT NULL) 481 * @hname: hierarchical profile name (NOT NULL) 482 * @n: length of @hname 483 * 484 * Requires: rcu_read_lock be held 485 * 486 * Returns: unrefcounted profile pointer or NULL if not found 487 * 488 * Do a relative name lookup, recursing through profile tree. 489 */ 490 static struct aa_profile *__lookupn_profile(struct aa_policy *base, 491 const char *hname, size_t n) 492 { 493 struct aa_profile *profile = NULL; 494 const char *split; 495 496 for (split = strnstr(hname, "//", n); split; 497 split = strnstr(hname, "//", n)) { 498 profile = __strn_find_child(&base->profiles, hname, 499 split - hname); 500 if (!profile) 501 return NULL; 502 503 base = &profile->base; 504 n -= split + 2 - hname; 505 hname = split + 2; 506 } 507 508 if (n) 509 return __strn_find_child(&base->profiles, hname, n); 510 return NULL; 511 } 512 513 static struct aa_profile *__lookup_profile(struct aa_policy *base, 514 const char *hname) 515 { 516 return __lookupn_profile(base, hname, strlen(hname)); 517 } 518 519 /** 520 * aa_lookupn_profile - find a profile by its full or partial name 521 * @ns: the namespace to start from (NOT NULL) 522 * @hname: name to do lookup on. Does not contain namespace prefix (NOT NULL) 523 * @n: size of @hname 524 * 525 * Returns: refcounted profile or NULL if not found 526 */ 527 struct aa_profile *aa_lookupn_profile(struct aa_ns *ns, const char *hname, 528 size_t n) 529 { 530 struct aa_profile *profile; 531 532 rcu_read_lock(); 533 do { 534 profile = __lookupn_profile(&ns->base, hname, n); 535 } while (profile && !aa_get_profile_not0(profile)); 536 rcu_read_unlock(); 537 538 /* the unconfined profile is not in the regular profile list */ 539 if (!profile && strncmp(hname, "unconfined", n) == 0) 540 profile = aa_get_newest_profile(ns->unconfined); 541 542 /* refcount released by caller */ 543 return profile; 544 } 545 546 struct aa_profile *aa_lookup_profile(struct aa_ns *ns, const char *hname) 547 { 548 return aa_lookupn_profile(ns, hname, strlen(hname)); 549 } 550 551 struct aa_profile *aa_fqlookupn_profile(struct aa_label *base, 552 const char *fqname, size_t n) 553 { 554 struct aa_profile *profile; 555 struct aa_ns *ns; 556 const char *name, *ns_name; 557 size_t ns_len; 558 559 name = aa_splitn_fqname(fqname, n, &ns_name, &ns_len); 560 if (ns_name) { 561 ns = aa_lookupn_ns(labels_ns(base), ns_name, ns_len); 562 if (!ns) 563 return NULL; 564 } else 565 ns = aa_get_ns(labels_ns(base)); 566 567 if (name) 568 profile = aa_lookupn_profile(ns, name, n - (name - fqname)); 569 else if (ns) 570 /* default profile for ns, currently unconfined */ 571 profile = aa_get_newest_profile(ns->unconfined); 572 else 573 profile = NULL; 574 aa_put_ns(ns); 575 576 return profile; 577 } 578 579 580 struct aa_profile *aa_alloc_null(struct aa_profile *parent, const char *name, 581 gfp_t gfp) 582 { 583 struct aa_profile *profile; 584 struct aa_ruleset *rules; 585 586 profile = aa_alloc_profile(name, NULL, gfp); 587 if (!profile) 588 return NULL; 589 590 /* TODO: ideally we should inherit abi from parent */ 591 profile->label.flags |= FLAG_NULL; 592 rules = list_first_entry(&profile->rules, typeof(*rules), list); 593 rules->file.dfa = aa_get_dfa(nulldfa); 594 rules->file.perms = kcalloc(2, sizeof(struct aa_perms), gfp); 595 if (!rules->file.perms) 596 goto fail; 597 rules->file.size = 2; 598 rules->policy.dfa = aa_get_dfa(nulldfa); 599 rules->policy.perms = kcalloc(2, sizeof(struct aa_perms), gfp); 600 if (!rules->policy.perms) 601 goto fail; 602 rules->policy.size = 2; 603 604 if (parent) { 605 profile->path_flags = parent->path_flags; 606 607 /* released on free_profile */ 608 rcu_assign_pointer(profile->parent, aa_get_profile(parent)); 609 profile->ns = aa_get_ns(parent->ns); 610 } 611 612 return profile; 613 614 fail: 615 aa_free_profile(profile); 616 617 return NULL; 618 } 619 620 /** 621 * aa_new_learning_profile - create or find a null-X learning profile 622 * @parent: profile that caused this profile to be created (NOT NULL) 623 * @hat: true if the null- learning profile is a hat 624 * @base: name to base the null profile off of 625 * @gfp: type of allocation 626 * 627 * Find/Create a null- complain mode profile used in learning mode. The 628 * name of the profile is unique and follows the format of parent//null-XXX. 629 * where XXX is based on the @name or if that fails or is not supplied 630 * a unique number 631 * 632 * null profiles are added to the profile list but the list does not 633 * hold a count on them so that they are automatically released when 634 * not in use. 635 * 636 * Returns: new refcounted profile else NULL on failure 637 */ 638 struct aa_profile *aa_new_learning_profile(struct aa_profile *parent, bool hat, 639 const char *base, gfp_t gfp) 640 { 641 struct aa_profile *p, *profile; 642 const char *bname; 643 char *name = NULL; 644 645 AA_BUG(!parent); 646 647 if (base) { 648 name = kmalloc(strlen(parent->base.hname) + 8 + strlen(base), 649 gfp); 650 if (name) { 651 sprintf(name, "%s//null-%s", parent->base.hname, base); 652 goto name; 653 } 654 /* fall through to try shorter uniq */ 655 } 656 657 name = kmalloc(strlen(parent->base.hname) + 2 + 7 + 8, gfp); 658 if (!name) 659 return NULL; 660 sprintf(name, "%s//null-%x", parent->base.hname, 661 atomic_inc_return(&parent->ns->uniq_null)); 662 663 name: 664 /* lookup to see if this is a dup creation */ 665 bname = basename(name); 666 profile = aa_find_child(parent, bname); 667 if (profile) 668 goto out; 669 670 profile = aa_alloc_null(parent, name, gfp); 671 if (!profile) 672 goto fail; 673 profile->mode = APPARMOR_COMPLAIN; 674 if (hat) 675 profile->label.flags |= FLAG_HAT; 676 677 mutex_lock_nested(&profile->ns->lock, profile->ns->level); 678 p = __find_child(&parent->base.profiles, bname); 679 if (p) { 680 aa_free_profile(profile); 681 profile = aa_get_profile(p); 682 } else { 683 __add_profile(&parent->base.profiles, profile); 684 } 685 mutex_unlock(&profile->ns->lock); 686 687 /* refcount released by caller */ 688 out: 689 kfree(name); 690 691 return profile; 692 693 fail: 694 kfree(name); 695 aa_free_profile(profile); 696 return NULL; 697 } 698 699 /** 700 * replacement_allowed - test to see if replacement is allowed 701 * @profile: profile to test if it can be replaced (MAYBE NULL) 702 * @noreplace: true if replacement shouldn't be allowed but addition is okay 703 * @info: Returns - info about why replacement failed (NOT NULL) 704 * 705 * Returns: %0 if replacement allowed else error code 706 */ 707 static int replacement_allowed(struct aa_profile *profile, int noreplace, 708 const char **info) 709 { 710 if (profile) { 711 if (profile->label.flags & FLAG_IMMUTIBLE) { 712 *info = "cannot replace immutable profile"; 713 return -EPERM; 714 } else if (noreplace) { 715 *info = "profile already exists"; 716 return -EEXIST; 717 } 718 } 719 return 0; 720 } 721 722 /* audit callback for net specific fields */ 723 static void audit_cb(struct audit_buffer *ab, void *va) 724 { 725 struct common_audit_data *sa = va; 726 struct apparmor_audit_data *ad = aad(sa); 727 728 if (ad->iface.ns) { 729 audit_log_format(ab, " ns="); 730 audit_log_untrustedstring(ab, ad->iface.ns); 731 } 732 } 733 734 /** 735 * audit_policy - Do auditing of policy changes 736 * @label: label to check if it can manage policy 737 * @op: policy operation being performed 738 * @ns_name: name of namespace being manipulated 739 * @name: name of profile being manipulated (NOT NULL) 740 * @info: any extra information to be audited (MAYBE NULL) 741 * @error: error code 742 * 743 * Returns: the error to be returned after audit is done 744 */ 745 static int audit_policy(struct aa_label *label, const char *op, 746 const char *ns_name, const char *name, 747 const char *info, int error) 748 { 749 DEFINE_AUDIT_DATA(ad, LSM_AUDIT_DATA_NONE, AA_CLASS_NONE, op); 750 751 ad.iface.ns = ns_name; 752 ad.name = name; 753 ad.info = info; 754 ad.error = error; 755 ad.label = label; 756 757 aa_audit_msg(AUDIT_APPARMOR_STATUS, &ad, audit_cb); 758 759 return error; 760 } 761 762 /* don't call out to other LSMs in the stack for apparmor policy admin 763 * permissions 764 */ 765 static int policy_ns_capable(struct aa_label *label, 766 struct user_namespace *userns, int cap) 767 { 768 int err; 769 770 /* check for MAC_ADMIN cap in cred */ 771 err = cap_capable(current_cred(), userns, cap, CAP_OPT_NONE); 772 if (!err) 773 err = aa_capable(label, cap, CAP_OPT_NONE); 774 775 return err; 776 } 777 778 /** 779 * aa_policy_view_capable - check if viewing policy in at @ns is allowed 780 * @label: label that is trying to view policy in ns 781 * @ns: namespace being viewed by @label (may be NULL if @label's ns) 782 * 783 * Returns: true if viewing policy is allowed 784 * 785 * If @ns is NULL then the namespace being viewed is assumed to be the 786 * tasks current namespace. 787 */ 788 bool aa_policy_view_capable(struct aa_label *label, struct aa_ns *ns) 789 { 790 struct user_namespace *user_ns = current_user_ns(); 791 struct aa_ns *view_ns = labels_view(label); 792 bool root_in_user_ns = uid_eq(current_euid(), make_kuid(user_ns, 0)) || 793 in_egroup_p(make_kgid(user_ns, 0)); 794 bool response = false; 795 if (!ns) 796 ns = view_ns; 797 798 if (root_in_user_ns && aa_ns_visible(view_ns, ns, true) && 799 (user_ns == &init_user_ns || 800 (unprivileged_userns_apparmor_policy != 0 && 801 user_ns->level == view_ns->level))) 802 response = true; 803 804 return response; 805 } 806 807 bool aa_policy_admin_capable(struct aa_label *label, struct aa_ns *ns) 808 { 809 struct user_namespace *user_ns = current_user_ns(); 810 bool capable = policy_ns_capable(label, user_ns, CAP_MAC_ADMIN) == 0; 811 812 AA_DEBUG("cap_mac_admin? %d\n", capable); 813 AA_DEBUG("policy locked? %d\n", aa_g_lock_policy); 814 815 return aa_policy_view_capable(label, ns) && capable && 816 !aa_g_lock_policy; 817 } 818 819 bool aa_current_policy_view_capable(struct aa_ns *ns) 820 { 821 struct aa_label *label; 822 bool res; 823 824 label = __begin_current_label_crit_section(); 825 res = aa_policy_view_capable(label, ns); 826 __end_current_label_crit_section(label); 827 828 return res; 829 } 830 831 bool aa_current_policy_admin_capable(struct aa_ns *ns) 832 { 833 struct aa_label *label; 834 bool res; 835 836 label = __begin_current_label_crit_section(); 837 res = aa_policy_admin_capable(label, ns); 838 __end_current_label_crit_section(label); 839 840 return res; 841 } 842 843 /** 844 * aa_may_manage_policy - can the current task manage policy 845 * @label: label to check if it can manage policy 846 * @ns: namespace being managed by @label (may be NULL if @label's ns) 847 * @mask: contains the policy manipulation operation being done 848 * 849 * Returns: 0 if the task is allowed to manipulate policy else error 850 */ 851 int aa_may_manage_policy(struct aa_label *label, struct aa_ns *ns, u32 mask) 852 { 853 const char *op; 854 855 if (mask & AA_MAY_REMOVE_POLICY) 856 op = OP_PROF_RM; 857 else if (mask & AA_MAY_REPLACE_POLICY) 858 op = OP_PROF_REPL; 859 else 860 op = OP_PROF_LOAD; 861 862 /* check if loading policy is locked out */ 863 if (aa_g_lock_policy) 864 return audit_policy(label, op, NULL, NULL, "policy_locked", 865 -EACCES); 866 867 if (!aa_policy_admin_capable(label, ns)) 868 return audit_policy(label, op, NULL, NULL, "not policy admin", 869 -EACCES); 870 871 /* TODO: add fine grained mediation of policy loads */ 872 return 0; 873 } 874 875 static struct aa_profile *__list_lookup_parent(struct list_head *lh, 876 struct aa_profile *profile) 877 { 878 const char *base = basename(profile->base.hname); 879 long len = base - profile->base.hname; 880 struct aa_load_ent *ent; 881 882 /* parent won't have trailing // so remove from len */ 883 if (len <= 2) 884 return NULL; 885 len -= 2; 886 887 list_for_each_entry(ent, lh, list) { 888 if (ent->new == profile) 889 continue; 890 if (strncmp(ent->new->base.hname, profile->base.hname, len) == 891 0 && ent->new->base.hname[len] == 0) 892 return ent->new; 893 } 894 895 return NULL; 896 } 897 898 /** 899 * __replace_profile - replace @old with @new on a list 900 * @old: profile to be replaced (NOT NULL) 901 * @new: profile to replace @old with (NOT NULL) 902 * 903 * Will duplicate and refcount elements that @new inherits from @old 904 * and will inherit @old children. 905 * 906 * refcount @new for list, put @old list refcount 907 * 908 * Requires: namespace list lock be held, or list not be shared 909 */ 910 static void __replace_profile(struct aa_profile *old, struct aa_profile *new) 911 { 912 struct aa_profile *child, *tmp; 913 914 if (!list_empty(&old->base.profiles)) { 915 LIST_HEAD(lh); 916 list_splice_init_rcu(&old->base.profiles, &lh, synchronize_rcu); 917 918 list_for_each_entry_safe(child, tmp, &lh, base.list) { 919 struct aa_profile *p; 920 921 list_del_init(&child->base.list); 922 p = __find_child(&new->base.profiles, child->base.name); 923 if (p) { 924 /* @p replaces @child */ 925 __replace_profile(child, p); 926 continue; 927 } 928 929 /* inherit @child and its children */ 930 /* TODO: update hname of inherited children */ 931 /* list refcount transferred to @new */ 932 p = aa_deref_parent(child); 933 rcu_assign_pointer(child->parent, aa_get_profile(new)); 934 list_add_rcu(&child->base.list, &new->base.profiles); 935 aa_put_profile(p); 936 } 937 } 938 939 if (!rcu_access_pointer(new->parent)) { 940 struct aa_profile *parent = aa_deref_parent(old); 941 rcu_assign_pointer(new->parent, aa_get_profile(parent)); 942 } 943 aa_label_replace(&old->label, &new->label); 944 /* migrate dents must come after label replacement b/c update */ 945 __aafs_profile_migrate_dents(old, new); 946 947 if (list_empty(&new->base.list)) { 948 /* new is not on a list already */ 949 list_replace_rcu(&old->base.list, &new->base.list); 950 aa_get_profile(new); 951 aa_put_profile(old); 952 } else 953 __list_remove_profile(old); 954 } 955 956 /** 957 * __lookup_replace - lookup replacement information for a profile 958 * @ns: namespace the lookup occurs in 959 * @hname: name of profile to lookup 960 * @noreplace: true if not replacing an existing profile 961 * @p: Returns - profile to be replaced 962 * @info: Returns - info string on why lookup failed 963 * 964 * Returns: profile to replace (no ref) on success else ptr error 965 */ 966 static int __lookup_replace(struct aa_ns *ns, const char *hname, 967 bool noreplace, struct aa_profile **p, 968 const char **info) 969 { 970 *p = aa_get_profile(__lookup_profile(&ns->base, hname)); 971 if (*p) { 972 int error = replacement_allowed(*p, noreplace, info); 973 if (error) { 974 *info = "profile can not be replaced"; 975 return error; 976 } 977 } 978 979 return 0; 980 } 981 982 static void share_name(struct aa_profile *old, struct aa_profile *new) 983 { 984 aa_put_str(new->base.hname); 985 aa_get_str(old->base.hname); 986 new->base.hname = old->base.hname; 987 new->base.name = old->base.name; 988 new->label.hname = old->label.hname; 989 } 990 991 /* Update to newest version of parent after previous replacements 992 * Returns: unrefcount newest version of parent 993 */ 994 static struct aa_profile *update_to_newest_parent(struct aa_profile *new) 995 { 996 struct aa_profile *parent, *newest; 997 998 parent = rcu_dereference_protected(new->parent, 999 mutex_is_locked(&new->ns->lock)); 1000 newest = aa_get_newest_profile(parent); 1001 1002 /* parent replaced in this atomic set? */ 1003 if (newest != parent) { 1004 aa_put_profile(parent); 1005 rcu_assign_pointer(new->parent, newest); 1006 } else 1007 aa_put_profile(newest); 1008 1009 return newest; 1010 } 1011 1012 /** 1013 * aa_replace_profiles - replace profile(s) on the profile list 1014 * @policy_ns: namespace load is occurring on 1015 * @label: label that is attempting to load/replace policy 1016 * @mask: permission mask 1017 * @udata: serialized data stream (NOT NULL) 1018 * 1019 * unpack and replace a profile on the profile list and uses of that profile 1020 * by any task creds via invalidating the old version of the profile, which 1021 * tasks will notice to update their own cred. If the profile does not exist 1022 * on the profile list it is added. 1023 * 1024 * Returns: size of data consumed else error code on failure. 1025 */ 1026 ssize_t aa_replace_profiles(struct aa_ns *policy_ns, struct aa_label *label, 1027 u32 mask, struct aa_loaddata *udata) 1028 { 1029 const char *ns_name = NULL, *info = NULL; 1030 struct aa_ns *ns = NULL; 1031 struct aa_load_ent *ent, *tmp; 1032 struct aa_loaddata *rawdata_ent; 1033 const char *op; 1034 ssize_t count, error; 1035 LIST_HEAD(lh); 1036 1037 op = mask & AA_MAY_REPLACE_POLICY ? OP_PROF_REPL : OP_PROF_LOAD; 1038 aa_get_loaddata(udata); 1039 /* released below */ 1040 error = aa_unpack(udata, &lh, &ns_name); 1041 if (error) 1042 goto out; 1043 1044 /* ensure that profiles are all for the same ns 1045 * TODO: update locking to remove this constaint. All profiles in 1046 * the load set must succeed as a set or the load will 1047 * fail. Sort ent list and take ns locks in hierarchy order 1048 */ 1049 count = 0; 1050 list_for_each_entry(ent, &lh, list) { 1051 if (ns_name) { 1052 if (ent->ns_name && 1053 strcmp(ent->ns_name, ns_name) != 0) { 1054 info = "policy load has mixed namespaces"; 1055 error = -EACCES; 1056 goto fail; 1057 } 1058 } else if (ent->ns_name) { 1059 if (count) { 1060 info = "policy load has mixed namespaces"; 1061 error = -EACCES; 1062 goto fail; 1063 } 1064 ns_name = ent->ns_name; 1065 } else 1066 count++; 1067 } 1068 if (ns_name) { 1069 ns = aa_prepare_ns(policy_ns ? policy_ns : labels_ns(label), 1070 ns_name); 1071 if (IS_ERR(ns)) { 1072 op = OP_PROF_LOAD; 1073 info = "failed to prepare namespace"; 1074 error = PTR_ERR(ns); 1075 ns = NULL; 1076 ent = NULL; 1077 goto fail; 1078 } 1079 } else 1080 ns = aa_get_ns(policy_ns ? policy_ns : labels_ns(label)); 1081 1082 mutex_lock_nested(&ns->lock, ns->level); 1083 /* check for duplicate rawdata blobs: space and file dedup */ 1084 if (!list_empty(&ns->rawdata_list)) { 1085 list_for_each_entry(rawdata_ent, &ns->rawdata_list, list) { 1086 if (aa_rawdata_eq(rawdata_ent, udata)) { 1087 struct aa_loaddata *tmp; 1088 1089 tmp = __aa_get_loaddata(rawdata_ent); 1090 /* check we didn't fail the race */ 1091 if (tmp) { 1092 aa_put_loaddata(udata); 1093 udata = tmp; 1094 break; 1095 } 1096 } 1097 } 1098 } 1099 /* setup parent and ns info */ 1100 list_for_each_entry(ent, &lh, list) { 1101 struct aa_policy *policy; 1102 struct aa_profile *p; 1103 1104 if (aa_g_export_binary) 1105 ent->new->rawdata = aa_get_loaddata(udata); 1106 error = __lookup_replace(ns, ent->new->base.hname, 1107 !(mask & AA_MAY_REPLACE_POLICY), 1108 &ent->old, &info); 1109 if (error) 1110 goto fail_lock; 1111 1112 if (ent->new->rename) { 1113 error = __lookup_replace(ns, ent->new->rename, 1114 !(mask & AA_MAY_REPLACE_POLICY), 1115 &ent->rename, &info); 1116 if (error) 1117 goto fail_lock; 1118 } 1119 1120 /* released when @new is freed */ 1121 ent->new->ns = aa_get_ns(ns); 1122 1123 if (ent->old || ent->rename) 1124 continue; 1125 1126 /* no ref on policy only use inside lock */ 1127 p = NULL; 1128 policy = __lookup_parent(ns, ent->new->base.hname); 1129 if (!policy) { 1130 /* first check for parent in the load set */ 1131 p = __list_lookup_parent(&lh, ent->new); 1132 if (!p) { 1133 /* 1134 * fill in missing parent with null 1135 * profile that doesn't have 1136 * permissions. This allows for 1137 * individual profile loading where 1138 * the child is loaded before the 1139 * parent, and outside of the current 1140 * atomic set. This unfortunately can 1141 * happen with some userspaces. The 1142 * null profile will be replaced once 1143 * the parent is loaded. 1144 */ 1145 policy = __create_missing_ancestors(ns, 1146 ent->new->base.hname, 1147 GFP_KERNEL); 1148 if (!policy) { 1149 error = -ENOENT; 1150 info = "parent does not exist"; 1151 goto fail_lock; 1152 } 1153 } 1154 } 1155 if (!p && policy != &ns->base) 1156 /* released on profile replacement or free_profile */ 1157 p = (struct aa_profile *) policy; 1158 rcu_assign_pointer(ent->new->parent, aa_get_profile(p)); 1159 } 1160 1161 /* create new fs entries for introspection if needed */ 1162 if (!udata->dents[AAFS_LOADDATA_DIR] && aa_g_export_binary) { 1163 error = __aa_fs_create_rawdata(ns, udata); 1164 if (error) { 1165 info = "failed to create raw_data dir and files"; 1166 ent = NULL; 1167 goto fail_lock; 1168 } 1169 } 1170 list_for_each_entry(ent, &lh, list) { 1171 if (!ent->old) { 1172 struct dentry *parent; 1173 if (rcu_access_pointer(ent->new->parent)) { 1174 struct aa_profile *p; 1175 p = aa_deref_parent(ent->new); 1176 parent = prof_child_dir(p); 1177 } else 1178 parent = ns_subprofs_dir(ent->new->ns); 1179 error = __aafs_profile_mkdir(ent->new, parent); 1180 } 1181 1182 if (error) { 1183 info = "failed to create"; 1184 goto fail_lock; 1185 } 1186 } 1187 1188 /* Done with checks that may fail - do actual replacement */ 1189 __aa_bump_ns_revision(ns); 1190 if (aa_g_export_binary) 1191 __aa_loaddata_update(udata, ns->revision); 1192 list_for_each_entry_safe(ent, tmp, &lh, list) { 1193 list_del_init(&ent->list); 1194 op = (!ent->old && !ent->rename) ? OP_PROF_LOAD : OP_PROF_REPL; 1195 1196 if (ent->old && ent->old->rawdata == ent->new->rawdata && 1197 ent->new->rawdata) { 1198 /* dedup actual profile replacement */ 1199 audit_policy(label, op, ns_name, ent->new->base.hname, 1200 "same as current profile, skipping", 1201 error); 1202 /* break refcount cycle with proxy. */ 1203 aa_put_proxy(ent->new->label.proxy); 1204 ent->new->label.proxy = NULL; 1205 goto skip; 1206 } 1207 1208 /* 1209 * TODO: finer dedup based on profile range in data. Load set 1210 * can differ but profile may remain unchanged 1211 */ 1212 audit_policy(label, op, ns_name, ent->new->base.hname, NULL, 1213 error); 1214 1215 if (ent->old) { 1216 share_name(ent->old, ent->new); 1217 __replace_profile(ent->old, ent->new); 1218 } else { 1219 struct list_head *lh; 1220 1221 if (rcu_access_pointer(ent->new->parent)) { 1222 struct aa_profile *parent; 1223 1224 parent = update_to_newest_parent(ent->new); 1225 lh = &parent->base.profiles; 1226 } else 1227 lh = &ns->base.profiles; 1228 __add_profile(lh, ent->new); 1229 } 1230 skip: 1231 aa_load_ent_free(ent); 1232 } 1233 __aa_labelset_update_subtree(ns); 1234 mutex_unlock(&ns->lock); 1235 1236 out: 1237 aa_put_ns(ns); 1238 aa_put_loaddata(udata); 1239 kfree(ns_name); 1240 1241 if (error) 1242 return error; 1243 return udata->size; 1244 1245 fail_lock: 1246 mutex_unlock(&ns->lock); 1247 1248 /* audit cause of failure */ 1249 op = (ent && !ent->old) ? OP_PROF_LOAD : OP_PROF_REPL; 1250 fail: 1251 audit_policy(label, op, ns_name, ent ? ent->new->base.hname : NULL, 1252 info, error); 1253 /* audit status that rest of profiles in the atomic set failed too */ 1254 info = "valid profile in failed atomic policy load"; 1255 list_for_each_entry(tmp, &lh, list) { 1256 if (tmp == ent) { 1257 info = "unchecked profile in failed atomic policy load"; 1258 /* skip entry that caused failure */ 1259 continue; 1260 } 1261 op = (!tmp->old) ? OP_PROF_LOAD : OP_PROF_REPL; 1262 audit_policy(label, op, ns_name, tmp->new->base.hname, info, 1263 error); 1264 } 1265 list_for_each_entry_safe(ent, tmp, &lh, list) { 1266 list_del_init(&ent->list); 1267 aa_load_ent_free(ent); 1268 } 1269 1270 goto out; 1271 } 1272 1273 /** 1274 * aa_remove_profiles - remove profile(s) from the system 1275 * @policy_ns: namespace the remove is being done from 1276 * @subj: label attempting to remove policy 1277 * @fqname: name of the profile or namespace to remove (NOT NULL) 1278 * @size: size of the name 1279 * 1280 * Remove a profile or sub namespace from the current namespace, so that 1281 * they can not be found anymore and mark them as replaced by unconfined 1282 * 1283 * NOTE: removing confinement does not restore rlimits to preconfinement values 1284 * 1285 * Returns: size of data consume else error code if fails 1286 */ 1287 ssize_t aa_remove_profiles(struct aa_ns *policy_ns, struct aa_label *subj, 1288 char *fqname, size_t size) 1289 { 1290 struct aa_ns *ns = NULL; 1291 struct aa_profile *profile = NULL; 1292 const char *name = fqname, *info = NULL; 1293 const char *ns_name = NULL; 1294 ssize_t error = 0; 1295 1296 if (*fqname == 0) { 1297 info = "no profile specified"; 1298 error = -ENOENT; 1299 goto fail; 1300 } 1301 1302 if (fqname[0] == ':') { 1303 size_t ns_len; 1304 1305 name = aa_splitn_fqname(fqname, size, &ns_name, &ns_len); 1306 /* released below */ 1307 ns = aa_lookupn_ns(policy_ns ? policy_ns : labels_ns(subj), 1308 ns_name, ns_len); 1309 if (!ns) { 1310 info = "namespace does not exist"; 1311 error = -ENOENT; 1312 goto fail; 1313 } 1314 } else 1315 /* released below */ 1316 ns = aa_get_ns(policy_ns ? policy_ns : labels_ns(subj)); 1317 1318 if (!name) { 1319 /* remove namespace - can only happen if fqname[0] == ':' */ 1320 mutex_lock_nested(&ns->parent->lock, ns->parent->level); 1321 __aa_bump_ns_revision(ns); 1322 __aa_remove_ns(ns); 1323 mutex_unlock(&ns->parent->lock); 1324 } else { 1325 /* remove profile */ 1326 mutex_lock_nested(&ns->lock, ns->level); 1327 profile = aa_get_profile(__lookup_profile(&ns->base, name)); 1328 if (!profile) { 1329 error = -ENOENT; 1330 info = "profile does not exist"; 1331 goto fail_ns_lock; 1332 } 1333 name = profile->base.hname; 1334 __aa_bump_ns_revision(ns); 1335 __remove_profile(profile); 1336 __aa_labelset_update_subtree(ns); 1337 mutex_unlock(&ns->lock); 1338 } 1339 1340 /* don't fail removal if audit fails */ 1341 (void) audit_policy(subj, OP_PROF_RM, ns_name, name, info, 1342 error); 1343 aa_put_ns(ns); 1344 aa_put_profile(profile); 1345 return size; 1346 1347 fail_ns_lock: 1348 mutex_unlock(&ns->lock); 1349 aa_put_ns(ns); 1350 1351 fail: 1352 (void) audit_policy(subj, OP_PROF_RM, ns_name, name, info, 1353 error); 1354 return error; 1355 } 1356