Sign Up
Log In
Log In
or
Sign Up
Places
All Projects
Status Monitor
Collapse sidebar
openSUSE:Leap:15.6:Update
openssh.28808
openssh-7.7p1-ldap.patch
Overview
Repositories
Revisions
Requests
Users
Attributes
Meta
File openssh-7.7p1-ldap.patch of Package openssh.28808
# HG changeset patch # Parent 860ce7cab52a11c12df044de6ffdcffa58c13f23 # Helper app for retrieving keys from a LDAP server # by Jan F. Chadima <jchadima@redhat.com> # # patch for openbsd-compat/base64.* introduces preprocessor macro # USE_INTERNAL_B64 intended to enforce using ssh supplied functions. # (The additional -lldap/-llber introduced in the patch cause configure to # discover the base64 functions in glibc (libresolv) and not to build the # internal versions. ssh-keyconverter consequently fails to link as it lacks # the proper flags, and libopenbsd-compat doesn't contain the b64_* functions) diff --git a/HOWTO.ldap-keys b/HOWTO.ldap-keys new file mode 100644 index 0000000..831d399 --- /dev/null +++ b/HOWTO.ldap-keys @@ -0,0 +1,108 @@ + +HOW TO START + +1) configure LDAP server + * Use LDAP server documentation +2) add appropriate LDAP schema + * For OpenLDAP or SunONE Use attached schema, otherwise you have to create + it. + * LDAP user entry + User entry: + - attached to the 'ldapPublicKey' objectclass + - attached to the 'posixAccount' objectclass + - with a filled 'sshPublicKey' attribute +3) insert users into LDAP + * Use LDAP Tree management tool as useful + * Entry in the LDAP server must respect 'posixAccount' and 'ldapPublicKey' + which are defined in core.schema and the additionnal lpk.schema. + * Example: + dn: uid=captain,ou=commanders,dc=enterprise,dc=universe + objectclass: top + objectclass: person + objectclass: organizationalPerson + objectclass: posixAccount + objectclass: ldapPublicKey + description: Jonathan Archer + userPassword: Porthos + cn: onathan Archer + sn: onathan Archer + uid: captain + uidNumber: 1001 + gidNumber: 1001 + homeDirectory: /home/captain + sshPublicKey: ssh-rss AAAAB3.... =captain@universe + sshPublicKey: command="kill -9 1" ssh-rss AAAAM5... +4) on the ssh side set in sshd_config + * Set up the backend + AuthorizedKeysCommand "@LIBEXECDIR@/ssh-ldap-wrapper" + AuthorizedKeysCommandRunAs <appropriate user to run LDAP> + * Do not forget to set + PubkeyAuthentication yes + * Swith off unnecessary auth methods +5) confugure ldap.conf + * Default ldap.conf is placed in /etc/ssh + * The configuration style is the same as other ldap based aplications +6) if necessary edit ssh-ldap-wrapper + * There is a possibility to change ldap.conf location + * There are some debug options + * Example + @LIBEXECDIR@/ssh-ldap-wrapper -s -f /etc/ldap.conf -w -d >> /tmp/ldapdebuglog.txt + +HOW TO MIGRATE FROM LPK + +1) goto HOW TO START 4) .... the ldap schema is the same + +2) convert the group requests to the appropriate LDAP requests + +HOW TO SOLVE PROBLEMS + +1) use debug in sshd + * /usr/sbin/sshd -d -d -d -d +2) use debug in ssh-ldap-helper + * ssh-ldap-helper -d -d -d -d -s <username> +3) use tcpdump ... other ldap client etc. + +ADVANTAGES + +1) Blocking an user account can be done directly from LDAP (if sshd is using + PubkeyAuthentication + AuthorizedKeysCommand with ldap only). + +DISADVANTAGES + +1) LDAP must be well configured, getting the public key of some user is not + a problem, but if anonymous LDAP allows write to users dn, somebody could + replace some user's public key by his own and impersonate some of your users + in all your server farm -- be VERY CAREFUL. +2) With incomplete PKI the MITM attack when sshd is requesting the public key, + could lead to a compromise of your servers allowing login as the + impersonated user. +3) If LDAP server is down there may be no fallback on passwd auth. + +MISC. + +1) todo + * Possibility to reuse the ssh-ldap-helper. + * Tune the LDAP part to accept all possible LDAP configurations. + +2) differences from original lpk + * No LDAP code in sshd. + * Support for various LDAP platforms and configurations. + * LDAP is configured in separate ldap.conf file. + +3) docs/link + * http://pacsec.jp/core05/psj05-barisani-en.pdf + * http://fritz.potsdam.edu/projects/openssh-lpk/ + * http://fritz.potsdam.edu/projects/sshgate/ + * http://dev.inversepath.com/trac/openssh-lpk + * http://lam.sf.net/ + ( http://lam.sourceforge.net/documentation/supportedSchemas.htm ) + +4) contributors/ideas/greets + - Eric AUGE <eau@phear.org> + - Andrea Barisani <andrea@inversepath.com> + - Falk Siemonsmeier. + - Jacob Rief. + - Michael Durchgraf. + - frederic peters. + - Finlay dobbie. + - Stefan Fisher. diff --git a/Makefile.in b/Makefile.in index 6010d1c..f54348b 100644 --- a/Makefile.in +++ b/Makefile.in @@ -25,6 +25,8 @@ SFTP_SERVER=$(libexecdir)/sftp-server SSH_KEYSIGN=$(libexecdir)/ssh-keysign SSH_PKCS11_HELPER=$(libexecdir)/ssh-pkcs11-helper SSH_SK_HELPER=$(libexecdir)/ssh-sk-helper +SSH_LDAP_HELPER=$(libexecdir)/ssh-ldap-helper +SSH_LDAP_WRAPPER=$(libexecdir)/ssh-ldap-wrapper CAVSTEST_CTR=$(libexecdir)/cavstest-ctr CAVSTEST_KDF=$(libexecdir)/cavstest-kdf PRIVSEP_PATH=@PRIVSEP_PATH@ @@ -74,6 +76,9 @@ TARGETS=ssh$(EXEEXT) sshd$(EXEEXT) ssh-add$(EXEEXT) ssh-keygen$(EXEEXT) ssh-keys TARGETS += cavstest-ctr$(EXEEXT) cavstest-kdf$(EXEEXT) +INSTALL_SSH_LDAP_HELPER=@INSTALL_SSH_LDAP_HELPER@ +TARGETS += ssh-ldap-helper$(EXEEXT) + XMSS_OBJS=\ ssh-xmss.o \ sshkey-xmss.o \ @@ -158,8 +163,8 @@ SFTPSERVER_OBJS=sftp-common.o sftp-server.o sftp-server-main.o SFTP_OBJS= sftp.o sftp-client.o sftp-common.o sftp-glob.o progressmeter.o -MANPAGES = moduli.5.out scp.1.out ssh-add.1.out ssh-agent.1.out ssh-keygen.1.out ssh-keyscan.1.out ssh.1.out sshd.8.out sftp-server.8.out sftp.1.out ssh-keysign.8.out ssh-pkcs11-helper.8.out ssh-sk-helper.8.out sshd_config.5.out ssh_config.5.out -MANPAGES_IN = moduli.5 scp.1 ssh-add.1 ssh-agent.1 ssh-keygen.1 ssh-keyscan.1 ssh.1 sshd.8 sftp-server.8 sftp.1 ssh-keysign.8 ssh-pkcs11-helper.8 ssh-sk-helper.8 sshd_config.5 ssh_config.5 +MANPAGES = moduli.5.out scp.1.out ssh-add.1.out ssh-agent.1.out ssh-keygen.1.out ssh-keyscan.1.out ssh.1.out sshd.8.out sftp-server.8.out sftp.1.out ssh-keysign.8.out ssh-pkcs11-helper.8.out ssh-sk-helper.8.out sshd_config.5.out ssh_config.5.out ssh-ldap-helper.8.out ssh-ldap.conf.5.out +MANPAGES_IN = moduli.5 scp.1 ssh-add.1 ssh-agent.1 ssh-keygen.1 ssh-keyscan.1 ssh.1 sshd.8 sftp-server.8 sftp.1 ssh-keysign.8 ssh-pkcs11-helper.8 ssh-sk-helper.8 sshd_config.5 ssh_config.5 ssh-ldap-helper.8 ssh-ldap.conf.5 MANTYPE = @MANTYPE@ CONFIGFILES=sshd_config.out ssh_config.out moduli.out @@ -242,6 +247,9 @@ ssh-sk-helper$(EXEEXT): $(LIBCOMPAT) libssh.a $(SKHELPER_OBJS) ssh-keyscan$(EXEEXT): $(LIBCOMPAT) libssh.a $(SSHKEYSCAN_OBJS) $(LD) -o $@ $(SSHKEYSCAN_OBJS) $(LDFLAGS) -lssh -lopenbsd-compat -lssh $(LIBS) +ssh-ldap-helper$(EXEEXT): $(LIBCOMPAT) libssh.a ldapconf.o ldapbody.o ldapmisc.o ldap-helper.o + $(LD) -o $@ ldapconf.o ldapbody.o ldapmisc.o ldap-helper.o $(LDFLAGS) -lssh -lopenbsd-compat -lssh -lopenbsd-compat $(LIBS) + sftp-server$(EXEEXT): $(LIBCOMPAT) libssh.a $(SFTPSERVER_OBJS) $(LD) -o $@ $(SFTPSERVER_OBJS) $(LDFLAGS) -lssh -lopenbsd-compat $(LIBS) @@ -406,6 +414,10 @@ install-files: $(INSTALL) -m 0755 $(STRIP_OPT) sshd$(EXEEXT) $(DESTDIR)$(sbindir)/sshd$(EXEEXT) $(INSTALL) -m 4711 $(STRIP_OPT) ssh-keysign$(EXEEXT) $(DESTDIR)$(SSH_KEYSIGN)$(EXEEXT) $(INSTALL) -m 0755 $(STRIP_OPT) ssh-pkcs11-helper$(EXEEXT) $(DESTDIR)$(SSH_PKCS11_HELPER)$(EXEEXT) + if test ! -z "$(INSTALL_SSH_LDAP_HELPER)" ; then \ + $(INSTALL) -m 0755 $(STRIP_OPT) ssh-ldap-helper $(DESTDIR)$(SSH_LDAP_HELPER) ; \ + $(INSTALL) -m 0755 ssh-ldap-wrapper $(DESTDIR)$(SSH_LDAP_WRAPPER) ; \ + fi $(INSTALL) -m 0755 $(STRIP_OPT) ssh-sk-helper$(EXEEXT) $(DESTDIR)$(SSH_SK_HELPER)$(EXEEXT) $(INSTALL) -m 0755 $(STRIP_OPT) sftp$(EXEEXT) $(DESTDIR)$(bindir)/sftp$(EXEEXT) $(INSTALL) -m 0755 $(STRIP_OPT) sftp-server$(EXEEXT) $(DESTDIR)$(SFTP_SERVER)$(EXEEXT) @@ -425,6 +437,10 @@ install-files: $(INSTALL) -m 644 sftp-server.8.out $(DESTDIR)$(mandir)/$(mansubdir)8/sftp-server.8 $(INSTALL) -m 644 ssh-keysign.8.out $(DESTDIR)$(mandir)/$(mansubdir)8/ssh-keysign.8 $(INSTALL) -m 644 ssh-pkcs11-helper.8.out $(DESTDIR)$(mandir)/$(mansubdir)8/ssh-pkcs11-helper.8 + if test ! -z "$(INSTALL_SSH_LDAP_HELPER)" ; then \ + $(INSTALL) -m 644 ssh-ldap-helper.8.out $(DESTDIR)$(mandir)/$(mansubdir)8/ssh-ldap-helper.8 ; \ + $(INSTALL) -m 644 ssh-ldap.conf.5.out $(DESTDIR)$(mandir)/$(mansubdir)5/ssh-ldap.conf.5 ; \ + fi $(INSTALL) -m 644 ssh-sk-helper.8.out $(DESTDIR)$(mandir)/$(mansubdir)8/ssh-sk-helper.8 install-sysconf: @@ -449,6 +465,13 @@ install-sysconf: else \ echo "$(DESTDIR)$(sysconfdir)/moduli already exists, install will not overwrite"; \ fi + if test ! -z "$(INSTALL_SSH_LDAP_HELPER)" ; then \ + if [ ! -f $(DESTDIR)$(sysconfdir)/ldap.conf ]; then \ + $(INSTALL) -m 644 ldap.conf $(DESTDIR)$(sysconfdir)/ldap.conf; \ + else \ + echo "$(DESTDIR)$(sysconfdir)/ldap.conf already exists, install will not overwrite"; \ + fi ; \ + fi host-key: ssh-keygen$(EXEEXT) @if [ -z "$(DESTDIR)" ] ; then \ @@ -487,6 +510,8 @@ uninstall: -rm -f $(DESTDIR)$(SSH_KEYSIGN)$(EXEEXT) -rm -f $(DESTDIR)$(SSH_PKCS11_HELPER)$(EXEEXT) -rm -f $(DESTDIR)$(SSH_SK_HELPER)$(EXEEXT) + -rm -f $(DESTDIR)$(SSH_LDAP_HELPER)$(EXEEXT) + -rm -f $(DESTDIR)$(SSH_LDAP_WRAPPER)$(EXEEXT) -rm -f $(DESTDIR)$(mandir)/$(mansubdir)1/ssh.1 -rm -f $(DESTDIR)$(mandir)/$(mansubdir)1/scp.1 -rm -f $(DESTDIR)$(mandir)/$(mansubdir)1/ssh-add.1 @@ -499,6 +524,7 @@ uninstall: -rm -f $(DESTDIR)$(mandir)/$(mansubdir)8/ssh-keysign.8 -rm -f $(DESTDIR)$(mandir)/$(mansubdir)8/ssh-pkcs11-helper.8 -rm -f $(DESTDIR)$(mandir)/$(mansubdir)8/ssh-sk-helper.8 + -rm -f $(DESTDIR)$(mandir)/$(mansubdir)8/ssh-ldap-helper.8 regress-prep: $(MKDIR_P) `pwd`/regress/unittests/test_helper diff --git a/configure.ac b/configure.ac index 4ddf539..1fd0b17 100644 --- a/configure.ac +++ b/configure.ac @@ -1688,6 +1688,106 @@ AC_ARG_WITH([audit], esac ] ) +# Check whether user wants LDAP support +LDAP_MSG="no" +INSTALL_SSH_LDAP_HELPER="" +AC_ARG_WITH(ldap, + [ --with-ldap[[=PATH]] Enable LDAP pubkey support (optionally in PATH)], + [ + if test "x$withval" != "xno" ; then + + INSTALL_SSH_LDAP_HELPER="yes" + CPPFLAGS="$CPPFLAGS -DLDAP_DEPRECATED" + + if test "x$withval" != "xyes" ; then + CPPFLAGS="$CPPFLAGS -I${withval}/include" + LDFLAGS="$LDFLAGS -L${withval}/lib" + fi + + AC_DEFINE([WITH_LDAP_PUBKEY], 1, [Enable LDAP pubkey support]) + LDAP_MSG="yes" + + AC_CHECK_HEADERS(lber.h) + AC_CHECK_HEADERS(ldap.h, , AC_MSG_ERROR(could not locate <ldap.h>)) + AC_CHECK_HEADERS(ldap_ssl.h) + + AC_ARG_WITH(ldap-lib, + [ --with-ldap-lib=type select ldap library [auto|netscape5|netscape4|netscape3|umich|openldap]]) + + if test -z "$with_ldap_lib"; then + with_ldap_lib=auto + fi + + if test -z "$found_ldap_lib" -a \( $with_ldap_lib = auto -o $with_ldap_lib = umich -o $with_ldap_lib = openldap \); then + AC_CHECK_LIB(lber, main, LIBS="-llber $LIBS" found_ldap_lib=yes) + AC_CHECK_LIB(ldap, main, LIBS="-lldap $LIBS" found_ldap_lib=yes) + fi + + if test -z "$found_ldap_lib" -a \( $with_ldap_lib = auto -o $with_ldap_lib = netscape5 \); then + AC_CHECK_LIB(ldap50, main, LIBS="-lldap50 -lssldap50 -lssl3 -lnss3 -lnspr4 -lprldap50 -lplc4 -lplds4 $LIBS" found_ldap_lib=yes) + fi + + if test -z "$found_ldap_lib" -a \( $with_ldap_lib = auto -o $with_ldap_lib = netscape4 \); then + AC_CHECK_LIB(ldapssl41, main, LIBS="-lldapssl41 -lplc3 -lplds3 -lnspr3 $LIBS" found_ldap_lib=yes) + if test -z "$found_ldap_lib"; then + AC_CHECK_LIB(ldapssl40, main, LIBS="-lldapssl40 $LIBS" found_ldap_lib=yes) + fi + if test -z "$found_ldap_lib"; then + AC_CHECK_LIB(ldap41, main, LIBS="-lldap41 $LIBS" found_ldap_lib=yes) + fi + if test -z "$found_ldap_lib"; then + AC_CHECK_LIB(ldap40, main, LIBS="-lldap40 $LIBS" found_ldap_lib=yes) + fi + fi + + if test -z "$found_ldap_lib" -a \( $with_ldap_lib = auto -o $with_ldap_lib = netscape3 \); then + AC_CHECK_LIB(ldapssl30, main, LIBS="-lldapssl30 $LIBS" found_ldap_lib=yes) + fi + + if test -z "$found_ldap_lib"; then + AC_MSG_ERROR(could not locate a valid LDAP library) + fi + + AC_MSG_CHECKING([for working LDAP support]) + AC_TRY_COMPILE( + [#include <sys/types.h> + #include <ldap.h>], + [(void)ldap_init(0, 0);], + [AC_MSG_RESULT(yes)], + [ + AC_MSG_RESULT(no) + AC_MSG_ERROR([** Incomplete or missing ldap libraries **]) + ]) + AC_CHECK_FUNCS( \ + ldap_init \ + ldap_get_lderrno \ + ldap_set_lderrno \ + ldap_parse_result \ + ldap_memfree \ + ldap_controls_free \ + ldap_set_option \ + ldap_get_option \ + ldapssl_init \ + ldap_start_tls_s \ + ldap_pvt_tls_set_option \ + ldap_initialize \ + ) + AC_CHECK_FUNCS(ldap_set_rebind_proc, + AC_MSG_CHECKING([number arguments of ldap_set_rebind_proc]) + AC_TRY_COMPILE( + [#include <lber.h> + #include <ldap.h>], + [ldap_set_rebind_proc(0, 0, 0);], + [ac_cv_ldap_set_rebind_proc=3], + [ac_cv_ldap_set_rebind_proc=2]) + AC_MSG_RESULT($ac_cv_ldap_set_rebind_proc) + AC_DEFINE(LDAP_SET_REBIND_PROC_ARGS, $ac_cv_ldap_set_rebind_proc, [number arguments of ldap_set_rebind_proc]) + ) + fi + ] +) +AC_SUBST(INSTALL_SSH_LDAP_HELPER) + AC_ARG_WITH([pie], [ --with-pie Build Position Independent Executables if possible], [ if test "x$withval" = "xno"; then diff --git a/ldap-helper.c b/ldap-helper.c new file mode 100644 index 0000000..0efff1f --- /dev/null +++ b/ldap-helper.c @@ -0,0 +1,155 @@ +/* $OpenBSD: ssh-pka-ldap.c,v 1.1 2009/12/03 03:34:42 jfch Exp $ */ +/* + * Copyright (c) 2009 Jan F. Chadima. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES + * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. + * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, + * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT + * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF + * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +#include "ldapincludes.h" +#include "log.h" +#include "misc.h" +#include "xmalloc.h" +#include "ldapconf.h" +#include "ldapbody.h" +#include <string.h> +#include <unistd.h> + +static int config_debug = 0; +int config_exclusive_config_file = 0; +static char *config_file_name = "/etc/ssh/ldap.conf"; +static char *config_single_user = NULL; +static int config_verbose = SYSLOG_LEVEL_VERBOSE; +int config_warning_config_file = 0; +extern char *__progname; + +static void +usage(void) +{ + fprintf(stderr, "usage: %s [options]\n", + __progname); + fprintf(stderr, "Options:\n"); + fprintf(stderr, " -d Output the log messages to stderr.\n"); + fprintf(stderr, " -e Check the config file for unknown commands.\n"); + fprintf(stderr, " -f file Use alternate config file (default is /etc/ssh/ldap.conf).\n"); + fprintf(stderr, " -s user Do not demonize, send the user's key to stdout.\n"); + fprintf(stderr, " -v Increase verbosity of the debug output (implies -d).\n"); + fprintf(stderr, " -w Warn on unknown commands in the config file.\n"); + exit(1); +} + +/* + * Main program for the ssh pka ldap agent. + */ + +int +main(int ac, char **av) +{ + int opt; + FILE *outfile = NULL; + + __progname = ssh_get_progname(av[0]); + + log_init(__progname, SYSLOG_LEVEL_DEBUG3, SYSLOG_FACILITY_AUTH, 0); + + /* + * Initialize option structure to indicate that no values have been + * set. + */ + initialize_options(); + + /* Parse command-line arguments. */ + while ((opt = getopt(ac, av, "def:s:vw")) != -1) { + switch (opt) { + case 'd': + config_debug = 1; + break; + + case 'e': + config_exclusive_config_file = 1; + config_warning_config_file = 1; + break; + + case 'f': + config_file_name = optarg; + break; + + case 's': + config_single_user = optarg; + outfile = fdopen (dup (fileno (stdout)), "w"); + break; + + case 'v': + config_debug = 1; + if (config_verbose < SYSLOG_LEVEL_DEBUG3) + config_verbose++; + break; + + case 'w': + config_warning_config_file = 1; + break; + + case '?': + default: + usage(); + break; + } + } + + /* Initialize loging */ + log_init(__progname, config_verbose, SYSLOG_FACILITY_AUTH, config_debug); + + if (ac != optind) + fatal ("illegal extra parameter %s", av[1]); + + /* Ensure that fds 0 and 2 are open or directed to /dev/null */ + if (config_debug == 0) + sanitise_stdfd(); + + /* Read config file */ + read_config_file(config_file_name); + fill_default_options(); + if (config_verbose == SYSLOG_LEVEL_DEBUG3) { + debug3 ("=== Configuration ==="); + dump_config(); + debug3 ("=== *** ==="); + } + + ldap_checkconfig(); + ldap_do_connect(); + + if (config_single_user) { + process_user (config_single_user, outfile); + } else { + usage(); + fatal ("Not yet implemented"); +/* TODO + * open unix socket a run the loop on it + */ + } + + ldap_do_close(); + return 0; +} + +/* Ugly hack */ +void *buffer_get_string(struct sshbuf *b, u_int *l) { return NULL; } +void buffer_put_string(struct sshbuf *b, const void *f, u_int l) {} + diff --git a/ldap-helper.h b/ldap-helper.h new file mode 100644 index 0000000..14cb29a --- /dev/null +++ b/ldap-helper.h @@ -0,0 +1,32 @@ +/* $OpenBSD: ldap-helper.h,v 1.1 2009/12/03 03:34:42 jfch Exp $ */ +/* + * Copyright (c) 2009 Jan F. Chadima. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES + * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. + * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, + * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT + * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF + * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +#ifndef LDAP_HELPER_H +#define LDAP_HELPER_H + +extern int config_exclusive_config_file; +extern int config_warning_config_file; + +#endif /* LDAP_HELPER_H */ diff --git a/ldap.conf b/ldap.conf new file mode 100644 index 0000000..42e38d3 --- /dev/null +++ b/ldap.conf @@ -0,0 +1,88 @@ +# $Id: openssh-5.5p1-ldap.patch,v 1.3 2010/07/07 13:48:36 jfch2222 Exp $ +# +# This is the example configuration file for the OpenSSH +# LDAP backend +# +# see ssh-ldap.conf(5) +# + +# URI with your LDAP server name. This allows to use +# Unix Domain Sockets to connect to a local LDAP Server. +#uri ldap://127.0.0.1/ +#uri ldaps://127.0.0.1/ +#uri ldapi://%2fvar%2frun%2fldapi_sock/ +# Note: %2f encodes the '/' used as directory separator + +# Another way to specify your LDAP server is to provide an +# host name and the port of our LDAP server. Host name +# must be resolvable without using LDAP. +# Multiple hosts may be specified, each separated by a +# space. How long nss_ldap takes to failover depends on +# whether your LDAP client library supports configurable +# network or connect timeouts (see bind_timelimit). +#host 127.0.0.1 + +# The port. +# Optional: default is 389. +#port 389 + +# The distinguished name to bind to the server with. +# Optional: default is to bind anonymously. +#binddn cn=openssh_keys,dc=example,dc=org + +# The credentials to bind with. +# Optional: default is no credential. +#bindpw TopSecret + +# The distinguished name of the search base. +#base dc=example,dc=org + +# The LDAP version to use (defaults to 3 +# if supported by client library) +#ldap_version 3 + +# The search scope. +#scope sub +#scope one +#scope base + +# Search timelimit +#timelimit 30 + +# Bind/connect timelimit +#bind_timelimit 30 + +# Reconnect policy: hard (default) will retry connecting to +# the software with exponential backoff, soft will fail +# immediately. +#bind_policy hard + +# SSL setup, may be implied by URI also. +#ssl no +#ssl on +#ssl start_tls + +# OpenLDAP SSL options +# Require and verify server certificate (yes/no) +# Default is to use libldap's default behavior, which can be configured in +# /etc/openldap/ldap.conf using the TLS_REQCERT setting. The default for +# OpenLDAP 2.0 and earlier is "no", for 2.1 and later is "yes". +#tls_checkpeer hard + +# CA certificates for server certificate verification +# At least one of these are required if tls_checkpeer is "yes" +#tls_cacertfile /etc/ssl/ca.cert +#tls_cacertdir /etc/pki/tls/certs + +# Seed the PRNG if /dev/urandom is not provided +#tls_randfile /var/run/egd-pool + +# SSL cipher suite +# See man ciphers for syntax +#tls_ciphers TLSv1 + +# Client certificate and key +# Use these, if your server requires client authentication. +#tls_cert +#tls_key + diff --git a/ldapbody.c b/ldapbody.c new file mode 100644 index 0000000..032cc89 --- /dev/null +++ b/ldapbody.c @@ -0,0 +1,494 @@ +/* $OpenBSD: ldapbody.c,v 1.1 2009/12/03 03:34:42 jfch Exp $ */ +/* + * Copyright (c) 2009 Jan F. Chadima. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES + * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. + * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, + * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT + * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF + * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +#include "ldapincludes.h" +#include "log.h" +#include "xmalloc.h" +#include "ldapconf.h" +#include "ldapmisc.h" +#include "ldapbody.h" +#include <stdio.h> +#include <unistd.h> + +#define LDAPSEARCH_FORMAT "(&(objectclass=posixAccount)(objectclass=ldapPublicKey)(uid=%s)%s)" +#define PUBKEYATTR "sshPublicKey" +#define LDAP_LOGFILE "%s/ldap.%d" + +static FILE *logfile = NULL; +static LDAP *ld; + +static char *attrs[] = { + PUBKEYATTR, + NULL +}; + +void +ldap_checkconfig (void) +{ +#ifdef HAVE_LDAP_INITIALIZE + if (options.host == NULL && options.uri == NULL) +#else + if (options.host == NULL) +#endif + fatal ("missing \"host\" in config file"); +} + +#if defined(LDAP_API_FEATURE_X_OPENLDAP) && (LDAP_API_VERSION > 2000) +static int +_rebind_proc (LDAP * ld, LDAP_CONST char *url, int request, ber_int_t msgid) +{ + struct timeval timeout; + int rc; +#if defined(HAVE_LDAP_PARSE_RESULT) && defined(HAVE_LDAP_CONTROLS_FREE) + LDAPMessage *result; +#endif /* HAVE_LDAP_PARSE_RESULT && HAVE_LDAP_CONTROLS_FREE */ + + debug2 ("Doing LDAP rebind to %s", options.binddn); + if (options.ssl == SSL_START_TLS) { + if ((rc = ldap_start_tls_s (ld, NULL, NULL)) != LDAP_SUCCESS) { + error ("ldap_starttls_s: %s", ldap_err2string (rc)); + return LDAP_OPERATIONS_ERROR; + } + } + +#if !defined(HAVE_LDAP_PARSE_RESULT) || !defined(HAVE_LDAP_CONTROLS_FREE) + return ldap_simple_bind_s (ld, options.binddn, options.bindpw); +#else + if (ldap_simple_bind(ld, options.binddn, options.bindpw) < 0) + fatal ("ldap_simple_bind %s", ldap_err2string (ldap_get_lderrno (ld, 0, 0))); + + timeout.tv_sec = options.bind_timelimit; + timeout.tv_usec = 0; + result = NULL; + if ((rc = ldap_result (ld, msgid, FALSE, &timeout, &result)) < 1) { + error ("ldap_result %s", ldap_err2string (ldap_get_lderrno (ld, 0, 0))); + ldap_msgfree (result); + return LDAP_OPERATIONS_ERROR; + } + debug3 ("LDAP rebind to %s succesfull", options.binddn); + return rc; +#endif +} +#else + +static int +_rebind_proc (LDAP * ld, char **whop, char **credp, int *methodp, int freeit) +{ + if (freeit) + return LDAP_SUCCESS; + + *whop = strdup (options.binddn); + *credp = strdup (options.bindpw); + *methodp = LDAP_AUTH_SIMPLE; + debug2 ("Doing LDAP rebind for %s", *whop); + return LDAP_SUCCESS; +} +#endif + +void +ldap_do_connect(void) +{ + int rc, msgid, ld_errno = 0; + struct timeval timeout; +#if defined(HAVE_LDAP_PARSE_RESULT) && defined(HAVE_LDAP_CONTROLS_FREE) + int parserc; + LDAPMessage *result; + LDAPControl **controls; + int reconnect = 0; +#endif /* HAVE_LDAP_PARSE_RESULT && HAVE_LDAP_CONTROLS_FREE */ + + debug ("LDAP do connect"); + +retry: + if (reconnect) { + debug3 ("Reconnecting with ld_errno %d", ld_errno); + if (options.bind_policy == 0 || + (ld_errno != LDAP_SERVER_DOWN && ld_errno != LDAP_TIMEOUT) || + reconnect > 5) + fatal ("Cannot connect to LDAP server"); + + if (reconnect > 1) + sleep (reconnect - 1); + + if (ld != NULL) { + ldap_unbind (ld); + ld = NULL; + } + logit("reconnecting to LDAP server..."); + } + + if (ld == NULL) { + int rc; + struct timeval tv; + +#ifdef HAVE_LDAP_SET_OPTION + if (options.debug > 0) { +#ifdef LBER_OPT_LOG_PRINT_FILE + if (options.logdir) { + char *logfilename; + int logfilenamelen; + + logfilenamelen = strlen (LDAP_LOGFILE) + strlen ("000000") + strlen (options.logdir); + logfilename = xmalloc (logfilenamelen); + snprintf (logfilename, logfilenamelen, LDAP_LOGFILE, options.logdir, (int) getpid ()); + logfilename[logfilenamelen - 1] = 0; + if ((logfile = fopen (logfilename, "a")) == NULL) + fatal ("cannot append to %s: %s", logfilename, strerror (errno)); + debug3 ("LDAP debug into %s", logfilename); + free (logfilename); + ber_set_option (NULL, LBER_OPT_LOG_PRINT_FILE, logfile); + } +#endif + if (options.debug) { +#ifdef LBER_OPT_DEBUG_LEVEL + ber_set_option (NULL, LBER_OPT_DEBUG_LEVEL, &options.debug); +#endif /* LBER_OPT_DEBUG_LEVEL */ +#ifdef LDAP_OPT_DEBUG_LEVEL + ldap_set_option (NULL, LDAP_OPT_DEBUG_LEVEL, &options.debug); +#endif /* LDAP_OPT_DEBUG_LEVEL */ + debug3 ("Set LDAP debug to %d", options.debug); + } + } +#endif /* HAVE_LDAP_SET_OPTION */ + + ld = NULL; +#ifdef HAVE_LDAPSSL_INIT + if (options.host != NULL) { + if (options.ssl_on == SSL_LDAPS) { + if ((rc = ldapssl_client_init (options.sslpath, NULL)) != LDAP_SUCCESS) + fatal ("ldapssl_client_init %s", ldap_err2string (rc)); + debug3 ("LDAPssl client init"); + } + + if (options.ssl_on != SSL_OFF) { + if ((ld = ldapssl_init (options.host, options.port, TRUE)) == NULL) + fatal ("ldapssl_init failed"); + debug3 ("LDAPssl init"); + } + } +#endif /* HAVE_LDAPSSL_INIT */ + + /* continue with opening */ + if (ld == NULL) { +#if defined (HAVE_LDAP_START_TLS_S) || (defined(HAVE_LDAP_SET_OPTION) && defined(LDAP_OPT_X_TLS)) + /* Some global TLS-specific options need to be set before we create our + * session context, so we set them here. */ + +#ifdef LDAP_OPT_X_TLS_RANDOM_FILE + /* rand file */ + if (options.tls_randfile != NULL) { + if ((rc = ldap_set_option (NULL, LDAP_OPT_X_TLS_RANDOM_FILE, + options.tls_randfile)) != LDAP_SUCCESS) + fatal ("ldap_set_option(LDAP_OPT_X_TLS_RANDOM_FILE): %s", + ldap_err2string (rc)); + debug3 ("Set TLS random file %s", options.tls_randfile); + } +#endif /* LDAP_OPT_X_TLS_RANDOM_FILE */ + + /* ca cert file */ + if (options.tls_cacertfile != NULL) { + if ((rc = ldap_set_option (NULL, LDAP_OPT_X_TLS_CACERTFILE, + options.tls_cacertfile)) != LDAP_SUCCESS) + error ("ldap_set_option(LDAP_OPT_X_TLS_CACERTFILE): %s", + ldap_err2string (rc)); + debug3 ("Set TLS CA cert file %s ", options.tls_cacertfile); + } + + /* ca cert directory */ + if (options.tls_cacertdir != NULL) { + if ((rc = ldap_set_option (NULL, LDAP_OPT_X_TLS_CACERTDIR, + options.tls_cacertdir)) != LDAP_SUCCESS) + fatal ("ldap_set_option(LDAP_OPT_X_TLS_CACERTDIR): %s", + ldap_err2string (rc)); + debug3 ("Set TLS CA cert dir %s ", options.tls_cacertdir); + } + + /* require cert? */ + if ((rc = ldap_set_option (NULL, LDAP_OPT_X_TLS_REQUIRE_CERT, + &options.tls_checkpeer)) != LDAP_SUCCESS) + fatal ("ldap_set_option(LDAP_OPT_X_TLS_REQUIRE_CERT): %s", + ldap_err2string (rc)); + debug3 ("Set TLS check peer to %d ", options.tls_checkpeer); + + /* set cipher suite, certificate and private key: */ + if (options.tls_ciphers != NULL) { + if ((rc = ldap_set_option (NULL, LDAP_OPT_X_TLS_CIPHER_SUITE, + options.tls_ciphers)) != LDAP_SUCCESS) + fatal ("ldap_set_option(LDAP_OPT_X_TLS_CIPHER_SUITE): %s", + ldap_err2string (rc)); + debug3 ("Set TLS ciphers to %s ", options.tls_ciphers); + } + + /* cert file */ + if (options.tls_cert != NULL) { + if ((rc = ldap_set_option (NULL, LDAP_OPT_X_TLS_CERTFILE, + options.tls_cert)) != LDAP_SUCCESS) + fatal ("ldap_set_option(LDAP_OPT_X_TLS_CERTFILE): %s", + ldap_err2string (rc)); + debug3 ("Set TLS cert file %s ", options.tls_cert); + } + + /* key file */ + if (options.tls_key != NULL) { + if ((rc = ldap_set_option (NULL, LDAP_OPT_X_TLS_KEYFILE, + options.tls_key)) != LDAP_SUCCESS) + fatal ("ldap_set_option(LDAP_OPT_X_TLS_KEYFILE): %s", + ldap_err2string (rc)); + debug3 ("Set TLS key file %s ", options.tls_key); + } +#endif +#ifdef HAVE_LDAP_INITIALIZE + if (options.uri != NULL) { + if ((rc = ldap_initialize (&ld, options.uri)) != LDAP_SUCCESS) + fatal ("ldap_initialize %s", ldap_err2string (rc)); + debug3 ("LDAP initialize %s", options.uri); + } + } +#endif /* HAVE_LDAP_INTITIALIZE */ + + /* continue with opening */ + if ((ld == NULL) && (options.host != NULL)) { +#ifdef HAVE_LDAP_INIT + if ((ld = ldap_init (options.host, options.port)) == NULL) + fatal ("ldap_init failed"); + debug3 ("LDAP init %s:%d", options.host, options.port); +#else + if ((ld = ldap_open (options.host, options.port)) == NULL) + fatal ("ldap_open failed"); + debug3 ("LDAP open %s:%d", options.host, options.port); +#endif /* HAVE_LDAP_INIT */ + } + + if (ld == NULL) + fatal ("no way to open ldap"); + +#if defined(HAVE_LDAP_SET_OPTION) && defined(LDAP_OPT_X_TLS) + if (options.ssl == SSL_LDAPS) { + if ((rc = ldap_set_option (ld, LDAP_OPT_X_TLS, &options.tls_checkpeer)) != LDAP_SUCCESS) + fatal ("ldap_set_option(LDAP_OPT_X_TLS) %s", ldap_err2string (rc)); + debug3 ("LDAP set LDAP_OPT_X_TLS_%d", options.tls_checkpeer); + } +#endif /* LDAP_OPT_X_TLS */ + +#if defined(HAVE_LDAP_SET_OPTION) && defined(LDAP_OPT_PROTOCOL_VERSION) + (void) ldap_set_option (ld, LDAP_OPT_PROTOCOL_VERSION, + &options.ldap_version); +#else + ld->ld_version = options.ldap_version; +#endif + debug3 ("LDAP set version to %d", options.ldap_version); + +#if LDAP_SET_REBIND_PROC_ARGS == 3 + ldap_set_rebind_proc (ld, _rebind_proc, NULL); +#elif LDAP_SET_REBIND_PROC_ARGS == 2 + ldap_set_rebind_proc (ld, _rebind_proc); +#else +#warning unknown LDAP_SET_REBIND_PROC_ARGS +#endif + debug3 ("LDAP set rebind proc"); + +#if defined(HAVE_LDAP_SET_OPTION) && defined(LDAP_OPT_DEREF) + (void) ldap_set_option (ld, LDAP_OPT_DEREF, &options.deref); +#else + ld->ld_deref = options.deref; +#endif + debug3 ("LDAP set deref to %d", options.deref); + +#if defined(HAVE_LDAP_SET_OPTION) && defined(LDAP_OPT_TIMELIMIT) + (void) ldap_set_option (ld, LDAP_OPT_TIMELIMIT, + &options.timelimit); +#else + ld->ld_timelimit = options.timelimit; +#endif + debug3 ("LDAP set timelimit to %d", options.timelimit); + +#if defined(HAVE_LDAP_SET_OPTION) && defined(LDAP_X_OPT_CONNECT_TIMEOUT) + /* + * This is a new option in the Netscape SDK which sets + * the TCP connect timeout. For want of a better value, + * we use the bind_timelimit to control this. + */ + timeout = options.bind_timelimit * 1000; + (void) ldap_set_option (ld, LDAP_X_OPT_CONNECT_TIMEOUT, &timeout); + debug3 ("LDAP set opt connect timeout to %d", timeout); +#endif + +#if defined(HAVE_LDAP_SET_OPTION) && defined(LDAP_OPT_NETWORK_TIMEOUT) + tv.tv_sec = options.bind_timelimit; + tv.tv_usec = 0; + (void) ldap_set_option (ld, LDAP_OPT_NETWORK_TIMEOUT, &tv); + debug3 ("LDAP set opt network timeout to %ld.0", tv.tv_sec); +#endif + +#if defined(HAVE_LDAP_SET_OPTION) && defined(LDAP_OPT_REFERRALS) + (void) ldap_set_option (ld, LDAP_OPT_REFERRALS, + options.referrals ? LDAP_OPT_ON : LDAP_OPT_OFF); + debug3 ("LDAP set referrals to %d", options.referrals); +#endif + +#if defined(HAVE_LDAP_SET_OPTION) && defined(LDAP_OPT_RESTART) + (void) ldap_set_option (ld, LDAP_OPT_RESTART, + options.restart ? LDAP_OPT_ON : LDAP_OPT_OFF); + debug3 ("LDAP set restart to %d", options.restart); +#endif + +#ifdef HAVE_LDAP_START_TLS_S + if (options.ssl == SSL_START_TLS) { + int version; + + if (ldap_get_option (ld, LDAP_OPT_PROTOCOL_VERSION, &version) + == LDAP_SUCCESS) { + if (version < LDAP_VERSION3) { + version = LDAP_VERSION3; + (void) ldap_set_option (ld, LDAP_OPT_PROTOCOL_VERSION, + &version); + debug3 ("LDAP set version to %d", version); + } + } + + if ((rc = ldap_start_tls_s (ld, NULL, NULL)) != LDAP_SUCCESS) + fatal ("ldap_starttls_s: %s", ldap_err2string (rc)); + debug3 ("LDAP start TLS"); + } +#endif /* HAVE_LDAP_START_TLS_S */ + } + + if ((msgid = ldap_simple_bind (ld, options.binddn, + options.bindpw)) == -1) { + ld_errno = ldap_get_lderrno (ld, 0, 0); + + error ("ldap_simple_bind %s", ldap_err2string (ld_errno)); + reconnect++; + goto retry; + } + debug3 ("LDAP simple bind (%s)", options.binddn); + + timeout.tv_sec = options.bind_timelimit; + timeout.tv_usec = 0; + if ((rc = ldap_result (ld, msgid, FALSE, &timeout, &result)) < 1) { + ld_errno = ldap_get_lderrno (ld, 0, 0); + + error ("ldap_result %s", ldap_err2string (ld_errno)); + reconnect++; + goto retry; + } + debug3 ("LDAP result in time"); + +#if defined(HAVE_LDAP_PARSE_RESULT) && defined(HAVE_LDAP_CONTROLS_FREE) + controls = NULL; + if ((parserc = ldap_parse_result (ld, result, &rc, 0, 0, 0, &controls, TRUE)) != LDAP_SUCCESS) + fatal ("ldap_parse_result %s", ldap_err2string (parserc)); + debug3 ("LDAP parse result OK"); + + if (controls != NULL) { + ldap_controls_free (controls); + } +#else + rc = ldap_result2error (session->ld, result, TRUE); +#endif + if (rc != LDAP_SUCCESS) + fatal ("error trying to bind as user \"%s\" (%s)", + options.binddn, ldap_err2string (rc)); + + debug2 ("LDAP do connect OK"); +} + +void +process_user (const char *user, FILE *output) +{ + LDAPMessage *res, *e; + char *buffer; + int bufflen, rc, i; + struct timeval timeout; + + debug ("LDAP process user"); + + /* quick check for attempts to be evil */ + if ((strchr(user, '(') != NULL) || (strchr(user, ')') != NULL) || + (strchr(user, '*') != NULL) || (strchr(user, '\\') != NULL)) { + logit ("illegal user name %s not processed", user); + return; + } + + /* build filter for LDAP request */ + bufflen = strlen (LDAPSEARCH_FORMAT) + strlen (user); + if (options.ssh_filter != NULL) + bufflen += strlen (options.ssh_filter); + buffer = xmalloc (bufflen); + snprintf(buffer, bufflen, LDAPSEARCH_FORMAT, user, (options.ssh_filter != NULL) ? options.ssh_filter : NULL); + buffer[bufflen - 1] = 0; + + debug3 ("LDAP search scope = %d %s", options.scope, buffer); + + timeout.tv_sec = options.timelimit; + timeout.tv_usec = 0; + if ((rc = ldap_search_st(ld, options.base, options.scope, buffer, attrs, 0, &timeout, &res)) != LDAP_SUCCESS) { + error ("ldap_search_st(): %s", ldap_err2string (rc)); + free (buffer); + return; + } + + /* free */ + free (buffer); + + for (e = ldap_first_entry(ld, res); e != NULL; e = ldap_next_entry(ld, e)) { + int num; + struct berval **keys; + + keys = ldap_get_values_len(ld, e, PUBKEYATTR); + num = ldap_count_values_len(keys); + for (i = 0 ; i < num ; i++) { + char *cp; //, *options = NULL; + + for (cp = keys[i]->bv_val; *cp == ' ' || *cp == '\t'; cp++); + if (!*cp || *cp == '\n' || *cp == '#') + continue; + + /* We have found the desired key. */ + fprintf (output, "%s\n", keys[i]->bv_val); + } + + ldap_value_free_len(keys); + } + + ldap_msgfree(res); + debug2 ("LDAP process user finished"); +} + +void +ldap_do_close(void) +{ + int rc; + + debug ("LDAP do close"); + if ((rc = ldap_unbind_ext(ld, NULL, NULL)) != LDAP_SUCCESS) + fatal ("ldap_unbind_ext: %s", + ldap_err2string (rc)); + + ld = NULL; + debug2 ("LDAP do close OK"); + return; +} + diff --git a/ldapbody.h b/ldapbody.h new file mode 100644 index 0000000..665dca2 --- /dev/null +++ b/ldapbody.h @@ -0,0 +1,37 @@ +/* $OpenBSD: ldapbody.h,v 1.1 2009/12/03 03:34:42 jfch Exp $ */ +/* + * Copyright (c) 2009 Jan F. Chadima. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES + * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. + * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, + * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT + * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF + * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +#ifndef LDAPBODY_H +#define LDAPBODY_H + +#include <stdio.h> + +void ldap_checkconfig(void); +void ldap_do_connect(void); +void process_user(const char *, FILE *); +void ldap_do_close(void); + +#endif /* LDAPBODY_H */ + diff --git a/ldapconf.c b/ldapconf.c new file mode 100644 index 0000000..2e22438 --- /dev/null +++ b/ldapconf.c @@ -0,0 +1,711 @@ +/* $OpenBSD: ldapconf.c,v 1.1 2009/12/03 03:34:42 jfch Exp $ */ +/* + * Copyright (c) 2009 Jan F. Chadima. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES + * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. + * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, + * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT + * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF + * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +#include "ldapincludes.h" +#include "ldap-helper.h" +#include "log.h" +#include "misc.h" +#include "xmalloc.h" +#include "ldapconf.h" +#include <unistd.h> +#include <string.h> + +/* Keyword tokens. */ + +typedef enum { + lBadOption, + lHost, lURI, lBase, lBindDN, lBindPW, lRootBindDN, + lScope, lDeref, lPort, lTimeLimit, lBind_TimeLimit, + lLdap_Version, lBind_Policy, lSSLPath, lSSL, lReferrals, + lRestart, lTLS_CheckPeer, lTLS_CaCertFile, + lTLS_CaCertDir, lTLS_Ciphers, lTLS_Cert, lTLS_Key, + lTLS_RandFile, lLogDir, lDebug, lSSH_Filter, + lDeprecated, lUnsupported +} OpCodes; + +/* Textual representations of the tokens. */ + +static struct { + const char *name; + OpCodes opcode; +} keywords[] = { + { "URI", lURI }, + { "Base", lBase }, + { "BindDN", lBindDN }, + { "BindPW", lBindPW }, + { "RootBindDN", lRootBindDN }, + { "Host", lHost }, + { "Port", lPort }, + { "Scope", lScope }, + { "Deref", lDeref }, + { "TimeLimit", lTimeLimit }, + { "TimeOut", lTimeLimit }, + { "Bind_Timelimit", lBind_TimeLimit }, + { "Network_TimeOut", lBind_TimeLimit }, +/* + * Todo + * SIZELIMIT + */ + { "Ldap_Version", lLdap_Version }, + { "Version", lLdap_Version }, + { "Bind_Policy", lBind_Policy }, + { "SSLPath", lSSLPath }, + { "SSL", lSSL }, + { "Referrals", lReferrals }, + { "Restart", lRestart }, + { "TLS_CheckPeer", lTLS_CheckPeer }, + { "TLS_ReqCert", lTLS_CheckPeer }, + { "TLS_CaCertFile", lTLS_CaCertFile }, + { "TLS_CaCert", lTLS_CaCertFile }, + { "TLS_CaCertDir", lTLS_CaCertDir }, + { "TLS_Ciphers", lTLS_Ciphers }, + { "TLS_Cipher_Suite", lTLS_Ciphers }, + { "TLS_Cert", lTLS_Cert }, + { "TLS_Certificate", lTLS_Cert }, + { "TLS_Key", lTLS_Key }, + { "TLS_RandFile", lTLS_RandFile }, +/* + * Todo + * TLS_CRLCHECK + * TLS_CRLFILE + */ + { "LogDir", lLogDir }, + { "Debug", lDebug }, + { "SSH_Filter", lSSH_Filter }, + { NULL, lBadOption } +}; + +/* Configuration ptions. */ + +Options options; + +/* + * Returns the number of the token pointed to by cp or oBadOption. + */ + +static OpCodes +parse_token(const char *cp, const char *filename, int linenum) +{ + u_int i; + + for (i = 0; keywords[i].name; i++) + if (strcasecmp(cp, keywords[i].name) == 0) + return keywords[i].opcode; + + if (config_warning_config_file) + logit("%s: line %d: Bad configuration option: %s", + filename, linenum, cp); + return lBadOption; +} + +/* + * Processes a single option line as used in the configuration files. This + * only sets those values that have not already been set. + */ +#define WHITESPACE " \t\r\n" + +static int +process_config_line(char *line, const char *filename, int linenum) +{ + char *s, **charptr, **xstringptr, *endofnumber, *keyword, *arg; + char *rootbinddn = NULL; + int opcode, *intptr, value; + size_t len; + + /* Strip trailing whitespace */ + for (len = strlen(line) - 1; len > 0; len--) { + if (strchr(WHITESPACE, line[len]) == NULL) + break; + line[len] = '\0'; + } + + s = line; + /* Get the keyword. (Each line is supposed to begin with a keyword). */ + if ((keyword = strdelim(&s)) == NULL) + return 0; + /* Ignore leading whitespace. */ + if (*keyword == '\0') + keyword = strdelim(&s); + if (keyword == NULL || !*keyword || *keyword == '\n' || *keyword == '#') + return 0; + + opcode = parse_token(keyword, filename, linenum); + + switch (opcode) { + case lBadOption: + /* don't panic, but count bad options */ + return -1; + /* NOTREACHED */ + + case lHost: + xstringptr = &options.host; +parse_xstring: + if (!s || *s == '\0') + fatal("%s line %d: missing dn",filename,linenum); + if (*xstringptr == NULL) + *xstringptr = xstrdup(s); + return 0; + + case lURI: + xstringptr = &options.uri; + goto parse_xstring; + + case lBase: + xstringptr = &options.base; + goto parse_xstring; + + case lBindDN: + xstringptr = &options.binddn; + goto parse_xstring; + + case lBindPW: + charptr = &options.bindpw; +parse_string: + arg = strdelim(&s); + if (!arg || *arg == '\0') + fatal("%.200s line %d: Missing argument.", filename, linenum); + if (*charptr == NULL) + *charptr = xstrdup(arg); + break; + + case lRootBindDN: + xstringptr = &rootbinddn; + goto parse_xstring; + + case lScope: + intptr = &options.scope; + arg = strdelim(&s); + if (!arg || *arg == '\0') + fatal("%.200s line %d: Missing sub/one/base argument.", + filename, linenum); + value = 0; /* To avoid compiler warning... */ + if (strcasecmp(arg, "sub") == 0 || + strcasecmp(arg, "subtree") == 0) + value = LDAP_SCOPE_SUBTREE; + else if (strcasecmp(arg, "one") == 0) + value = LDAP_SCOPE_ONELEVEL; + else if (strcasecmp(arg, "base") == 0) + value = LDAP_SCOPE_BASE; + else + fatal("%.200s line %d: Bad sub/one/base argument.", + filename, linenum); + if (*intptr == -1) + *intptr = value; + break; + + case lDeref: + intptr = &options.scope; + arg = strdelim(&s); + if (!arg || *arg == '\0') + fatal("%.200s line %d: Missing never/searching/finding/always argument.", + filename, linenum); + value = 0; /* To avoid compiler warning... */ + if (!strcasecmp(arg, "never")) + value = LDAP_DEREF_NEVER; + else if (!strcasecmp(arg, "searching")) + value = LDAP_DEREF_SEARCHING; + else if (!strcasecmp(arg, "finding")) + value = LDAP_DEREF_FINDING; + else if (!strcasecmp(arg, "always")) + value = LDAP_DEREF_ALWAYS; + else + fatal("%.200s line %d: Bad never/searching/finding/always argument.", + filename, linenum); + if (*intptr == -1) + *intptr = value; + break; + + case lPort: + intptr = &options.port; +parse_int: + arg = strdelim(&s); + if (!arg || *arg == '\0') + fatal("%.200s line %d: Missing argument.", filename, linenum); + if (arg[0] < '0' || arg[0] > '9') + fatal("%.200s line %d: Bad number.", filename, linenum); + + /* Octal, decimal, or hex format? */ + value = strtol(arg, &endofnumber, 0); + if (arg == endofnumber) + fatal("%.200s line %d: Bad number.", filename, linenum); + if (*intptr == -1) + *intptr = value; + break; + + case lTimeLimit: + intptr = &options.timelimit; +parse_time: + arg = strdelim(&s); + if (!arg || *arg == '\0') + fatal("%s line %d: missing time value.", + filename, linenum); + if ((value = convtime(arg)) == -1) + fatal("%s line %d: invalid time value.", + filename, linenum); + if (*intptr == -1) + *intptr = value; + break; + + case lBind_TimeLimit: + intptr = &options.bind_timelimit; + goto parse_time; + + case lLdap_Version: + intptr = &options.ldap_version; + goto parse_int; + + case lBind_Policy: + intptr = &options.bind_policy; + arg = strdelim(&s); + if (!arg || *arg == '\0') + fatal("%.200s line %d: Missing soft/hard argument.", + filename, linenum); + value = 0; /* To avoid compiler warning... */ + if (strcasecmp(arg, "hard") == 0 || + strcasecmp(arg, "hard_open") == 0 || + strcasecmp(arg, "hard_init") == 0) + value = 1; + else if (strcasecmp(arg, "soft") == 0) + value = 0; + else + fatal("%.200s line %d: Bad soft/hard argument.", + filename, linenum); + if (*intptr == -1) + break; + + case lSSLPath: + charptr = &options.sslpath; + goto parse_string; + + case lSSL: + intptr = &options.ssl; + arg = strdelim(&s); + if (!arg || *arg == '\0') + fatal("%.200s line %d: Missing yes/no/start_tls argument.", + filename, linenum); + value = 0; /* To avoid compiler warning... */ + if (strcasecmp(arg, "yes") == 0 || + strcasecmp(arg, "true") == 0 || + strcasecmp(arg, "on") == 0) + value = SSL_LDAPS; + else if (strcasecmp(arg, "no") == 0 || + strcasecmp(arg, "false") == 0 || + strcasecmp(arg, "off") == 0) + value = SSL_OFF; + else if (!strcasecmp (arg, "start_tls")) + value = SSL_START_TLS; + else + fatal("%.200s line %d: Bad yes/no/start_tls argument.", + filename, linenum); + if (*intptr == -1) + *intptr = value; + break; + + case lReferrals: + intptr = &options.referrals; +parse_flag: + arg = strdelim(&s); + if (!arg || *arg == '\0') + fatal("%.200s line %d: Missing yes/no argument.", + filename, linenum); + value = 0; /* To avoid compiler warning... */ + if (strcasecmp(arg, "yes") == 0 || + strcasecmp(arg, "true") == 0 || + strcasecmp(arg, "on") == 0) + value = 1; + else if (strcasecmp(arg, "no") == 0 || + strcasecmp(arg, "false") == 0 || + strcasecmp(arg, "off") == 0) + value = 0; + else + fatal("%.200s line %d: Bad yes/no argument.", + filename, linenum); + if (*intptr == -1) + *intptr = value; + break; + + case lRestart: + intptr = &options.restart; + goto parse_flag; + + case lTLS_CheckPeer: + intptr = &options.tls_checkpeer; + arg = strdelim(&s); + if (!arg || *arg == '\0') + fatal("%.200s line %d: Missing never/hard/demand/alow/try argument.", + filename, linenum); + value = 0; /* To avoid compiler warning... */ + if (strcasecmp(arg, "never") == 0 || + strcasecmp(arg, "no") == 0 || + strcasecmp(arg, "false") == 0 || + strcasecmp(arg, "off") == 0) + value = LDAP_OPT_X_TLS_NEVER; + else if (strcasecmp(arg, "hard") == 0 || + strcasecmp(arg, "yes") == 0 || + strcasecmp(arg, "true") == 0 || + strcasecmp(arg, "on") == 0) + value = LDAP_OPT_X_TLS_HARD; + else if (strcasecmp(arg, "demand") == 0) + value = LDAP_OPT_X_TLS_DEMAND; + else if (strcasecmp(arg, "allow") == 0) + value = LDAP_OPT_X_TLS_ALLOW; + else if (strcasecmp(arg, "try") == 0) + value = LDAP_OPT_X_TLS_TRY; + else + fatal("%.200s line %d: Bad never/hard/demand/alow/try argument.", + filename, linenum); + if (*intptr == -1) + break; + + case lTLS_CaCertFile: + charptr = &options.tls_cacertfile; + goto parse_string; + + case lTLS_CaCertDir: + charptr = &options.tls_cacertdir; + goto parse_string; + + case lTLS_Ciphers: + xstringptr = &options.tls_ciphers; + goto parse_xstring; + + case lTLS_Cert: + charptr = &options.tls_cert; + goto parse_string; + + case lTLS_Key: + charptr = &options.tls_key; + goto parse_string; + + case lTLS_RandFile: + charptr = &options.tls_randfile; + goto parse_string; + + case lLogDir: + charptr = &options.logdir; + goto parse_string; + + case lDebug: + intptr = &options.debug; + goto parse_int; + + case lSSH_Filter: + xstringptr = &options.ssh_filter; + goto parse_xstring; + + case lDeprecated: + debug("%s line %d: Deprecated option \"%s\"", + filename, linenum, keyword); + return 0; + + case lUnsupported: + error("%s line %d: Unsupported option \"%s\"", + filename, linenum, keyword); + return 0; + + default: + fatal("process_config_line: Unimplemented opcode %d", opcode); + } + + /* Check that there is no garbage at end of line. */ + if ((arg = strdelim(&s)) != NULL && *arg != '\0') { + fatal("%.200s line %d: garbage at end of line; \"%.200s\".", + filename, linenum, arg); + } + return 0; +} + +/* + * Reads the config file and modifies the options accordingly. Options + * should already be initialized before this call. This never returns if + * there is an error. If the file does not exist, this returns 0. + */ + +void +read_config_file(const char *filename) +{ + FILE *f; + char line[1024]; + int active, linenum; + int bad_options = 0; + struct stat sb; + + if ((f = fopen(filename, "r")) == NULL) + fatal("fopen %s: %s", filename, strerror(errno)); + + if (fstat(fileno(f), &sb) == -1) + fatal("fstat %s: %s", filename, strerror(errno)); + if (((sb.st_uid != 0 && sb.st_uid != getuid()) || + (sb.st_mode & 022) != 0)) + fatal("Bad owner or permissions on %s", filename); + + debug("Reading configuration data %.200s", filename); + + /* + * Mark that we are now processing the options. This flag is turned + * on/off by Host specifications. + */ + active = 1; + linenum = 0; + while (fgets(line, sizeof(line), f)) { + /* Update line number counter. */ + linenum++; + if (process_config_line(line, filename, linenum) != 0) + bad_options++; + } + fclose(f); + if ((bad_options > 0) && config_exclusive_config_file) + fatal("%s: terminating, %d bad configuration options", + filename, bad_options); +} + +/* + * Initializes options to special values that indicate that they have not yet + * been set. Read_config_file will only set options with this value. Options + * are processed in the following order: command line, user config file, + * system config file. Last, fill_default_options is called. + */ + +void +initialize_options(void) +{ + memset(&options, 'X', sizeof(options)); + options.host = NULL; + options.uri = NULL; + options.base = NULL; + options.binddn = NULL; + options.bindpw = NULL; + options.scope = -1; + options.deref = -1; + options.port = -1; + options.timelimit = -1; + options.bind_timelimit = -1; + options.ldap_version = -1; + options.bind_policy = -1; + options.sslpath = NULL; + options.ssl = -1; + options.referrals = -1; + options.restart = -1; + options.tls_checkpeer = -1; + options.tls_cacertfile = NULL; + options.tls_cacertdir = NULL; + options.tls_ciphers = NULL; + options.tls_cert = NULL; + options.tls_key = NULL; + options.tls_randfile = NULL; + options.logdir = NULL; + options.debug = -1; + options.ssh_filter = NULL; +} + +/* + * Called after processing other sources of option data, this fills those + * options for which no value has been specified with their default values. + */ + +void +fill_default_options(void) +{ + if (options.uri != NULL) { + LDAPURLDesc *ludp; + + if (ldap_url_parse(options.uri, &ludp) == LDAP_SUCCESS) { + if (options.ssl == -1) { + if (strcmp(ludp->lud_scheme, "ldap") == 0) + options.ssl = 2; + if (strcmp(ludp->lud_scheme, "ldapi") == 0) + options.ssl = 0; + else if (strcmp(ludp->lud_scheme, "ldaps") == 0) + options.ssl = 1; + } + if (options.host == NULL) + options.host = xstrdup (ludp->lud_host); + if (options.port == -1) + options.port = ludp->lud_port; + + ldap_free_urldesc (ludp); + } + } + if (options.ssl == -1) + options.ssl = SSL_START_TLS; + if (options.port == -1) + options.port = (options.ssl == 0) ? 389 : 636; + if (options.uri == NULL) { + int len; +#define MAXURILEN 4096 + + options.uri = xmalloc (MAXURILEN); + len = snprintf(options.uri, MAXURILEN, "ldap%s://%s:%d", + (options.ssl == 0) ? "" : "s", options.host, options.port); + options.uri[MAXURILEN - 1] = 0; + options.uri = xreallocarray(options.uri, len + 1, 1); + } + if (options.binddn == NULL) + options.binddn = ""; + if (options.bindpw == NULL) + options.bindpw = ""; + if (options.scope == -1) + options.scope = LDAP_SCOPE_SUBTREE; + if (options.deref == -1) + options.deref = LDAP_DEREF_NEVER; + if (options.timelimit == -1) + options.timelimit = 10; + if (options.bind_timelimit == -1) + options.bind_timelimit = 10; + if (options.ldap_version == -1) + options.ldap_version = 3; + if (options.bind_policy == -1) + options.bind_policy = 1; + if (options.referrals == -1) + options.referrals = 1; + if (options.restart == -1) + options.restart = 1; + if (options.tls_checkpeer == -1) + options.tls_checkpeer = LDAP_OPT_X_TLS_HARD; + if (options.debug == -1) + options.debug = 0; + if (options.ssh_filter == NULL) + options.ssh_filter = ""; +} + +static const char * +lookup_opcode_name(OpCodes code) +{ + u_int i; + + for (i = 0; keywords[i].name != NULL; i++) + if (keywords[i].opcode == code) + return(keywords[i].name); + return "UNKNOWN"; +} + +static void +dump_cfg_string(OpCodes code, const char *val) +{ + if (val == NULL) + debug3("%s <UNDEFINED>", lookup_opcode_name(code)); + else + debug3("%s %s", lookup_opcode_name(code), val); +} + +static void +dump_cfg_int(OpCodes code, int val) +{ + if (val == -1) + debug3("%s <UNDEFINED>", lookup_opcode_name(code)); + else + debug3("%s %d", lookup_opcode_name(code), val); +} + +struct names { + int value; + char *name; +}; + +static void +dump_cfg_namedint(OpCodes code, int val, struct names *names) +{ + u_int i; + + if (val == -1) + debug3("%s <UNDEFINED>", lookup_opcode_name(code)); + else { + for (i = 0; names[i].value != -1; i++) + if (names[i].value == val) { + debug3("%s %s", lookup_opcode_name(code), names[i].name); + return; + } + debug3("%s unknown: %d", lookup_opcode_name(code), val); + } +} + +static struct names _yesnotls[] = { + { 0, "No" }, + { 1, "Yes" }, + { 2, "Start_TLS" }, + { -1, NULL }}; + +static struct names _scope[] = { + { LDAP_SCOPE_BASE, "Base" }, + { LDAP_SCOPE_ONELEVEL, "One" }, + { LDAP_SCOPE_SUBTREE, "Sub"}, + { -1, NULL }}; + +static struct names _deref[] = { + { LDAP_DEREF_NEVER, "Never" }, + { LDAP_DEREF_SEARCHING, "Searching" }, + { LDAP_DEREF_FINDING, "Finding" }, + { LDAP_DEREF_ALWAYS, "Always" }, + { -1, NULL }}; + +static struct names _yesno[] = { + { 0, "No" }, + { 1, "Yes" }, + { -1, NULL }}; + +static struct names _bindpolicy[] = { + { 0, "Soft" }, + { 1, "Hard" }, + { -1, NULL }}; + +static struct names _checkpeer[] = { + { LDAP_OPT_X_TLS_NEVER, "Never" }, + { LDAP_OPT_X_TLS_HARD, "Hard" }, + { LDAP_OPT_X_TLS_DEMAND, "Demand" }, + { LDAP_OPT_X_TLS_ALLOW, "Allow" }, + { LDAP_OPT_X_TLS_TRY, "TRY" }, + { -1, NULL }}; + +void +dump_config(void) +{ + dump_cfg_string(lURI, options.uri); + dump_cfg_string(lHost, options.host); + dump_cfg_int(lPort, options.port); + dump_cfg_namedint(lSSL, options.ssl, _yesnotls); + dump_cfg_int(lLdap_Version, options.ldap_version); + dump_cfg_int(lTimeLimit, options.timelimit); + dump_cfg_int(lBind_TimeLimit, options.bind_timelimit); + dump_cfg_string(lBase, options.base); + dump_cfg_string(lBindDN, options.binddn); + dump_cfg_string(lBindPW, options.bindpw); + dump_cfg_namedint(lScope, options.scope, _scope); + dump_cfg_namedint(lDeref, options.deref, _deref); + dump_cfg_namedint(lReferrals, options.referrals, _yesno); + dump_cfg_namedint(lRestart, options.restart, _yesno); + dump_cfg_namedint(lBind_Policy, options.bind_policy, _bindpolicy); + dump_cfg_string(lSSLPath, options.sslpath); + dump_cfg_namedint(lTLS_CheckPeer, options.tls_checkpeer, _checkpeer); + dump_cfg_string(lTLS_CaCertFile, options.tls_cacertfile); + dump_cfg_string(lTLS_CaCertDir, options.tls_cacertdir); + dump_cfg_string(lTLS_Ciphers, options.tls_ciphers); + dump_cfg_string(lTLS_Cert, options.tls_cert); + dump_cfg_string(lTLS_Key, options.tls_key); + dump_cfg_string(lTLS_RandFile, options.tls_randfile); + dump_cfg_string(lLogDir, options.logdir); + dump_cfg_int(lDebug, options.debug); + dump_cfg_string(lSSH_Filter, options.ssh_filter); +} + diff --git a/ldapconf.h b/ldapconf.h new file mode 100644 index 0000000..c2aa704 --- /dev/null +++ b/ldapconf.h @@ -0,0 +1,71 @@ +/* $OpenBSD: ldapconf.c,v 1.1 2009/12/03 03:34:42 jfch Exp $ */ +/* + * Copyright (c) 2009 Jan F. Chadima. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES + * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. + * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, + * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT + * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF + * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +#ifndef LDAPCONF_H +#define LDAPCONF_H + +#define SSL_OFF 0 +#define SSL_LDAPS 1 +#define SSL_START_TLS 2 + +/* Data structure for representing option data. */ + +typedef struct { + char *host; + char *uri; + char *base; + char *binddn; + char *bindpw; + int scope; + int deref; + int port; + int timelimit; + int bind_timelimit; + int ldap_version; + int bind_policy; + char *sslpath; + int ssl; + int referrals; + int restart; + int tls_checkpeer; + char *tls_cacertfile; + char *tls_cacertdir; + char *tls_ciphers; + char *tls_cert; + char *tls_key; + char *tls_randfile; + char *logdir; + int debug; + char *ssh_filter; +} Options; + +extern Options options; + +void read_config_file(const char *); +void initialize_options(void); +void fill_default_options(void); +void dump_config(void); + +#endif /* LDAPCONF_H */ diff --git a/ldapincludes.h b/ldapincludes.h new file mode 100644 index 0000000..8539bdc --- /dev/null +++ b/ldapincludes.h @@ -0,0 +1,41 @@ +/* $OpenBSD: ldapconf.c,v 1.1 2009/12/03 03:34:42 jfch Exp $ */ +/* + * Copyright (c) 2009 Jan F. Chadima. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES + * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. + * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, + * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT + * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF + * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +#ifndef LDAPINCLUDES_H +#define LDAPINCLUDES_H + +#include "includes.h" + +#ifdef HAVE_LBER_H +#include <lber.h> +#endif +#ifdef HAVE_LDAP_H +#include <ldap.h> +#endif +#ifdef HAVE_LDAP_SSL_H +#include <ldap_ssl.h> +#endif + +#endif /* LDAPINCLUDES_H */ diff --git a/ldapmisc.c b/ldapmisc.c new file mode 100644 index 0000000..de23c0c --- /dev/null +++ b/ldapmisc.c @@ -0,0 +1,79 @@ + +#include "ldapincludes.h" +#include "ldapmisc.h" + +#ifndef HAVE_LDAP_GET_LDERRNO +int +ldap_get_lderrno (LDAP * ld, char **m, char **s) +{ +#ifdef HAVE_LDAP_GET_OPTION + int rc; +#endif + int lderrno; + +#if defined(HAVE_LDAP_GET_OPTION) && defined(LDAP_OPT_ERROR_NUMBER) + if ((rc = ldap_get_option (ld, LDAP_OPT_ERROR_NUMBER, &lderrno)) != LDAP_SUCCESS) + return rc; +#else + lderrno = ld->ld_errno; +#endif + + if (s != NULL) { +#if defined(HAVE_LDAP_GET_OPTION) && defined(LDAP_OPT_ERROR_STRING) + if ((rc = ldap_get_option (ld, LDAP_OPT_ERROR_STRING, s)) != LDAP_SUCCESS) + return rc; +#else + *s = ld->ld_error; +#endif + } + + if (m != NULL) { +#if defined(HAVE_LDAP_GET_OPTION) && defined(LDAP_OPT_MATCHED_DN) + if ((rc = ldap_get_option (ld, LDAP_OPT_MATCHED_DN, m)) != LDAP_SUCCESS) + return rc; +#else + *m = ld->ld_matched; +#endif + } + + return lderrno; +} +#endif + +#ifndef HAVE_LDAP_SET_LDERRNO +int +ldap_set_lderrno (LDAP * ld, int lderrno, const char *m, const char *s) +{ +#ifdef HAVE_LDAP_SET_OPTION + int rc; +#endif + +#if defined(HAVE_LDAP_SET_OPTION) && defined(LDAP_OPT_ERROR_NUMBER) + if ((rc = ldap_set_option (ld, LDAP_OPT_ERROR_NUMBER, &lderrno)) != LDAP_SUCCESS) + return rc; +#else + ld->ld_errno = lderrno; +#endif + + if (s != NULL) { +#if defined(HAVE_LDAP_SET_OPTION) && defined(LDAP_OPT_ERROR_STRING) + if ((rc = ldap_set_option (ld, LDAP_OPT_ERROR_STRING, s)) != LDAP_SUCCESS) + return rc; +#else + ld->ld_error = s; +#endif + } + + if (m != NULL) { +#if defined(HAVE_LDAP_SET_OPTION) && defined(LDAP_OPT_MATCHED_DN) + if ((rc = ldap_set_option (ld, LDAP_OPT_MATCHED_DN, m)) != LDAP_SUCCESS) + return rc; +#else + ld->ld_matched = m; +#endif + } + + return LDAP_SUCCESS; +} +#endif + diff --git a/ldapmisc.h b/ldapmisc.h new file mode 100644 index 0000000..4c271df --- /dev/null +++ b/ldapmisc.h @@ -0,0 +1,35 @@ +/* $OpenBSD: ldapbody.h,v 1.1 2009/12/03 03:34:42 jfch Exp $ */ +/* + * Copyright (c) 2009 Jan F. Chadima. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES + * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. + * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, + * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT + * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF + * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +#ifndef LDAPMISC_H +#define LDAPMISC_H + +#include "ldapincludes.h" + +int ldap_get_lderrno (LDAP *, char **, char **); +int ldap_set_lderrno (LDAP *, int, const char *, const char *); + +#endif /* LDAPMISC_H */ + diff --git a/openbsd-compat/base64.c b/openbsd-compat/base64.c index 9e74667..14824be 100644 --- a/openbsd-compat/base64.c +++ b/openbsd-compat/base64.c @@ -46,7 +46,7 @@ #include "includes.h" -#if (!defined(HAVE_B64_NTOP) && !defined(HAVE___B64_NTOP)) || (!defined(HAVE_B64_PTON) && !defined(HAVE___B64_PTON)) +#if (!defined(HAVE_B64_NTOP) && !defined(HAVE___B64_NTOP)) || (!defined(HAVE_B64_PTON) && !defined(HAVE___B64_PTON)) || defined(USE_INTERNAL_B64) #include <sys/types.h> #include <sys/param.h> @@ -129,7 +129,7 @@ static const char Pad64 = '='; characters followed by one "=" padding character. */ -#if !defined(HAVE_B64_NTOP) && !defined(HAVE___B64_NTOP) +#if !defined(HAVE_B64_NTOP) && !defined(HAVE___B64_NTOP) || defined(USE_INTERNAL_B64) int b64_ntop(u_char const *src, size_t srclength, char *target, size_t targsize) { @@ -185,7 +185,7 @@ b64_ntop(u_char const *src, size_t srclength, char *target, size_t targsize) } #endif /* !defined(HAVE_B64_NTOP) && !defined(HAVE___B64_NTOP) */ -#if !defined(HAVE_B64_PTON) && !defined(HAVE___B64_PTON) +#if !defined(HAVE_B64_PTON) && !defined(HAVE___B64_PTON) || defined(USE_INTERNAL_B64) /* skips all whitespace anywhere. converts characters, four at a time, starting at (or after) diff --git a/openbsd-compat/base64.h b/openbsd-compat/base64.h index bd77293..e27df9a 100644 --- a/openbsd-compat/base64.h +++ b/openbsd-compat/base64.h @@ -45,16 +45,16 @@ #include "includes.h" -#ifndef HAVE___B64_NTOP -# ifndef HAVE_B64_NTOP +#if !defined(HAVE___B64_NTOP) || defined(USE_INTERNAL_B64) +# if !defined(HAVE_B64_NTOP) || defined(USE_INTERNAL_B64) int b64_ntop(u_char const *src, size_t srclength, char *target, size_t targsize); # endif /* !HAVE_B64_NTOP */ # define __b64_ntop(a,b,c,d) b64_ntop(a,b,c,d) #endif /* HAVE___B64_NTOP */ -#ifndef HAVE___B64_PTON -# ifndef HAVE_B64_PTON +#if !defined(HAVE___B64_PTON) || defined(USE_INTERNAL_B64) +# if !defined(HAVE_B64_PTON) || defined(USE_INTERNAL_B64) int b64_pton(char const *src, u_char *target, size_t targsize); # endif /* !HAVE_B64_PTON */ # define __b64_pton(a,b,c) b64_pton(a,b,c) diff --git a/openssh-lpk-openldap.schema b/openssh-lpk-openldap.schema new file mode 100644 index 0000000..c84f90f --- /dev/null +++ b/openssh-lpk-openldap.schema @@ -0,0 +1,21 @@ +# +# LDAP Public Key Patch schema for use with openssh-ldappubkey +# useful with PKA-LDAP also +# +# Author: Eric AUGE <eau@phear.org> +# +# Based on the proposal of : Mark Ruijter +# + + +# octetString SYNTAX +attributetype ( 1.3.6.1.4.1.24552.500.1.1.1.13 NAME 'sshPublicKey' + DESC 'MANDATORY: OpenSSH Public key' + EQUALITY octetStringMatch + SYNTAX 1.3.6.1.4.1.1466.115.121.1.40 ) + +# printableString SYNTAX yes|no +objectclass ( 1.3.6.1.4.1.24552.500.1.1.2.0 NAME 'ldapPublicKey' SUP top AUXILIARY + DESC 'MANDATORY: OpenSSH LPK objectclass' + MUST ( sshPublicKey $ uid ) + ) diff --git a/openssh-lpk-sun.schema b/openssh-lpk-sun.schema new file mode 100644 index 0000000..3136673 --- /dev/null +++ b/openssh-lpk-sun.schema @@ -0,0 +1,23 @@ +# +# LDAP Public Key Patch schema for use with openssh-ldappubkey +# useful with PKA-LDAP also +# +# Author: Eric AUGE <eau@phear.org> +# +# Schema for Sun Directory Server. +# Based on the original schema, modified by Stefan Fischer. +# + +dn: cn=schema + +# octetString SYNTAX +attributeTypes: ( 1.3.6.1.4.1.24552.500.1.1.1.13 NAME 'sshPublicKey' + DESC 'MANDATORY: OpenSSH Public key' + EQUALITY octetStringMatch + SYNTAX 1.3.6.1.4.1.1466.115.121.1.40 ) + +# printableString SYNTAX yes|no +objectClasses: ( 1.3.6.1.4.1.24552.500.1.1.2.0 NAME 'ldapPublicKey' SUP top AUXILIARY + DESC 'MANDATORY: OpenSSH LPK objectclass' + MUST ( sshPublicKey $ uid ) + ) diff --git a/ssh-ldap-helper.8 b/ssh-ldap-helper.8 new file mode 100644 index 0000000..f8440e4 --- /dev/null +++ b/ssh-ldap-helper.8 @@ -0,0 +1,79 @@ +.\" $OpenBSD: ssh-ldap-helper.8,v 1.1 2010/02/10 23:20:38 markus Exp $ +.\" +.\" Copyright (c) 2010 Jan F. Chadima. All rights reserved. +.\" +.\" Permission to use, copy, modify, and distribute this software for any +.\" purpose with or without fee is hereby granted, provided that the above +.\" copyright notice and this permission notice appear in all copies. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES +.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR +.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES +.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN +.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF +.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +.\" +.Dd $Mdocdate: April 29 2010 $ +.Dt SSH-LDAP-HELPER 8 +.Os +.Sh NAME +.Nm ssh-ldap-helper +.Nd sshd helper program for ldap support +.Sh SYNOPSIS +.Nm ssh-ldap-helper +.Op Fl devw +.Op Fl f Ar file +.Op Fl s Ar user +.Sh DESCRIPTION +.Nm +is used by +.Xr sshd 1 +to access keys provided by an LDAP. +.Nm +is disabled by default and can only be enabled in the +sshd configuration file +.Pa /etc/ssh/sshd_config +by setting +.Cm AuthorizedKeysCommand +to +.Dq @LIBEXECDIR@/ssh-ldap-wrapper . +.Pp +.Nm +is not intended to be invoked by the user, but from +.Xr sshd 8 via +.Xr ssh-ldap-wrapper . +.Pp +The options are as follows: +.Bl -tag -width Ds +.It Fl d +Set the debug mode; +.Nm +prints all logs to stderr instead of syslog. +.It Fl e +Implies \-w; +.Nm +halts if it encounters an unknown item in the ldap.conf file. +.It Fl f +.Nm +uses this file as the ldap configuration file instead of /etc/ssh/ldap.conf (default). +.It Fl s +.Nm +prints out the user's keys to stdout and exits. +.It Fl v +Implies \-d; +increases verbosity. +.It Fl w +.Nm +writes warnings about unknown items in the ldap.conf configuration file. +.El +.Sh SEE ALSO +.Xr sshd 8 , +.Xr sshd_config 5 , +.Xr ssh-ldap.conf 5 , +.Sh HISTORY +.Nm +first appeared in +OpenSSH 5.5 + PKA-LDAP . +.Sh AUTHORS +.An Jan F. Chadima Aq jchadima@redhat.com diff --git a/ssh-ldap-wrapper b/ssh-ldap-wrapper new file mode 100644 index 0000000..9fdfc37 --- /dev/null +++ b/ssh-ldap-wrapper @@ -0,0 +1,4 @@ +#!/bin/sh + +exec @LIBEXECDIR@/ssh-ldap-helper -s "$1" + diff --git a/ssh-ldap.conf.5 b/ssh-ldap.conf.5 new file mode 100644 index 0000000..15eb03d --- /dev/null +++ b/ssh-ldap.conf.5 @@ -0,0 +1,376 @@ +.\" $OpenBSD: ssh-ldap.conf.5,v 1.1 2010/02/10 23:20:38 markus Exp $ +.\" +.\" Copyright (c) 2010 Jan F. Chadima. All rights reserved. +.\" +.\" Permission to use, copy, modify, and distribute this software for any +.\" purpose with or without fee is hereby granted, provided that the above +.\" copyright notice and this permission notice appear in all copies. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES +.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR +.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES +.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN +.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF +.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +.\" +.Dd $Mdocdate: may 12 2010 $ +.Dt SSH-LDAP.CONF 5 +.Os +.Sh NAME +.Nm ssh-ldap.conf +.Nd configuration file for ssh-ldap-helper +.Sh SYNOPSIS +.Nm /etc/ssh/ldap.conf +.Sh DESCRIPTION +.Xr ssh-ldap-helper 8 +reads configuration data from +.Pa /etc/ssh/ldap.conf +(or the file specified with +.Fl f +on the command line). +The file contains keyword-argument pairs, one per line. +Lines starting with +.Ql # +and empty lines are interpreted as comments. +.Pp +The value starts with the first non-blank character after +the keyword's name, and terminates at the end of the line, +or at the last sequence of blanks before the end of the line. +Quoting values that contain blanks +may be incorrect, as the quotes would become part of the value. +The possible keywords and their meanings are as follows (note that +keywords are case-insensitive, and arguments, on a case by case basis, may be case-sensitive). +.Bl -tag -width Ds +.It Cm URI +The argument(s) are in the form +.Pa ldap[si]://[name[:port]] +and specify the URI(s) of an LDAP server(s) to which the +.Xr ssh-ldap-helper 8 +should connect. The URI scheme may be any of +.Dq ldap , +.Dq ldaps +or +.Dq ldapi , +which refer to LDAP over TCP, LDAP over SSL (TLS) and LDAP +over IPC (UNIX domain sockets), respectively. +Each server's name can be specified as a +domain-style name or an IP address literal. Optionally, the +server's name can followed by a ':' and the port number the LDAP +server is listening on. If no port number is provided, the default +port for the scheme is used (389 for ldap://, 636 for ldaps://). +For LDAP over IPC, name is the name of the socket, and no port +is required, nor allowed; note that directory separators must be +URL-encoded, like any other characters that are special to URLs; +A space separated list of URIs may be provided. +There is no default. +.It Cm Base +Specifies the default base Distinguished Name (DN) to use when performing ldap operations. +The base must be specified as a DN in LDAP format. +There is no default. +.It Cm BindDN +Specifies the default BIND DN to use when connecting to the ldap server. +The bind DN must be specified as a Distinguished Name in LDAP format. +There is no default. +.It Cm BindPW +Specifies the default password to use when connecting to the ldap server via +.Cm BindDN . +There is no default. +.It Cm RootBindDN +Intentionaly does nothing. Recognized for compatibility reasons. +.It Cm Host +The argument(s) specifies the name(s) of an LDAP server(s) to which the +.Xr ssh-ldap-helper 8 +should connect. Each server's name can be specified as a +domain-style name or an IP address and optionally followed by a ':' and +the port number the ldap server is listening on. A space-separated +list of hosts may be provided. +There is no default. +.Cm Host +is deprecated in favor of +.Cm URI . +.It Cm Port +Specifies the default port used when connecting to LDAP servers(s). +The port may be specified as a number. +The default port is 389 for ldap:// or 636 for ldaps:// respectively. +.Cm Port +is deprecated in favor of +.Cm URI . +.It Cm Scope +Specifies the starting point of an LDAP search and the depth from the base DN to which the search should descend. +There are three options (values) that can be assigned to the +.Cm Scope parameter: +.Dq base , +.Dq one +and +.Dq subtree . +Alias for the subtree is +.Dq sub . +The value +.Dq base +is used to indicate searching only the entry at the base DN, resulting in only that entry being returned (keeping in mind that it also has to meet the search filter criteria!). +The value +.Dq one +is used to indicate searching all entries one level under the base DN, but not including the base DN and not including any entries under that one level under the base DN. +The value +.Dq subtree +is used to indicate searching of all entries at all levels under and including the specified base DN. +The default is +.Dq subtree . +.It Cm Deref +Specifies how alias dereferencing is done when performing a search. There are four +possible values that can be assigned to the +.Cm Deref +parameter: +.Dq never , +.Dq searching , +.Dq finding , +and +.Dq always . +The value +.Dq never +means that the aliases are never dereferenced. +The value +.Dq searching +means that the aliases are dereferenced in subordinates of the base object, but +not in locating the base object of the search. +The value +.Dq finding +means that the aliases are only dereferenced when locating the base object of the search. +The value +.Dq always +means that the aliases are dereferenced both in searching and in locating the base object +of the search. +The default is +.Dq never . +.It Cm TimeLimit +Specifies a time limit (in seconds) to use when performing searches. +The number should be a non-negative integer. A +.Cm TimeLimit +of zero (0) specifies that the search time is unlimited. Please note that the server +may still apply any server-side limit on the duration of a search operation. +The default value is 10. +.It Cm TimeOut +Is an aliast to +.Cm TimeLimit . +.It Cm Bind_TimeLimit +Specifies the timeout (in seconds) after which the poll(2)/select(2) +following a connect(2) returns in case of no activity. +The default value is 10. +.It Cm Network_TimeOut +Is an alias to +.Cm Bind_TimeLimit . +.It Cm Ldap_Version +Specifies what version of the LDAP protocol should be used. +The allowed values are 2 or 3. The default is 3. +.It Cm Version +Is an alias to +.Cm Ldap_Version . +.It Cm Bind_Policy +Specifies the policy to use for reconnecting to an unavailable LDAP server. There are 2 available values: +.Dq hard +and +.Dq soft. +.Dq hard has 2 aliases +.Dq hard_open +and +.Dq hard_init . +The value +.Dq hard +means that reconects that the +.Xr ssh-ldap-helper 8 +tries to reconnect to the LDAP server 5 times before failure. There is exponential backoff before retrying. +The value +.Dq soft +means that +.Xr ssh-ldap-helper 8 +fails immediately when it cannot connect to the LDAP seerver. +The deault is +.Dq hard . +.It Cm SSLPath +Specifies the path to the X.509 certificate database. +There is no default. +.It Cm SSL +Specifies whether to use SSL/TLS or not. +There are three allowed values: +.Dq yes , +.Dq no +and +.Dq start_tls +Both +.Dq true +and +.Dq on +are the aliases for +.Dq yes . +.Dq false +and +.Dq off +are the aliases for +.Dq no . +If +.Dq start_tls +is specified then StartTLS is used rather than raw LDAP over SSL. +The default for ldap:// is +.Dq start_tls , +for ldaps:// +.Dq yes +and +.Dq no +for the ldapi:// . +In case of host based configuration the default is +.Dq start_tls . +.It Cm Referrals +Specifies if the client should automatically follow referrals returned +by LDAP servers. +The value can be or +.Dq yes +or +.Dq no . +.Dq true +and +.Dq on +are the aliases for +.Dq yes . +.Dq false +and +.Dq off +are the aliases for +.Dq no . +The default is yes. +.It Cm Restart +Specifies whether the LDAP client library should restart the select(2) system call when interrupted. +The value can be or +.Dq yes +or +.Dq no . +.Dq true +and +.Dq on +are the aliases for +.Dq yes . +.Dq false +and +.Dq off +are the aliases for +.Dq no . +The default is yes. +.It Cm TLS_CheckPeer +Specifies what checks to perform on server certificates in a TLS session, +if any. The value +can be specified as one of the following keywords: +.Dq never , +.Dq hard , +.Dq demand , +.Dq allow +and +.Dq try . +.Dq true , +.Dq on +and +.Dq yes +are aliases for +.Dq hard . +.Dq false , +.Dq off +and +.Dq no +are the aliases for +.Dq never . +The value +.Dq never +means that the client will not request or check any server certificate. +The value +.Dq allow +means that the server certificate is requested. If no certificate is provided, +the session proceeds normally. If a bad certificate is provided, it will +be ignored and the session proceeds normally. +The value +.Dq try +means that the server certificate is requested. If no certificate is provided, +the session proceeds normally. If a bad certificate is provided, +the session is immediately terminated. +The value +.Dq demand +means that the server certificate is requested. If no +certificate is provided, or a bad certificate is provided, the session +is immediately terminated. +The value +.Dq hard +is the same as +.Dq demand . +It requires an SSL connection. In the case of the plain conection the +session is immediately terminated. +The default is +.Dq hard . +.It Cm TLS_ReqCert +Is an alias for +.Cm TLS_CheckPeer . +.It Cm TLS_CACertFile +Specifies the file that contains certificates for all of the Certificate +Authorities the client will recognize. +There is no default. +.It Cm TLS_CACert +Is an alias for +.Cm TLS_CACertFile . +.It Cm TLS_CACertDIR +Specifies the path of a directory that contains Certificate Authority +certificates in separate individual files. The +.Cm TLS_CACert +is always used before +.Cm TLS_CACertDir . +The specified directory must be managed with the OpenSSL c_rehash utility. +There is no default. +.It Cm TLS_Ciphers +Specifies acceptable cipher suite and preference order. +The value should be a cipher specification for OpenSSL, +e.g., +.Dq HIGH:MEDIUM:+SSLv2 . +The default is +.Dq ALL . +.It Cm TLS_Cipher_Suite +Is an alias for +.Cm TLS_Ciphers . +.It Cm TLS_Cert +Specifies the file that contains the client certificate. +There is no default. +.It Cm TLS_Certificate +Is an alias for +.Cm TLS_Cert . +.It Cm TLS_Key +Specifies the file that contains the private key that matches the certificate +stored in the +.Cm TLS_Cert +file. Currently, the private key must not be protected with a password, so +it is of critical importance that the key file is protected carefully. +There is no default. +.It Cm TLS_RandFile +Specifies the file to obtain random bits from when /dev/[u]random is +not available. Generally set to the name of the EGD/PRNGD socket. +The environment variable RANDFILE can also be used to specify the filename. +There is no default. +.It Cm LogDir +Specifies the directory used for logging by the LDAP client library. +There is no default. +.It Cm Debug +Specifies the debug level used for logging by the LDAP client library. +There is no default. +.It Cm SSH_Filter +Specifies the user filter applied on the LDAP serch. +The default is no filter. +.El +.Sh FILES +.Bl -tag -width Ds +.It Pa /etc/ssh/ldap.conf +Ldap configuration file for +.Xr ssh-ldap-helper 8 . +.El +.Sh "SEE ALSO" +.Xr ldap.conf 5 , +.Xr ssh-ldap-helper 8 +.Sh HISTORY +.Nm +first appeared in +OpenSSH 5.5 + PKA-LDAP . +.Sh AUTHORS +.An Jan F. Chadima Aq jchadima@redhat.com
Locations
Projects
Search
Status Monitor
Help
OpenBuildService.org
Documentation
API Documentation
Code of Conduct
Contact
Support
@OBShq
Terms
openSUSE Build Service is sponsored by
The Open Build Service is an
openSUSE project
.
Sign Up
Log In
Places
Places
All Projects
Status Monitor
