1 // SPDX-License-Identifier: GPL-2.0-only
3 * Copyright (C) 2007 Casey Schaufler <casey@schaufler-ca.com>
6 * Casey Schaufler <casey@schaufler-ca.com>
9 #include <linux/types.h>
10 #include <linux/slab.h>
12 #include <linux/sched.h>
15 struct smack_known smack_known_huh
= {
20 struct smack_known smack_known_hat
= {
25 struct smack_known smack_known_star
= {
30 struct smack_known smack_known_floor
= {
35 struct smack_known smack_known_web
= {
40 LIST_HEAD(smack_known_list
);
43 * The initial value needs to be bigger than any of the
46 static u32 smack_next_secid
= 10;
49 * what events do we log
50 * can be overwritten at run-time by /smack/logging
52 int log_policy
= SMACK_AUDIT_DENIED
;
55 * smk_access_entry - look up matching access rule
56 * @subject_label: a pointer to the subject's Smack label
57 * @object_label: a pointer to the object's Smack label
58 * @rule_list: the list of rules to search
60 * This function looks up the subject/object pair in the
61 * access rule list and returns the access mode. If no
62 * entry is found returns -ENOENT.
66 * Earlier versions of this function allowed for labels that
67 * were not on the label list. This was done to allow for
68 * labels to come over the network that had never been seen
69 * before on this host. Unless the receiving socket has the
70 * star label this will always result in a failure check. The
71 * star labeled socket case is now handled in the networking
72 * hooks so there is no case where the label is not on the
73 * label list. Checking to see if the address of two labels
74 * is the same is now a reliable test.
76 * Do the object check first because that is more
79 * Allowing write access implies allowing locking.
81 int smk_access_entry(char *subject_label
, char *object_label
,
82 struct list_head
*rule_list
)
85 struct smack_rule
*srp
;
87 list_for_each_entry_rcu(srp
, rule_list
, list
) {
88 if (srp
->smk_object
->smk_known
== object_label
&&
89 srp
->smk_subject
->smk_known
== subject_label
) {
90 may
= srp
->smk_access
;
96 * MAY_WRITE implies MAY_LOCK.
98 if ((may
& MAY_WRITE
) == MAY_WRITE
)
104 * smk_access - determine if a subject has a specific access to an object
105 * @subject: a pointer to the subject's Smack label entry
106 * @object: a pointer to the object's Smack label entry
107 * @request: the access requested, in "MAY" format
108 * @a : a pointer to the audit data
110 * This function looks up the subject/object pair in the
111 * access rule list and returns 0 if the access is permitted,
112 * non zero otherwise.
114 * Smack labels are shared on smack_list
116 int smk_access(struct smack_known
*subject
, struct smack_known
*object
,
117 int request
, struct smk_audit_info
*a
)
123 * Hardcoded comparisons.
126 * A star subject can't access any object.
128 if (subject
== &smack_known_star
) {
133 * An internet object can be accessed by any subject.
134 * Tasks cannot be assigned the internet label.
135 * An internet subject can access any object.
137 if (object
== &smack_known_web
|| subject
== &smack_known_web
)
140 * A star object can be accessed by any subject.
142 if (object
== &smack_known_star
)
145 * An object can be accessed in any way by a subject
146 * with the same label.
148 if (subject
->smk_known
== object
->smk_known
)
151 * A hat subject can read or lock any object.
152 * A floor object can be read or locked by any subject.
154 if ((request
& MAY_ANYREAD
) == request
||
155 (request
& MAY_LOCK
) == request
) {
156 if (object
== &smack_known_floor
)
158 if (subject
== &smack_known_hat
)
162 * Beyond here an explicit relationship is required.
163 * If the requested access is contained in the available
164 * access (e.g. read is included in readwrite) it's
165 * good. A negative response from smk_access_entry()
166 * indicates there is no entry for this pair.
169 may
= smk_access_entry(subject
->smk_known
, object
->smk_known
,
170 &subject
->smk_rules
);
173 if (may
<= 0 || (request
& may
) != request
) {
177 #ifdef CONFIG_SECURITY_SMACK_BRINGUP
179 * Return a positive value if using bringup mode.
180 * This allows the hooks to identify checks that
181 * succeed because of "b" rules.
183 if (may
& MAY_BRINGUP
)
184 rc
= SMACK_BRINGUP_ALLOW
;
189 #ifdef CONFIG_SECURITY_SMACK_BRINGUP
191 if (object
== smack_unconfined
)
192 rc
= SMACK_UNCONFINED_OBJECT
;
193 if (subject
== smack_unconfined
)
194 rc
= SMACK_UNCONFINED_SUBJECT
;
200 smack_log(subject
->smk_known
, object
->smk_known
,
208 * smk_tskacc - determine if a task has a specific access to an object
209 * @tsp: a pointer to the subject's task
210 * @obj_known: a pointer to the object's label entry
211 * @mode: the access requested, in "MAY" format
212 * @a : common audit data
214 * This function checks the subject task's label/object label pair
215 * in the access rule list and returns 0 if the access is permitted,
216 * non zero otherwise. It allows that the task may have the capability
217 * to override the rules.
219 int smk_tskacc(struct task_smack
*tsp
, struct smack_known
*obj_known
,
220 u32 mode
, struct smk_audit_info
*a
)
222 struct smack_known
*sbj_known
= smk_of_task(tsp
);
227 * Check the global rule list
229 rc
= smk_access(sbj_known
, obj_known
, mode
, NULL
);
232 * If there is an entry in the task's rule list
233 * it can further restrict access.
235 may
= smk_access_entry(sbj_known
->smk_known
,
236 obj_known
->smk_known
,
240 if ((mode
& may
) == mode
)
246 * Allow for priviliged to override policy.
248 if (rc
!= 0 && smack_privileged(CAP_MAC_OVERRIDE
))
254 smack_log(sbj_known
->smk_known
, obj_known
->smk_known
,
261 * smk_curacc - determine if current has a specific access to an object
262 * @obj_known: a pointer to the object's Smack label entry
263 * @mode: the access requested, in "MAY" format
264 * @a : common audit data
266 * This function checks the current subject label/object label pair
267 * in the access rule list and returns 0 if the access is permitted,
268 * non zero otherwise. It allows that current may have the capability
269 * to override the rules.
271 int smk_curacc(struct smack_known
*obj_known
,
272 u32 mode
, struct smk_audit_info
*a
)
274 struct task_smack
*tsp
= smack_cred(current_cred());
276 return smk_tskacc(tsp
, obj_known
, mode
, a
);
281 * smack_str_from_perm : helper to transalate an int to a
283 * @string : the string to fill
287 static inline void smack_str_from_perm(char *string
, int access
)
291 if (access
& MAY_READ
)
293 if (access
& MAY_WRITE
)
295 if (access
& MAY_EXEC
)
297 if (access
& MAY_APPEND
)
299 if (access
& MAY_TRANSMUTE
)
301 if (access
& MAY_LOCK
)
306 * smack_log_callback - SMACK specific information
307 * will be called by generic audit code
308 * @ab : the audit_buffer
312 static void smack_log_callback(struct audit_buffer
*ab
, void *a
)
314 struct common_audit_data
*ad
= a
;
315 struct smack_audit_data
*sad
= ad
->smack_audit_data
;
316 audit_log_format(ab
, "lsm=SMACK fn=%s action=%s",
317 ad
->smack_audit_data
->function
,
318 sad
->result
? "denied" : "granted");
319 audit_log_format(ab
, " subject=");
320 audit_log_untrustedstring(ab
, sad
->subject
);
321 audit_log_format(ab
, " object=");
322 audit_log_untrustedstring(ab
, sad
->object
);
323 if (sad
->request
[0] == '\0')
324 audit_log_format(ab
, " labels_differ");
326 audit_log_format(ab
, " requested=%s", sad
->request
);
330 * smack_log - Audit the granting or denial of permissions.
331 * @subject_label : smack label of the requester
332 * @object_label : smack label of the object being accessed
333 * @request: requested permissions
334 * @result: result from smk_access
335 * @a: auxiliary audit data
337 * Audit the granting or denial of permissions in accordance
340 void smack_log(char *subject_label
, char *object_label
, int request
,
341 int result
, struct smk_audit_info
*ad
)
343 #ifdef CONFIG_SECURITY_SMACK_BRINGUP
344 char request_buffer
[SMK_NUM_ACCESS_TYPE
+ 5];
346 char request_buffer
[SMK_NUM_ACCESS_TYPE
+ 1];
348 struct smack_audit_data
*sad
;
349 struct common_audit_data
*a
= &ad
->a
;
351 /* check if we have to log the current event */
352 if (result
< 0 && (log_policy
& SMACK_AUDIT_DENIED
) == 0)
354 if (result
== 0 && (log_policy
& SMACK_AUDIT_ACCEPT
) == 0)
357 sad
= a
->smack_audit_data
;
359 if (sad
->function
== NULL
)
360 sad
->function
= "unknown";
362 /* end preparing the audit data */
363 smack_str_from_perm(request_buffer
, request
);
364 sad
->subject
= subject_label
;
365 sad
->object
= object_label
;
366 #ifdef CONFIG_SECURITY_SMACK_BRINGUP
368 * The result may be positive in bringup mode.
369 * A positive result is an allow, but not for normal reasons.
370 * Mark it as successful, but don't filter it out even if
371 * the logging policy says to do so.
373 if (result
== SMACK_UNCONFINED_SUBJECT
)
374 strcat(request_buffer
, "(US)");
375 else if (result
== SMACK_UNCONFINED_OBJECT
)
376 strcat(request_buffer
, "(UO)");
381 sad
->request
= request_buffer
;
382 sad
->result
= result
;
384 common_lsm_audit(a
, smack_log_callback
, NULL
);
386 #else /* #ifdef CONFIG_AUDIT */
387 void smack_log(char *subject_label
, char *object_label
, int request
,
388 int result
, struct smk_audit_info
*ad
)
393 DEFINE_MUTEX(smack_known_lock
);
395 struct hlist_head smack_known_hash
[SMACK_HASH_SLOTS
];
398 * smk_insert_entry - insert a smack label into a hash map,
400 * this function must be called under smack_known_lock
402 void smk_insert_entry(struct smack_known
*skp
)
405 struct hlist_head
*head
;
407 hash
= full_name_hash(NULL
, skp
->smk_known
, strlen(skp
->smk_known
));
408 head
= &smack_known_hash
[hash
& (SMACK_HASH_SLOTS
- 1)];
410 hlist_add_head_rcu(&skp
->smk_hashed
, head
);
411 list_add_rcu(&skp
->list
, &smack_known_list
);
415 * smk_find_entry - find a label on the list, return the list entry
416 * @string: a text string that might be a Smack label
418 * Returns a pointer to the entry in the label list that
419 * matches the passed string or NULL if not found.
421 struct smack_known
*smk_find_entry(const char *string
)
424 struct hlist_head
*head
;
425 struct smack_known
*skp
;
427 hash
= full_name_hash(NULL
, string
, strlen(string
));
428 head
= &smack_known_hash
[hash
& (SMACK_HASH_SLOTS
- 1)];
430 hlist_for_each_entry_rcu(skp
, head
, smk_hashed
)
431 if (strcmp(skp
->smk_known
, string
) == 0)
438 * smk_parse_smack - parse smack label from a text string
439 * @string: a text string that might contain a Smack label
440 * @len: the maximum size, or zero if it is NULL terminated.
442 * Returns a pointer to the clean label or an error code.
444 char *smk_parse_smack(const char *string
, int len
)
450 len
= strlen(string
) + 1;
453 * Reserve a leading '-' as an indicator that
454 * this isn't a label, but an option to interfaces
455 * including /smack/cipso and /smack/cipso2
457 if (string
[0] == '-')
458 return ERR_PTR(-EINVAL
);
460 for (i
= 0; i
< len
; i
++)
461 if (string
[i
] > '~' || string
[i
] <= ' ' || string
[i
] == '/' ||
462 string
[i
] == '"' || string
[i
] == '\\' || string
[i
] == '\'')
465 if (i
== 0 || i
>= SMK_LONGLABEL
)
466 return ERR_PTR(-EINVAL
);
468 smack
= kzalloc(i
+ 1, GFP_NOFS
);
470 return ERR_PTR(-ENOMEM
);
472 strncpy(smack
, string
, i
);
478 * smk_netlbl_mls - convert a catset to netlabel mls categories
479 * @catset: the Smack categories
480 * @sap: where to put the netlabel categories
482 * Allocates and fills attr.mls
483 * Returns 0 on success, error code on failure.
485 int smk_netlbl_mls(int level
, char *catset
, struct netlbl_lsm_secattr
*sap
,
494 sap
->flags
|= NETLBL_SECATTR_MLS_CAT
;
495 sap
->attr
.mls
.lvl
= level
;
496 sap
->attr
.mls
.cat
= NULL
;
498 for (cat
= 1, cp
= catset
, byte
= 0; byte
< len
; cp
++, byte
++)
499 for (m
= 0x80; m
!= 0; m
>>= 1, cat
++) {
502 rc
= netlbl_catmap_setbit(&sap
->attr
.mls
.cat
,
505 netlbl_catmap_free(sap
->attr
.mls
.cat
);
514 * smk_import_entry - import a label, return the list entry
515 * @string: a text string that might be a Smack label
516 * @len: the maximum size, or zero if it is NULL terminated.
518 * Returns a pointer to the entry in the label list that
519 * matches the passed string, adding it if necessary,
522 struct smack_known
*smk_import_entry(const char *string
, int len
)
524 struct smack_known
*skp
;
529 smack
= smk_parse_smack(string
, len
);
531 return ERR_CAST(smack
);
533 mutex_lock(&smack_known_lock
);
535 skp
= smk_find_entry(smack
);
539 skp
= kzalloc(sizeof(*skp
), GFP_NOFS
);
541 skp
= ERR_PTR(-ENOMEM
);
545 skp
->smk_known
= smack
;
546 skp
->smk_secid
= smack_next_secid
++;
547 skp
->smk_netlabel
.domain
= skp
->smk_known
;
548 skp
->smk_netlabel
.flags
=
549 NETLBL_SECATTR_DOMAIN
| NETLBL_SECATTR_MLS_LVL
;
551 * If direct labeling works use it.
552 * Otherwise use mapped labeling.
554 slen
= strlen(smack
);
555 if (slen
< SMK_CIPSOLEN
)
556 rc
= smk_netlbl_mls(smack_cipso_direct
, skp
->smk_known
,
557 &skp
->smk_netlabel
, slen
);
559 rc
= smk_netlbl_mls(smack_cipso_mapped
, (char *)&skp
->smk_secid
,
560 &skp
->smk_netlabel
, sizeof(skp
->smk_secid
));
563 INIT_LIST_HEAD(&skp
->smk_rules
);
564 mutex_init(&skp
->smk_rules_lock
);
566 * Make sure that the entry is actually
567 * filled before putting it on the list.
569 smk_insert_entry(skp
);
573 * smk_netlbl_mls failed.
580 mutex_unlock(&smack_known_lock
);
586 * smack_from_secid - find the Smack label associated with a secid
587 * @secid: an integer that might be associated with a Smack label
589 * Returns a pointer to the appropriate Smack label entry if there is one,
590 * otherwise a pointer to the invalid Smack label.
592 struct smack_known
*smack_from_secid(const u32 secid
)
594 struct smack_known
*skp
;
597 list_for_each_entry_rcu(skp
, &smack_known_list
, list
) {
598 if (skp
->smk_secid
== secid
) {
605 * If we got this far someone asked for the translation
606 * of a secid that is not on the list.
609 return &smack_known_huh
;
613 * Unless a process is running with one of these labels
614 * even having CAP_MAC_OVERRIDE isn't enough to grant
615 * privilege to violate MAC policy. If no labels are
616 * designated (the empty list case) capabilities apply to
619 LIST_HEAD(smack_onlycap_list
);
620 DEFINE_MUTEX(smack_onlycap_lock
);
623 * smack_privileged_cred - are all privilege requirements met by cred
624 * @cap: The requested capability
625 * @cred: the credential to use
627 * Is the task privileged and allowed to be privileged
628 * by the onlycap rule.
630 * Returns true if the task is allowed to be privileged, false if it's not.
632 bool smack_privileged_cred(int cap
, const struct cred
*cred
)
634 struct task_smack
*tsp
= smack_cred(cred
);
635 struct smack_known
*skp
= tsp
->smk_task
;
636 struct smack_known_list_elem
*sklep
;
639 rc
= cap_capable(cred
, &init_user_ns
, cap
, CAP_OPT_NONE
);
644 if (list_empty(&smack_onlycap_list
)) {
649 list_for_each_entry_rcu(sklep
, &smack_onlycap_list
, list
) {
650 if (sklep
->smk_label
== skp
) {
661 * smack_privileged - are all privilege requirements met
662 * @cap: The requested capability
664 * Is the task privileged and allowed to be privileged
665 * by the onlycap rule.
667 * Returns true if the task is allowed to be privileged, false if it's not.
669 bool smack_privileged(int cap
)
672 * All kernel tasks are privileged
674 if (unlikely(current
->flags
& PF_KTHREAD
))
677 return smack_privileged_cred(cap
, current_cred());