1 /* 2 * Implementation of the multi-level security (MLS) policy. 3 * 4 * Author : Stephen Smalley, <sds@epoch.ncsc.mil> 5 */ 6 /* 7 * Updated: Trusted Computer Solutions, Inc. <dgoeddel@trustedcs.com> 8 * 9 * Support for enhanced MLS infrastructure. 10 * 11 * Copyright (C) 2004-2006 Trusted Computer Solutions, Inc. 12 */ 13 /* 14 * Updated: Hewlett-Packard <paul@paul-moore.com> 15 * 16 * Added support to import/export the MLS label from NetLabel 17 * 18 * (c) Copyright Hewlett-Packard Development Company, L.P., 2006 19 */ 20 21 #include <linux/kernel.h> 22 #include <linux/slab.h> 23 #include <linux/string.h> 24 #include <linux/errno.h> 25 #include <net/netlabel.h> 26 #include "sidtab.h" 27 #include "mls.h" 28 #include "policydb.h" 29 #include "services.h" 30 31 /* 32 * Return the length in bytes for the MLS fields of the 33 * security context string representation of `context'. 34 */ 35 int mls_compute_context_len(struct context *context) 36 { 37 int i, l, len, head, prev; 38 char *nm; 39 struct ebitmap *e; 40 struct ebitmap_node *node; 41 42 if (!policydb.mls_enabled) 43 return 0; 44 45 len = 1; /* for the beginning ":" */ 46 for (l = 0; l < 2; l++) { 47 int index_sens = context->range.level[l].sens; 48 len += strlen(sym_name(&policydb, SYM_LEVELS, index_sens - 1)); 49 50 /* categories */ 51 head = -2; 52 prev = -2; 53 e = &context->range.level[l].cat; 54 ebitmap_for_each_positive_bit(e, node, i) { 55 if (i - prev > 1) { 56 /* one or more negative bits are skipped */ 57 if (head != prev) { 58 nm = sym_name(&policydb, SYM_CATS, prev); 59 len += strlen(nm) + 1; 60 } 61 nm = sym_name(&policydb, SYM_CATS, i); 62 len += strlen(nm) + 1; 63 head = i; 64 } 65 prev = i; 66 } 67 if (prev != head) { 68 nm = sym_name(&policydb, SYM_CATS, prev); 69 len += strlen(nm) + 1; 70 } 71 if (l == 0) { 72 if (mls_level_eq(&context->range.level[0], 73 &context->range.level[1])) 74 break; 75 else 76 len++; 77 } 78 } 79 80 return len; 81 } 82 83 /* 84 * Write the security context string representation of 85 * the MLS fields of `context' into the string `*scontext'. 86 * Update `*scontext' to point to the end of the MLS fields. 87 */ 88 void mls_sid_to_context(struct context *context, 89 char **scontext) 90 { 91 char *scontextp, *nm; 92 int i, l, head, prev; 93 struct ebitmap *e; 94 struct ebitmap_node *node; 95 96 if (!policydb.mls_enabled) 97 return; 98 99 scontextp = *scontext; 100 101 *scontextp = ':'; 102 scontextp++; 103 104 for (l = 0; l < 2; l++) { 105 strcpy(scontextp, sym_name(&policydb, SYM_LEVELS, 106 context->range.level[l].sens - 1)); 107 scontextp += strlen(scontextp); 108 109 /* categories */ 110 head = -2; 111 prev = -2; 112 e = &context->range.level[l].cat; 113 ebitmap_for_each_positive_bit(e, node, i) { 114 if (i - prev > 1) { 115 /* one or more negative bits are skipped */ 116 if (prev != head) { 117 if (prev - head > 1) 118 *scontextp++ = '.'; 119 else 120 *scontextp++ = ','; 121 nm = sym_name(&policydb, SYM_CATS, prev); 122 strcpy(scontextp, nm); 123 scontextp += strlen(nm); 124 } 125 if (prev < 0) 126 *scontextp++ = ':'; 127 else 128 *scontextp++ = ','; 129 nm = sym_name(&policydb, SYM_CATS, i); 130 strcpy(scontextp, nm); 131 scontextp += strlen(nm); 132 head = i; 133 } 134 prev = i; 135 } 136 137 if (prev != head) { 138 if (prev - head > 1) 139 *scontextp++ = '.'; 140 else 141 *scontextp++ = ','; 142 nm = sym_name(&policydb, SYM_CATS, prev); 143 strcpy(scontextp, nm); 144 scontextp += strlen(nm); 145 } 146 147 if (l == 0) { 148 if (mls_level_eq(&context->range.level[0], 149 &context->range.level[1])) 150 break; 151 else 152 *scontextp++ = '-'; 153 } 154 } 155 156 *scontext = scontextp; 157 return; 158 } 159 160 int mls_level_isvalid(struct policydb *p, struct mls_level *l) 161 { 162 struct level_datum *levdatum; 163 164 if (!l->sens || l->sens > p->p_levels.nprim) 165 return 0; 166 levdatum = hashtab_search(p->p_levels.table, 167 sym_name(p, SYM_LEVELS, l->sens - 1)); 168 if (!levdatum) 169 return 0; 170 171 /* 172 * Return 1 iff all the bits set in l->cat are also be set in 173 * levdatum->level->cat and no bit in l->cat is larger than 174 * p->p_cats.nprim. 175 */ 176 return ebitmap_contains(&levdatum->level->cat, &l->cat, 177 p->p_cats.nprim); 178 } 179 180 int mls_range_isvalid(struct policydb *p, struct mls_range *r) 181 { 182 return (mls_level_isvalid(p, &r->level[0]) && 183 mls_level_isvalid(p, &r->level[1]) && 184 mls_level_dom(&r->level[1], &r->level[0])); 185 } 186 187 /* 188 * Return 1 if the MLS fields in the security context 189 * structure `c' are valid. Return 0 otherwise. 190 */ 191 int mls_context_isvalid(struct policydb *p, struct context *c) 192 { 193 struct user_datum *usrdatum; 194 195 if (!p->mls_enabled) 196 return 1; 197 198 if (!mls_range_isvalid(p, &c->range)) 199 return 0; 200 201 if (c->role == OBJECT_R_VAL) 202 return 1; 203 204 /* 205 * User must be authorized for the MLS range. 206 */ 207 if (!c->user || c->user > p->p_users.nprim) 208 return 0; 209 usrdatum = p->user_val_to_struct[c->user - 1]; 210 if (!mls_range_contains(usrdatum->range, c->range)) 211 return 0; /* user may not be associated with range */ 212 213 return 1; 214 } 215 216 /* 217 * Set the MLS fields in the security context structure 218 * `context' based on the string representation in 219 * the string `*scontext'. Update `*scontext' to 220 * point to the end of the string representation of 221 * the MLS fields. 222 * 223 * This function modifies the string in place, inserting 224 * NULL characters to terminate the MLS fields. 225 * 226 * If a def_sid is provided and no MLS field is present, 227 * copy the MLS field of the associated default context. 228 * Used for upgraded to MLS systems where objects may lack 229 * MLS fields. 230 * 231 * Policy read-lock must be held for sidtab lookup. 232 * 233 */ 234 int mls_context_to_sid(struct policydb *pol, 235 char oldc, 236 char **scontext, 237 struct context *context, 238 struct sidtab *s, 239 u32 def_sid) 240 { 241 242 char delim; 243 char *scontextp, *p, *rngptr; 244 struct level_datum *levdatum; 245 struct cat_datum *catdatum, *rngdatum; 246 int l, rc = -EINVAL; 247 248 if (!pol->mls_enabled) { 249 if (def_sid != SECSID_NULL && oldc) 250 *scontext += strlen(*scontext) + 1; 251 return 0; 252 } 253 254 /* 255 * No MLS component to the security context, try and map to 256 * default if provided. 257 */ 258 if (!oldc) { 259 struct context *defcon; 260 261 if (def_sid == SECSID_NULL) 262 goto out; 263 264 defcon = sidtab_search(s, def_sid); 265 if (!defcon) 266 goto out; 267 268 rc = mls_context_cpy(context, defcon); 269 goto out; 270 } 271 272 /* Extract low sensitivity. */ 273 scontextp = p = *scontext; 274 while (*p && *p != ':' && *p != '-') 275 p++; 276 277 delim = *p; 278 if (delim != '\0') 279 *p++ = '\0'; 280 281 for (l = 0; l < 2; l++) { 282 levdatum = hashtab_search(pol->p_levels.table, scontextp); 283 if (!levdatum) { 284 rc = -EINVAL; 285 goto out; 286 } 287 288 context->range.level[l].sens = levdatum->level->sens; 289 290 if (delim == ':') { 291 /* Extract category set. */ 292 while (1) { 293 scontextp = p; 294 while (*p && *p != ',' && *p != '-') 295 p++; 296 delim = *p; 297 if (delim != '\0') 298 *p++ = '\0'; 299 300 /* Separate into range if exists */ 301 rngptr = strchr(scontextp, '.'); 302 if (rngptr != NULL) { 303 /* Remove '.' */ 304 *rngptr++ = '\0'; 305 } 306 307 catdatum = hashtab_search(pol->p_cats.table, 308 scontextp); 309 if (!catdatum) { 310 rc = -EINVAL; 311 goto out; 312 } 313 314 rc = ebitmap_set_bit(&context->range.level[l].cat, 315 catdatum->value - 1, 1); 316 if (rc) 317 goto out; 318 319 /* If range, set all categories in range */ 320 if (rngptr) { 321 int i; 322 323 rngdatum = hashtab_search(pol->p_cats.table, rngptr); 324 if (!rngdatum) { 325 rc = -EINVAL; 326 goto out; 327 } 328 329 if (catdatum->value >= rngdatum->value) { 330 rc = -EINVAL; 331 goto out; 332 } 333 334 for (i = catdatum->value; i < rngdatum->value; i++) { 335 rc = ebitmap_set_bit(&context->range.level[l].cat, i, 1); 336 if (rc) 337 goto out; 338 } 339 } 340 341 if (delim != ',') 342 break; 343 } 344 } 345 if (delim == '-') { 346 /* Extract high sensitivity. */ 347 scontextp = p; 348 while (*p && *p != ':') 349 p++; 350 351 delim = *p; 352 if (delim != '\0') 353 *p++ = '\0'; 354 } else 355 break; 356 } 357 358 if (l == 0) { 359 context->range.level[1].sens = context->range.level[0].sens; 360 rc = ebitmap_cpy(&context->range.level[1].cat, 361 &context->range.level[0].cat); 362 if (rc) 363 goto out; 364 } 365 *scontext = ++p; 366 rc = 0; 367 out: 368 return rc; 369 } 370 371 /* 372 * Set the MLS fields in the security context structure 373 * `context' based on the string representation in 374 * the string `str'. This function will allocate temporary memory with the 375 * given constraints of gfp_mask. 376 */ 377 int mls_from_string(char *str, struct context *context, gfp_t gfp_mask) 378 { 379 char *tmpstr, *freestr; 380 int rc; 381 382 if (!policydb.mls_enabled) 383 return -EINVAL; 384 385 /* we need freestr because mls_context_to_sid will change 386 the value of tmpstr */ 387 tmpstr = freestr = kstrdup(str, gfp_mask); 388 if (!tmpstr) { 389 rc = -ENOMEM; 390 } else { 391 rc = mls_context_to_sid(&policydb, ':', &tmpstr, context, 392 NULL, SECSID_NULL); 393 kfree(freestr); 394 } 395 396 return rc; 397 } 398 399 /* 400 * Copies the MLS range `range' into `context'. 401 */ 402 int mls_range_set(struct context *context, 403 struct mls_range *range) 404 { 405 int l, rc = 0; 406 407 /* Copy the MLS range into the context */ 408 for (l = 0; l < 2; l++) { 409 context->range.level[l].sens = range->level[l].sens; 410 rc = ebitmap_cpy(&context->range.level[l].cat, 411 &range->level[l].cat); 412 if (rc) 413 break; 414 } 415 416 return rc; 417 } 418 419 int mls_setup_user_range(struct context *fromcon, struct user_datum *user, 420 struct context *usercon) 421 { 422 if (policydb.mls_enabled) { 423 struct mls_level *fromcon_sen = &(fromcon->range.level[0]); 424 struct mls_level *fromcon_clr = &(fromcon->range.level[1]); 425 struct mls_level *user_low = &(user->range.level[0]); 426 struct mls_level *user_clr = &(user->range.level[1]); 427 struct mls_level *user_def = &(user->dfltlevel); 428 struct mls_level *usercon_sen = &(usercon->range.level[0]); 429 struct mls_level *usercon_clr = &(usercon->range.level[1]); 430 431 /* Honor the user's default level if we can */ 432 if (mls_level_between(user_def, fromcon_sen, fromcon_clr)) 433 *usercon_sen = *user_def; 434 else if (mls_level_between(fromcon_sen, user_def, user_clr)) 435 *usercon_sen = *fromcon_sen; 436 else if (mls_level_between(fromcon_clr, user_low, user_def)) 437 *usercon_sen = *user_low; 438 else 439 return -EINVAL; 440 441 /* Lower the clearance of available contexts 442 if the clearance of "fromcon" is lower than 443 that of the user's default clearance (but 444 only if the "fromcon" clearance dominates 445 the user's computed sensitivity level) */ 446 if (mls_level_dom(user_clr, fromcon_clr)) 447 *usercon_clr = *fromcon_clr; 448 else if (mls_level_dom(fromcon_clr, user_clr)) 449 *usercon_clr = *user_clr; 450 else 451 return -EINVAL; 452 } 453 454 return 0; 455 } 456 457 /* 458 * Convert the MLS fields in the security context 459 * structure `c' from the values specified in the 460 * policy `oldp' to the values specified in the policy `newp'. 461 */ 462 int mls_convert_context(struct policydb *oldp, 463 struct policydb *newp, 464 struct context *c) 465 { 466 struct level_datum *levdatum; 467 struct cat_datum *catdatum; 468 struct ebitmap bitmap; 469 struct ebitmap_node *node; 470 int l, i; 471 472 if (!policydb.mls_enabled) 473 return 0; 474 475 for (l = 0; l < 2; l++) { 476 levdatum = hashtab_search(newp->p_levels.table, 477 sym_name(oldp, SYM_LEVELS, 478 c->range.level[l].sens - 1)); 479 480 if (!levdatum) 481 return -EINVAL; 482 c->range.level[l].sens = levdatum->level->sens; 483 484 ebitmap_init(&bitmap); 485 ebitmap_for_each_positive_bit(&c->range.level[l].cat, node, i) { 486 int rc; 487 488 catdatum = hashtab_search(newp->p_cats.table, 489 sym_name(oldp, SYM_CATS, i)); 490 if (!catdatum) 491 return -EINVAL; 492 rc = ebitmap_set_bit(&bitmap, catdatum->value - 1, 1); 493 if (rc) 494 return rc; 495 496 cond_resched(); 497 } 498 ebitmap_destroy(&c->range.level[l].cat); 499 c->range.level[l].cat = bitmap; 500 } 501 502 return 0; 503 } 504 505 int mls_compute_sid(struct context *scontext, 506 struct context *tcontext, 507 u16 tclass, 508 u32 specified, 509 struct context *newcontext, 510 bool sock) 511 { 512 struct range_trans rtr; 513 struct mls_range *r; 514 struct class_datum *cladatum; 515 int default_range = 0; 516 517 if (!policydb.mls_enabled) 518 return 0; 519 520 switch (specified) { 521 case AVTAB_TRANSITION: 522 /* Look for a range transition rule. */ 523 rtr.source_type = scontext->type; 524 rtr.target_type = tcontext->type; 525 rtr.target_class = tclass; 526 r = hashtab_search(policydb.range_tr, &rtr); 527 if (r) 528 return mls_range_set(newcontext, r); 529 530 if (tclass && tclass <= policydb.p_classes.nprim) { 531 cladatum = policydb.class_val_to_struct[tclass - 1]; 532 if (cladatum) 533 default_range = cladatum->default_range; 534 } 535 536 switch (default_range) { 537 case DEFAULT_SOURCE_LOW: 538 return mls_context_cpy_low(newcontext, scontext); 539 case DEFAULT_SOURCE_HIGH: 540 return mls_context_cpy_high(newcontext, scontext); 541 case DEFAULT_SOURCE_LOW_HIGH: 542 return mls_context_cpy(newcontext, scontext); 543 case DEFAULT_TARGET_LOW: 544 return mls_context_cpy_low(newcontext, tcontext); 545 case DEFAULT_TARGET_HIGH: 546 return mls_context_cpy_high(newcontext, tcontext); 547 case DEFAULT_TARGET_LOW_HIGH: 548 return mls_context_cpy(newcontext, tcontext); 549 } 550 551 /* Fallthrough */ 552 case AVTAB_CHANGE: 553 if ((tclass == policydb.process_class) || (sock == true)) 554 /* Use the process MLS attributes. */ 555 return mls_context_cpy(newcontext, scontext); 556 else 557 /* Use the process effective MLS attributes. */ 558 return mls_context_cpy_low(newcontext, scontext); 559 case AVTAB_MEMBER: 560 /* Use the process effective MLS attributes. */ 561 return mls_context_cpy_low(newcontext, scontext); 562 563 /* fall through */ 564 } 565 return -EINVAL; 566 } 567 568 #ifdef CONFIG_NETLABEL 569 /** 570 * mls_export_netlbl_lvl - Export the MLS sensitivity levels to NetLabel 571 * @context: the security context 572 * @secattr: the NetLabel security attributes 573 * 574 * Description: 575 * Given the security context copy the low MLS sensitivity level into the 576 * NetLabel MLS sensitivity level field. 577 * 578 */ 579 void mls_export_netlbl_lvl(struct context *context, 580 struct netlbl_lsm_secattr *secattr) 581 { 582 if (!policydb.mls_enabled) 583 return; 584 585 secattr->attr.mls.lvl = context->range.level[0].sens - 1; 586 secattr->flags |= NETLBL_SECATTR_MLS_LVL; 587 } 588 589 /** 590 * mls_import_netlbl_lvl - Import the NetLabel MLS sensitivity levels 591 * @context: the security context 592 * @secattr: the NetLabel security attributes 593 * 594 * Description: 595 * Given the security context and the NetLabel security attributes, copy the 596 * NetLabel MLS sensitivity level into the context. 597 * 598 */ 599 void mls_import_netlbl_lvl(struct context *context, 600 struct netlbl_lsm_secattr *secattr) 601 { 602 if (!policydb.mls_enabled) 603 return; 604 605 context->range.level[0].sens = secattr->attr.mls.lvl + 1; 606 context->range.level[1].sens = context->range.level[0].sens; 607 } 608 609 /** 610 * mls_export_netlbl_cat - Export the MLS categories to NetLabel 611 * @context: the security context 612 * @secattr: the NetLabel security attributes 613 * 614 * Description: 615 * Given the security context copy the low MLS categories into the NetLabel 616 * MLS category field. Returns zero on success, negative values on failure. 617 * 618 */ 619 int mls_export_netlbl_cat(struct context *context, 620 struct netlbl_lsm_secattr *secattr) 621 { 622 int rc; 623 624 if (!policydb.mls_enabled) 625 return 0; 626 627 rc = ebitmap_netlbl_export(&context->range.level[0].cat, 628 &secattr->attr.mls.cat); 629 if (rc == 0 && secattr->attr.mls.cat != NULL) 630 secattr->flags |= NETLBL_SECATTR_MLS_CAT; 631 632 return rc; 633 } 634 635 /** 636 * mls_import_netlbl_cat - Import the MLS categories from NetLabel 637 * @context: the security context 638 * @secattr: the NetLabel security attributes 639 * 640 * Description: 641 * Copy the NetLabel security attributes into the SELinux context; since the 642 * NetLabel security attribute only contains a single MLS category use it for 643 * both the low and high categories of the context. Returns zero on success, 644 * negative values on failure. 645 * 646 */ 647 int mls_import_netlbl_cat(struct context *context, 648 struct netlbl_lsm_secattr *secattr) 649 { 650 int rc; 651 652 if (!policydb.mls_enabled) 653 return 0; 654 655 rc = ebitmap_netlbl_import(&context->range.level[0].cat, 656 secattr->attr.mls.cat); 657 if (rc != 0) 658 goto import_netlbl_cat_failure; 659 660 rc = ebitmap_cpy(&context->range.level[1].cat, 661 &context->range.level[0].cat); 662 if (rc != 0) 663 goto import_netlbl_cat_failure; 664 665 return 0; 666 667 import_netlbl_cat_failure: 668 ebitmap_destroy(&context->range.level[0].cat); 669 ebitmap_destroy(&context->range.level[1].cat); 670 return rc; 671 } 672 #endif /* CONFIG_NETLABEL */ 673