linux/security/selinux/ss/mls.c
<<
>>
Prefs
   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 */
  35int 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 */
  88void 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
 160int 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
 180int 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 */
 191int 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 */
 234int 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;
 367out:
 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 */
 377int 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 */
 402int 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
 419int 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 */
 462int 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
 505int 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 */
 579void 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 */
 599void 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 */
 619int 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 */
 647int 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)
 658                goto import_netlbl_cat_failure;
 659        memcpy(&context->range.level[1].cat, &context->range.level[0].cat,
 660               sizeof(context->range.level[0].cat));
 661
 662        return 0;
 663
 664import_netlbl_cat_failure:
 665        ebitmap_destroy(&context->range.level[0].cat);
 666        return rc;
 667}
 668#endif /* CONFIG_NETLABEL */
 669