linux/security/lsm_audit.c
<<
>>
Prefs
   1// SPDX-License-Identifier: GPL-2.0-only
   2/*
   3 * common LSM auditing functions
   4 *
   5 * Based on code written for SELinux by :
   6 *                      Stephen Smalley, <sds@tycho.nsa.gov>
   7 *                      James Morris <jmorris@redhat.com>
   8 * Author : Etienne Basset, <etienne.basset@ensta.org>
   9 */
  10
  11#include <linux/types.h>
  12#include <linux/stddef.h>
  13#include <linux/kernel.h>
  14#include <linux/gfp.h>
  15#include <linux/fs.h>
  16#include <linux/init.h>
  17#include <net/sock.h>
  18#include <linux/un.h>
  19#include <net/af_unix.h>
  20#include <linux/audit.h>
  21#include <linux/ipv6.h>
  22#include <linux/ip.h>
  23#include <net/ip.h>
  24#include <net/ipv6.h>
  25#include <linux/tcp.h>
  26#include <linux/udp.h>
  27#include <linux/dccp.h>
  28#include <linux/sctp.h>
  29#include <linux/lsm_audit.h>
  30#include <linux/security.h>
  31
  32/**
  33 * ipv4_skb_to_auditdata : fill auditdata from skb
  34 * @skb : the skb
  35 * @ad : the audit data to fill
  36 * @proto : the layer 4 protocol
  37 *
  38 * return  0 on success
  39 */
  40int ipv4_skb_to_auditdata(struct sk_buff *skb,
  41                struct common_audit_data *ad, u8 *proto)
  42{
  43        int ret = 0;
  44        struct iphdr *ih;
  45
  46        ih = ip_hdr(skb);
  47        if (ih == NULL)
  48                return -EINVAL;
  49
  50        ad->u.net->v4info.saddr = ih->saddr;
  51        ad->u.net->v4info.daddr = ih->daddr;
  52
  53        if (proto)
  54                *proto = ih->protocol;
  55        /* non initial fragment */
  56        if (ntohs(ih->frag_off) & IP_OFFSET)
  57                return 0;
  58
  59        switch (ih->protocol) {
  60        case IPPROTO_TCP: {
  61                struct tcphdr *th = tcp_hdr(skb);
  62                if (th == NULL)
  63                        break;
  64
  65                ad->u.net->sport = th->source;
  66                ad->u.net->dport = th->dest;
  67                break;
  68        }
  69        case IPPROTO_UDP: {
  70                struct udphdr *uh = udp_hdr(skb);
  71                if (uh == NULL)
  72                        break;
  73
  74                ad->u.net->sport = uh->source;
  75                ad->u.net->dport = uh->dest;
  76                break;
  77        }
  78        case IPPROTO_DCCP: {
  79                struct dccp_hdr *dh = dccp_hdr(skb);
  80                if (dh == NULL)
  81                        break;
  82
  83                ad->u.net->sport = dh->dccph_sport;
  84                ad->u.net->dport = dh->dccph_dport;
  85                break;
  86        }
  87        case IPPROTO_SCTP: {
  88                struct sctphdr *sh = sctp_hdr(skb);
  89                if (sh == NULL)
  90                        break;
  91                ad->u.net->sport = sh->source;
  92                ad->u.net->dport = sh->dest;
  93                break;
  94        }
  95        default:
  96                ret = -EINVAL;
  97        }
  98        return ret;
  99}
 100#if IS_ENABLED(CONFIG_IPV6)
 101/**
 102 * ipv6_skb_to_auditdata : fill auditdata from skb
 103 * @skb : the skb
 104 * @ad : the audit data to fill
 105 * @proto : the layer 4 protocol
 106 *
 107 * return  0 on success
 108 */
 109int ipv6_skb_to_auditdata(struct sk_buff *skb,
 110                struct common_audit_data *ad, u8 *proto)
 111{
 112        int offset, ret = 0;
 113        struct ipv6hdr *ip6;
 114        u8 nexthdr;
 115        __be16 frag_off;
 116
 117        ip6 = ipv6_hdr(skb);
 118        if (ip6 == NULL)
 119                return -EINVAL;
 120        ad->u.net->v6info.saddr = ip6->saddr;
 121        ad->u.net->v6info.daddr = ip6->daddr;
 122        ret = 0;
 123        /* IPv6 can have several extension header before the Transport header
 124         * skip them */
 125        offset = skb_network_offset(skb);
 126        offset += sizeof(*ip6);
 127        nexthdr = ip6->nexthdr;
 128        offset = ipv6_skip_exthdr(skb, offset, &nexthdr, &frag_off);
 129        if (offset < 0)
 130                return 0;
 131        if (proto)
 132                *proto = nexthdr;
 133        switch (nexthdr) {
 134        case IPPROTO_TCP: {
 135                struct tcphdr _tcph, *th;
 136
 137                th = skb_header_pointer(skb, offset, sizeof(_tcph), &_tcph);
 138                if (th == NULL)
 139                        break;
 140
 141                ad->u.net->sport = th->source;
 142                ad->u.net->dport = th->dest;
 143                break;
 144        }
 145        case IPPROTO_UDP: {
 146                struct udphdr _udph, *uh;
 147
 148                uh = skb_header_pointer(skb, offset, sizeof(_udph), &_udph);
 149                if (uh == NULL)
 150                        break;
 151
 152                ad->u.net->sport = uh->source;
 153                ad->u.net->dport = uh->dest;
 154                break;
 155        }
 156        case IPPROTO_DCCP: {
 157                struct dccp_hdr _dccph, *dh;
 158
 159                dh = skb_header_pointer(skb, offset, sizeof(_dccph), &_dccph);
 160                if (dh == NULL)
 161                        break;
 162
 163                ad->u.net->sport = dh->dccph_sport;
 164                ad->u.net->dport = dh->dccph_dport;
 165                break;
 166        }
 167        case IPPROTO_SCTP: {
 168                struct sctphdr _sctph, *sh;
 169
 170                sh = skb_header_pointer(skb, offset, sizeof(_sctph), &_sctph);
 171                if (sh == NULL)
 172                        break;
 173                ad->u.net->sport = sh->source;
 174                ad->u.net->dport = sh->dest;
 175                break;
 176        }
 177        default:
 178                ret = -EINVAL;
 179        }
 180        return ret;
 181}
 182#endif
 183
 184
 185static inline void print_ipv6_addr(struct audit_buffer *ab,
 186                                   const struct in6_addr *addr, __be16 port,
 187                                   char *name1, char *name2)
 188{
 189        if (!ipv6_addr_any(addr))
 190                audit_log_format(ab, " %s=%pI6c", name1, addr);
 191        if (port)
 192                audit_log_format(ab, " %s=%d", name2, ntohs(port));
 193}
 194
 195static inline void print_ipv4_addr(struct audit_buffer *ab, __be32 addr,
 196                                   __be16 port, char *name1, char *name2)
 197{
 198        if (addr)
 199                audit_log_format(ab, " %s=%pI4", name1, &addr);
 200        if (port)
 201                audit_log_format(ab, " %s=%d", name2, ntohs(port));
 202}
 203
 204/**
 205 * dump_common_audit_data - helper to dump common audit data
 206 * @a : common audit data
 207 *
 208 */
 209static void dump_common_audit_data(struct audit_buffer *ab,
 210                                   struct common_audit_data *a)
 211{
 212        char comm[sizeof(current->comm)];
 213
 214        /*
 215         * To keep stack sizes in check force programers to notice if they
 216         * start making this union too large!  See struct lsm_network_audit
 217         * as an example of how to deal with large data.
 218         */
 219        BUILD_BUG_ON(sizeof(a->u) > sizeof(void *)*2);
 220
 221        audit_log_format(ab, " pid=%d comm=", task_tgid_nr(current));
 222        audit_log_untrustedstring(ab, memcpy(comm, current->comm, sizeof(comm)));
 223
 224        switch (a->type) {
 225        case LSM_AUDIT_DATA_NONE:
 226                return;
 227        case LSM_AUDIT_DATA_IPC:
 228                audit_log_format(ab, " key=%d ", a->u.ipc_id);
 229                break;
 230        case LSM_AUDIT_DATA_CAP:
 231                audit_log_format(ab, " capability=%d ", a->u.cap);
 232                break;
 233        case LSM_AUDIT_DATA_PATH: {
 234                struct inode *inode;
 235
 236                audit_log_d_path(ab, " path=", &a->u.path);
 237
 238                inode = d_backing_inode(a->u.path.dentry);
 239                if (inode) {
 240                        audit_log_format(ab, " dev=");
 241                        audit_log_untrustedstring(ab, inode->i_sb->s_id);
 242                        audit_log_format(ab, " ino=%lu", inode->i_ino);
 243                }
 244                break;
 245        }
 246        case LSM_AUDIT_DATA_FILE: {
 247                struct inode *inode;
 248
 249                audit_log_d_path(ab, " path=", &a->u.file->f_path);
 250
 251                inode = file_inode(a->u.file);
 252                if (inode) {
 253                        audit_log_format(ab, " dev=");
 254                        audit_log_untrustedstring(ab, inode->i_sb->s_id);
 255                        audit_log_format(ab, " ino=%lu", inode->i_ino);
 256                }
 257                break;
 258        }
 259        case LSM_AUDIT_DATA_IOCTL_OP: {
 260                struct inode *inode;
 261
 262                audit_log_d_path(ab, " path=", &a->u.op->path);
 263
 264                inode = a->u.op->path.dentry->d_inode;
 265                if (inode) {
 266                        audit_log_format(ab, " dev=");
 267                        audit_log_untrustedstring(ab, inode->i_sb->s_id);
 268                        audit_log_format(ab, " ino=%lu", inode->i_ino);
 269                }
 270
 271                audit_log_format(ab, " ioctlcmd=0x%hx", a->u.op->cmd);
 272                break;
 273        }
 274        case LSM_AUDIT_DATA_DENTRY: {
 275                struct inode *inode;
 276
 277                audit_log_format(ab, " name=");
 278                spin_lock(&a->u.dentry->d_lock);
 279                audit_log_untrustedstring(ab, a->u.dentry->d_name.name);
 280                spin_unlock(&a->u.dentry->d_lock);
 281
 282                inode = d_backing_inode(a->u.dentry);
 283                if (inode) {
 284                        audit_log_format(ab, " dev=");
 285                        audit_log_untrustedstring(ab, inode->i_sb->s_id);
 286                        audit_log_format(ab, " ino=%lu", inode->i_ino);
 287                }
 288                break;
 289        }
 290        case LSM_AUDIT_DATA_INODE: {
 291                struct dentry *dentry;
 292                struct inode *inode;
 293
 294                rcu_read_lock();
 295                inode = a->u.inode;
 296                dentry = d_find_alias_rcu(inode);
 297                if (dentry) {
 298                        audit_log_format(ab, " name=");
 299                        spin_lock(&dentry->d_lock);
 300                        audit_log_untrustedstring(ab, dentry->d_name.name);
 301                        spin_unlock(&dentry->d_lock);
 302                }
 303                audit_log_format(ab, " dev=");
 304                audit_log_untrustedstring(ab, inode->i_sb->s_id);
 305                audit_log_format(ab, " ino=%lu", inode->i_ino);
 306                rcu_read_unlock();
 307                break;
 308        }
 309        case LSM_AUDIT_DATA_TASK: {
 310                struct task_struct *tsk = a->u.tsk;
 311                if (tsk) {
 312                        pid_t pid = task_tgid_nr(tsk);
 313                        if (pid) {
 314                                char comm[sizeof(tsk->comm)];
 315                                audit_log_format(ab, " opid=%d ocomm=", pid);
 316                                audit_log_untrustedstring(ab,
 317                                    memcpy(comm, tsk->comm, sizeof(comm)));
 318                        }
 319                }
 320                break;
 321        }
 322        case LSM_AUDIT_DATA_NET:
 323                if (a->u.net->sk) {
 324                        const struct sock *sk = a->u.net->sk;
 325                        struct unix_sock *u;
 326                        struct unix_address *addr;
 327                        int len = 0;
 328                        char *p = NULL;
 329
 330                        switch (sk->sk_family) {
 331                        case AF_INET: {
 332                                struct inet_sock *inet = inet_sk(sk);
 333
 334                                print_ipv4_addr(ab, inet->inet_rcv_saddr,
 335                                                inet->inet_sport,
 336                                                "laddr", "lport");
 337                                print_ipv4_addr(ab, inet->inet_daddr,
 338                                                inet->inet_dport,
 339                                                "faddr", "fport");
 340                                break;
 341                        }
 342#if IS_ENABLED(CONFIG_IPV6)
 343                        case AF_INET6: {
 344                                struct inet_sock *inet = inet_sk(sk);
 345
 346                                print_ipv6_addr(ab, &sk->sk_v6_rcv_saddr,
 347                                                inet->inet_sport,
 348                                                "laddr", "lport");
 349                                print_ipv6_addr(ab, &sk->sk_v6_daddr,
 350                                                inet->inet_dport,
 351                                                "faddr", "fport");
 352                                break;
 353                        }
 354#endif
 355                        case AF_UNIX:
 356                                u = unix_sk(sk);
 357                                addr = smp_load_acquire(&u->addr);
 358                                if (!addr)
 359                                        break;
 360                                if (u->path.dentry) {
 361                                        audit_log_d_path(ab, " path=", &u->path);
 362                                        break;
 363                                }
 364                                len = addr->len-sizeof(short);
 365                                p = &addr->name->sun_path[0];
 366                                audit_log_format(ab, " path=");
 367                                if (*p)
 368                                        audit_log_untrustedstring(ab, p);
 369                                else
 370                                        audit_log_n_hex(ab, p, len);
 371                                break;
 372                        }
 373                }
 374
 375                switch (a->u.net->family) {
 376                case AF_INET:
 377                        print_ipv4_addr(ab, a->u.net->v4info.saddr,
 378                                        a->u.net->sport,
 379                                        "saddr", "src");
 380                        print_ipv4_addr(ab, a->u.net->v4info.daddr,
 381                                        a->u.net->dport,
 382                                        "daddr", "dest");
 383                        break;
 384                case AF_INET6:
 385                        print_ipv6_addr(ab, &a->u.net->v6info.saddr,
 386                                        a->u.net->sport,
 387                                        "saddr", "src");
 388                        print_ipv6_addr(ab, &a->u.net->v6info.daddr,
 389                                        a->u.net->dport,
 390                                        "daddr", "dest");
 391                        break;
 392                }
 393                if (a->u.net->netif > 0) {
 394                        struct net_device *dev;
 395
 396                        /* NOTE: we always use init's namespace */
 397                        dev = dev_get_by_index(&init_net, a->u.net->netif);
 398                        if (dev) {
 399                                audit_log_format(ab, " netif=%s", dev->name);
 400                                dev_put(dev);
 401                        }
 402                }
 403                break;
 404#ifdef CONFIG_KEYS
 405        case LSM_AUDIT_DATA_KEY:
 406                audit_log_format(ab, " key_serial=%u", a->u.key_struct.key);
 407                if (a->u.key_struct.key_desc) {
 408                        audit_log_format(ab, " key_desc=");
 409                        audit_log_untrustedstring(ab, a->u.key_struct.key_desc);
 410                }
 411                break;
 412#endif
 413        case LSM_AUDIT_DATA_KMOD:
 414                audit_log_format(ab, " kmod=");
 415                audit_log_untrustedstring(ab, a->u.kmod_name);
 416                break;
 417        case LSM_AUDIT_DATA_IBPKEY: {
 418                struct in6_addr sbn_pfx;
 419
 420                memset(&sbn_pfx.s6_addr, 0,
 421                       sizeof(sbn_pfx.s6_addr));
 422                memcpy(&sbn_pfx.s6_addr, &a->u.ibpkey->subnet_prefix,
 423                       sizeof(a->u.ibpkey->subnet_prefix));
 424                audit_log_format(ab, " pkey=0x%x subnet_prefix=%pI6c",
 425                                 a->u.ibpkey->pkey, &sbn_pfx);
 426                break;
 427        }
 428        case LSM_AUDIT_DATA_IBENDPORT:
 429                audit_log_format(ab, " device=%s port_num=%u",
 430                                 a->u.ibendport->dev_name,
 431                                 a->u.ibendport->port);
 432                break;
 433        case LSM_AUDIT_DATA_LOCKDOWN:
 434                audit_log_format(ab, " lockdown_reason=\"%s\"",
 435                                 lockdown_reasons[a->u.reason]);
 436                break;
 437        } /* switch (a->type) */
 438}
 439
 440/**
 441 * common_lsm_audit - generic LSM auditing function
 442 * @a:  auxiliary audit data
 443 * @pre_audit: lsm-specific pre-audit callback
 444 * @post_audit: lsm-specific post-audit callback
 445 *
 446 * setup the audit buffer for common security information
 447 * uses callback to print LSM specific information
 448 */
 449void common_lsm_audit(struct common_audit_data *a,
 450        void (*pre_audit)(struct audit_buffer *, void *),
 451        void (*post_audit)(struct audit_buffer *, void *))
 452{
 453        struct audit_buffer *ab;
 454
 455        if (a == NULL)
 456                return;
 457        /* we use GFP_ATOMIC so we won't sleep */
 458        ab = audit_log_start(audit_context(), GFP_ATOMIC | __GFP_NOWARN,
 459                             AUDIT_AVC);
 460
 461        if (ab == NULL)
 462                return;
 463
 464        if (pre_audit)
 465                pre_audit(ab, a);
 466
 467        dump_common_audit_data(ab, a);
 468
 469        if (post_audit)
 470                post_audit(ab, a);
 471
 472        audit_log_end(ab);
 473}
 474