1 // SPDX-License-Identifier: GPL-2.0-only
3 * NSA Security-Enhanced Linux (SELinux) security module
5 * This file contains the SELinux XFRM hook function implementations.
7 * Authors: Serge Hallyn <sergeh@us.ibm.com>
8 * Trent Jaeger <jaegert@us.ibm.com>
10 * Updated: Venkat Yekkirala <vyekkirala@TrustedCS.com>
12 * Granular IPSec Associations for use in MLS environments.
14 * Copyright (C) 2005 International Business Machines Corporation
15 * Copyright (C) 2006 Trusted Computer Solutions, Inc.
21 * 1. Make sure to enable the following options in your kernel config:
23 * CONFIG_SECURITY_NETWORK=y
24 * CONFIG_SECURITY_NETWORK_XFRM=y
25 * CONFIG_SECURITY_SELINUX=m/y
27 * 1. Caching packets, so they are not dropped during negotiation
28 * 2. Emulating a reasonable SO_PEERSEC across machines
29 * 3. Testing addition of sk_policy's with security context via setsockopt
31 #include <linux/kernel.h>
32 #include <linux/init.h>
33 #include <linux/security.h>
34 #include <linux/types.h>
35 #include <linux/slab.h>
37 #include <linux/tcp.h>
38 #include <linux/skbuff.h>
39 #include <linux/xfrm.h>
41 #include <net/checksum.h>
43 #include <linux/atomic.h>
49 /* Labeled XFRM instance counter */
50 atomic_t selinux_xfrm_refcount
= ATOMIC_INIT(0);
53 * Returns true if the context is an LSM/SELinux context.
55 static inline int selinux_authorizable_ctx(struct xfrm_sec_ctx
*ctx
)
58 (ctx
->ctx_doi
== XFRM_SC_DOI_LSM
) &&
59 (ctx
->ctx_alg
== XFRM_SC_ALG_SELINUX
));
63 * Returns true if the xfrm contains a security blob for SELinux.
65 static inline int selinux_authorizable_xfrm(struct xfrm_state
*x
)
67 return selinux_authorizable_ctx(x
->security
);
71 * Allocates a xfrm_sec_state and populates it using the supplied security
72 * xfrm_user_sec_ctx context.
74 static int selinux_xfrm_alloc_user(struct xfrm_sec_ctx
**ctxp
,
75 struct xfrm_user_sec_ctx
*uctx
,
79 const struct task_security_struct
*tsec
= selinux_cred(current_cred());
80 struct xfrm_sec_ctx
*ctx
= NULL
;
83 if (ctxp
== NULL
|| uctx
== NULL
||
84 uctx
->ctx_doi
!= XFRM_SC_DOI_LSM
||
85 uctx
->ctx_alg
!= XFRM_SC_ALG_SELINUX
)
88 str_len
= uctx
->ctx_len
;
89 if (str_len
>= PAGE_SIZE
)
92 ctx
= kmalloc(sizeof(*ctx
) + str_len
+ 1, gfp
);
96 ctx
->ctx_doi
= XFRM_SC_DOI_LSM
;
97 ctx
->ctx_alg
= XFRM_SC_ALG_SELINUX
;
98 ctx
->ctx_len
= str_len
;
99 memcpy(ctx
->ctx_str
, &uctx
[1], str_len
);
100 ctx
->ctx_str
[str_len
] = '\0';
101 rc
= security_context_to_sid(&selinux_state
, ctx
->ctx_str
, str_len
,
106 rc
= avc_has_perm(&selinux_state
,
107 tsec
->sid
, ctx
->ctx_sid
,
108 SECCLASS_ASSOCIATION
, ASSOCIATION__SETCONTEXT
, NULL
);
113 atomic_inc(&selinux_xfrm_refcount
);
122 * Free the xfrm_sec_ctx structure.
124 static void selinux_xfrm_free(struct xfrm_sec_ctx
*ctx
)
129 atomic_dec(&selinux_xfrm_refcount
);
134 * Authorize the deletion of a labeled SA or policy rule.
136 static int selinux_xfrm_delete(struct xfrm_sec_ctx
*ctx
)
138 const struct task_security_struct
*tsec
= selinux_cred(current_cred());
143 return avc_has_perm(&selinux_state
,
144 tsec
->sid
, ctx
->ctx_sid
,
145 SECCLASS_ASSOCIATION
, ASSOCIATION__SETCONTEXT
,
150 * LSM hook implementation that authorizes that a flow can use a xfrm policy
153 int selinux_xfrm_policy_lookup(struct xfrm_sec_ctx
*ctx
, u32 fl_secid
, u8 dir
)
157 /* All flows should be treated as polmatch'ing an otherwise applicable
158 * "non-labeled" policy. This would prevent inadvertent "leaks". */
162 /* Context sid is either set to label or ANY_ASSOC */
163 if (!selinux_authorizable_ctx(ctx
))
166 rc
= avc_has_perm(&selinux_state
,
167 fl_secid
, ctx
->ctx_sid
,
168 SECCLASS_ASSOCIATION
, ASSOCIATION__POLMATCH
, NULL
);
169 return (rc
== -EACCES
? -ESRCH
: rc
);
173 * LSM hook implementation that authorizes that a state matches
174 * the given policy, flow combo.
176 int selinux_xfrm_state_pol_flow_match(struct xfrm_state
*x
,
177 struct xfrm_policy
*xp
,
178 const struct flowi_common
*flic
)
185 /* unlabeled policy and labeled SA can't match */
188 /* unlabeled policy and unlabeled SA match all flows */
192 /* unlabeled SA and labeled policy can't match */
195 if (!selinux_authorizable_xfrm(x
))
196 /* Not a SELinux-labeled SA */
199 state_sid
= x
->security
->ctx_sid
;
200 flic_sid
= flic
->flowic_secid
;
202 if (flic_sid
!= state_sid
)
205 /* We don't need a separate SA Vs. policy polmatch check since the SA
206 * is now of the same label as the flow and a flow Vs. policy polmatch
207 * check had already happened in selinux_xfrm_policy_lookup() above. */
208 return (avc_has_perm(&selinux_state
, flic_sid
, state_sid
,
209 SECCLASS_ASSOCIATION
, ASSOCIATION__SENDTO
,
213 static u32
selinux_xfrm_skb_sid_egress(struct sk_buff
*skb
)
215 struct dst_entry
*dst
= skb_dst(skb
);
216 struct xfrm_state
*x
;
221 if (x
== NULL
|| !selinux_authorizable_xfrm(x
))
224 return x
->security
->ctx_sid
;
227 static int selinux_xfrm_skb_sid_ingress(struct sk_buff
*skb
,
230 u32 sid_session
= SECSID_NULL
;
231 struct sec_path
*sp
= skb_sec_path(skb
);
236 for (i
= sp
->len
- 1; i
>= 0; i
--) {
237 struct xfrm_state
*x
= sp
->xvec
[i
];
238 if (selinux_authorizable_xfrm(x
)) {
239 struct xfrm_sec_ctx
*ctx
= x
->security
;
241 if (sid_session
== SECSID_NULL
) {
242 sid_session
= ctx
->ctx_sid
;
245 } else if (sid_session
!= ctx
->ctx_sid
) {
259 * LSM hook implementation that checks and/or returns the xfrm sid for the
262 int selinux_xfrm_decode_session(struct sk_buff
*skb
, u32
*sid
, int ckall
)
268 return selinux_xfrm_skb_sid_ingress(skb
, sid
, ckall
);
271 int selinux_xfrm_skb_sid(struct sk_buff
*skb
, u32
*sid
)
275 rc
= selinux_xfrm_skb_sid_ingress(skb
, sid
, 0);
276 if (rc
== 0 && *sid
== SECSID_NULL
)
277 *sid
= selinux_xfrm_skb_sid_egress(skb
);
283 * LSM hook implementation that allocs and transfers uctx spec to xfrm_policy.
285 int selinux_xfrm_policy_alloc(struct xfrm_sec_ctx
**ctxp
,
286 struct xfrm_user_sec_ctx
*uctx
,
289 return selinux_xfrm_alloc_user(ctxp
, uctx
, gfp
);
293 * LSM hook implementation that copies security data structure from old to new
294 * for policy cloning.
296 int selinux_xfrm_policy_clone(struct xfrm_sec_ctx
*old_ctx
,
297 struct xfrm_sec_ctx
**new_ctxp
)
299 struct xfrm_sec_ctx
*new_ctx
;
304 new_ctx
= kmemdup(old_ctx
, sizeof(*old_ctx
) + old_ctx
->ctx_len
,
308 atomic_inc(&selinux_xfrm_refcount
);
315 * LSM hook implementation that frees xfrm_sec_ctx security information.
317 void selinux_xfrm_policy_free(struct xfrm_sec_ctx
*ctx
)
319 selinux_xfrm_free(ctx
);
323 * LSM hook implementation that authorizes deletion of labeled policies.
325 int selinux_xfrm_policy_delete(struct xfrm_sec_ctx
*ctx
)
327 return selinux_xfrm_delete(ctx
);
331 * LSM hook implementation that allocates a xfrm_sec_state, populates it using
332 * the supplied security context, and assigns it to the xfrm_state.
334 int selinux_xfrm_state_alloc(struct xfrm_state
*x
,
335 struct xfrm_user_sec_ctx
*uctx
)
337 return selinux_xfrm_alloc_user(&x
->security
, uctx
, GFP_KERNEL
);
341 * LSM hook implementation that allocates a xfrm_sec_state and populates based
344 int selinux_xfrm_state_alloc_acquire(struct xfrm_state
*x
,
345 struct xfrm_sec_ctx
*polsec
, u32 secid
)
348 struct xfrm_sec_ctx
*ctx
;
349 char *ctx_str
= NULL
;
358 rc
= security_sid_to_context(&selinux_state
, secid
, &ctx_str
,
363 ctx
= kmalloc(sizeof(*ctx
) + str_len
, GFP_ATOMIC
);
369 ctx
->ctx_doi
= XFRM_SC_DOI_LSM
;
370 ctx
->ctx_alg
= XFRM_SC_ALG_SELINUX
;
371 ctx
->ctx_sid
= secid
;
372 ctx
->ctx_len
= str_len
;
373 memcpy(ctx
->ctx_str
, ctx_str
, str_len
);
376 atomic_inc(&selinux_xfrm_refcount
);
383 * LSM hook implementation that frees xfrm_state security information.
385 void selinux_xfrm_state_free(struct xfrm_state
*x
)
387 selinux_xfrm_free(x
->security
);
391 * LSM hook implementation that authorizes deletion of labeled SAs.
393 int selinux_xfrm_state_delete(struct xfrm_state
*x
)
395 return selinux_xfrm_delete(x
->security
);
399 * LSM hook that controls access to unlabelled packets. If
400 * a xfrm_state is authorizable (defined by macro) then it was
401 * already authorized by the IPSec process. If not, then
402 * we need to check for unlabelled access since this may not have
403 * gone thru the IPSec process.
405 int selinux_xfrm_sock_rcv_skb(u32 sk_sid
, struct sk_buff
*skb
,
406 struct common_audit_data
*ad
)
409 struct sec_path
*sp
= skb_sec_path(skb
);
410 u32 peer_sid
= SECINITSID_UNLABELED
;
413 for (i
= 0; i
< sp
->len
; i
++) {
414 struct xfrm_state
*x
= sp
->xvec
[i
];
416 if (x
&& selinux_authorizable_xfrm(x
)) {
417 struct xfrm_sec_ctx
*ctx
= x
->security
;
418 peer_sid
= ctx
->ctx_sid
;
424 /* This check even when there's no association involved is intended,
425 * according to Trent Jaeger, to make sure a process can't engage in
426 * non-IPsec communication unless explicitly allowed by policy. */
427 return avc_has_perm(&selinux_state
,
429 SECCLASS_ASSOCIATION
, ASSOCIATION__RECVFROM
, ad
);
433 * POSTROUTE_LAST hook's XFRM processing:
434 * If we have no security association, then we need to determine
435 * whether the socket is allowed to send to an unlabelled destination.
436 * If we do have a authorizable security association, then it has already been
437 * checked in the selinux_xfrm_state_pol_flow_match hook above.
439 int selinux_xfrm_postroute_last(u32 sk_sid
, struct sk_buff
*skb
,
440 struct common_audit_data
*ad
, u8 proto
)
442 struct dst_entry
*dst
;
448 /* We should have already seen this packet once before it
449 * underwent xfrm(s). No need to subject it to the unlabeled
458 struct dst_entry
*iter
;
460 for (iter
= dst
; iter
!= NULL
; iter
= xfrm_dst_child(iter
)) {
461 struct xfrm_state
*x
= iter
->xfrm
;
463 if (x
&& selinux_authorizable_xfrm(x
))
468 /* This check even when there's no association involved is intended,
469 * according to Trent Jaeger, to make sure a process can't engage in
470 * non-IPsec communication unless explicitly allowed by policy. */
471 return avc_has_perm(&selinux_state
, sk_sid
, SECINITSID_UNLABELED
,
472 SECCLASS_ASSOCIATION
, ASSOCIATION__SENDTO
, ad
);