2 * rlm_ldap.c LDAP authorization and authentication module.
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License as published by
6 * the Free Software Foundation; either version 2 of the License, or
7 * (at your option) any later version.
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
14 * You should have received a copy of the GNU General Public License
15 * along with this program; if not, write to the Free Software
16 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
18 * Copyright 1999,2000,2001,2002,2003,2004,2005,2006,2007,2008,
19 * 2009,2010,2011,1012 The FreeRADIUS Server Project.
21 * Copyright 2012 Alan DeKok <aland@freeradius.org>
24 #include <freeradius-devel/ident.h>
27 #include <freeradius-devel/radiusd.h>
28 #include <freeradius-devel/modules.h>
29 #include <freeradius-devel/rad_assert.h>
36 #define MAX_FILTER_STR_LEN 1024
40 fr_connection_pool_t *pool;
53 int ldap_debug; /* Debug flag for LDAP SDK */
54 const char *xlat_name; /* name used to xlat */
57 TLDAP_RADIUS *check_map;
58 TLDAP_RADIUS *reply_map;
64 * Access related configuration
67 int positive_access_attr;
73 char *default_profile;
84 * TLS items. We should really normalize these with the
94 char *tls_require_cert;
107 #ifdef LDAP_OPT_X_KEEPALIVE_IDLE
110 #ifdef LDAP_OPT_X_KEEPALIVE_PROBES
111 int keepalive_probes;
113 #ifdef LDAP_OPT_ERROR_NUMBER
114 int keepalive_interval;
119 /* The default setting for TLS Certificate Verification */
120 #define TLS_DEFAULT_VERIFY "allow"
125 static CONF_PARSER tls_config[] = {
126 {"start_tls", PW_TYPE_BOOLEAN,
127 offsetof(ldap_instance,start_tls), NULL, "no"},
128 {"cacertfile", PW_TYPE_FILENAME,
129 offsetof(ldap_instance,tls_cacertfile), NULL, NULL},
130 {"cacertdir", PW_TYPE_FILENAME,
131 offsetof(ldap_instance,tls_cacertdir), NULL, NULL},
132 {"certfile", PW_TYPE_FILENAME,
133 offsetof(ldap_instance,tls_certfile), NULL, NULL},
134 {"keyfile", PW_TYPE_FILENAME,
135 offsetof(ldap_instance,tls_keyfile), NULL, NULL},
136 {"randfile", PW_TYPE_STRING_PTR, /* OK if it changes on HUP */
137 offsetof(ldap_instance,tls_randfile), NULL, NULL},
138 {"require_cert", PW_TYPE_STRING_PTR,
139 offsetof(ldap_instance,tls_require_cert), NULL, TLS_DEFAULT_VERIFY},
140 { NULL, -1, 0, NULL, NULL }
144 static CONF_PARSER attr_config[] = {
148 /* LDAP attribute name that controls remote access */
149 {"access_attr", PW_TYPE_STRING_PTR,
150 offsetof(ldap_instance,access_attr), NULL, NULL},
151 {"positive_access_attr", PW_TYPE_BOOLEAN,
152 offsetof(ldap_instance,positive_access_attr), NULL, "yes"},
154 {"base_filter", PW_TYPE_STRING_PTR,
155 offsetof(ldap_instance,base_filter), NULL, "(objectclass=radiusprofile)"},
156 {"default_profile", PW_TYPE_STRING_PTR,
157 offsetof(ldap_instance,default_profile), NULL, NULL},
158 {"profile_attribute", PW_TYPE_STRING_PTR,
159 offsetof(ldap_instance,profile_attr), NULL, NULL},
161 { NULL, -1, 0, NULL, NULL }
166 * Group configuration
168 static CONF_PARSER group_config[] = {
170 * Group checks. These could probably be done
171 * via dynamic xlat's.
173 {"name_attribute", PW_TYPE_STRING_PTR,
174 offsetof(ldap_instance,groupname_attr), NULL, "cn"},
175 {"membership_filter", PW_TYPE_STRING_PTR,
176 offsetof(ldap_instance,groupmemb_filt), NULL, "(|(&(objectClass=GroupOfNames)(member=%{Ldap-UserDn}))(&(objectClass=GroupOfUniqueNames)(uniquemember=%{Ldap-UserDn})))"},
177 {"membership_attribute", PW_TYPE_STRING_PTR,
178 offsetof(ldap_instance,groupmemb_attr), NULL, NULL},
181 { NULL, -1, 0, NULL, NULL }
185 * Various options that don't belong in the main configuration.
187 * Note that these overlap a bit with the connection pool code!
189 static CONF_PARSER option_config[] = {
191 * Debugging flags to the server
193 {"ldap_debug", PW_TYPE_INTEGER,
194 offsetof(ldap_instance,ldap_debug), NULL, "0x0000"},
196 {"chase_referrals", PW_TYPE_BOOLEAN,
197 offsetof(ldap_instance,chase_referrals), NULL, NULL},
199 {"rebind", PW_TYPE_BOOLEAN,
200 offsetof(ldap_instance,rebind), NULL, NULL},
202 /* timeout on network activity */
203 {"net_timeout", PW_TYPE_INTEGER,
204 offsetof(ldap_instance,net_timeout), NULL, "10"},
206 /* timeout for search results */
207 {"timeout", PW_TYPE_INTEGER,
208 offsetof(ldap_instance,timeout), NULL, "20"},
210 /* allow server unlimited time for search (server-side limit) */
211 {"timelimit", PW_TYPE_INTEGER,
212 offsetof(ldap_instance,timelimit), NULL, "20"},
214 #ifdef LDAP_OPT_X_KEEPALIVE_IDLE
215 {"idle", PW_TYPE_INTEGER, offsetof(ldap_instance,keepalive_idle), NULL, "60"},
217 #ifdef LDAP_OPT_X_KEEPALIVE_PROBES
218 {"probes", PW_TYPE_INTEGER, offsetof(ldap_instance,keepalive_probes), NULL, "3"},
220 #ifdef LDAP_OPT_ERROR_NUMBER
221 {"interval", PW_TYPE_INTEGER, offsetof(ldap_instance,keepalive_interval), NULL, "30"},
223 { NULL, -1, 0, NULL, NULL }
227 static const CONF_PARSER module_config[] = {
228 {"server", PW_TYPE_STRING_PTR,
229 offsetof(ldap_instance,server), NULL, "localhost"},
230 {"port", PW_TYPE_INTEGER,
231 offsetof(ldap_instance,port), NULL, "389"},
233 {"password", PW_TYPE_STRING_PTR,
234 offsetof(ldap_instance,password), NULL, ""},
235 {"identity", PW_TYPE_STRING_PTR,
236 offsetof(ldap_instance,login), NULL, ""},
241 {"basedn", PW_TYPE_STRING_PTR,
242 offsetof(ldap_instance,basedn), NULL, "o=notexist"},
244 {"filter", PW_TYPE_STRING_PTR,
245 offsetof(ldap_instance,filter), NULL, "(uid=%u)"},
247 /* file with mapping between LDAP and RADIUS attributes */
248 {"dictionary_mapping", PW_TYPE_FILENAME,
249 offsetof(ldap_instance, map_file), NULL, NULL},
252 * Terrible things which should be deleted.
254 {"do_xlat", PW_TYPE_BOOLEAN,
255 offsetof(ldap_instance,do_xlat), NULL, "yes"},
257 { "profiles", PW_TYPE_SUBSECTION, 0, NULL, (const void *) attr_config },
259 { "group", PW_TYPE_SUBSECTION, 0, NULL, (const void *) group_config },
261 { "options", PW_TYPE_SUBSECTION, 0, NULL, (const void *) option_config },
263 { "tls", PW_TYPE_SUBSECTION, 0, NULL, (const void *) tls_config },
265 { "profiles", PW_TYPE_SUBSECTION, 0, NULL, (const void *) attr_config },
267 {NULL, -1, 0, NULL, NULL}
270 typedef struct ldap_conn {
278 #if LDAP_SET_REBIND_PROC_ARGS == 3
280 * Rebind && chase referral stuff
282 static int ldap_rebind(LDAP *ld, LDAP_CONST char *url,
283 UNUSED ber_tag_t request, UNUSED ber_int_t msgid,
286 LDAP_CONN *conn = ctx;
288 conn->referred = TRUE;
289 conn->rebound = TRUE; /* not really, but oh well... */
290 rad_assert(ld == conn->ld);
292 DEBUG(" [%s] rebind to URL %s", conn->inst->xlat_name, url);
293 return ldap_bind_s(ld, conn->inst->login, conn->inst->password,
298 static int ldap_bind_wrapper(LDAP_CONN **pconn, const char *user,
299 const char *password,
300 const char **perror_str, int do_rebind)
302 int rcode, ldap_errno;
303 int module_rcode = RLM_MODULE_FAIL;
304 int reconnect = FALSE;
305 const char *error_string;
306 LDAP_CONN *conn = *pconn;
307 ldap_instance *inst = conn->inst;
308 LDAPMessage *result = NULL;
312 ldap_errno = ldap_bind(conn->ld, user, password, LDAP_AUTH_SIMPLE);
313 if (ldap_errno < 0) {
315 ldap_get_option(conn->ld, LDAP_OPT_ERROR_NUMBER, &ldap_errno);
316 error_string = ldap_err2string(ldap_errno);
318 if (do_rebind && !reconnect) {
319 conn = fr_connection_reconnect(inst->pool, conn);
321 if (!conn) return RLM_MODULE_FAIL;
326 if (perror_str) *perror_str = error_string;
328 #ifdef HAVE_LDAP_INITIALIZE
330 radlog(L_ERR, " [%s] %s bind to %s failed: %s",
331 inst->xlat_name, user,
332 inst->server, error_string);
336 radlog(L_ERR, " [%s] %s bind to %s:%d failed: %s",
337 inst->xlat_name, user,
338 inst->server, inst->port,
342 return module_rcode; /* caller closes the connection */
345 DEBUG3(" [%s] waiting for bind result ...", inst->xlat_name);
347 tv.tv_sec = inst->timeout;
349 rcode = ldap_result(conn->ld, ldap_errno, 1, &tv, &result);
350 if (rcode < 0) goto get_error;
353 error_string = "timeout";
357 ldap_errno = ldap_result2error(conn->ld, result, 1);
358 switch (ldap_errno) {
362 case LDAP_INVALID_CREDENTIALS:
363 case LDAP_CONSTRAINT_VIOLATION:
364 rcode = RLM_MODULE_REJECT;
371 return RLM_MODULE_OK;
374 /*************************************************************************
376 * Function: ldap_conn_create
378 * Purpose: Create and return a new connection
379 * This function is probably too big.
381 *************************************************************************/
382 static void *ldap_conn_create(void *ctx)
385 int ldap_errno, ldap_version;
387 ldap_instance *inst = ctx;
389 LDAP_CONN *conn = NULL;
392 #ifdef HAVE_LDAP_INITIALIZE
394 DEBUG(" [%s] Connect to %s", inst->xlat_name, inst->server);
396 ldap_errno = ldap_initialize(&ld, inst->server);
398 if (ldap_errno != LDAP_SUCCESS) {
399 radlog(L_ERR, " [%s] ldap_initialize() failed: %s",
400 inst->xlat_name, ldap_err2string(ldap_errno));
406 DEBUG(" [%s] Connect to %s:%d", inst->xlat_name,
407 inst->server, inst->port);
409 ld = ldap_init(inst->server, inst->port);
411 radlog(L_ERR, " [%s] ldap_init() failed", inst->xlat_name);
413 if (ld) ldap_unbind_s(ld);
419 * We now have a connection structure, but no actual TCP connection.
421 * Set a bunch of LDAP options, using common code.
424 #define do_ldap_option(_option, _name, _value) if (ldap_set_option(ld, _option, _value) != LDAP_OPT_SUCCESS) { \
425 ldap_get_option(ld, LDAP_OPT_ERROR_NUMBER, &ldap_errno); \
426 radlog(L_ERR, " [%s] Could not set %s: %s", inst->xlat_name, _name, ldap_err2string(ldap_errno)); \
429 if (inst->ldap_debug) {
430 do_ldap_option(LDAP_OPT_DEBUG_LEVEL, "ldap_debug", &(inst->ldap_debug));
434 * Leave "chase_referrals" unset to use the OpenLDAP
437 if (inst->chase_referrals != 2) {
438 if (inst->chase_referrals) {
439 do_ldap_option(LDAP_OPT_REFERRALS, "chase_referrals", LDAP_OPT_ON);
441 #if LDAP_SET_REBIND_PROC_ARGS == 3
442 if (inst->rebind == 1) {
443 ldap_set_rebind_proc(ld, ldap_rebind, inst);
447 do_ldap_option(LDAP_OPT_REFERRALS, "chase_referrals", LDAP_OPT_OFF);
451 tv.tv_sec = inst->net_timeout;
453 do_ldap_option(LDAP_OPT_NETWORK_TIMEOUT, "net_timeout", &tv);
455 do_ldap_option(LDAP_OPT_TIMELIMIT, "timelimit", &(inst->timelimit));
457 ldap_version = LDAP_VERSION3;
458 do_ldap_option(LDAP_OPT_PROTOCOL_VERSION, "ldap_version", &ldap_version);
460 #ifdef LDAP_OPT_X_KEEPALIVE_IDLE
461 do_ldap_option(LDAP_OPT_X_KEEPALIVE_IDLE, "keepalive idle", &(inst->keepalive_idle));
464 #ifdef LDAP_OPT_X_KEEPALIVE_PROBES
465 do_ldap_option(LDAP_OPT_X_KEEPALIVE_PROBES, "keepalive probes", &(inst->keepalive_probes));
468 #ifdef LDAP_OPT_X_KEEPALIVE_INTERVAL
469 do_ldap_option(LDAP_OPT_X_KEEPALIVE_INTERVAL, "keepalive interval", &(inst->keepalive_interval));
472 #ifdef HAVE_LDAP_START_TLS
474 * Set all of the TLS options
476 if (inst->tls_mode) {
477 do_ldap_option(LDAP_OPT_X_TLS, "tls_mode", &(inst->tls_mode));
480 #define maybe_ldap_option(_option, _name, _value) if (_value) do_ldap_option(_option, _name, _value)
482 maybe_ldap_option(LDAP_OPT_X_TLS_CACERTFILE,
483 "cacertfile", inst->tls_cacertfile);
484 maybe_ldap_option(LDAP_OPT_X_TLS_CACERTDIR,
485 "cacertdir", inst->tls_cacertdir);
487 #ifdef HAVE_LDAP_INT_TLS_CONFIG
488 if (ldap_int_tls_config(NULL, LDAP_OPT_X_TLS_REQUIRE_CERT,
489 (inst->tls_require_cert)) != LDAP_OPT_SUCCESS) {
490 ldap_get_option(ld, LDAP_OPT_ERROR_NUMBER, &ldap_errno);
491 radlog(L_ERR, " [%s] could not set ",
492 "LDAP_OPT_X_TLS_REQUIRE_CERT option to %s: %s",
494 inst->tls_require_cert,
495 ldap_err2string(ldap_errno));
499 maybe_ldap_option(LDAP_OPT_X_TLS_CERTFILE,
500 "certfile", inst->tls_certfile);
501 maybe_ldap_option(LDAP_OPT_X_TLS_KEYFILE,
502 "keyfile", inst->tls_keyfile);
503 maybe_ldap_option(LDAP_OPT_X_TLS_RANDOM_FILE,
504 "randfile", inst->tls_randfile);
507 * And finally start the TLS code.
509 if (inst->start_tls && (inst->port != 636)) {
510 ldap_errno = ldap_start_tls_s(ld, NULL, NULL);
511 if (ldap_errno != LDAP_SUCCESS) {
512 ldap_get_option(ld, LDAP_OPT_ERROR_NUMBER,
514 radlog(L_ERR, " [%s] could not start TLS: %s",
516 ldap_err2string(ldap_errno));
520 #endif /* HAVE_LDAP_START_TLS */
522 conn = rad_malloc(sizeof(*conn));
525 conn->rebound = FALSE;
526 conn->referred = FALSE;
528 module_rcode = ldap_bind_wrapper(&conn, inst->login, inst->password,
530 if (module_rcode != RLM_MODULE_OK) {
531 radlog(L_ERR, " [%s] Failed binding to LDAP server: %s",
532 inst->xlat_name, error);
535 * FIXME: print "check config, morians!
544 /*************************************************************************
546 * Function: ldap_conn_delete
548 * Purpose: Close and delete a connection
550 *************************************************************************/
551 static int ldap_conn_delete(UNUSED void *ctx, void *connection)
553 LDAP_CONN *conn = connection;
555 ldap_unbind_s(conn->ld);
562 /*************************************************************************
564 * Function: ldap_get_socket
566 * Purpose: Gets an LDAP socket from the connection pool
568 *************************************************************************/
569 static LDAP_CONN *ldap_get_socket(ldap_instance *inst)
573 conn = fr_connection_get(inst->pool);
575 radlog(L_ERR, " [%s] All ldap connections are in use",
583 /*************************************************************************
585 * Function: ldap_release_socket
587 * Purpose: Frees an LDAP socket back to the connection pool
589 *************************************************************************/
590 static void ldap_release_socket(ldap_instance *inst, LDAP_CONN *conn)
593 * Could have already been free'd due to a previous error.
598 * We chased a referral to another server.
600 * This connection is no longer part of the pool which is
601 * connected to and bound to the configured server.
604 * Note that we do NOT close it if it was bound to
605 * another user. Instead, we let the next caller do the
608 if (conn->referred) {
609 fr_connection_del(inst->pool, conn);
613 fr_connection_release(inst->pool, conn);
618 /*************************************************************************
620 * Function: ldap_escape_func
622 * Purpose: Converts "bad" strings into ones which are safe for LDAP
624 *************************************************************************/
625 static size_t ldap_escape_func(char *out, size_t outlen, const char *in)
631 * Encode unsafe characters.
634 ((in[0] == ' ') || (in[0] == '#'))) ||
635 (strchr(",+\"\\<>;*=()", *in))) {
636 static const char hex[] = "0123456789abcdef";
639 * Only 3 or less bytes available.
646 *(out++) = hex[((*in) >> 4) & 0x0f];
647 *(out++) = hex[(*in) & 0x0f];
655 * Only one byte left.
672 /*************************************************************************
674 * Function: perform_search
676 * Purpose: Do a search and get a response
678 *************************************************************************/
679 static int perform_search(ldap_instance *inst, LDAP_CONN **pconn,
680 char *search_basedn, int scope, char *filter,
681 char **attrs, LDAPMessage **presult)
684 int reconnect = FALSE;
685 LDAP_CONN *conn = *pconn;
691 * Do all searches as the default admin user.
694 ldap_errno = ldap_bind_wrapper(pconn,
695 inst->login, inst->password,
697 if (ldap_errno != RLM_MODULE_OK) {
701 rad_assert(*pconn != NULL);
703 conn->rebound = FALSE;
706 tv.tv_sec = inst->timeout;
708 DEBUG2(" [%s] Performing search in '%s' with filter '%s'", inst->xlat_name,
709 search_basedn ? search_basedn : "(null)" , filter);
712 ldap_errno = ldap_search_st(conn->ld, search_basedn, scope, filter,
713 attrs, 0, &tv, presult);
714 switch (ldap_errno) {
716 case LDAP_NO_SUCH_OBJECT:
719 case LDAP_SERVER_DOWN:
721 ldap_msgfree(*presult);
723 if (reconnect) return -1;
726 conn = fr_connection_reconnect(inst->pool, conn);
727 *pconn = conn; /* tell the caller we have a new connection */
728 if (!conn) return -1;
731 case LDAP_INSUFFICIENT_ACCESS:
732 radlog(L_ERR, " [%s] ldap_search() failed: Insufficient access. Check the identity and password configuration directives.", inst->xlat_name);
733 ldap_msgfree(*presult);
737 exec_trigger(NULL, inst->cs, "modules.ldap.timeout", TRUE);
738 radlog(L_ERR, " [%s] ldap_search() failed: Timed out while waiting for server to respond. Please increase the timeout.", inst->xlat_name);
739 ldap_msgfree(*presult);
742 case LDAP_FILTER_ERROR:
743 radlog(L_ERR, " [%s] ldap_search() failed: Bad search filter: %s", inst->xlat_name,filter);
744 ldap_msgfree(*presult);
747 case LDAP_TIMELIMIT_EXCEEDED:
748 exec_trigger(NULL, inst->cs, "modules.ldap.timeout", TRUE);
751 case LDAP_UNAVAILABLE:
753 * Reconnect. There's an issue with the socket
756 ldap_get_option(conn->ld, LDAP_OPT_ERROR_NUMBER, &ldap_errno);
757 radlog(L_ERR, " [%s] ldap_search() failed: %s", inst->xlat_name,
758 ldap_err2string(ldap_errno));
762 ldap_get_option(conn->ld, LDAP_OPT_ERROR_NUMBER, &ldap_errno);
763 radlog(L_ERR, " [%s] ldap_search() failed: %s", inst->xlat_name,
764 ldap_err2string(ldap_errno));
765 ldap_msgfree(*presult);
769 ldap_errno = ldap_count_entries(conn->ld, *presult);
770 if (ldap_errno == 0) {
771 ldap_msgfree(*presult);
772 DEBUG(" [%s] object not found", inst->xlat_name);
776 if (ldap_errno != 1) {
777 ldap_msgfree(*presult);
778 DEBUG(" [%s] got ambiguous search result (%d results)", inst->xlat_name, ldap_errno);
785 /*************************************************************************
787 * Function: ldap_xlat
789 * Purpose: Expand an LDAP URL into a query, and return a string
790 * result from that query.
792 *************************************************************************/
793 static size_t ldap_xlat(void *instance, REQUEST *request, const char *fmt,
794 char *out, size_t freespace, RADIUS_ESCAPE_STRING func)
798 ldap_instance *inst = instance;
799 LDAPURLDesc *ldap_url;
800 LDAPMessage *result = NULL;
801 LDAPMessage *msg = NULL;
805 char buffer[MAX_FILTER_STR_LEN];
807 if (strchr(fmt, '%') != NULL) {
808 if (!radius_xlat(buffer, sizeof(buffer), fmt, request, func)) {
809 radlog (L_ERR, " [%s] Unable to create LDAP URL.", inst->xlat_name);
817 if (!ldap_is_ldap_url(url)) {
818 radlog (L_ERR, " [%s] String passed does not look like an LDAP URL.",
823 if (ldap_url_parse(url, &ldap_url)){
824 radlog (L_ERR, " [%s] LDAP URL parse failed.", inst->xlat_name);
829 * Nothing, empty string, "*" string, or got 2 things, die.
831 if (!ldap_url->lud_attrs || !ldap_url->lud_attrs[0] ||
832 !*ldap_url->lud_attrs[0] || (strcmp(ldap_url->lud_attrs[0], "*") == 0) ||
833 ldap_url->lud_attrs[1]) {
834 radlog (L_ERR, " [%s] Invalid Attribute(s) request.",
839 if (ldap_url->lud_host &&
840 ((strncmp(inst->server, ldap_url->lud_host, strlen(inst->server)) != 0) ||
841 (ldap_url->lud_port != inst->port))) {
842 DEBUG(" [%s] Requested server/port is .", inst->xlat_name);
846 conn = ldap_get_socket(inst);
847 if (!conn) goto free_urldesc;
849 rcode = perform_search(inst, &conn, ldap_url->lud_dn, ldap_url->lud_scope,
850 ldap_url->lud_filter, ldap_url->lud_attrs, &result);
853 DEBUG(" [%s] Search returned not found", inst->xlat_name);
856 DEBUG(" [%s] Search returned error", inst->xlat_name);
860 msg = ldap_first_entry(conn->ld, result);
862 DEBUG(" [%s] ldap_first_entry() failed", inst->xlat_name);
866 vals = ldap_get_values(conn->ld, msg, ldap_url->lud_attrs[0]);
868 DEBUG(" [%s] ldap_get_values failed", inst->xlat_name);
872 length = strlen(vals[0]);
873 if (length >= freespace){
878 strlcpy(out, vals[0], freespace);
881 ldap_value_free(vals);
883 ldap_msgfree(result);
885 ldap_release_socket(inst, conn);
887 ldap_free_urldesc(ldap_url);
893 static char *get_userdn(LDAP_CONN **pconn, REQUEST *request, int *module_rcode)
897 ldap_instance *inst = (*pconn)->inst;
898 LDAPMessage *result, *msg;
899 static char firstattr[] = "uid";
900 char *user_dn, *attrs[] = {firstattr, NULL};
901 char filter[MAX_FILTER_STR_LEN];
902 char basedn[MAX_FILTER_STR_LEN];
904 *module_rcode = RLM_MODULE_FAIL;
906 vp = pairfind(request->config_items, PW_LDAP_USERDN, 0);
907 if (vp) return vp->vp_strvalue;
909 if (!radius_xlat(filter, sizeof(filter), inst->filter,
910 request, ldap_escape_func)) {
911 radlog(L_ERR, " [%s] unable to create filter.", inst->xlat_name);
912 *module_rcode = RLM_MODULE_INVALID;
916 if (!radius_xlat(basedn, sizeof(basedn), inst->basedn,
917 request, ldap_escape_func)) {
918 radlog(L_ERR, " [%s] unable to create basedn.", inst->xlat_name);
919 *module_rcode = RLM_MODULE_INVALID;
923 rcode = perform_search(inst, pconn, basedn, LDAP_SCOPE_SUBTREE,
924 filter, attrs, &result);
927 *module_rcode = RLM_MODULE_NOTFOUND;
933 if ((msg = ldap_first_entry((*pconn)->ld, result)) == NULL) {
934 ldap_msgfree(result);
938 if ((user_dn = ldap_get_dn((*pconn)->ld, msg)) == NULL) {
939 ldap_msgfree(result);
943 vp = pairmake("LDAP-UserDn", user_dn, T_OP_EQ);
945 ldap_memfree(user_dn);
946 ldap_msgfree(result);
950 pairadd(&request->config_items, vp);
951 ldap_memfree(user_dn);
952 ldap_msgfree(result);
954 return vp->vp_strvalue;
958 /*****************************************************************************
960 * Perform LDAP-Group comparison checking
962 *****************************************************************************/
963 static int ldap_groupcmp(void *instance, REQUEST *request,
964 UNUSED VALUE_PAIR *thing, VALUE_PAIR *check,
965 UNUSED VALUE_PAIR *check_pairs,
966 UNUSED VALUE_PAIR **reply_pairs)
968 ldap_instance *inst = instance;
970 LDAPMessage *result = NULL;
971 LDAPMessage *msg = NULL;
972 static char firstattr[] = "dn";
973 char *attrs[] = {firstattr,NULL};
975 char *group_attrs[] = {inst->groupmemb_attr,NULL};
979 char gr_filter[MAX_FILTER_STR_LEN];
980 char filter[MAX_FILTER_STR_LEN];
981 char basedn[MAX_FILTER_STR_LEN];
983 if (check->length == 0) {
984 RDEBUG("Cannot do comparison: group name is empty");
988 conn = ldap_get_socket(inst);
992 * This is used in the default membership filter.
994 user_dn = get_userdn(&conn, request, &module_rcode);
996 ldap_release_socket(inst, conn);
1000 if (!inst->groupmemb_filt) goto check_attr;
1002 if (!radius_xlat(filter, sizeof(filter),
1003 inst->groupmemb_filt, request, ldap_escape_func)) {
1004 RDEBUG("Failed creating group filter");
1009 * If it's a DN, use that.
1011 if (strchr(check->vp_strvalue,',') != NULL) {
1012 strlcpy(filter, gr_filter, sizeof(filter));
1013 strlcpy(basedn, check->vp_strvalue, sizeof(basedn));
1016 snprintf(filter, sizeof(filter), "(&(%s=%s)%s)",
1017 inst->groupname_attr,
1018 check->vp_strvalue, gr_filter);
1021 * get_userdn does this, too. Oh well.
1023 if (!radius_xlat(basedn, sizeof(basedn), inst->basedn,
1024 request, ldap_escape_func)) {
1025 radlog(L_ERR, " [%s] unable to create basedn.\n",
1031 rcode = perform_search(inst, &conn, basedn, LDAP_SCOPE_SUBTREE,
1032 filter, attrs, &result);
1034 ldap_release_socket(inst, conn);
1035 ldap_msgfree(result);
1036 RDEBUG("User found in group %s", check->vp_strvalue);
1041 ldap_release_socket(inst, conn);
1042 RDEBUG("Failed performing search");
1046 /* else the search returned -2, for "not found" */
1049 * Else the search returned NOTFOUND. See if we're
1050 * configured to search for group membership using user
1053 if (!inst->groupmemb_attr) {
1054 ldap_release_socket(inst, conn);
1055 RDEBUG("Group %s was not found, or user is not a member",
1056 check->vp_strvalue);
1061 snprintf(filter ,sizeof(filter), "(objectclass=*)");
1063 rcode = perform_search(inst, &conn, user_dn, LDAP_SCOPE_BASE,
1064 filter, group_attrs, &result);
1066 RDEBUG("Search failed for group attrs");
1067 ldap_release_socket(inst, conn);
1071 msg = ldap_first_entry(conn->ld, result);
1073 RDEBUG("First entry failed for group attrs");
1074 ldap_release_socket(inst, conn);
1075 ldap_msgfree(result);
1079 vals = ldap_get_values(conn->ld, msg, inst->groupmemb_attr);
1081 RDEBUG("Get values failed for group attrs");
1082 ldap_release_socket(inst, conn);
1083 ldap_msgfree(result);
1088 * Loop over the list of groups the user is a member of,
1089 * looking for a match.
1092 for (i = 0; i < ldap_count_values(vals); i++){
1093 LDAPMessage *gr_result = NULL;
1095 if (strcmp(vals[i], check->vp_strvalue) == 0){
1101 * The group isn't a DN: ignore it.
1103 if (strchr(vals[i], ',') == NULL) continue;
1105 /* This looks like a DN. Do tons more work. */
1106 snprintf(filter,sizeof(filter), "(%s=%s)",
1107 inst->groupname_attr, check->vp_strvalue);
1109 rcode = perform_search(inst, &conn, vals[i], LDAP_SCOPE_BASE,
1110 filter, attrs, &gr_result);
1112 RDEBUG("Failed doing group search");
1113 ldap_value_free(vals);
1114 ldap_msgfree(result);
1115 ldap_release_socket(inst, conn);
1119 ldap_msgfree(gr_result);
1123 ldap_value_free(vals);
1124 ldap_msgfree(result);
1125 ldap_release_socket(inst, conn);
1128 RDEBUG("groupcmp: Group %s not found, or user is not a member",
1129 check->vp_strvalue);
1137 /*****************************************************************************
1139 * Detach from the LDAP server and cleanup internal state.
1141 *****************************************************************************/
1142 static int ldap_detach(void *instance)
1144 ldap_instance *inst = instance;
1146 fr_connection_pool_delete(inst->pool);
1148 if (inst->map_file) {
1149 rlm_ldap_map_free(&inst->check_map);
1150 rlm_ldap_map_free(&inst->reply_map);
1159 /*************************************************************************
1161 * Function: rlm_ldap_instantiate
1163 * Purpose: Uses section of radiusd config file passed as parameter
1164 * to create an instance of the module.
1166 *************************************************************************/
1167 static int ldap_instantiate(CONF_SECTION * conf, void **instance)
1169 ldap_instance *inst;
1171 inst = rad_malloc(sizeof *inst);
1175 memset(inst, 0, sizeof(*inst));
1178 inst->chase_referrals = 2; /* use OpenLDAP defaults */
1181 if (cf_section_parse(conf, inst, module_config) < 0) {
1186 if (inst->server == NULL) {
1187 radlog(L_ERR, "rlm_ldap: missing 'server' directive.");
1193 * Check for URLs. If they're used and the library doesn't
1194 * support them, then complain.
1197 if (ldap_is_ldap_url(inst->server)) {
1198 #ifdef HAVE_LDAP_INITIALIZE
1202 radlog(L_ERR, "rlm_ldap: 'server' directive is in URL form but ldap_initialize() is not available.");
1208 /* workaround for servers which support LDAPS but not START TLS */
1209 if (inst->port == LDAPS_PORT || inst->tls_mode) {
1210 inst->tls_mode = LDAP_OPT_X_TLS_HARD;
1215 inst->xlat_name = cf_section_name2(conf);
1216 if (!inst->xlat_name) inst->xlat_name = cf_section_name1(conf);
1218 #if LDAP_SET_REBIND_PROC_ARGS != 3
1220 * The 2-argument rebind doesn't take an instance
1221 * variable. Our rebind function needs the instance
1222 * variable for the username, password, etc.
1224 if (inst->rebind == 1) {
1225 radlog(L_ERR, "%s: Cannot use 'rebind' directive as this version of libldap does not support the API that we need.", inst->xlat-name);
1231 if (inst->map_file) {
1234 inst->attrs = rad_malloc(sizeof(inst->attrs[0]) * MAX_ATTRMAP);
1235 inst->attrs[0] = NULL;
1237 if (inst->profile_attr) inst->attrs[offset++] = inst->profile_attr;
1238 if (inst->access_attr) inst->attrs[offset++] = inst->access_attr;
1240 if (rlm_ldap_map_read(inst->xlat_name, inst->map_file,
1241 &inst->check_map, &inst->reply_map,
1248 if (!inst->check_map || !inst->reply_map) {
1249 radlog(L_ERR, "%s: Empty file: %s",
1250 inst->xlat_name, inst->map_file);
1256 if (inst->default_profile || inst->profile_attr) {
1257 radlog(L_ERR, "%s: You MUST specify \"dictionary_mapping\" to use the profile attributes", inst->xlat_name);
1264 * Group comparison checks.
1266 paircompare_register(PW_LDAP_GROUP, PW_USER_NAME, ldap_groupcmp, inst);
1267 if (cf_section_name2(conf)) {
1272 snprintf(buffer, sizeof(buffer), "%s-Ldap-Group", inst->xlat_name);
1273 memset(&flags, 0, sizeof(flags));
1275 dict_addattr(buffer, -1, 0, PW_TYPE_STRING, flags);
1276 da = dict_attrbyname(buffer);
1278 radlog(L_ERR, "%s: Failed creating attribute %s",
1279 inst->xlat_name, buffer);
1284 paircompare_register(da->attr, PW_USER_NAME, ldap_groupcmp, inst);
1287 xlat_register(inst->xlat_name, ldap_xlat, inst);
1290 * Initialize the socket pool.
1292 inst->pool = fr_connection_pool_init(inst->cs, inst,
1306 static void module_failure_msg(VALUE_PAIR **vps, const char *fmt, ...)
1312 vp = paircreate(PW_MODULE_FAILURE_MESSAGE, 0, PW_TYPE_STRING);
1318 vsnprintf(vp->vp_strvalue, sizeof(vp->vp_strvalue), fmt, ap);
1324 static int check_access(ldap_instance *inst, LDAP_CONN *conn, LDAPMessage *msg)
1329 vals = ldap_get_values(conn->ld, msg, inst->access_attr);
1331 if (inst->positive_access_attr) {
1332 if (strncmp(vals[0], "FALSE", 5) == 0) {
1333 DEBUG("dialup access disabled");
1340 DEBUG("%s attribute exists - access denied by default",
1344 ldap_value_free(vals);
1346 } else if (inst->positive_access_attr) {
1347 DEBUG("No %s attribute - access denied by default", inst->access_attr);
1357 static void apply_profile(ldap_instance *inst, LDAP_CONN **pconn,
1358 REQUEST *request, char *profile)
1361 LDAPMessage *result, *msg;
1362 VALUE_PAIR *check_tmp, *reply_tmp;
1363 char filter[MAX_FILTER_STR_LEN];
1365 if (!profile || !*profile) return;
1367 strlcpy(filter,inst->base_filter,sizeof(filter));
1369 rcode = perform_search(inst, pconn, profile, LDAP_SCOPE_BASE, filter,
1370 inst->attrs, &result);
1372 RDEBUG("FAILED Searching profile %s", profile);
1376 msg = ldap_first_entry((*pconn)->ld, result);
1377 if (!msg) goto free_result;
1379 check_tmp = rlm_ldap_pairget(inst->xlat_name, (*pconn)->ld, msg,
1380 inst->check_map, &request->config_items, 1);
1382 pairfree(&check_tmp);
1385 reply_tmp = rlm_ldap_pairget(inst->xlat_name, (*pconn)->ld, msg,
1386 inst->reply_map, &request->packet->vps, 0);
1388 pairfree(&reply_tmp);
1392 ldap_msgfree(result);
1396 static void do_one_map(ldap_instance *inst, LDAP *ld, REQUEST *request,
1397 LDAPMessage *msg, TLDAP_RADIUS *map, VALUE_PAIR **vps,
1402 vp = rlm_ldap_pairget(inst->xlat_name, ld, msg, map, vps, is_check);
1404 if (inst->do_xlat) {
1405 pairxlatmove(request, vps, &vp);
1415 static void do_check_reply(ldap_instance *inst, LDAP *ld, REQUEST *request,
1418 do_one_map(inst, ld, request, msg, inst->check_map, &request->config_items, 1);
1419 do_one_map(inst, ld, request, msg, inst->reply_map, &request->reply->vps, 0);
1422 * More warning messages for people who can't be bothered
1423 * to read the documentation.
1425 if (debug_flag > 1) {
1426 if (!pairfind(request->config_items, PW_CLEARTEXT_PASSWORD, 0) &&
1427 !pairfind(request->config_items, PW_NT_PASSWORD, 0) &&
1428 !pairfind(request->config_items, PW_USER_PASSWORD, 0) &&
1429 !pairfind(request->config_items, PW_PASSWORD_WITH_HEADER, 0) &&
1430 !pairfind(request->config_items, PW_CRYPT_PASSWORD, 0)) {
1431 DEBUG("WARNING: No \"known good\" password was found in LDAP. Are you sure that the user is configured correctly?");
1437 /******************************************************************************
1439 * Function: ldap_authorize
1441 * Purpose: Check if user is authorized for remote access
1443 ******************************************************************************/
1444 static int ldap_authorize(void *instance, REQUEST * request)
1446 int rcode, did_work;
1447 int module_rcode = RLM_MODULE_NOOP;
1448 ldap_instance *inst = instance;
1453 LDAPMessage *result, *msg;
1454 char filter[MAX_FILTER_STR_LEN];
1455 char basedn[MAX_FILTER_STR_LEN];
1457 did_work = FALSE; /* for debugging user problems */
1459 if (!request->username) {
1460 RDEBUG2("Attribute \"User-Name\" is required for authorization.\n");
1461 return RLM_MODULE_NOOP;
1465 * Check for valid input, zero length names not permitted
1467 if (request->username->length == 0) {
1468 RDEBUG2("zero length username not permitted\n");
1469 return RLM_MODULE_INVALID;
1472 if (!radius_xlat(filter, sizeof(filter), inst->filter,
1473 request, ldap_escape_func)) {
1474 radlog(L_ERR, " [%s] Failed creating filter.\n", inst->xlat_name);
1475 return RLM_MODULE_INVALID;
1478 if (!radius_xlat(basedn, sizeof(basedn), inst->basedn,
1479 request, ldap_escape_func)) {
1480 radlog(L_ERR, " [%s] Failed creating basedn.\n", inst->xlat_name);
1481 return RLM_MODULE_INVALID;
1484 conn = ldap_get_socket(inst);
1485 if (!conn) return RLM_MODULE_FAIL;
1487 rcode = perform_search(inst, &conn, basedn, LDAP_SCOPE_SUBTREE, filter,
1488 inst->attrs, &result);
1491 module_failure_msg(&request->packet->vps,
1492 "[%s] Search returned not found",
1494 DEBUG(" [%s] Search returned not found", inst->xlat_name);
1495 module_rcode = RLM_MODULE_NOTFOUND;
1498 DEBUG(" [%s] Search returned error", inst->xlat_name);
1502 msg = ldap_first_entry(conn->ld, result);
1504 RDEBUG2("ldap_first_entry() failed");
1508 user_dn = ldap_get_dn(conn->ld, msg);
1510 RDEBUG2("ldap_get_dn() failed");
1515 * Adding attribute containing the Users' DN.
1517 pairadd(&request->config_items, pairmake("Ldap-UserDn", user_dn, T_OP_EQ));
1518 ldap_memfree(user_dn);
1523 if (inst->access_attr) {
1526 if (check_access(inst, conn, msg) < 0) {
1527 module_rcode = RLM_MODULE_USERLOCK;
1533 * Apply ONE user profile, or a default user profile.
1535 vp = pairfind(request->config_items, PW_USER_PROFILE, 0);
1536 if (vp || inst->default_profile) {
1537 char *profile = inst->default_profile;
1539 if (vp) profile = vp->vp_strvalue;
1542 apply_profile(inst, &conn, request, profile);
1546 * Apply a SET of user profiles.
1548 if (inst->profile_attr &&
1549 (vals = ldap_get_values(conn->ld, msg, inst->profile_attr)) != NULL) {
1553 for (i = 0; (vals[i] != NULL) && (*vals[i] != '\0'); i++) {
1554 apply_profile(inst, &conn, request, vals[i]);
1558 ldap_value_free(vals);
1561 if (inst->map_file) {
1563 do_check_reply(inst, conn->ld, request, msg);
1567 RDEBUG("WARNING: The module did NOTHING in the 'authorize' section. Why is it listed?");
1568 RDEBUG("WARNING: You can probably delete '%s' from 'authorize'",
1573 ldap_msgfree(result);
1575 ldap_release_socket(inst, conn);
1577 return module_rcode;
1581 /*****************************************************************************
1583 * Function: ldap_authenticate
1585 * Purpose: Check the user's password against ldap database
1587 *****************************************************************************/
1588 static int ldap_authenticate(void *instance, REQUEST * request)
1591 const char *user_dn;
1592 ldap_instance *inst = instance;
1596 * Ensure that we're being passed a plain-text password, and not
1600 if (!request->username) {
1601 radlog(L_AUTH, " [%s] Attribute \"User-Name\" is required for authentication.", inst->xlat_name);
1602 return RLM_MODULE_INVALID;
1605 if (!request->password) {
1606 radlog(L_AUTH, " [%s] Attribute \"User-Password\" is required for authentication.", inst->xlat_name);
1607 RDEBUG2(" You seem to have set \"Auth-Type := LDAP\" somewhere.");
1608 RDEBUG2(" *******************************************************");
1609 RDEBUG2(" * THAT CONFIGURATION IS WRONG. DELETE IT.");
1610 RDEBUG2(" * YOU ARE PREVENTING THE SERVER FROM WORKING PROPERLY.");
1611 RDEBUG2(" *******************************************************");
1612 return RLM_MODULE_INVALID;
1615 if (request->password->attribute != PW_USER_PASSWORD) {
1616 radlog(L_AUTH, " [%s] Attribute \"User-Password\" is required for authentication. Cannot use \"%s\".", inst->xlat_name, request->password->name);
1617 return RLM_MODULE_INVALID;
1620 if (request->password->length == 0) {
1621 module_failure_msg(&request->packet->vps,
1622 "[%s] empty password supplied", inst->xlat_name);
1623 return RLM_MODULE_INVALID;
1626 conn = ldap_get_socket(inst);
1627 if (!conn) return RLM_MODULE_FAIL;
1629 RDEBUG("login attempt by \"%s\" with password \"%s\"",
1630 request->username->vp_strvalue, request->password->vp_strvalue);
1633 * Get the DN by doing a search.
1635 user_dn = get_userdn(&conn, request, &module_rcode);
1637 ldap_release_socket(inst, conn);
1638 return module_rcode;
1644 conn->rebound = TRUE;
1645 module_rcode = ldap_bind_wrapper(&conn, user_dn,
1646 request->password->vp_strvalue,
1648 if (module_rcode == RLM_MODULE_OK) {
1649 RDEBUG(" [%s] Bind as user '%s' was successful", inst->xlat_name,
1653 ldap_release_socket(inst, conn);
1654 return module_rcode;
1658 /* globally exported name */
1659 module_t rlm_ldap = {
1662 RLM_TYPE_THREAD_SAFE, /* type: reserved */
1663 ldap_instantiate, /* instantiation */
1664 ldap_detach, /* detach */
1666 ldap_authenticate, /* authentication */
1667 ldap_authorize, /* authorization */
1668 NULL, /* preaccounting */
1669 NULL, /* accounting */
1670 NULL, /* checksimul */
1671 NULL, /* pre-proxy */
1672 NULL, /* post-proxy */