1
/* IVLE - Informatics Virtual Learning Environment
2
* Copyright (C) 2007-2008 The University of Melbourne
4
* This program is free software; you can redistribute it and/or modify
5
* it under the terms of the GNU General Public License as published by
6
* the Free Software Foundation; either version 2 of the License, or
7
* (at your option) any later version.
9
* This program is distributed in the hope that it will be useful,
10
* but WITHOUT ANY WARRANTY; without even the implied warranty of
11
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12
* GNU General Public License for more details.
14
* You should have received a copy of the GNU General Public License
15
* along with this program; if not, write to the Free Software
16
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
19
* Author: Tom Conway, Matt Giuca
22
* This program runs a given program in a given working dir.
23
* First, it chroots to a jail path and setuids to a given user ID.
24
* This is intented to provide a safe execution environment for arbitrary
25
* programs and services.
27
* Scripts (such as Python programs) should be executed by supplying
28
* "/usr/bin/python" as the program, and the script as the first argument.
30
* Usage: trampoline uid jail-path working-path program [args...]
31
* Must run as root. Will safely setuid to the supplied uid, checking that it
32
* is not root. Recommended that the file is set up as follows:
33
* sudo chown root:root trampoline; sudo chroot +s trampoline
43
#include <sys/mount.h>
44
#include <sys/types.h>
47
#include <sys/resource.h>
51
/* conf.h is admin-configured by the setup process.
52
* It defines jail_base.
58
/* Returns TRUE if the given uid is allowed to execute trampoline.
59
* Only root or the web server should be allowed to execute.
60
* This is determined by the whitelist allowed_uids in conf.h.
62
int uid_allowed(int uid)
65
/* root is always allowed to execute trampoline */
68
/* loop over all allowed_uids */
69
for (i=(sizeof(allowed_uids)/sizeof(*allowed_uids))-1; i>=0; i--)
71
if (allowed_uids[i] == uid)
74
/* default to disallowing */
78
/* Turn the process into a daemon using the standard
85
/* already a daemon */
86
if ( getppid() == 1 ) return;
88
/* Fork off the parent process */
93
/* If we got a good PID, then we can exit the parent process. */
98
/* At this point we are executing as the child process */
100
/* Change the file mode mask */
103
/* Create a new SID for the child process */
109
/* Change the current working directory. This prevents the current
110
directory from being locked; hence not being able to remove it. */
111
if ((chdir("/")) < 0) {
115
/* Redirect standard files to /dev/null */
116
freopen( "/dev/null", "r", stdin);
117
freopen( "/dev/null", "w", stdout);
118
freopen( "/dev/null", "w", stderr);
121
static void usage(const char* nm)
124
"usage: %s [-d] [-u] <uid> <base> <src> <system> <jail> <cwd> <program> [args...]\n", nm);
128
#ifdef IVLE_AUFS_JAILS
129
/* Die more pleasantly if mallocs fail. */
130
void *die_if_null(void *ptr)
134
perror("not enough memory");
140
int checked_mount(const char *source, const char *target,
141
const char *filesystemtype, unsigned long mountflags,
144
int result = mount(source, target, filesystemtype, mountflags, data);
147
syslog(LOG_ERR, "could not mount %s on %s\n", source, target);
148
perror("could not mount");
156
/* Find the path of the user components of a jail, given a mountpoint. */
157
char *jail_src(const char *jail_src_base, const char *jail_base,
158
const char *jailpath)
164
srclen = strlen(jail_src_base);
165
dstlen = strlen(jail_base);
167
src = die_if_null(malloc(strlen(jailpath) + (srclen - dstlen) + 1));
168
strcpy(src, jail_src_base);
169
strcat(src, jailpath+dstlen);
174
/* Check for the validity of a jail in the given path, mounting it if it looks
176
* TODO: Updating /etc/mtab would be nice. */
177
void mount_if_needed(const char *jail_src_base, const char *jail_base,
178
const char *jail_system, const char *jailpath)
185
/* Check if there is something useful in the jail. If not, it's probably
187
jaillib = die_if_null(malloc(strlen(jailpath) + 5));
188
sprintf(jaillib, "%s/lib", jailpath);
190
if (access(jaillib, F_OK))
192
/* No /lib? Mustn't be mounted. Mount it, creating the dir if needed. */
193
if (access(jailpath, F_OK))
195
if(mkdir(jailpath, 0755))
197
syslog(LOG_ERR, "could not create mountpoint %s\n", jailpath);
198
perror("could not create jail mountpoint");
201
syslog(LOG_NOTICE, "created mountpoint %s\n", jailpath);
204
jailsrc = jail_src(jail_src_base, jail_base, jailpath);
205
checked_mount(jail_system, jailpath, NULL, MS_BIND | MS_RDONLY, NULL);
207
source_bits = die_if_null(malloc(strlen(jailsrc) + 5 + 1));
208
target_bits = die_if_null(malloc(strlen(jailpath) + 5 + 1));
209
sprintf(source_bits, "%s/home", jailsrc);
210
sprintf(target_bits, "%s/home", jailpath);
212
checked_mount(source_bits, target_bits, NULL, MS_BIND, NULL);
214
sprintf(source_bits, "%s/tmp", jailsrc);
215
sprintf(target_bits, "%s/tmp", jailpath);
217
checked_mount(source_bits, target_bits, NULL, MS_BIND, NULL);
219
syslog(LOG_INFO, "mounted %s\n", jailpath);
228
#endif /* IVLE_AUFS_JAILS */
230
/* Unsets any signal mask applied by the parent process */
231
int unmask_signals(void)
235
sigset = die_if_null(malloc(sizeof(sigset_t)));
237
result = sigprocmask(SIG_SETMASK, sigset, NULL);
239
printf("%d", result);
243
int main(int argc, char* const argv[])
256
char canonical_jailpath[PATH_MAX];
258
/* Disallow execution from all users but the whitelisted ones, and root */
259
if (!uid_allowed(getuid()))
261
fprintf(stderr, "only the web server may execute trampoline\n");
265
/* Args check and usage */
271
if (strcmp(argv[arg_num], "-d") == 0)
281
if (strcmp(argv[arg_num], "-u") == 0)
290
uid = atoi(argv[arg_num++]);
291
jail_base = argv[arg_num++];
292
jail_src_base = argv[arg_num++];
293
jail_system = argv[arg_num++];
294
jailpath = argv[arg_num++];
295
work_dir = argv[arg_num++];
296
prog = argv[arg_num];
297
args = argv + arg_num;
299
/* Disallow suiding to the root user */
302
fprintf(stderr, "cannot set up a jail as root\n");
306
/* Jail path must be an absolute path,
307
* and it must begin with jail_base.
309
if (norm(canonical_jailpath, PATH_MAX, jailpath) != 0)
311
fprintf(stderr, "bad jail path: %s\n", jailpath);
314
if (strncmp(canonical_jailpath, jail_base, strlen(jail_base)))
316
fprintf(stderr, "bad jail path: %s\n", jailpath);
320
openlog("trampoline", LOG_CONS | LOG_PID | LOG_NDELAY, LOG_USER);
322
#ifdef IVLE_AUFS_JAILS
323
mount_if_needed(jail_src_base, jail_base, jail_system, canonical_jailpath);
324
#endif /* IVLE_AUFS_JAILS */
326
/* chroot into the jail.
327
* Henceforth this process, and its children, cannot see anything above
328
* canoncial_jailpath. */
329
if (chroot(canonical_jailpath))
331
syslog(LOG_ERR, "chroot to %s failed\n", canonical_jailpath);
333
perror("could not chroot");
337
/* chdir into the specified working directory */
340
perror("could not chdir");
344
/* setuid to the given user ID.
345
* Henceforth we will be running as this user instead of root.
349
perror("could not setgid");
355
perror("could not setuid");
359
/* set user resource limits */
363
/* Process adress space in memory */
364
l.rlim_cur = 192 * 1024 * 1024; /* 192MiB */
365
l.rlim_max = 256 * 1024 * 1024; /* 256MiB */
366
if (setrlimit(RLIMIT_AS, &l))
368
perror("could not setrlimit/RLIMIT_AS");
372
/* Process data segment in memory
373
* Note: This requires a kernel patch to work correctly otherwise it is
374
* ineffective (thus you are only limited by RLIMIT_AS)
376
l.rlim_cur = 192 * 1024 * 1024; /* 192MiB */
377
l.rlim_max = 256 * 1024 * 1024; /* 256MiB */
378
if (setrlimit(RLIMIT_DATA, &l))
380
perror("could not setrlimit/RLIMIT_DATA");
385
l.rlim_cur = 0; /* No core files */
386
l.rlim_max = 0; /* No core files */
387
if (setrlimit(RLIMIT_CORE, &l))
389
perror("could not setrlimit/RLIMIT_CORE");
394
l.rlim_cur = 25; /* 25 Seconds */
395
l.rlim_max = 30; /* 30 Seconds */
396
if (setrlimit(RLIMIT_CPU, &l))
398
perror("could not setrlimit/RLIMIT_CPU");
403
l.rlim_cur = 64 * 1024 * 1024; /* 64MiB */
404
l.rlim_max = 72 * 1024 * 1024; /* 72MiB */
405
if (setrlimit(RLIMIT_FSIZE, &l))
407
perror("could not setrlimit/RLIMIT_FSIZE");
412
/* Remove any signal handler masks so we can send signals to the child */
415
perror("could not unmask signals");
419
/* If everything was OK daemonize (if required) */
425
/* exec (replace this process with the a new instance of the target
426
* program). Pass along all the arguments.
427
* Note that for script execution, the "program" will be the interpreter,
428
* and the first argument will be the script. */
431
/* nb exec won't return unless there was an error */
432
syslog(LOG_ERR, "exec of %s in %s failed", prog, canonical_jailpath);
434
perror("could not exec");