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 == 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_label: a pointer to the subject's Smack label
 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(char *subject_label, char *object_label, int request,
 126                struct smk_audit_info *a)
 127 {
 128         struct smack_known *skp;
 129         int may = MAY_NOT;
 130         int rc = 0;
 131
 132         /*
 133          * Hardcoded comparisons.
 134          *
 135          * A star subject can't access any object.
 136          */
 137         if (subject_label == smack_known_star.smk_known) {
 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_label == smack_known_web.smk_known)
 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_label == object_label)
 159                 goto out_audit;
 160         /*
 161          * A hat subject can read any object.
 162          * A floor object can be read by any subject.
 163          */
 164         if ((request & MAY_ANYREAD) == request) {
 165                 if (object_label == smack_known_floor.smk_known)
 166                         goto out_audit;
 167                 if (subject_label == smack_known_hat.smk_known)
 168                         goto out_audit;
 169         }
 170         /*
 171          * Beyond here an explicit relationship is required.
 172          * If the requested access is contained in the available
 173          * access (e.g. read is included in readwrite) it's
 174          * good. A negative response from smk_access_entry()
 175          * indicates there is no entry for this pair.
 176          */
 177         skp = smk_find_entry(subject_label);
 178         rcu_read_lock();
 179         may = smk_access_entry(subject_label, object_label, &skp->smk_rules);
 180         rcu_read_unlock();
 181
 182         if (may > 0 && (request & may) == request)
 183                 goto out_audit;
 184
 185         rc = -EACCES;
 186 out_audit:
 187 #ifdef CONFIG_AUDIT
 188         if (a)
 189                 smack_log(subject_label, object_label, request, rc, a);
 190 #endif
 191         return rc;
 192 }
 193
 194 /**
 195  * smk_curacc - determine if current has a specific access to an object
 196  * @obj_label: a pointer to the object's Smack label
 197  * @mode: the access requested, in "MAY" format
 198  * @a : common audit data
 199  *
 200  * This function checks the current subject label/object label pair
 201  * in the access rule list and returns 0 if the access is permitted,
 202  * non zero otherwise. It allows that current may have the capability
 203  * to override the rules.
 204  */
 205 int smk_curacc(char *obj_label, u32 mode, struct smk_audit_info *a)
 206 {
 207         struct task_smack *tsp = current_security();
 208         char *sp = smk_of_task(tsp);
 209         int may;
 210         int rc;
 211
 212         /*
 213          * Check the global rule list
 214          */
 215         rc = smk_access(sp, obj_label, mode, NULL);
 216         if (rc == 0) {
 217                 /*
 218                  * If there is an entry in the task's rule list
 219                  * it can further restrict access.
 220                  */
 221                 may = smk_access_entry(sp, obj_label, &tsp->smk_rules);
 222                 if (may < 0)
 223                         goto out_audit;
 224                 if ((mode & may) == mode)
 225                         goto out_audit;
 226                 rc = -EACCES;
 227         }
 228
 229         /*
 230          * Allow for priviliged to override policy.
 231          */
 232         if (rc != 0 && smack_privileged(CAP_MAC_OVERRIDE))
 233                 rc = 0;
 234
 235 out_audit:
 236 #ifdef CONFIG_AUDIT
 237         if (a)
 238                 smack_log(sp, obj_label, mode, rc, a);
 239 #endif
 240         return rc;
 241 }
 242
 243 #ifdef CONFIG_AUDIT
 244 /**
 245  * smack_str_from_perm : helper to transalate an int to a
 246  * readable string
 247  * @string : the string to fill
 248  * @access : the int
 249  *
 250  */
 251 static inline void smack_str_from_perm(char *string, int access)
 252 {
 253         int i = 0;
 254         if (access & MAY_READ)
 255                 string[i++] = 'r';
 256         if (access & MAY_WRITE)
 257                 string[i++] = 'w';
 258         if (access & MAY_EXEC)
 259                 string[i++] = 'x';
 260         if (access & MAY_APPEND)
 261                 string[i++] = 'a';
 262         if (access & MAY_TRANSMUTE)
 263                 string[i++] = 't';
 264         if (access & MAY_LOCK)
 265                 string[i++] = 'l';
 266         string[i] = '\0';
 267 }
 268 /**
 269  * smack_log_callback - SMACK specific information
 270  * will be called by generic audit code
 271  * @ab : the audit_buffer
 272  * @a  : audit_data
 273  *
 274  */
 275 static void smack_log_callback(struct audit_buffer *ab, void *a)
 276 {
 277         struct common_audit_data *ad = a;
 278         struct smack_audit_data *sad = &ad->smack_audit_data;
 279         audit_log_format(ab, "lsm=SMACK fn=%s action=%s",
 280                          ad->smack_audit_data.function,
 281                          sad->result ? "denied" : "granted");
 282         audit_log_format(ab, " subject=");
 283         audit_log_untrustedstring(ab, sad->subject);
 284         audit_log_format(ab, " object=");
 285         audit_log_untrustedstring(ab, sad->object);
 286         audit_log_format(ab, " requested=%s", sad->request);
 287 }
 288
 289 /**
 290  *  smack_log - Audit the granting or denial of permissions.
 291  *  @subject_label : smack label of the requester
 292  *  @object_label  : smack label of the object being accessed
 293  *  @request: requested permissions
 294  *  @result: result from smk_access
 295  *  @a:  auxiliary audit data
 296  *
 297  * Audit the granting or denial of permissions in accordance
 298  * with the policy.
 299  */
 300 void smack_log(char *subject_label, char *object_label, int request,
 301                int result, struct smk_audit_info *ad)
 302 {
 303         char request_buffer[SMK_NUM_ACCESS_TYPE + 1];
 304         struct smack_audit_data *sad;
 305         struct common_audit_data *a = &ad->a;
 306
 307         /* check if we have to log the current event */
 308         if (result != 0 && (log_policy & SMACK_AUDIT_DENIED) == 0)
 309                 return;
 310         if (result == 0 && (log_policy & SMACK_AUDIT_ACCEPT) == 0)
 311                 return;
 312
 313         if (a->smack_audit_data.function == NULL)
 314                 a->smack_audit_data.function = "unknown";
 315
 316         /* end preparing the audit data */
 317         sad = &a->smack_audit_data;
 318         smack_str_from_perm(request_buffer, request);
 319         sad->subject = subject_label;
 320         sad->object  = object_label;
 321         sad->request = request_buffer;
 322         sad->result  = result;
 323         a->lsm_pre_audit = smack_log_callback;
 324
 325         common_lsm_audit(a);
 326 }
 327 #else /* #ifdef CONFIG_AUDIT */
 328 void smack_log(char *subject_label, char *object_label, int request,
 329                int result, struct smk_audit_info *ad)
 330 {
 331 }
 332 #endif
 333
 334 DEFINE_MUTEX(smack_known_lock);
 335
 336 /**
 337  * smk_find_entry - find a label on the list, return the list entry
 338  * @string: a text string that might be a Smack label
 339  *
 340  * Returns a pointer to the entry in the label list that
 341  * matches the passed string.
 342  */
 343 struct smack_known *smk_find_entry(const char *string)
 344 {
 345         struct smack_known *skp;
 346
 347         list_for_each_entry_rcu(skp, &smack_known_list, list) {
 348                 if (strcmp(skp->smk_known, string) == 0)
 349                         return skp;
 350         }
 351
 352         return NULL;
 353 }
 354
 355 /**
 356  * smk_parse_smack - parse smack label from a text string
 357  * @string: a text string that might contain a Smack label
 358  * @len: the maximum size, or zero if it is NULL terminated.
 359  *
 360  * Returns a pointer to the clean label, or NULL
 361  */
 362 char *smk_parse_smack(const char *string, int len)
 363 {
 364         char *smack;
 365         int i;
 366
 367         if (len <= 0)
 368                 len = strlen(string) + 1;
 369
 370         /*
 371          * Reserve a leading '-' as an indicator that
 372          * this isn't a label, but an option to interfaces
 373          * including /smack/cipso and /smack/cipso2
 374          */
 375         if (string[0] == '-')
 376                 return NULL;
 377
 378         for (i = 0; i < len; i++)
 379                 if (string[i] > '~' || string[i] <= ' ' || string[i] == '/' ||
 380                     string[i] == '"' || string[i] == '\\' || string[i] == '\'')
 381                         break;
 382
 383         if (i == 0 || i >= SMK_LONGLABEL)
 384                 return NULL;
 385
 386         smack = kzalloc(i + 1, GFP_KERNEL);
 387         if (smack != NULL) {
 388                 strncpy(smack, string, i + 1);
 389                 smack[i] = '\0';
 390         }
 391         return smack;
 392 }
 393
 394 /**
 395  * smk_netlbl_mls - convert a catset to netlabel mls categories
 396  * @catset: the Smack categories
 397  * @sap: where to put the netlabel categories
 398  *
 399  * Allocates and fills attr.mls
 400  * Returns 0 on success, error code on failure.
 401  */
 402 int smk_netlbl_mls(int level, char *catset, struct netlbl_lsm_secattr *sap,
 403                         int len)
 404 {
 405         unsigned char *cp;
 406         unsigned char m;
 407         int cat;
 408         int rc;
 409         int byte;
 410
 411         sap->flags |= NETLBL_SECATTR_MLS_CAT;
 412         sap->attr.mls.lvl = level;
 413         sap->attr.mls.cat = netlbl_secattr_catmap_alloc(GFP_ATOMIC);
 414         sap->attr.mls.cat->startbit = 0;
 415
 416         for (cat = 1, cp = catset, byte = 0; byte < len; cp++, byte++)
 417                 for (m = 0x80; m != 0; m >>= 1, cat++) {
 418                         if ((m & *cp) == 0)
 419                                 continue;
 420                         rc = netlbl_secattr_catmap_setbit(sap->attr.mls.cat,
 421                                                           cat, GFP_ATOMIC);
 422                         if (rc < 0) {
 423                                 netlbl_secattr_catmap_free(sap->attr.mls.cat);
 424                                 return rc;
 425                         }
 426                 }
 427
 428         return 0;
 429 }
 430
 431 /**
 432  * smk_import_entry - import a label, return the list entry
 433  * @string: a text string that might be a Smack label
 434  * @len: the maximum size, or zero if it is NULL terminated.
 435  *
 436  * Returns a pointer to the entry in the label list that
 437  * matches the passed string, adding it if necessary.
 438  */
 439 struct smack_known *smk_import_entry(const char *string, int len)
 440 {
 441         struct smack_known *skp;
 442         char *smack;
 443         int slen;
 444         int rc;
 445
 446         smack = smk_parse_smack(string, len);
 447         if (smack == NULL)
 448                 return NULL;
 449
 450         mutex_lock(&smack_known_lock);
 451
 452         skp = smk_find_entry(smack);
 453         if (skp != NULL)
 454                 goto freeout;
 455
 456         skp = kzalloc(sizeof(*skp), GFP_KERNEL);
 457         if (skp == NULL)
 458                 goto freeout;
 459
 460         skp->smk_known = smack;
 461         skp->smk_secid = smack_next_secid++;
 462         skp->smk_netlabel.domain = skp->smk_known;
 463         skp->smk_netlabel.flags =
 464                 NETLBL_SECATTR_DOMAIN | NETLBL_SECATTR_MLS_LVL;
 465         /*
 466          * If direct labeling works use it.
 467          * Otherwise use mapped labeling.
 468          */
 469         slen = strlen(smack);
 470         if (slen < SMK_CIPSOLEN)
 471                 rc = smk_netlbl_mls(smack_cipso_direct, skp->smk_known,
 472                                &skp->smk_netlabel, slen);
 473         else
 474                 rc = smk_netlbl_mls(smack_cipso_mapped, (char *)&skp->smk_secid,
 475                                &skp->smk_netlabel, sizeof(skp->smk_secid));
 476
 477         if (rc >= 0) {
 478                 INIT_LIST_HEAD(&skp->smk_rules);
 479                 mutex_init(&skp->smk_rules_lock);
 480                 /*
 481                  * Make sure that the entry is actually
 482                  * filled before putting it on the list.
 483                  */
 484                 list_add_rcu(&skp->list, &smack_known_list);
 485                 goto unlockout;
 486         }
 487         /*
 488          * smk_netlbl_mls failed.
 489          */
 490         kfree(skp);
 491         skp = NULL;
 492 freeout:
 493         kfree(smack);
 494 unlockout:
 495         mutex_unlock(&smack_known_lock);
 496
 497         return skp;
 498 }
 499
 500 /**
 501  * smk_import - import a smack label
 502  * @string: a text string that might be a Smack label
 503  * @len: the maximum size, or zero if it is NULL terminated.
 504  *
 505  * Returns a pointer to the label in the label list that
 506  * matches the passed string, adding it if necessary.
 507  */
 508 char *smk_import(const char *string, int len)
 509 {
 510         struct smack_known *skp;
 511
 512         /* labels cannot begin with a '-' */
 513         if (string[0] == '-')
 514                 return NULL;
 515         skp = smk_import_entry(string, len);
 516         if (skp == NULL)
 517                 return NULL;
 518         return skp->smk_known;
 519 }
 520
 521 /**
 522  * smack_from_secid - find the Smack label associated with a secid
 523  * @secid: an integer that might be associated with a Smack label
 524  *
 525  * Returns a pointer to the appropriate Smack label if there is one,
 526  * otherwise a pointer to the invalid Smack label.
 527  */
 528 char *smack_from_secid(const u32 secid)
 529 {
 530         struct smack_known *skp;
 531
 532         rcu_read_lock();
 533         list_for_each_entry_rcu(skp, &smack_known_list, list) {
 534                 if (skp->smk_secid == secid) {
 535                         rcu_read_unlock();
 536                         return skp->smk_known;
 537                 }
 538         }
 539
 540         /*
 541          * If we got this far someone asked for the translation
 542          * of a secid that is not on the list.
 543          */
 544         rcu_read_unlock();
 545         return smack_known_invalid.smk_known;
 546 }
 547
 548 /**
 549  * smack_to_secid - find the secid associated with a Smack label
 550  * @smack: the Smack label
 551  *
 552  * Returns the appropriate secid if there is one,
 553  * otherwise 0
 554  */
 555 u32 smack_to_secid(const char *smack)
 556 {
 557         struct smack_known *skp = smk_find_entry(smack);
 558
 559         if (skp == NULL)
 560                 return 0;
 561         return skp->smk_secid;
 562 }