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