share/man/man4/mac_biba.4

   1 .\" Copyright (c) 2002-2004 Networks Associates Technology, Inc.
   2 .\" All rights reserved.
   3 .\"
   4 .\" This software was developed for the FreeBSD Project by Chris Costello
   5 .\" at Safeport Network Services and Network Associates Laboratories, the
   6 .\" Security Research Division of Network Associates, Inc. under
   7 .\" DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"), as part of the
   8 .\" DARPA CHATS research program.
   9 .\"
  10 .\" Redistribution and use in source and binary forms, with or without
  11 .\" modification, are permitted provided that the following conditions
  12 .\" are met:
  13 .\" 1. Redistributions of source code must retain the above copyright
  14 .\"    notice, this list of conditions and the following disclaimer.
  15 .\" 2. Redistributions in binary form must reproduce the above copyright
  16 .\"    notice, this list of conditions and the following disclaimer in the
  17 .\"    documentation and/or other materials provided with the distribution.
  18 .\"
  19 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND
  20 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  21 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  22 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE
  23 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  24 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  25 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  26 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  27 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  28 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  29 .\" SUCH DAMAGE.
  30 .\"
  31 .\" $FreeBSD$
  32 .\"
  33 .Dd November 18, 2002
  34 .Os
  35 .Dt MAC_BIBA 4
  36 .Sh NAME
  37 .Nm mac_biba
  38 .Nd "Biba data integrity policy"
  39 .Sh SYNOPSIS
  40 To compile Biba into your kernel, place the following lines in your kernel
  41 configuration file:
  42 .Bd -ragged -offset indent
  43 .Cd "options MAC"
  44 .Cd "options MAC_BIBA"
  45 .Ed
  46 .Pp
  47 Alternately, to load the Biba module at boot time, place the following line
  48 in your kernel configuration file:
  49 .Bd -ragged -offset indent
  50 .Cd "options MAC"
  51 .Ed
  52 .Pp
  53 and in
  54 .Xr loader.conf 5 :
  55 .Bd -literal -offset indent
  56 mac_biba_load="YES"
  57 .Ed
  58 .Sh DESCRIPTION
  59 The
  60 .Nm
  61 policy module implements the Biba integrity model,
  62 which protects the integrity of system objects and subjects by means of
  63 a strict information flow policy.
  64 In Biba, all system subjects and objects are assigned integrity labels, made
  65 up of hierarchal grades, and non-hierarchal components.
  66 Together, these label elements permit all labels to be placed in a partial
  67 order, with information flow protections based on a dominance operator
  68 describing the order.
  69 The hierarchal grade field is expressed as a value between 0 and 65535,
  70 with higher values reflecting higher integrity.
  71 The non-hierarchal compartment field is expressed as a set of up to 256
  72 components, numbered from 0 to 255.
  73 A complete label consists of both hierarchal and non-hierarchal elements.
  74 .Pp
  75 Three special label values exist:
  76 .Bl -column -offset indent ".Li biba/equal" "lower than all other labels"
  77 .It Sy Label Ta Sy Comparison
  78 .It Li biba/low Ta "lower than all other labels"
  79 .It Li biba/equal Ta "equal to all other labels"
  80 .It Li biba/high Ta "higher than all other labels"
  81 .El
  82 .Pp
  83 The
  84 .Dq Li biba/high
  85 label is assigned to system objects which affect the integrity of the system
  86 as a whole.
  87 The
  88 .Dq Li biba/equal
  89 label
  90 may be used to indicate that a particular subject or object is exempt from
  91 the Biba protections.
  92 These special label values are not specified as containing any compartments,
  93 although in a label comparison,
  94 .Dq Li biba/high
  95 appears to contain all compartments,
  96 .Dq Li biba/equal
  97 the same compartments as the other label to which it is being compared,
  98 and
  99 .Dq Li biba/low
 100 none.
 101 .Pp
 102 In general, Biba access control takes the following model:
 103 .Bl -bullet
 104 .It
 105 A subject at the same integrity level as an object may both read from
 106 and write to the object as though Biba protections were not in place.
 107 .It
 108 A subject at a higher integrity level than an object may write to the object,
 109 but not read the object.
 110 .It
 111 A subject at a lower integrity level than an object may read the object,
 112 but not write to the object.
 113 .It
 114 If the subject and object labels may not be compared in the partial order,
 115 all access is restricted.
 116 .El
 117 .Pp
 118 These rules prevent subjects of lower integrity from influencing the
 119 behavior of higher integrity subjects by preventing the flow of information,
 120 and hence control, from allowing low integrity subjects to modify either
 121 a high integrity object or high integrity subjects acting on those objects.
 122 Biba integrity policies may be appropriate in a number of environments,
 123 both from the perspective of preventing corruption of the operating system,
 124 and corruption of user data if marked as higher integrity than the attacker.
 125 In traditional trusted operating systems, the Biba integrity model is used
 126 to protect the Trusted Code Base (TCB).
 127 .Pp
 128 The Biba integrity model is similar to
 129 .Xr mac_lomac 4 ,
 130 with the exception that LOMAC permits access by a higher integrity subject
 131 to a lower integrity object, but downgrades the integrity level of the subject
 132 to prevent integrity rules from being violated.
 133 Biba is a fixed label policy in that all subject and object label changes are
 134 explicit, whereas LOMAC is a floating label policy.
 135 .Pp
 136 The Biba integrity model is also similar to
 137 .Xr mac_mls 4 ,
 138 with the exception that the dominance operator and access rules are reversed,
 139 preventing the downward flow of information rather than the upward flow of
 140 information.
 141 Multi-Level Security (MLS) protects the confidentiality, rather than the
 142 integrity, of subjects and objects.
 143 .Ss Label Format
 144 Almost all system objects are tagged with an effective, active label element,
 145 reflecting the integrity of the object, or integrity of the data contained
 146 in the object.
 147 In general, objects labels are represented in the following form:
 148 .Pp
 149 .Sm off
 150 .D1 Li biba / Ar grade : compartments
 151 .Sm on
 152 .Pp
 153 For example:
 154 .Pp
 155 .Bd -literal -offset indent
 156 biba/10:2+3+6
 157 biba/low
 158 .Ed
 159 .Pp
 160 Subject labels consist of three label elements: an effective (active) label,
 161 as well as a range of available labels.
 162 This range is represented using two ordered Biba label elements, and when set
 163 on a process, permits the process to change its active label to any label of
 164 greater or equal integrity to the low end of the range, and lesser or equal
 165 integrity to the high end of the range.
 166 In general, subject labels are represented in the following form:
 167 .Pp
 168 .Sm off
 169 .D1 Li biba / Ar effectivegrade : effectivecompartments ( lograde : locompartments -
 170 .D1 Ar higrade : hicompartments )
 171 .Sm on
 172 .Pp
 173 For example:
 174 .Bd -literal -offset indent
 175 biba/10:2+3+6(5:2+3-20:2+3+4+5+6)
 176 biba/high(low-high)
 177 .Ed
 178 .Pp
 179 Valid ranged labels must meet the following requirement regarding their
 180 elements:
 181 .Pp
 182 .D1 Ar rangehigh No \[>=] Ar effective No \[>=] Ar rangelow
 183 .Pp
 184 One class of objects with ranges currently exists, the network interface.
 185 In the case of the network interface, the effective label element references the
 186 default label for packets received over the interface, and the range
 187 represents the range of acceptable labels of packets to be transmitted over
 188 the interface.
 189 .Ss Runtime Configuration
 190 The following
 191 .Xr sysctl 8
 192 MIBs are available for fine-tuning the enforcement of this MAC policy.
 193 .Bl -tag -width ".Va security.mac.biba.ptys_equal"
 194 .It Va security.mac.biba.enabled
 195 Enables enforcement of the Biba integrity policy.
 196 (Default: 1).
 197 .It Va security.mac.biba.ptys_equal
 198 Label
 199 .Xr pty 4 Ns s
 200 as
 201 .Dq Li biba/equal
 202 upon creation.
 203 (Default: 0).
 204 .It Va security.mac.biba.revocation_enabled
 205 Revoke access to objects if the label is changed to dominate the subject.
 206 (Default: 0).
 207 .El
 208 .Sh SEE ALSO
 209 .Xr mac 4 ,
 210 .Xr mac_bsdextended 4 ,
 211 .Xr mac_ifoff 4 ,
 212 .Xr mac_lomac 4 ,
 213 .Xr mac_mls 4 ,
 214 .Xr mac_none 4 ,
 215 .Xr mac_partition 4 ,
 216 .Xr mac_portacl 4 ,
 217 .Xr mac_seeotheruids 4 ,
 218 .Xr mac_test 4 ,
 219 .Xr maclabel 7 ,
 220 .Xr mac 9
 221 .Sh HISTORY
 222 The
 223 .Nm
 224 policy module first appeared in
 225 .Fx 5.0
 226 and was developed by the
 227 .Tn TrustedBSD
 228 Project.
 229 .Sh AUTHORS
 230 This software was contributed to the
 231 .Fx
 232 Project by Network Associates Labs,
 233 the Security Research Division of Network Associates
 234 Inc.
 235 under DARPA/SPAWAR contract N66001-01-C-8035
 236 .Pq Dq CBOSS ,
 237 as part of the DARPA CHATS research program.