security/smack/smack_access.c

   1 /*
   2  * Copyright (C) 2007 Casey Schaufler <casey@schaufler-ca.com>
   3  *
   4  *      This program is free software; you can redistribute it and/or modify
   5  *      it under the terms of the GNU General Public License as published by
   6  *      the Free Software Foundation, version 2.
   7  *
   8  * Author:
   9  *      Casey Schaufler <casey@schaufler-ca.com>
  10  *
  11  */
  12
  13 #include <linux/types.h>
  14 #include <linux/slab.h>
  15 #include <linux/fs.h>
  16 #include <linux/sched.h>
  17 #include "smack.h"
  18
  19 struct smack_known smack_known_huh = {
  20         .smk_known      = "?",
  21         .smk_secid      = 2,
  22 };
  23
  24 struct smack_known smack_known_hat = {
  25         .smk_known      = "^",
  26         .smk_secid      = 3,
  27 };
  28
  29 struct smack_known smack_known_star = {
  30         .smk_known      = "*",
  31         .smk_secid      = 4,
  32 };
  33
  34 struct smack_known smack_known_floor = {
  35         .smk_known      = "_",
  36         .smk_secid      = 5,
  37 };
  38
  39 struct smack_known smack_known_invalid = {
  40         .smk_known      = "",
  41         .smk_secid      = 6,
  42 };
  43
  44 struct smack_known smack_known_web = {
  45         .smk_known      = "@",
  46         .smk_secid      = 7,
  47 };
  48
  49 LIST_HEAD(smack_known_list);
  50
  51 /*
  52  * The initial value needs to be bigger than any of the
  53  * known values above.
  54  */
  55 static u32 smack_next_secid = 10;
  56
  57 /*
  58  * what events do we log
  59  * can be overwritten at run-time by /smack/logging
  60  */
  61 int log_policy = SMACK_AUDIT_DENIED;
  62
  63 /**
  64  * smk_access_entry - look up matching access rule
  65  * @subject_label: a pointer to the subject's Smack label
  66  * @object_label: a pointer to the object's Smack label
  67  * @rule_list: the list of rules to search
  68  *
  69  * This function looks up the subject/object pair in the
  70  * access rule list and returns the access mode. If no
  71  * entry is found returns -ENOENT.
  72  *
  73  * NOTE:
  74  *
  75  * Earlier versions of this function allowed for labels that
  76  * were not on the label list. This was done to allow for
  77  * labels to come over the network that had never been seen
  78  * before on this host. Unless the receiving socket has the
  79  * star label this will always result in a failure check. The
  80  * star labeled socket case is now handled in the networking
  81  * hooks so there is no case where the label is not on the
  82  * label list. Checking to see if the address of two labels
  83  * is the same is now a reliable test.
  84  *
  85  * Do the object check first because that is more
  86  * likely to differ.
  87  *
  88  * Allowing write access implies allowing locking.
  89  */
  90 int smk_access_entry(char *subject_label, char *object_label,
  91                         struct list_head *rule_list)
  92 {
  93         int may = -ENOENT;
  94         struct smack_rule *srp;
  95
  96         list_for_each_entry_rcu(srp, rule_list, list) {
  97                 if (srp->smk_object == object_label &&
  98                     srp->smk_subject->smk_known == subject_label) {
  99                         may = srp->smk_access;
 100                         break;
 101                 }
 102         }
 103
 104         /*
 105          * MAY_WRITE implies MAY_LOCK.
 106          */
 107         if ((may & MAY_WRITE) == MAY_WRITE)
 108                 may |= MAY_LOCK;
 109         return may;
 110 }
 111
 112 /**
 113  * smk_access - determine if a subject has a specific access to an object
 114  * @subject_known: a pointer to the subject's Smack label entry
 115  * @object_label: a pointer to the object's Smack label
 116  * @request: the access requested, in "MAY" format
 117  * @a : a pointer to the audit data
 118  *
 119  * This function looks up the subject/object pair in the
 120  * access rule list and returns 0 if the access is permitted,
 121  * non zero otherwise.
 122  *
 123  * Smack labels are shared on smack_list
 124  */
 125 int smk_access(struct smack_known *subject_known, char *object_label,
 126                 int request, struct smk_audit_info *a)
 127 {
 128         int may = MAY_NOT;
 129         int rc = 0;
 130
 131         /*
 132          * Hardcoded comparisons.
 133          */
 134         /*
 135          * A star subject can't access any object.
 136          */
 137         if (subject_known == &smack_known_star) {
 138                 rc = -EACCES;
 139                 goto out_audit;
 140         }
 141         /*
 142          * An internet object can be accessed by any subject.
 143          * Tasks cannot be assigned the internet label.
 144          * An internet subject can access any object.
 145          */
 146         if (object_label == smack_known_web.smk_known ||
 147             subject_known == &smack_known_web)
 148                 goto out_audit;
 149         /*
 150          * A star object can be accessed by any subject.
 151          */
 152         if (object_label == smack_known_star.smk_known)
 153                 goto out_audit;
 154         /*
 155          * An object can be accessed in any way by a subject
 156          * with the same label.
 157          */
 158         if (subject_known->smk_known == object_label)
 159                 goto out_audit;
 160         /*
 161          * A hat subject can read or lock any object.
 162          * A floor object can be read or locked by any subject.
 163          */
 164         if ((request & MAY_ANYREAD) == request ||
 165             (request & MAY_LOCK) == request) {
 166                 if (object_label == smack_known_floor.smk_known)
 167                         goto out_audit;
 168                 if (subject_known == &smack_known_hat)
 169                         goto out_audit;
 170         }
 171         /*
 172          * Beyond here an explicit relationship is required.
 173          * If the requested access is contained in the available
 174          * access (e.g. read is included in readwrite) it's
 175          * good. A negative response from smk_access_entry()
 176          * indicates there is no entry for this pair.
 177          */
 178         rcu_read_lock();
 179         may = smk_access_entry(subject_known->smk_known, object_label,
 180                                 &subject_known->smk_rules);
 181         rcu_read_unlock();
 182
 183         if (may <= 0 || (request & may) != request) {
 184                 rc = -EACCES;
 185                 goto out_audit;
 186         }
 187 #ifdef CONFIG_SECURITY_SMACK_BRINGUP
 188         /*
 189          * Return a positive value if using bringup mode.
 190          * This allows the hooks to identify checks that
 191          * succeed because of "b" rules.
 192          */
 193         if (may & MAY_BRINGUP)
 194                 rc = SMACK_BRINGUP_ALLOW;
 195 #endif
 196
 197 out_audit:
 198
 199 #ifdef CONFIG_SECURITY_SMACK_BRINGUP
 200         if (rc < 0) {
 201                 if (smack_unconfined != NULL) {
 202                         if (object_label == smack_unconfined->smk_known)
 203                                 rc = SMACK_UNCONFINED_OBJECT;
 204                         if (subject_known->smk_known == smack_unconfined->smk_known)
 205                                 rc = SMACK_UNCONFINED_SUBJECT;
 206                 }
 207         }
 208 #endif
 209
 210 #ifdef CONFIG_AUDIT
 211         if (a)
 212                 smack_log(subject_known->smk_known, object_label, request,
 213                                 rc, a);
 214 #endif
 215
 216         return rc;
 217 }
 218
 219 /**
 220  * smk_tskacc - determine if a task has a specific access to an object
 221  * @tsp: a pointer to the subject task
 222  * @obj_label: a pointer to the object's Smack label
 223  * @mode: the access requested, in "MAY" format
 224  * @a : common audit data
 225  *
 226  * This function checks the subject task's label/object label pair
 227  * in the access rule list and returns 0 if the access is permitted,
 228  * non zero otherwise. It allows that the task may have the capability
 229  * to override the rules.
 230  */
 231 int smk_tskacc(struct task_smack *subject, char *obj_label,
 232                u32 mode, struct smk_audit_info *a)
 233 {
 234         struct smack_known *skp = smk_of_task(subject);
 235         int may;
 236         int rc;
 237
 238         /*
 239          * Check the global rule list
 240          */
 241         rc = smk_access(skp, obj_label, mode, NULL);
 242         if (rc >= 0) {
 243                 /*
 244                  * If there is an entry in the task's rule list
 245                  * it can further restrict access.
 246                  */
 247                 may = smk_access_entry(skp->smk_known, obj_label,
 248                                         &subject->smk_rules);
 249                 if (may < 0)
 250                         goto out_audit;
 251                 if ((mode & may) == mode)
 252                         goto out_audit;
 253                 rc = -EACCES;
 254         }
 255
 256         /*
 257          * Allow for priviliged to override policy.
 258          */
 259         if (rc != 0 && smack_privileged(CAP_MAC_OVERRIDE))
 260                 rc = 0;
 261
 262 out_audit:
 263 #ifdef CONFIG_AUDIT
 264         if (a)
 265                 smack_log(skp->smk_known, obj_label, mode, rc, a);
 266 #endif
 267         return rc;
 268 }
 269
 270 /**
 271  * smk_curacc - determine if current has a specific access to an object
 272  * @obj_label: a pointer to the object's Smack label
 273  * @mode: the access requested, in "MAY" format
 274  * @a : common audit data
 275  *
 276  * This function checks the current subject label/object label pair
 277  * in the access rule list and returns 0 if the access is permitted,
 278  * non zero otherwise. It allows that current may have the capability
 279  * to override the rules.
 280  */
 281 int smk_curacc(char *obj_label, u32 mode, struct smk_audit_info *a)
 282 {
 283         struct task_smack *tsp = current_security();
 284
 285         return smk_tskacc(tsp, obj_label, mode, a);
 286 }
 287
 288 #ifdef CONFIG_AUDIT
 289 /**
 290  * smack_str_from_perm : helper to transalate an int to a
 291  * readable string
 292  * @string : the string to fill
 293  * @access : the int
 294  *
 295  */
 296 static inline void smack_str_from_perm(char *string, int access)
 297 {
 298         int i = 0;
 299
 300         if (access & MAY_READ)
 301                 string[i++] = 'r';
 302         if (access & MAY_WRITE)
 303                 string[i++] = 'w';
 304         if (access & MAY_EXEC)
 305                 string[i++] = 'x';
 306         if (access & MAY_APPEND)
 307                 string[i++] = 'a';
 308         if (access & MAY_TRANSMUTE)
 309                 string[i++] = 't';
 310         if (access & MAY_LOCK)
 311                 string[i++] = 'l';
 312         string[i] = '\0';
 313 }
 314 /**
 315  * smack_log_callback - SMACK specific information
 316  * will be called by generic audit code
 317  * @ab : the audit_buffer
 318  * @a  : audit_data
 319  *
 320  */
 321 static void smack_log_callback(struct audit_buffer *ab, void *a)
 322 {
 323         struct common_audit_data *ad = a;
 324         struct smack_audit_data *sad = ad->smack_audit_data;
 325         audit_log_format(ab, "lsm=SMACK fn=%s action=%s",
 326                          ad->smack_audit_data->function,
 327                          sad->result ? "denied" : "granted");
 328         audit_log_format(ab, " subject=");
 329         audit_log_untrustedstring(ab, sad->subject);
 330         audit_log_format(ab, " object=");
 331         audit_log_untrustedstring(ab, sad->object);
 332         if (sad->request[0] == '\0')
 333                 audit_log_format(ab, " labels_differ");
 334         else
 335                 audit_log_format(ab, " requested=%s", sad->request);
 336 }
 337
 338 /**
 339  *  smack_log - Audit the granting or denial of permissions.
 340  *  @subject_label : smack label of the requester
 341  *  @object_label  : smack label of the object being accessed
 342  *  @request: requested permissions
 343  *  @result: result from smk_access
 344  *  @a:  auxiliary audit data
 345  *
 346  * Audit the granting or denial of permissions in accordance
 347  * with the policy.
 348  */
 349 void smack_log(char *subject_label, char *object_label, int request,
 350                int result, struct smk_audit_info *ad)
 351 {
 352 #ifdef CONFIG_SECURITY_SMACK_BRINGUP
 353         char request_buffer[SMK_NUM_ACCESS_TYPE + 5];
 354 #else
 355         char request_buffer[SMK_NUM_ACCESS_TYPE + 1];
 356 #endif
 357         struct smack_audit_data *sad;
 358         struct common_audit_data *a = &ad->a;
 359
 360         /* check if we have to log the current event */
 361         if (result < 0 && (log_policy & SMACK_AUDIT_DENIED) == 0)
 362                 return;
 363         if (result == 0 && (log_policy & SMACK_AUDIT_ACCEPT) == 0)
 364                 return;
 365
 366         sad = a->smack_audit_data;
 367
 368         if (sad->function == NULL)
 369                 sad->function = "unknown";
 370
 371         /* end preparing the audit data */
 372         smack_str_from_perm(request_buffer, request);
 373         sad->subject = subject_label;
 374         sad->object  = object_label;
 375 #ifdef CONFIG_SECURITY_SMACK_BRINGUP
 376         /*
 377          * The result may be positive in bringup mode.
 378          * A positive result is an allow, but not for normal reasons.
 379          * Mark it as successful, but don't filter it out even if
 380          * the logging policy says to do so.
 381          */
 382         if (result == SMACK_UNCONFINED_SUBJECT)
 383                 strcat(request_buffer, "(US)");
 384         else if (result == SMACK_UNCONFINED_OBJECT)
 385                 strcat(request_buffer, "(UO)");
 386
 387         if (result > 0)
 388                 result = 0;
 389 #endif
 390         sad->request = request_buffer;
 391         sad->result  = result;
 392
 393         common_lsm_audit(a, smack_log_callback, NULL);
 394 }
 395 #else /* #ifdef CONFIG_AUDIT */
 396 void smack_log(char *subject_label, char *object_label, int request,
 397                int result, struct smk_audit_info *ad)
 398 {
 399 }
 400 #endif
 401
 402 DEFINE_MUTEX(smack_known_lock);
 403
 404 struct hlist_head smack_known_hash[SMACK_HASH_SLOTS];
 405
 406 /**
 407  * smk_insert_entry - insert a smack label into a hash map,
 408  *
 409  * this function must be called under smack_known_lock
 410  */
 411 void smk_insert_entry(struct smack_known *skp)
 412 {
 413         unsigned int hash;
 414         struct hlist_head *head;
 415
 416         hash = full_name_hash(skp->smk_known, strlen(skp->smk_known));
 417         head = &smack_known_hash[hash & (SMACK_HASH_SLOTS - 1)];
 418
 419         hlist_add_head_rcu(&skp->smk_hashed, head);
 420         list_add_rcu(&skp->list, &smack_known_list);
 421 }
 422
 423 /**
 424  * smk_find_entry - find a label on the list, return the list entry
 425  * @string: a text string that might be a Smack label
 426  *
 427  * Returns a pointer to the entry in the label list that
 428  * matches the passed string.
 429  */
 430 struct smack_known *smk_find_entry(const char *string)
 431 {
 432         unsigned int hash;
 433         struct hlist_head *head;
 434         struct smack_known *skp;
 435
 436         hash = full_name_hash(string, strlen(string));
 437         head = &smack_known_hash[hash & (SMACK_HASH_SLOTS - 1)];
 438
 439         hlist_for_each_entry_rcu(skp, head, smk_hashed)
 440                 if (strcmp(skp->smk_known, string) == 0)
 441                         return skp;
 442
 443         return NULL;
 444 }
 445
 446 /**
 447  * smk_parse_smack - parse smack label from a text string
 448  * @string: a text string that might contain a Smack label
 449  * @len: the maximum size, or zero if it is NULL terminated.
 450  *
 451  * Returns a pointer to the clean label, or NULL
 452  */
 453 char *smk_parse_smack(const char *string, int len)
 454 {
 455         char *smack;
 456         int i;
 457
 458         if (len <= 0)
 459                 len = strlen(string) + 1;
 460
 461         /*
 462          * Reserve a leading '-' as an indicator that
 463          * this isn't a label, but an option to interfaces
 464          * including /smack/cipso and /smack/cipso2
 465          */
 466         if (string[0] == '-')
 467                 return NULL;
 468
 469         for (i = 0; i < len; i++)
 470                 if (string[i] > '~' || string[i] <= ' ' || string[i] == '/' ||
 471                     string[i] == '"' || string[i] == '\\' || string[i] == '\'')
 472                         break;
 473
 474         if (i == 0 || i >= SMK_LONGLABEL)
 475                 return NULL;
 476
 477         smack = kzalloc(i + 1, GFP_KERNEL);
 478         if (smack != NULL) {
 479                 strncpy(smack, string, i + 1);
 480                 smack[i] = '\0';
 481         }
 482         return smack;
 483 }
 484
 485 /**
 486  * smk_netlbl_mls - convert a catset to netlabel mls categories
 487  * @catset: the Smack categories
 488  * @sap: where to put the netlabel categories
 489  *
 490  * Allocates and fills attr.mls
 491  * Returns 0 on success, error code on failure.
 492  */
 493 int smk_netlbl_mls(int level, char *catset, struct netlbl_lsm_secattr *sap,
 494                         int len)
 495 {
 496         unsigned char *cp;
 497         unsigned char m;
 498         int cat;
 499         int rc;
 500         int byte;
 501
 502         sap->flags |= NETLBL_SECATTR_MLS_CAT;
 503         sap->attr.mls.lvl = level;
 504         sap->attr.mls.cat = netlbl_secattr_catmap_alloc(GFP_ATOMIC);
 505         if (!sap->attr.mls.cat)
 506                 return -ENOMEM;
 507         sap->attr.mls.cat->startbit = 0;
 508
 509         for (cat = 1, cp = catset, byte = 0; byte < len; cp++, byte++)
 510                 for (m = 0x80; m != 0; m >>= 1, cat++) {
 511                         if ((m & *cp) == 0)
 512                                 continue;
 513                         rc = netlbl_secattr_catmap_setbit(sap->attr.mls.cat,
 514                                                           cat, GFP_ATOMIC);
 515                         if (rc < 0) {
 516                                 netlbl_secattr_catmap_free(sap->attr.mls.cat);
 517                                 return rc;
 518                         }
 519                 }
 520
 521         return 0;
 522 }
 523
 524 /**
 525  * smk_import_entry - import a label, return the list entry
 526  * @string: a text string that might be a Smack label
 527  * @len: the maximum size, or zero if it is NULL terminated.
 528  *
 529  * Returns a pointer to the entry in the label list that
 530  * matches the passed string, adding it if necessary.
 531  */
 532 struct smack_known *smk_import_entry(const char *string, int len)
 533 {
 534         struct smack_known *skp;
 535         char *smack;
 536         int slen;
 537         int rc;
 538
 539         smack = smk_parse_smack(string, len);
 540         if (smack == NULL)
 541                 return NULL;
 542
 543         mutex_lock(&smack_known_lock);
 544
 545         skp = smk_find_entry(smack);
 546         if (skp != NULL)
 547                 goto freeout;
 548
 549         skp = kzalloc(sizeof(*skp), GFP_KERNEL);
 550         if (skp == NULL)
 551                 goto freeout;
 552
 553         skp->smk_known = smack;
 554         skp->smk_secid = smack_next_secid++;
 555         skp->smk_netlabel.domain = skp->smk_known;
 556         skp->smk_netlabel.flags =
 557                 NETLBL_SECATTR_DOMAIN | NETLBL_SECATTR_MLS_LVL;
 558         /*
 559          * If direct labeling works use it.
 560          * Otherwise use mapped labeling.
 561          */
 562         slen = strlen(smack);
 563         if (slen < SMK_CIPSOLEN)
 564                 rc = smk_netlbl_mls(smack_cipso_direct, skp->smk_known,
 565                                &skp->smk_netlabel, slen);
 566         else
 567                 rc = smk_netlbl_mls(smack_cipso_mapped, (char *)&skp->smk_secid,
 568                                &skp->smk_netlabel, sizeof(skp->smk_secid));
 569
 570         if (rc >= 0) {
 571                 INIT_LIST_HEAD(&skp->smk_rules);
 572                 mutex_init(&skp->smk_rules_lock);
 573                 /*
 574                  * Make sure that the entry is actually
 575                  * filled before putting it on the list.
 576                  */
 577                 smk_insert_entry(skp);
 578                 goto unlockout;
 579         }
 580         /*
 581          * smk_netlbl_mls failed.
 582          */
 583         kfree(skp);
 584         skp = NULL;
 585 freeout:
 586         kfree(smack);
 587 unlockout:
 588         mutex_unlock(&smack_known_lock);
 589
 590         return skp;
 591 }
 592
 593 /**
 594  * smk_import - import a smack label
 595  * @string: a text string that might be a Smack label
 596  * @len: the maximum size, or zero if it is NULL terminated.
 597  *
 598  * Returns a pointer to the label in the label list that
 599  * matches the passed string, adding it if necessary.
 600  */
 601 char *smk_import(const char *string, int len)
 602 {
 603         struct smack_known *skp;
 604
 605         /* labels cannot begin with a '-' */
 606         if (string[0] == '-')
 607                 return NULL;
 608         skp = smk_import_entry(string, len);
 609         if (skp == NULL)
 610                 return NULL;
 611         return skp->smk_known;
 612 }
 613
 614 /**
 615  * smack_from_secid - find the Smack label associated with a secid
 616  * @secid: an integer that might be associated with a Smack label
 617  *
 618  * Returns a pointer to the appropriate Smack label entry if there is one,
 619  * otherwise a pointer to the invalid Smack label.
 620  */
 621 struct smack_known *smack_from_secid(const u32 secid)
 622 {
 623         struct smack_known *skp;
 624
 625         rcu_read_lock();
 626         list_for_each_entry_rcu(skp, &smack_known_list, list) {
 627                 if (skp->smk_secid == secid) {
 628                         rcu_read_unlock();
 629                         return skp;
 630                 }
 631         }
 632
 633         /*
 634          * If we got this far someone asked for the translation
 635          * of a secid that is not on the list.
 636          */
 637         rcu_read_unlock();
 638         return &smack_known_invalid;
 639 }
 640
 641 /**
 642  * smack_to_secid - find the secid associated with a Smack label
 643  * @smack: the Smack label
 644  *
 645  * Returns the appropriate secid if there is one,
 646  * otherwise 0
 647  */
 648 u32 smack_to_secid(const char *smack)
 649 {
 650         struct smack_known *skp = smk_find_entry(smack);
 651
 652         if (skp == NULL)
 653                 return 0;
 654         return skp->smk_secid;
 655 }
 656
 657 /*
 658  * Unless a process is running with one of these labels
 659  * even having CAP_MAC_OVERRIDE isn't enough to grant
 660  * privilege to violate MAC policy. If no labels are
 661  * designated (the empty list case) capabilities apply to
 662  * everyone.
 663  */
 664 LIST_HEAD(smack_onlycap_list);
 665 DEFINE_MUTEX(smack_onlycap_lock);
 666
 667 /*
 668  * Is the task privileged and allowed to be privileged
 669  * by the onlycap rule.
 670  *
 671  * Returns 1 if the task is allowed to be privileged, 0 if it's not.
 672  */
 673 int smack_privileged(int cap)
 674 {
 675         struct smack_known *skp = smk_of_current();
 676         struct smack_onlycap *sop;
 677
 678         /*
 679          * All kernel tasks are privileged
 680          */
 681         if (unlikely(current->flags & PF_KTHREAD))
 682                 return 1;
 683
 684         if (!capable(cap))
 685                 return 0;
 686
 687         rcu_read_lock();
 688         if (list_empty(&smack_onlycap_list)) {
 689                 rcu_read_unlock();
 690                 return 1;
 691         }
 692
 693         list_for_each_entry_rcu(sop, &smack_onlycap_list, list) {
 694                 if (sop->smk_label == skp) {
 695                         rcu_read_unlock();
 696                         return 1;
 697                 }
 698         }
 699         rcu_read_unlock();
 700
 701         return 0;
 702 }