findwwwritable.py

   1 #!/usr/bin/python
   2 # python 2.x is used
   3
   4 import os
   5 import stat
   6 from os.path import join
   7
   8
   9 def collect_writable_dirs(rootdir, uids, gids):
  10     """Returns a list of directories below rootdir (including rootdir) that are writable
  11     by the users with the given uids or gids or that are world writable.
  12     Normally, uid(s) is the user id of the apache user (e.g. www-data) and gids is a list
  13     of group ids this user is member of.
  14
  15     :param rootdir: string. directory where the search should start at
  16     :param uids: list of integer user ids
  17     :param gids: list of integer group ids"""
  18     assert isinstance(rootdir, str)
  19     assert isinstance(uids, list)
  20     for uid in uids: assert isinstance(uid, int)
  21     assert isinstance(gids, list)
  22     for gid in gids: assert isinstance(gid, int)
  23
  24     writable_dirs = [] # dirs with write permissions - this list is filled by this function
  25
  26     for root, dirs, files in os.walk(rootdir):
  27         for d in dirs:
  28             dp = join(root, d) # dp is the dir with path
  29             s = os.lstat(dp)
  30             if (s.st_mode & stat.S_IFLNK) == stat.S_IFLNK: continue # skip symlinks
  31             if s.st_uid in uids and (s.st_mode & stat.S_IWUSR) > 0:
  32                 writable_dirs.append(dp)
  33             elif s.st_gid in gids and (s.st_mode & stat.S_IWGRP) > 0:
  34                 writable_dirs.append(dp)
  35             elif (s.st_mode & stat.S_IWOTH) > 0:
  36                 writable_dirs.append(dp)
  37
  38     return writable_dirs
  39
  40
  41
  42 def summarize_dirs(writable_dirs):
  43     """Takes a list of directories and omits each subdirectory if its parent directory
  44     is also included in the list. The modified list is returned.
  45
  46     :param writable_dirs: List of directories (strings)."""
  47     writable_dirs = sorted(writable_dirs)
  48
  49     i = 0
  50     while i < len(writable_dirs)-1:
  51         if writable_dirs[i+1].startswith(writable_dirs[i] + '/'):
  52             del writable_dirs[i+1]
  53         else:
  54             i += 1
  55
  56     return writable_dirs
  57
  58
  59 def apply_whitelist(writable_dirs, whitelist):
  60     """Removes all directories that are contained in the list whitelist from the list writable_dirs.
  61     It returns the modified writable_dirs.
  62
  63     :param writable_dirs: List of directories
  64     :param whitelist: List of directories that should be removed from writable_dirs.
  65     :return: list of writable directories."""
  66     return sorted(list(set(writable_dirs).difference(whitelist)))
  67
  68
  69
  70 if __name__ == '__main__':
  71
  72     # variables
  73     uids = [33]                # user ids of the user whos write permissions should be found
  74     gids = [33, 42, 121, 127]  # group ids of the user whos write permissions should be found
  75     rootdir = '/home'          # directory where the seach is started
  76     whitelist = []             # list of directories that are known to be writable and that should not be reported.
  77
  78     # collect and summarize writable directories
  79     writable_dirs = collect_writable_dirs(rootdir, uids, gids)
  80     writable_dirs = summarize_dirs(writable_dirs)
  81     writable_dirs = apply_whitelist(writable_dirs, whitelist)
  82
  83     # print writable directories
  84     for d in writable_dirs:
  85         print d
  86
  87