freebsd-dev/sys/security/mac/mac_policy.h
Robert Watson ddcdf2650b Begin committing support for Mandatory Access Control and extensible
kernel access control.  The MAC framework permits loadable kernel
modules to link to the kernel at compile-time, boot-time, or run-time,
and augment the system security policy.  This commit includes the
initial kernel implementation, although the interface with the userland
components of the oeprating system is still under work, and not all
kernel subsystems are supported.  Later in this commit sequence,
documentation of which kernel subsystems will not work correctly with
a kernel compiled with MAC support will be added.

Include files to declare MAC userland interface (mac.h), MAC subsystem
entry points (mac.h), and MAC policy entry points (mac_policy.h).  These
files define the interface between the kernel and the MAC framework,
and between the MAC framework and each registered policy module.  These
APIs and ABIs may not be assumed to be stable until following FreeBSD
5.1-RELEASE.

Obtained from:	TrustedBSD Project
Sponsored by:	DARPA, NAI Labs
2002-07-30 21:32:34 +00:00

492 lines
19 KiB
C

/*-
* Copyright (c) 1999, 2000, 2001, 2002 Robert N. M. Watson
* Copyright (c) 2001, 2002 Networks Associates Technology, Inc.
* All rights reserved.
*
* This software was developed by Robert Watson for the TrustedBSD Project.
*
* This software was developed for the FreeBSD Project in part by NAI Labs,
* the Security Research Division of Network Associates, Inc. under
* DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"), as part of the DARPA
* CHATS research program.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
* 3. The names of the authors may not be used to endorse or promote
* products derived from this software without specific prior written
* permission.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
*
* $FreeBSD$
*/
/*
* Kernel interface for MAC policy modules.
*/
#ifndef _SYS_MAC_POLICY_H
#define _SYS_MAC_POLICY_H
/*-
* Pluggable access control policy definition structure.
*
* List of operations that are performed as part of the implementation
* of a MAC policy. Policy implementors declare operations with a
* mac_policy_ops structure, and using the MAC_POLICY_SET() macro.
* If an entry point is not declared, then then the policy will be ignored
* during evaluation of that event or check.
*
* Operations are sorted first by general class of operation, then
* alphabetically.
*/
struct mac_policy_conf;
struct mac_policy_ops {
/*
* Policy module operations.
*/
void (*mpo_destroy)(struct mac_policy_conf *mpc);
void (*mpo_init)(struct mac_policy_conf *mpc);
/*
* Label operations.
*/
void (*mpo_init_bpfdesc)(struct bpf_d *, struct label *label);
void (*mpo_init_cred)(struct ucred *, struct label *label);
void (*mpo_init_devfsdirent)(struct devfs_dirent *,
struct label *label);
void (*mpo_init_ifnet)(struct ifnet *, struct label *label);
void (*mpo_init_ipq)(struct ipq *ipq, struct label *label);
int (*mpo_init_mbuf)(struct mbuf *, int how, struct label *label);
void (*mpo_init_mount)(struct mount *, struct label *mntlabel,
struct label *fslabel);
void (*mpo_init_socket)(struct socket *so, struct label *label,
struct label *peerlabel);
void (*mpo_init_pipe)(struct pipe *pipe, struct label *label);
void (*mpo_init_temp)(struct label *label);
void (*mpo_init_vnode)(struct vnode *, struct label *label);
void (*mpo_destroy_bpfdesc)(struct bpf_d *, struct label *label);
void (*mpo_destroy_cred)(struct ucred *, struct label *label);
void (*mpo_destroy_devfsdirent)(struct devfs_dirent *de,
struct label *label);
void (*mpo_destroy_ifnet)(struct ifnet *, struct label *label);
void (*mpo_destroy_ipq)(struct ipq *ipq, struct label *label);
void (*mpo_destroy_mbuf)(struct mbuf *, struct label *label);
void (*mpo_destroy_mount)(struct mount *, struct label *mntlabel,
struct label *fslabel);
void (*mpo_destroy_socket)(struct socket *so, struct label *label,
struct label *peerlabel);
void (*mpo_destroy_pipe)(struct pipe *pipe, struct label *label);
void (*mpo_destroy_temp)(struct label *label);
void (*mpo_destroy_vnode)(struct vnode *, struct label *label);
int (*mpo_externalize)(struct label *label, struct mac *extmac);
int (*mpo_internalize)(struct label *label, struct mac *extmac);
/*
* Labeling event operations: file system objects, and things that
* look a lot like file system objects.
*/
void (*mpo_create_devfs_device)(dev_t dev, struct devfs_dirent *de,
struct label *label);
void (*mpo_create_devfs_directory)(char *dirname, int dirnamelen,
struct devfs_dirent *de, struct label *label);
void (*mpo_create_devfs_vnode)(struct devfs_dirent *de,
struct label *direntlabel, struct vnode *vp,
struct label *vnodelabel);
void (*mpo_create_vnode)(struct ucred *cred, struct vnode *parent,
struct label *parentlabel, struct vnode *child,
struct label *childlabel);
void (*mpo_create_mount)(struct ucred *cred, struct mount *mp,
struct label *mntlabel, struct label *fslabel);
void (*mpo_create_root_mount)(struct ucred *cred, struct mount *mp,
struct label *mountlabel, struct label *fslabel);
void (*mpo_relabel_vnode)(struct ucred *cred, struct vnode *vp,
struct label *vnodelabel, struct label *label);
int (*mpo_stdcreatevnode_ea)(struct vnode *vp,
struct label *vnodelabel);
void (*mpo_update_devfsdirent)(struct devfs_dirent *devfs_dirent,
struct label *direntlabel, struct vnode *vp,
struct label *vnodelabel);
void (*mpo_update_procfsvnode)(struct vnode *vp,
struct label *vnodelabel, struct ucred *cred);
int (*mpo_update_vnode_from_extattr)(struct vnode *vp,
struct label *vnodelabel, struct mount *mp,
struct label *fslabel);
int (*mpo_update_vnode_from_externalized)(struct vnode *vp,
struct label *vnodelabel, struct mac *mac);
void (*mpo_update_vnode_from_mount)(struct vnode *vp,
struct label *vnodelabel, struct mount *mp,
struct label *fslabel);
/*
* Labeling event operations: IPC objects.
*/
void (*mpo_create_mbuf_from_socket)(struct socket *so,
struct label *socketlabel, struct mbuf *m,
struct label *mbuflabel);
void (*mpo_create_socket)(struct ucred *cred, struct socket *so,
struct label *socketlabel);
void (*mpo_create_socket_from_socket)(struct socket *oldsocket,
struct label *oldsocketlabel, struct socket *newsocket,
struct label *newsocketlabel);
void (*mpo_relabel_socket)(struct ucred *cred, struct socket *so,
struct label *oldlabel, struct label *newlabel);
void (*mpo_relabel_pipe)(struct ucred *cred, struct pipe *pipe,
struct label *oldlabel, struct label *newlabel);
void (*mpo_set_socket_peer_from_mbuf)(struct mbuf *mbuf,
struct label *mbuflabel, struct socket *so,
struct label *socketpeerlabel);
void (*mpo_set_socket_peer_from_socket)(struct socket *oldsocket,
struct label *oldsocketlabel, struct socket *newsocket,
struct label *newsocketpeerlabel);
void (*mpo_create_pipe)(struct ucred *cred, struct pipe *pipe,
struct label *pipelabel);
/*
* Labeling event operations: network objects.
*/
void (*mpo_create_bpfdesc)(struct ucred *cred, struct bpf_d *bpf_d,
struct label *bpflabel);
void (*mpo_create_ifnet)(struct ifnet *ifnet,
struct label *ifnetlabel);
void (*mpo_create_ipq)(struct mbuf *fragment,
struct label *fragmentlabel, struct ipq *ipq,
struct label *ipqlabel);
void (*mpo_create_datagram_from_ipq)
(struct ipq *ipq, struct label *ipqlabel,
struct mbuf *datagram, struct label *datagramlabel);
void (*mpo_create_fragment)(struct mbuf *datagram,
struct label *datagramlabel, struct mbuf *fragment,
struct label *fragmentlabel);
void (*mpo_create_mbuf_from_mbuf)(struct mbuf *oldmbuf,
struct label *oldlabel, struct mbuf *newmbuf,
struct label *newlabel);
void (*mpo_create_mbuf_linklayer)(struct ifnet *ifnet,
struct label *ifnetlabel, struct mbuf *mbuf,
struct label *mbuflabel);
void (*mpo_create_mbuf_from_bpfdesc)(struct bpf_d *bpf_d,
struct label *bpflabel, struct mbuf *mbuf,
struct label *mbuflabel);
void (*mpo_create_mbuf_from_ifnet)(struct ifnet *ifnet,
struct label *ifnetlabel, struct mbuf *mbuf,
struct label *mbuflabel);
void (*mpo_create_mbuf_multicast_encap)(struct mbuf *oldmbuf,
struct label *oldmbuflabel, struct ifnet *ifnet,
struct label *ifnetlabel, struct mbuf *newmbuf,
struct label *newmbuflabel);
void (*mpo_create_mbuf_netlayer)(struct mbuf *oldmbuf,
struct label *oldmbuflabel, struct mbuf *newmbuf,
struct label *newmbuflabel);
int (*mpo_fragment_match)(struct mbuf *fragment,
struct label *fragmentlabel, struct ipq *ipq,
struct label *ipqlabel);
void (*mpo_relabel_ifnet)(struct ucred *cred, struct ifnet *ifnet,
struct label *ifnetlabel, struct label *newlabel);
void (*mpo_update_ipq)(struct mbuf *fragment,
struct label *fragmentlabel, struct ipq *ipq,
struct label *ipqlabel);
/*
* Labeling event operations: processes.
*/
void (*mpo_create_cred)(struct ucred *parent_cred,
struct ucred *child_cred);
void (*mpo_execve_transition)(struct ucred *old, struct ucred *new,
struct vnode *vp, struct label *vnodelabel);
int (*mpo_execve_will_transition)(struct ucred *old,
struct vnode *vp, struct label *vnodelabel);
void (*mpo_create_proc0)(struct ucred *cred);
void (*mpo_create_proc1)(struct ucred *cred);
void (*mpo_relabel_cred)(struct ucred *cred,
struct label *newlabel);
/*
* Access control checks.
*/
int (*mpo_check_bpfdesc_receive)(struct bpf_d *bpf_d,
struct label *bpflabel, struct ifnet *ifnet,
struct label *ifnetlabel);
int (*mpo_check_cred_relabel)(struct ucred *cred,
struct label *newlabel);
int (*mpo_check_cred_visible)(struct ucred *u1, struct ucred *u2);
int (*mpo_check_ifnet_relabel)(struct ucred *cred,
struct ifnet *ifnet, struct label *ifnetlabel,
struct label *newlabel);
int (*mpo_check_ifnet_transmit)(struct ifnet *ifnet,
struct label *ifnetlabel, struct mbuf *m,
struct label *mbuflabel);
int (*mpo_check_mount_stat)(struct ucred *cred, struct mount *mp,
struct label *mntlabel);
int (*mpo_check_pipe_ioctl)(struct ucred *cred, struct pipe *pipe,
struct label *pipelabel, unsigned long cmd, void *data);
int (*mpo_check_pipe_op)(struct ucred *cred, struct pipe *pipe,
struct label *pipelabel, int op);
int (*mpo_check_pipe_relabel)(struct ucred *cred,
struct pipe *pipe, struct label *pipelabel,
struct label *newlabel);
int (*mpo_check_proc_debug)(struct ucred *cred,
struct proc *proc);
int (*mpo_check_proc_sched)(struct ucred *cred,
struct proc *proc);
int (*mpo_check_proc_signal)(struct ucred *cred,
struct proc *proc, int signum);
int (*mpo_check_socket_bind)(struct ucred *cred,
struct socket *so, struct label *socketlabel,
struct sockaddr *sockaddr);
int (*mpo_check_socket_connect)(struct ucred *cred,
struct socket *so, struct label *socketlabel,
struct sockaddr *sockaddr);
int (*mpo_check_socket_listen)(struct ucred *cred,
struct socket *so, struct label *socketlabel);
int (*mpo_check_socket_receive)(struct socket *so,
struct label *socketlabel, struct mbuf *m,
struct label *mbuflabel);
int (*mpo_check_socket_relabel)(struct ucred *cred,
struct socket *so, struct label *socketlabel,
struct label *newlabel);
int (*mpo_check_socket_visible)(struct ucred *cred,
struct socket *so, struct label *socketlabel);
int (*mpo_check_vnode_access)(struct ucred *cred,
struct vnode *vp, struct label *label, int flags);
int (*mpo_check_vnode_chdir)(struct ucred *cred,
struct vnode *dvp, struct label *dlabel);
int (*mpo_check_vnode_chroot)(struct ucred *cred,
struct vnode *dvp, struct label *dlabel);
int (*mpo_check_vnode_create)(struct ucred *cred,
struct vnode *dvp, struct label *dlabel,
struct componentname *cnp, struct vattr *vap);
int (*mpo_check_vnode_delete)(struct ucred *cred,
struct vnode *dvp, struct label *dlabel,
struct vnode *vp, void *label, struct componentname *cnp);
int (*mpo_check_vnode_deleteacl)(struct ucred *cred,
struct vnode *vp, struct label *label, acl_type_t type);
int (*mpo_check_vnode_exec)(struct ucred *cred, struct vnode *vp,
struct label *label);
int (*mpo_check_vnode_getacl)(struct ucred *cred,
struct vnode *vp, struct label *label, acl_type_t type);
int (*mpo_check_vnode_getextattr)(struct ucred *cred,
struct vnode *vp, struct label *label, int attrnamespace,
const char *name, struct uio *uio);
int (*mpo_check_vnode_lookup)(struct ucred *cred,
struct vnode *dvp, struct label *dlabel,
struct componentname *cnp);
int (*mpo_check_vnode_open)(struct ucred *cred, struct vnode *vp,
struct label *label, mode_t acc_mode);
int (*mpo_check_vnode_readdir)(struct ucred *cred,
struct vnode *dvp, struct label *dlabel);
int (*mpo_check_vnode_readlink)(struct ucred *cred,
struct vnode *vp, struct label *label);
int (*mpo_check_vnode_relabel)(struct ucred *cred,
struct vnode *vp, struct label *vnodelabel,
struct label *newlabel);
int (*mpo_check_vnode_rename_from)(struct ucred *cred,
struct vnode *dvp, struct label *dlabel, struct vnode *vp,
struct label *label, struct componentname *cnp);
int (*mpo_check_vnode_rename_to)(struct ucred *cred,
struct vnode *dvp, struct label *dlabel, struct vnode *vp,
struct label *label, int samedir,
struct componentname *cnp);
int (*mpo_check_vnode_revoke)(struct ucred *cred,
struct vnode *vp, struct label *label);
int (*mpo_check_vnode_setacl)(struct ucred *cred,
struct vnode *vp, struct label *label, acl_type_t type,
struct acl *acl);
int (*mpo_check_vnode_setextattr)(struct ucred *cred,
struct vnode *vp, struct label *label, int attrnamespace,
const char *name, struct uio *uio);
int (*mpo_check_vnode_setflags)(struct ucred *cred,
struct vnode *vp, struct label *label, u_long flags);
int (*mpo_check_vnode_setmode)(struct ucred *cred,
struct vnode *vp, struct label *label, mode_t mode);
int (*mpo_check_vnode_setowner)(struct ucred *cred,
struct vnode *vp, struct label *label, uid_t uid,
gid_t gid);
int (*mpo_check_vnode_setutimes)(struct ucred *cred,
struct vnode *vp, struct label *label,
struct timespec atime, struct timespec mtime);
int (*mpo_check_vnode_stat)(struct ucred *cred, struct vnode *vp,
struct label *label);
vm_prot_t (*mpo_check_vnode_mmap_perms)(struct ucred *cred,
struct vnode *vp, struct label *label, int newmapping);
int (*mpo_check_vnode_op)(struct ucred *cred, struct vnode *vp,
struct label *label, int op);
};
typedef void *macop_t;
enum mac_op_constant {
MAC_OP_LAST,
MAC_DESTROY,
MAC_INIT,
MAC_INIT_BPFDESC,
MAC_INIT_CRED,
MAC_INIT_DEVFSDIRENT,
MAC_INIT_IFNET,
MAC_INIT_IPQ,
MAC_INIT_MBUF,
MAC_INIT_MOUNT,
MAC_INIT_PIPE,
MAC_INIT_SOCKET,
MAC_INIT_TEMP,
MAC_INIT_VNODE,
MAC_DESTROY_BPFDESC,
MAC_DESTROY_CRED,
MAC_DESTROY_DEVFSDIRENT,
MAC_DESTROY_IFNET,
MAC_DESTROY_IPQ,
MAC_DESTROY_MBUF,
MAC_DESTROY_MOUNT,
MAC_DESTROY_PIPE,
MAC_DESTROY_SOCKET,
MAC_DESTROY_TEMP,
MAC_DESTROY_VNODE,
MAC_EXTERNALIZE,
MAC_INTERNALIZE,
MAC_CREATE_DEVFS_DEVICE,
MAC_CREATE_DEVFS_DIRECTORY,
MAC_CREATE_DEVFS_VNODE,
MAC_CREATE_VNODE,
MAC_CREATE_MOUNT,
MAC_CREATE_ROOT_MOUNT,
MAC_RELABEL_VNODE,
MAC_STDCREATEVNODE_EA,
MAC_UPDATE_DEVFSDIRENT,
MAC_UPDATE_PROCFSVNODE,
MAC_UPDATE_VNODE_FROM_EXTATTR,
MAC_UPDATE_VNODE_FROM_EXTERNALIZED,
MAC_UPDATE_VNODE_FROM_MOUNT,
MAC_CREATE_MBUF_FROM_SOCKET,
MAC_CREATE_PIPE,
MAC_CREATE_SOCKET,
MAC_CREATE_SOCKET_FROM_SOCKET,
MAC_RELABEL_PIPE,
MAC_RELABEL_SOCKET,
MAC_SET_SOCKET_PEER_FROM_MBUF,
MAC_SET_SOCKET_PEER_FROM_SOCKET,
MAC_CREATE_BPFDESC,
MAC_CREATE_DATAGRAM_FROM_IPQ,
MAC_CREATE_IFNET,
MAC_CREATE_IPQ,
MAC_CREATE_FRAGMENT,
MAC_CREATE_MBUF_FROM_MBUF,
MAC_CREATE_MBUF_LINKLAYER,
MAC_CREATE_MBUF_FROM_BPFDESC,
MAC_CREATE_MBUF_FROM_IFNET,
MAC_CREATE_MBUF_MULTICAST_ENCAP,
MAC_CREATE_MBUF_NETLAYER,
MAC_FRAGMENT_MATCH,
MAC_RELABEL_IFNET,
MAC_UPDATE_IPQ,
MAC_CREATE_CRED,
MAC_EXECVE_TRANSITION,
MAC_EXECVE_WILL_TRANSITION,
MAC_CREATE_PROC0,
MAC_CREATE_PROC1,
MAC_RELABEL_CRED,
MAC_CHECK_BPFDESC_RECEIVE,
MAC_CHECK_CRED_RELABEL,
MAC_CHECK_CRED_VISIBLE,
MAC_CHECK_IFNET_RELABEL,
MAC_CHECK_IFNET_TRANSMIT,
MAC_CHECK_MOUNT_STAT,
MAC_CHECK_PIPE_IOCTL,
MAC_CHECK_PIPE_OP,
MAC_CHECK_PIPE_RELABEL,
MAC_CHECK_PROC_DEBUG,
MAC_CHECK_PROC_SCHED,
MAC_CHECK_PROC_SIGNAL,
MAC_CHECK_SOCKET_BIND,
MAC_CHECK_SOCKET_CONNECT,
MAC_CHECK_SOCKET_LISTEN,
MAC_CHECK_SOCKET_RELABEL,
MAC_CHECK_SOCKET_RECEIVE,
MAC_CHECK_SOCKET_VISIBLE,
MAC_CHECK_VNODE_ACCESS,
MAC_CHECK_VNODE_CHDIR,
MAC_CHECK_VNODE_CHROOT,
MAC_CHECK_VNODE_CREATE,
MAC_CHECK_VNODE_DELETE,
MAC_CHECK_VNODE_DELETEACL,
MAC_CHECK_VNODE_EXEC,
MAC_CHECK_VNODE_GETACL,
MAC_CHECK_VNODE_GETEXTATTR,
MAC_CHECK_VNODE_LOOKUP,
MAC_CHECK_VNODE_OPEN,
MAC_CHECK_VNODE_READDIR,
MAC_CHECK_VNODE_READLINK,
MAC_CHECK_VNODE_RELABEL,
MAC_CHECK_VNODE_RENAME_FROM,
MAC_CHECK_VNODE_RENAME_TO,
MAC_CHECK_VNODE_REVOKE,
MAC_CHECK_VNODE_SETACL,
MAC_CHECK_VNODE_SETEXTATTR,
MAC_CHECK_VNODE_SETFLAGS,
MAC_CHECK_VNODE_SETMODE,
MAC_CHECK_VNODE_SETOWNER,
MAC_CHECK_VNODE_SETUTIMES,
MAC_CHECK_VNODE_STAT,
MAC_CHECK_VNODE_MMAP_PERMS,
MAC_CHECK_VNODE_OP,
};
struct mac_policy_op_entry {
enum mac_op_constant mpe_constant; /* what this hook implements */
void *mpe_function; /* hook's implementation */
};
struct mac_policy_conf {
char *mpc_name; /* policy name */
char *mpc_fullname; /* policy full name */
struct mac_policy_ops *mpc_ops; /* policy operations */
struct mac_policy_op_entry *mpc_entries; /* ops to fill in */
int mpc_loadtime_flags; /* flags */
int *mpc_field_off; /* security field */
int mpc_runtime_flags; /* flags */
LIST_ENTRY(mac_policy_conf) mpc_list; /* global list */
};
/* Flags for the mpc_loadtime_flags field. */
#define MPC_LOADTIME_FLAG_NOTLATE 0x00000001
#define MPC_LOADTIME_FLAG_UNLOADOK 0x00000002
/* Flags for the mpc_runtime_flags field. */
#define MPC_RUNTIME_FLAG_REGISTERED 0x00000001
#define MAC_POLICY_SET(mpents, mpname, mpfullname, mpflags, privdata_wanted) \
static struct mac_policy_conf mpname##_mac_policy_conf = { \
#mpname, \
mpfullname, \
NULL, \
mpents, \
mpflags, \
privdata_wanted, \
0, \
}; \
static moduledata_t mpname##_mod = { \
#mpname, \
mac_policy_modevent, \
&mpname##_mac_policy_conf \
}; \
DECLARE_MODULE(mpname, mpname##_mod, SI_SUB_MAC_POLICY, \
SI_ORDER_MIDDLE)
int mac_policy_modevent(module_t mod, int type, void *data);
#define LABEL_TO_SLOT(l, s) (l)->l_perpolicy[s]
#endif /* !_SYS_MAC_POLICY_H */