root/security/lsm_audit.c

DEFINITIONS

1. ipv4_skb_to_auditdata
2. ipv6_skb_to_auditdata
3. print_ipv6_addr
4. print_ipv4_addr
5. dump_common_audit_data
6. common_lsm_audit

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