From 338f579d2d3a27de21f4d4ca32d031ff513a5d3c Mon Sep 17 00:00:00 2001 From: Thorsten Kukuk Date: Tue, 29 Aug 2006 16:21:31 +0000 Subject: Relevant BUGIDs: Purpose of commit: new feature Commit summary: --------------- As discussed with Tomas I'm adding the pam_loginuid module from RH to make the SELinux/Audit stack complete: 2006-08-29 Thorsten Kukuk * doc/sag/pam_loginuid.xml: New. * doc/sag/Linux-PAM_SAG.xml: Include pam_loginuid.xml. * configure.in: Add modules/pam_loginuid/Makefile. * modules/Makefile.am: Add pam_loginuid sub directory. * libpam/pam_static_modules.h: Add pam_loginuid. * modules/pam_loginuid/Makefile.am: New. * modules/pam_loginuid/tst-pam_loginuid: New. * modules/pam_loginuid/pam_loginuid.8.xml: New. * modules/pam_loginuid/pam_loginuid.8: New, generated from XML source. * modules/pam_loginuid/pam_loginuid.c: New. * modules/pam_loginuid/README.xml: New. * modules/pam_loginuid/README: New, generated from XML source. --- modules/pam_loginuid/.cvsignore | 7 + modules/pam_loginuid/Makefile.am | 34 +++++ modules/pam_loginuid/README | 29 ++++ modules/pam_loginuid/README.xml | 36 +++++ modules/pam_loginuid/pam_loginuid.8 | 59 ++++++++ modules/pam_loginuid/pam_loginuid.8.xml | 125 +++++++++++++++++ modules/pam_loginuid/pam_loginuid.c | 240 ++++++++++++++++++++++++++++++++ modules/pam_loginuid/tst-pam_loginuid | 2 + 8 files changed, 532 insertions(+) create mode 100644 modules/pam_loginuid/.cvsignore create mode 100644 modules/pam_loginuid/Makefile.am create mode 100644 modules/pam_loginuid/README create mode 100644 modules/pam_loginuid/README.xml create mode 100644 modules/pam_loginuid/pam_loginuid.8 create mode 100644 modules/pam_loginuid/pam_loginuid.8.xml create mode 100644 modules/pam_loginuid/pam_loginuid.c create mode 100755 modules/pam_loginuid/tst-pam_loginuid (limited to 'modules/pam_loginuid') diff --git a/modules/pam_loginuid/.cvsignore b/modules/pam_loginuid/.cvsignore new file mode 100644 index 00000000..2a3d8d21 --- /dev/null +++ b/modules/pam_loginuid/.cvsignore @@ -0,0 +1,7 @@ +*.la +*.lo +.deps +.libs +Makefile +Makefile.in +pam_loginuid diff --git a/modules/pam_loginuid/Makefile.am b/modules/pam_loginuid/Makefile.am new file mode 100644 index 00000000..d4fd3263 --- /dev/null +++ b/modules/pam_loginuid/Makefile.am @@ -0,0 +1,34 @@ +# +# Copyright (c) 2006 Thorsten Kukuk +# + +CLEANFILES = *~ + +EXTRA_DIST = README $(MANS) $(XMLS) tst-pam_loginuid + +man_MANS = pam_loginuid.8 + +XMLS = README.xml pam_loginuid.8.xml + +securelibdir = $(SECUREDIR) +secureconfdir = $(SCONFIGDIR) + +AM_CFLAGS = -I$(top_srcdir)/libpam/include -I$(top_srcdir)/libpamc/include +AM_LDFLAGS = -no-undefined -avoid-version -module \ + -L$(top_builddir)/libpam -lpam +if HAVE_VERSIONING + AM_LDFLAGS += -Wl,--version-script=$(srcdir)/../modules.map +endif + +securelib_LTLIBRARIES = pam_loginuid.la + +if ENABLE_REGENERATE_MAN + +noinst_DATA = README + +README: pam_loginuid.8.xml + +-include $(top_srcdir)/Make.xml.rules +endif + +TESTS = tst-pam_loginuid diff --git a/modules/pam_loginuid/README b/modules/pam_loginuid/README new file mode 100644 index 00000000..c8b0eb00 --- /dev/null +++ b/modules/pam_loginuid/README @@ -0,0 +1,29 @@ +pam_loginuid — Record user's login uid to the process attribute + +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ + +DESCRIPTION + +The pam_loginuid module sets the loginuid process attribute for the process +that was authenticated. This is necessary for applications to be correctly +audited. This PAM module should only be used for entry point applications like: +login, sshd, gdm, vsftpd, crond, at, and remote. There are probably other entry +point applications besides these. You should not use it for applications like +sudo or su as that defeats the purpose by changing the loginuid to the account +they just switched to. + +EXAMPLES + +#%PAM-1.0 +auth required pam_unix.so +auth required pam_nologin.so +account required pam_unix.so +password required pam_unix.so +session required pam_unix.so +session required pam_loginuid.so + + +AUTHOR + +pam_loginuid was written by Steve Grubb + diff --git a/modules/pam_loginuid/README.xml b/modules/pam_loginuid/README.xml new file mode 100644 index 00000000..3bcd38ab --- /dev/null +++ b/modules/pam_loginuid/README.xml @@ -0,0 +1,36 @@ + + +--> +]> + +
+ + + + + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" + href="pam_loginuid.8.xml" xpointer='xpointer(//refnamediv[@id = "pam_loginuid-name"]/*)'/> + + + + +
+ +
+ +
+ +
+ +
+ +
+ +
diff --git a/modules/pam_loginuid/pam_loginuid.8 b/modules/pam_loginuid/pam_loginuid.8 new file mode 100644 index 00000000..55485e9d --- /dev/null +++ b/modules/pam_loginuid/pam_loginuid.8 @@ -0,0 +1,59 @@ +.\" Title: pam_loginuid +.\" Author: +.\" Generator: DocBook XSL Stylesheets vsnapshot_2006\-08\-24_0226 +.\" Date: 08/29/2006 +.\" Manual: Linux\-PAM Manual +.\" Source: Linux\-PAM Manual +.\" +.TH "PAM_LOGINUID" "8" "08/29/2006" "Linux\-PAM Manual" "Linux\-PAM Manual" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" +pam_loginuid \- Record user's login uid to the process attribute +.SH "SYNOPSIS" +.HP 16 +\fBpam_loginuid.so\fR [require_auditd] +.SH "DESCRIPTION" +.PP +The pam_loginuid module sets the loginuid process attribute for the process that was authenticated. This is necessary for applications to be correctly audited. This PAM module should only be used for entry point applications like: login, sshd, gdm, vsftpd, crond, at, and remote. There are probably other entry point applications besides these. You should not use it for applications like sudo or su as that defeats the purpose by changing the loginuid to the account they just switched to. +.SH "OPTIONS" +.TP 3n +\fBrequire_auditd\fR +This option, when given, will cause this module to query the audit daemon status and deny logins if it is not running. +.SH "MODULE SERVICES PROVIDED" +.PP +The +\fBsession\fR +service is supported. +.SH "RETURN VALUES" +.PP +.TP 3n +PAM_SESSION_ERR +An error occured during session management. +.SH "EXAMPLES" +.sp +.RS 3n +.nf +#%PAM\-1.0 +auth required pam_unix.so +auth required pam_nologin.so +account required pam_unix.so +password required pam_unix.so +session required pam_unix.so +session required pam_loginuid.so + +.fi +.RE +.SH "SEE ALSO" +.PP + +\fBpam.conf\fR(5), +\fBpam.d\fR(8), +\fBpam\fR(8), +\fBauditctl\fR(8), +\fBauditd\fR(8) +.SH "AUTHOR" +.PP +pam_loginuid was written by Steve Grubb diff --git a/modules/pam_loginuid/pam_loginuid.8.xml b/modules/pam_loginuid/pam_loginuid.8.xml new file mode 100644 index 00000000..7022d9af --- /dev/null +++ b/modules/pam_loginuid/pam_loginuid.8.xml @@ -0,0 +1,125 @@ + + + + + + + pam_loginuid + 8 + Linux-PAM Manual + + + + pam_loginuid + Record user's login uid to the process attribute + + + + + pam_loginuid.so + + require_auditd + + + + + + + DESCRIPTION + + + The pam_loginuid module sets the loginuid process attribute for the + process that was authenticated. This is necessary for applications + to be correctly audited. This PAM module should only be used for entry + point applications like: login, sshd, gdm, vsftpd, crond, at, and + remote. There are probably other entry point applications besides + these. You should not use it for applications like sudo or su as + that defeats the purpose by changing the loginuid to the account + they just switched to. + + + + + OPTIONS + + + + + + + + This option, when given, will cause this module to query + the audit daemon status and deny logins if it is not running. + + + + + + + + MODULE SERVICES PROVIDED + + The service is supported. + + + + + RETURN VALUES + + + + PAM_SESSION_ERR + + + An error occured during session management. + + + + + + + + + + EXAMPLES + +#%PAM-1.0 +auth required pam_unix.so +auth required pam_nologin.so +account required pam_unix.so +password required pam_unix.so +session required pam_unix.so +session required pam_loginuid.so + + + + + SEE ALSO + + + pam.conf5 + , + + pam.d8 + , + + pam8 + , + + auditctl8 + , + + auditd8 + + + + + + AUTHOR + + pam_loginuid was written by Steve Grubb <sgrubb@redhat.com> + + + + diff --git a/modules/pam_loginuid/pam_loginuid.c b/modules/pam_loginuid/pam_loginuid.c new file mode 100644 index 00000000..13d915e3 --- /dev/null +++ b/modules/pam_loginuid/pam_loginuid.c @@ -0,0 +1,240 @@ +/* pam_loginuid.c -- + * Copyright 2005 Red Hat Inc., Durham, North Carolina. + * All Rights Reserved. + * + * This program is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation; either version 2 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + * + * Authors: + * Steve Grubb + * + * PAM module that sets the login uid introduced in kernel 2.6.11 + */ + +#include "config.h" +#include +#include +#include +#include +#include +#include +#include +#include + +#include +#include +#include + +#include + +#ifdef HAVE_LIBAUDIT +#include +#include +#include +#endif + +/* + * This function writes the loginuid to the /proc system. It returns + * 0 on success and 1 on failure. + */ +static int set_loginuid(pam_handle_t *pamh, uid_t uid) +{ + int fd, count, rc = 0; + char loginuid[24]; + + count = snprintf(loginuid, sizeof(loginuid), "%d", uid); + fd = open("/proc/self/loginuid", O_NOFOLLOW|O_WRONLY|O_TRUNC); + if (fd < 0) { + int loglevel = LOG_DEBUG; + if (errno != ENOENT) { + rc = 1; + loglevel = LOG_ERR; + } + pam_syslog(pamh, loglevel, "set_loginuid failed opening loginuid"); + return rc; + } + if (pam_modutil_write(fd, loginuid, count) != count) + rc = 1; + close(fd); + return rc; +} + +#ifdef HAVE_LIBAUDIT +/* + * This function is called only if "require_auditd" option is passed. It is + * called after loginuid has been set. The purpose is to disallow logins + * should the audit daemon not be running or crashed. It returns PAM_SUCCESS + * if the audit daemon is running and PAM_SESSION_ERR otherwise. + */ +static int check_auditd(void) +{ + int fd, retval; + + fd = audit_open(); + if (fd < 0) { + /* This is here to let people that build their own kernel + and disable the audit system get in. You get these error + codes only when the kernel doesn't have audit + compiled in. */ + if (errno == EINVAL || errno == EPROTONOSUPPORT || + errno == EAFNOSUPPORT) + return PAM_SUCCESS; + return PAM_SESSION_ERR; + } + retval = audit_request_status(fd); + if (retval > 0) { + struct audit_reply rep; + int i; + int timeout = 30; /* tenths of seconds */ + fd_set read_mask; + + FD_ZERO(&read_mask); + FD_SET(fd, &read_mask); + + for (i = 0; i < timeout; i++) { + struct timeval t; + int rc; + + t.tv_sec = 0; + t.tv_usec = 100000; + do { + rc = select(fd+1, &read_mask, NULL, NULL, &t); + } while (rc < 0 && errno == EINTR); + + rc = audit_get_reply(fd, &rep, GET_REPLY_NONBLOCKING,0); + if (rc > 0) { + /* If we get done or error, break out */ + if (rep.type == NLMSG_DONE || + rep.type == NLMSG_ERROR) + break; + + /* If its not status, keep looping */ + if (rep.type != AUDIT_GET) + continue; + + /* Found it... */ + close(fd); + if (rep.status->pid == 0) + return PAM_SESSION_ERR; + else + return PAM_SUCCESS; + } + } + } + close(fd); + if (retval == -ECONNREFUSED) { + /* This is here to let people that build their own kernel + and disable the audit system get in. ECONNREFUSED is + issued by the kernel when there is "no on listening". */ + return PAM_SUCCESS; + } else if (retval == -EPERM && getuid() != 0) { + /* If we get this, then the kernel supports auditing + * but we don't have enough privilege to write to the + * socket. Therefore, we have already been authenticated + * and we are a common user. Just act as though auditing + * is not enabled. Any other error we take seriously. */ + return PAM_SUCCESS; + } + + return PAM_SESSION_ERR; +} +#endif + +/* + * Initialize audit session for user + */ +static int +_pam_loginuid(pam_handle_t *pamh, int flags UNUSED, +#ifdef HAVE_LIBAUDIT + int argc, const char **argv +#else + int argc UNUSED, const char **argv UNUSED +#endif +) +{ + const char *user = NULL; + struct passwd *pwd; +#ifdef HAVE_LIBAUDIT + int require_auditd = 0; +#endif + + /* get user name */ + if (pam_get_user(pamh, &user, NULL) != PAM_SUCCESS) + { + pam_syslog(pamh, LOG_ERR, "error recovering login user-name"); + return PAM_SESSION_ERR; + } + + /* get user info */ + if ((pwd = pam_modutil_getpwnam(pamh, user)) == NULL) { + pam_syslog(pamh, LOG_ERR, + "error: login user-name '%s' does not exist", user); + return PAM_SESSION_ERR; + } + + if (set_loginuid(pamh, pwd->pw_uid)) { + pam_syslog(pamh, LOG_ERR, "set_loginuid failed\n"); + return PAM_SESSION_ERR; + } + +#ifdef HAVE_LIBAUDIT + while (argc-- > 0) { + if (strcmp(*argv, "require_auditd") == 0) + require_auditd = 1; + argv++; + } + + if (require_auditd) + return check_auditd(); + else +#endif + return PAM_SUCCESS; +} + +/* + * PAM routines + * + * This is here for vsftpd which doesn't seem to run the session stack + */ +PAM_EXTERN int +pam_sm_acct_mgmt(pam_handle_t *pamh, int flags, int argc, const char **argv) +{ + return _pam_loginuid(pamh, flags, argc, argv); +} + +PAM_EXTERN int +pam_sm_open_session(pam_handle_t *pamh, int flags, int argc, const char **argv) +{ + return _pam_loginuid(pamh, flags, argc, argv); +} + +PAM_EXTERN int +pam_sm_close_session(pam_handle_t *pamh UNUSED, int flags UNUSED, + int argc UNUSED, const char **argv UNUSED) +{ + return PAM_SUCCESS; +} + +/* static module data */ +#ifdef PAM_STATIC +struct pam_module _pam_loginuid_modstruct = { + "pam_loginuid", + NULL, + NULL, + pam_sm_acct_mgmt, + pam_sm_open_session, + pam_sm_close_session, + NULL +}; +#endif diff --git a/modules/pam_loginuid/tst-pam_loginuid b/modules/pam_loginuid/tst-pam_loginuid new file mode 100755 index 00000000..bd1e83b7 --- /dev/null +++ b/modules/pam_loginuid/tst-pam_loginuid @@ -0,0 +1,2 @@ +#!/bin/sh +../../tests/tst-dlopen .libs/pam_loginuid.so -- cgit v1.2.3