granicus.if.org Git - apache/blob - support/suexec.c

   1 /* ====================================================================
   2  * The Apache Software License, Version 1.1
   3  *
   4  * Copyright (c) 2000-2002 The Apache Software Foundation.  All rights
   5  * reserved.
   6  *
   7  * Redistribution and use in source and binary forms, with or without
   8  * modification, are permitted provided that the following conditions
   9  * are met:
  10  *
  11  * 1. Redistributions of source code must retain the above copyright
  12  *    notice, this list of conditions and the following disclaimer.
  13  *
  14  * 2. Redistributions in binary form must reproduce the above copyright
  15  *    notice, this list of conditions and the following disclaimer in
  16  *    the documentation and/or other materials provided with the
  17  *    distribution.
  18  *
  19  * 3. The end-user documentation included with the redistribution,
  20  *    if any, must include the following acknowledgment:
  21  *       "This product includes software developed by the
  22  *        Apache Software Foundation (http://www.apache.org/)."
  23  *    Alternately, this acknowledgment may appear in the software itself,
  24  *    if and wherever such third-party acknowledgments normally appear.
  25  *
  26  * 4. The names "Apache" and "Apache Software Foundation" must
  27  *    not be used to endorse or promote products derived from this
  28  *    software without prior written permission. For written
  29  *    permission, please contact apache@apache.org.
  30  *
  31  * 5. Products derived from this software may not be called "Apache",
  32  *    nor may "Apache" appear in their name, without prior written
  33  *    permission of the Apache Software Foundation.
  34  *
  35  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
  36  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  37  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  38  * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
  39  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  40  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  41  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  42  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  43  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  44  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  45  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  46  * SUCH DAMAGE.
  47  * ====================================================================
  48  *
  49  * This software consists of voluntary contributions made by many
  50  * individuals on behalf of the Apache Software Foundation.  For more
  51  * information on the Apache Software Foundation, please see
  52  * <http://www.apache.org/>.
  53  */
  54
  55 /*
  56  * suexec.c -- "Wrapper" support program for suEXEC behaviour for Apache
  57  *
  58  ***********************************************************************
  59  *
  60  * NOTE! : DO NOT edit this code!!!  Unless you know what you are doing,
  61  *         editing this code might open up your system in unexpected
  62  *         ways to would-be crackers.  Every precaution has been taken
  63  *         to make this code as safe as possible; alter it at your own
  64  *         risk.
  65  *
  66  ***********************************************************************
  67  *
  68  *
  69  */
  70
  71 #include "apr.h"
  72 #include "ap_config.h"
  73 #include "suexec.h"
  74
  75 #include <sys/param.h>
  76 #include <sys/stat.h>
  77 #include <sys/types.h>
  78 #include <string.h>
  79 #include <time.h>
  80 #if APR_HAVE_UNISTD_H
  81 #include <unistd.h>
  82 #endif
  83
  84 #include <stdio.h>
  85 #include <stdarg.h>
  86 #include <stdlib.h>
  87
  88 #ifdef HAVE_PWD_H
  89 #include <pwd.h>
  90 #endif
  91
  92 #ifdef HAVE_GRP_H
  93 #include <grp.h>
  94 #endif
  95
  96 /*
  97  ***********************************************************************
  98  * There is no initgroups() in QNX, so I believe this is safe :-)
  99  * Use cc -osuexec -3 -O -mf -DQNX suexec.c to compile.
 100  *
 101  * May 17, 1997.
 102  * Igor N. Kovalenko -- infoh@mail.wplus.net
 103  ***********************************************************************
 104  */
 105
 106 #if defined(NEED_INITGROUPS)
 107 int initgroups(const char *name, gid_t basegid)
 108 {
 109     /* QNX and MPE do not appear to support supplementary groups. */
 110     return 0;
 111 }
 112 #endif
 113
 114 #if defined(PATH_MAX)
 115 #define AP_MAXPATH PATH_MAX
 116 #elif defined(MAXPATHLEN)
 117 #define AP_MAXPATH MAXPATHLEN
 118 #else
 119 #define AP_MAXPATH 8192
 120 #endif
 121
 122 #define AP_ENVBUF 256
 123
 124 extern char **environ;
 125 static FILE *log = NULL;
 126
 127 char *safe_env_lst[] =
 128 {
 129     "AUTH_TYPE",
 130     "CONTENT_LENGTH",
 131     "CONTENT_TYPE",
 132     "DATE_GMT",
 133     "DATE_LOCAL",
 134     "DOCUMENT_NAME",
 135     "DOCUMENT_PATH_INFO",
 136     "DOCUMENT_ROOT",
 137     "DOCUMENT_URI",
 138     "FILEPATH_INFO",
 139     "GATEWAY_INTERFACE",
 140     "HTTPS",
 141     "LAST_MODIFIED",
 142     "PATH_INFO",
 143     "PATH_TRANSLATED",
 144     "QUERY_STRING",
 145     "QUERY_STRING_UNESCAPED",
 146     "REMOTE_ADDR",
 147     "REMOTE_HOST",
 148     "REMOTE_IDENT",
 149     "REMOTE_PORT",
 150     "REMOTE_USER",
 151     "REDIRECT_QUERY_STRING",
 152     "REDIRECT_STATUS",
 153     "REDIRECT_URL",
 154     "REQUEST_METHOD",
 155     "REQUEST_URI",
 156     "SCRIPT_FILENAME",
 157     "SCRIPT_NAME",
 158     "SCRIPT_URI",
 159     "SCRIPT_URL",
 160     "SERVER_ADMIN",
 161     "SERVER_NAME",
 162     "SERVER_ADDR",
 163     "SERVER_PORT",
 164     "SERVER_PROTOCOL",
 165     "SERVER_SOFTWARE",
 166     "UNIQUE_ID",
 167     "USER_NAME",
 168     "TZ",
 169     NULL
 170 };
 171
 172
 173 static void err_output(const char *fmt, va_list ap)
 174 {
 175 #ifdef AP_LOG_EXEC
 176     time_t timevar;
 177     struct tm *lt;
 178
 179     if (!log) {
 180         if ((log = fopen(AP_LOG_EXEC, "a")) == NULL) {
 181             fprintf(stderr, "failed to open log file\n");
 182             perror("fopen");
 183             exit(1);
 184         }
 185     }
 186
 187     time(&timevar);
 188     lt = localtime(&timevar);
 189
 190     fprintf(log, "[%d-%.2d-%.2d %.2d:%.2d:%.2d]: ",
 191             lt->tm_year + 1900, lt->tm_mon + 1, lt->tm_mday,
 192             lt->tm_hour, lt->tm_min, lt->tm_sec);
 193
 194     vfprintf(log, fmt, ap);
 195
 196     fflush(log);
 197 #endif /* AP_LOG_EXEC */
 198     return;
 199 }
 200
 201 static void log_err(const char *fmt,...)
 202 {
 203 #ifdef AP_LOG_EXEC
 204     va_list ap;
 205
 206     va_start(ap, fmt);
 207     err_output(fmt, ap);
 208     va_end(ap);
 209 #endif /* AP_LOG_EXEC */
 210     return;
 211 }
 212
 213 static void clean_env(void)
 214 {
 215     char pathbuf[512];
 216     char **cleanenv;
 217     char **ep;
 218     int cidx = 0;
 219     int idx;
 220
 221
 222     if ((cleanenv = (char **) calloc(AP_ENVBUF, sizeof(char *))) == NULL) {
 223         log_err("failed to malloc memory for environment\n");
 224         exit(120);
 225     }
 226
 227     sprintf(pathbuf, "PATH=%s", AP_SAFE_PATH);
 228     cleanenv[cidx] = strdup(pathbuf);
 229     cidx++;
 230
 231     for (ep = environ; *ep && cidx < AP_ENVBUF-1; ep++) {
 232         if (!strncmp(*ep, "HTTP_", 5) || !strncmp(*ep, "SSL_", 4)) {
 233             cleanenv[cidx] = *ep;
 234             cidx++;
 235         }
 236         else {
 237             for (idx = 0; safe_env_lst[idx]; idx++) {
 238                 if (!strncmp(*ep, safe_env_lst[idx],
 239                              strlen(safe_env_lst[idx]))) {
 240                     cleanenv[cidx] = *ep;
 241                     cidx++;
 242                     break;
 243                 }
 244             }
 245         }
 246     }
 247
 248     cleanenv[cidx] = NULL;
 249
 250     environ = cleanenv;
 251 }
 252
 253 int main(int argc, char *argv[])
 254 {
 255     int userdir = 0;        /* ~userdir flag             */
 256     uid_t uid;              /* user information          */
 257     gid_t gid;              /* target group placeholder  */
 258     char *target_uname;     /* target user name          */
 259     char *target_gname;     /* target group name         */
 260     char *target_homedir;   /* target home directory     */
 261     char *actual_uname;     /* actual user name          */
 262     char *actual_gname;     /* actual group name         */
 263     char *prog;             /* name of this program      */
 264     char *cmd;              /* command to be executed    */
 265     char cwd[AP_MAXPATH];   /* current working directory */
 266     char dwd[AP_MAXPATH];   /* docroot working directory */
 267     struct passwd *pw;      /* password entry holder     */
 268     struct group *gr;       /* group entry holder        */
 269     struct stat dir_info;   /* directory info holder     */
 270     struct stat prg_info;   /* program info holder       */
 271
 272     prog = argv[0];
 273     /*
 274      * Check existence/validity of the UID of the user
 275      * running this program.  Error out if invalid.
 276      */
 277     uid = getuid();
 278     if ((pw = getpwuid(uid)) == NULL) {
 279         log_err("crit: invalid uid: (%ld)\n", uid);
 280         exit(102);
 281     }
 282     /*
 283      * See if this is a 'how were you compiled' request, and
 284      * comply if so.
 285      */
 286     if ((argc > 1)
 287         && (! strcmp(argv[1], "-V"))
 288         && ((uid == 0)
 289 #ifdef _OSD_POSIX
 290         /* User name comparisons are case insensitive on BS2000/OSD */
 291             || (! strcasecmp(AP_HTTPD_USER, pw->pw_name)))
 292 #else  /* _OSD_POSIX */
 293             || (! strcmp(AP_HTTPD_USER, pw->pw_name)))
 294 #endif /* _OSD_POSIX */
 295         ) {
 296 #ifdef AP_DOC_ROOT
 297         fprintf(stderr, " -D AP_DOC_ROOT=\"%s\"\n", AP_DOC_ROOT);
 298 #endif
 299 #ifdef AP_GID_MIN
 300         fprintf(stderr, " -D AP_GID_MIN=%d\n", AP_GID_MIN);
 301 #endif
 302 #ifdef AP_HTTPD_USER
 303         fprintf(stderr, " -D AP_HTTPD_USER=\"%s\"\n", AP_HTTPD_USER);
 304 #endif
 305 #ifdef AP_LOG_EXEC
 306         fprintf(stderr, " -D AP_LOG_EXEC=\"%s\"\n", AP_LOG_EXEC);
 307 #endif
 308 #ifdef AP_SAFE_PATH
 309         fprintf(stderr, " -D AP_SAFE_PATH=\"%s\"\n", AP_SAFE_PATH);
 310 #endif
 311 #ifdef AP_SUEXEC_UMASK
 312         fprintf(stderr, " -D AP_SUEXEC_UMASK=%03o\n", AP_SUEXEC_UMASK);
 313 #endif
 314 #ifdef AP_UID_MIN
 315         fprintf(stderr, " -D AP_UID_MIN=%d\n", AP_UID_MIN);
 316 #endif
 317 #ifdef AP_USERDIR_SUFFIX
 318         fprintf(stderr, " -D AP_USERDIR_SUFFIX=\"%s\"\n", AP_USERDIR_SUFFIX);
 319 #endif
 320         exit(0);
 321     }
 322     /*
 323      * If there are a proper number of arguments, set
 324      * all of them to variables.  Otherwise, error out.
 325      */
 326     if (argc < 4) {
 327         log_err("too few arguments\n");
 328         exit(101);
 329     }
 330     target_uname = argv[1];
 331     target_gname = argv[2];
 332     cmd = argv[3];
 333
 334     /*
 335      * Check to see if the user running this program
 336      * is the user allowed to do so as defined in
 337      * suexec.h.  If not the allowed user, error out.
 338      */
 339 #ifdef _OSD_POSIX
 340     /* User name comparisons are case insensitive on BS2000/OSD */
 341     if (strcasecmp(AP_HTTPD_USER, pw->pw_name)) {
 342         log_err("user mismatch (%s instead of %s)\n", pw->pw_name, AP_HTTPD_USER);
 343         exit(103);
 344     }
 345 #else  /*_OSD_POSIX*/
 346     if (strcmp(AP_HTTPD_USER, pw->pw_name)) {
 347         log_err("user mismatch (%s instead of %s)\n", pw->pw_name, AP_HTTPD_USER);
 348         exit(103);
 349     }
 350 #endif /*_OSD_POSIX*/
 351
 352     /*
 353      * Check for a leading '/' (absolute path) in the command to be executed,
 354      * or attempts to back up out of the current directory,
 355      * to protect against attacks.  If any are
 356      * found, error out.  Naughty naughty crackers.
 357      */
 358     if ((cmd[0] == '/') || (!strncmp(cmd, "../", 3))
 359         || (strstr(cmd, "/../") != NULL)) {
 360         log_err("invalid command (%s)\n", cmd);
 361         exit(104);
 362     }
 363
 364     /*
 365      * Check to see if this is a ~userdir request.  If
 366      * so, set the flag, and remove the '~' from the
 367      * target username.
 368      */
 369     if (!strncmp("~", target_uname, 1)) {
 370         target_uname++;
 371         userdir = 1;
 372     }
 373
 374     /*
 375      * Error out if the target username is invalid.
 376      */
 377     if (strspn(target_uname, "1234567890") != strlen(target_uname)) {
 378         if ((pw = getpwnam(target_uname)) == NULL) {
 379             log_err("invalid target user name: (%s)\n", target_uname);
 380             exit(105);
 381         }
 382     }
 383     else {
 384         if ((pw = getpwuid(atoi(target_uname))) == NULL) {
 385             log_err("invalid target user id: (%s)\n", target_uname);
 386             exit(121);
 387         }
 388     }
 389
 390     /*
 391      * Error out if the target group name is invalid.
 392      */
 393     if (strspn(target_gname, "1234567890") != strlen(target_gname)) {
 394         if ((gr = getgrnam(target_gname)) == NULL) {
 395             log_err("invalid target group name: (%s)\n", target_gname);
 396             exit(106);
 397         }
 398         gid = gr->gr_gid;
 399         actual_gname = strdup(gr->gr_name);
 400     }
 401     else {
 402         gid = atoi(target_gname);
 403         actual_gname = strdup(target_gname);
 404     }
 405
 406 #ifdef _OSD_POSIX
 407     /*
 408      * Initialize BS2000 user environment
 409      */
 410     {
 411         pid_t pid;
 412         int status;
 413
 414         switch (pid = ufork(target_uname)) {
 415         case -1:    /* Error */
 416             log_err("failed to setup bs2000 environment for user %s: %s\n",
 417                     target_uname, strerror(errno));
 418             exit(150);
 419         case 0:     /* Child */
 420             break;
 421         default:    /* Father */
 422             while (pid != waitpid(pid, &status, 0))
 423                 ;
 424             /* @@@ FIXME: should we deal with STOP signals as well? */
 425             if (WIFSIGNALED(status)) {
 426                 kill (getpid(), WTERMSIG(status));
 427             }
 428             exit(WEXITSTATUS(status));
 429         }
 430     }
 431 #endif /*_OSD_POSIX*/
 432
 433     /*
 434      * Save these for later since initgroups will hose the struct
 435      */
 436     uid = pw->pw_uid;
 437     actual_uname = strdup(pw->pw_name);
 438     target_homedir = strdup(pw->pw_dir);
 439
 440     /*
 441      * Log the transaction here to be sure we have an open log
 442      * before we setuid().
 443      */
 444     log_err("uid: (%s/%s) gid: (%s/%s) cmd: %s\n",
 445             target_uname, actual_uname,
 446             target_gname, actual_gname,
 447             cmd);
 448
 449     /*
 450      * Error out if attempt is made to execute as root or as
 451      * a UID less than AP_UID_MIN.  Tsk tsk.
 452      */
 453     if ((uid == 0) || (uid < AP_UID_MIN)) {
 454         log_err("cannot run as forbidden uid (%d/%s)\n", uid, cmd);
 455         exit(107);
 456     }
 457
 458     /*
 459      * Error out if attempt is made to execute as root group
 460      * or as a GID less than AP_GID_MIN.  Tsk tsk.
 461      */
 462     if ((gid == 0) || (gid < AP_GID_MIN)) {
 463         log_err("cannot run as forbidden gid (%d/%s)\n", gid, cmd);
 464         exit(108);
 465     }
 466
 467     /*
 468      * Change UID/GID here so that the following tests work over NFS.
 469      *
 470      * Initialize the group access list for the target user,
 471      * and setgid() to the target group. If unsuccessful, error out.
 472      */
 473     if (((setgid(gid)) != 0) || (initgroups(actual_uname, gid) != 0)) {
 474         log_err("failed to setgid (%ld: %s)\n", gid, cmd);
 475         exit(109);
 476     }
 477
 478     /*
 479      * setuid() to the target user.  Error out on fail.
 480      */
 481     if ((setuid(uid)) != 0) {
 482         log_err("failed to setuid (%ld: %s)\n", uid, cmd);
 483         exit(110);
 484     }
 485
 486     /*
 487      * Get the current working directory, as well as the proper
 488      * document root (dependant upon whether or not it is a
 489      * ~userdir request).  Error out if we cannot get either one,
 490      * or if the current working directory is not in the docroot.
 491      * Use chdir()s and getcwd()s to avoid problems with symlinked
 492      * directories.  Yuck.
 493      */
 494     if (getcwd(cwd, AP_MAXPATH) == NULL) {
 495         log_err("cannot get current working directory\n");
 496         exit(111);
 497     }
 498
 499     if (userdir) {
 500         if (((chdir(target_homedir)) != 0) ||
 501             ((chdir(AP_USERDIR_SUFFIX)) != 0) ||
 502             ((getcwd(dwd, AP_MAXPATH)) == NULL) ||
 503             ((chdir(cwd)) != 0)) {
 504             log_err("cannot get docroot information (%s)\n", target_homedir);
 505             exit(112);
 506         }
 507     }
 508     else {
 509         if (((chdir(AP_DOC_ROOT)) != 0) ||
 510             ((getcwd(dwd, AP_MAXPATH)) == NULL) ||
 511             ((chdir(cwd)) != 0)) {
 512             log_err("cannot get docroot information (%s)\n", AP_DOC_ROOT);
 513             exit(113);
 514         }
 515     }
 516
 517     if ((strncmp(cwd, dwd, strlen(dwd))) != 0) {
 518         log_err("command not in docroot (%s/%s)\n", cwd, cmd);
 519         exit(114);
 520     }
 521
 522     /*
 523      * Stat the cwd and verify it is a directory, or error out.
 524      */
 525     if (((lstat(cwd, &dir_info)) != 0) || !(S_ISDIR(dir_info.st_mode))) {
 526         log_err("cannot stat directory: (%s)\n", cwd);
 527         exit(115);
 528     }
 529
 530     /*
 531      * Error out if cwd is writable by others.
 532      */
 533     if ((dir_info.st_mode & S_IWOTH) || (dir_info.st_mode & S_IWGRP)) {
 534         log_err("directory is writable by others: (%s)\n", cwd);
 535         exit(116);
 536     }
 537
 538     /*
 539      * Error out if we cannot stat the program.
 540      */
 541     if (((lstat(cmd, &prg_info)) != 0) || (S_ISLNK(prg_info.st_mode))) {
 542         log_err("cannot stat program: (%s)\n", cmd);
 543         exit(117);
 544     }
 545
 546     /*
 547      * Error out if the program is writable by others.
 548      */
 549     if ((prg_info.st_mode & S_IWOTH) || (prg_info.st_mode & S_IWGRP)) {
 550         log_err("file is writable by others: (%s/%s)\n", cwd, cmd);
 551         exit(118);
 552     }
 553
 554     /*
 555      * Error out if the file is setuid or setgid.
 556      */
 557     if ((prg_info.st_mode & S_ISUID) || (prg_info.st_mode & S_ISGID)) {
 558         log_err("file is either setuid or setgid: (%s/%s)\n", cwd, cmd);
 559         exit(119);
 560     }
 561
 562     /*
 563      * Error out if the target name/group is different from
 564      * the name/group of the cwd or the program.
 565      */
 566     if ((uid != dir_info.st_uid) ||
 567         (gid != dir_info.st_gid) ||
 568         (uid != prg_info.st_uid) ||
 569         (gid != prg_info.st_gid)) {
 570         log_err("target uid/gid (%ld/%ld) mismatch "
 571                 "with directory (%ld/%ld) or program (%ld/%ld)\n",
 572                 uid, gid,
 573                 dir_info.st_uid, dir_info.st_gid,
 574                 prg_info.st_uid, prg_info.st_gid);
 575         exit(120);
 576     }
 577     /*
 578      * Error out if the program is not executable for the user.
 579      * Otherwise, she won't find any error in the logs except for
 580      * "[error] Premature end of script headers: ..."
 581      */
 582     if (!(prg_info.st_mode & S_IXUSR)) {
 583         log_err("file has no execute permission: (%s/%s)\n", cwd, cmd);
 584         exit(121);
 585     }
 586
 587 #ifdef AP_SUEXEC_UMASK
 588     /*
 589      * umask() uses inverse logic; bits are CLEAR for allowed access.
 590      */
 591     if ((~AP_SUEXEC_UMASK) & 0022) {
 592         log_err("notice: AP_SUEXEC_UMASK of %03o allows "
 593                 "write permission to group and/or other\n", AP_SUEXEC_UMASK);
 594     }
 595     umask(AP_SUEXEC_UMASK);
 596 #endif /* AP_SUEXEC_UMASK */
 597     clean_env();
 598
 599     /*
 600      * Be sure to close the log file so the CGI can't
 601      * mess with it.  If the exec fails, it will be reopened
 602      * automatically when log_err is called.  Note that the log
 603      * might not actually be open if AP_LOG_EXEC isn't defined.
 604      * However, the "log" cell isn't ifdef'd so let's be defensive
 605      * and assume someone might have done something with it
 606      * outside an ifdef'd AP_LOG_EXEC block.
 607      */
 608     if (log != NULL) {
 609         fclose(log);
 610         log = NULL;
 611     }
 612
 613     /*
 614      * Execute the command, replacing our image with its own.
 615      */
 616 #ifdef NEED_HASHBANG_EMUL
 617     /* We need the #! emulation when we want to execute scripts */
 618     {
 619         extern char **environ;
 620
 621         ap_execve(cmd, &argv[3], environ);
 622     }
 623 #else /*NEED_HASHBANG_EMUL*/
 624     execv(cmd, &argv[3]);
 625 #endif /*NEED_HASHBANG_EMUL*/
 626
 627     /*
 628      * (I can't help myself...sorry.)
 629      *
 630      * Uh oh.  Still here.  Where's the kaboom?  There was supposed to be an
 631      * EARTH-shattering kaboom!
 632      *
 633      * Oh well, log the failure and error out.
 634      */
 635     log_err("(%d)%s: exec failed (%s)\n", errno, strerror(errno), cmd);
 636     exit(255);
 637 }