2 * This program is is free software; you can redistribute it and/or modify
3 * it under the terms of the GNU General Public License, version 2 if the
4 * License as published by the Free Software Foundation.
6 * This program is distributed in the hope that it will be useful,
7 * but WITHOUT ANY WARRANTY; without even the implied warranty of
8 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
9 * GNU General Public License for more details.
11 * You should have received a copy of the GNU General Public License
12 * along with this program; if not, write to the Free Software
13 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
19 * @brief Implements SQL 'users' file, and SQL accounting.
21 * @copyright 2012 Arran Cudbard-Bell <a.cudbardb@freeradius.org>
22 * @copyright 2000,2006 The FreeRADIUS server project
23 * @copyright 2000 Mike Machado <mike@innercite.com>
24 * @copyright 2000 Alan DeKok <aland@ox.org>
30 #include <freeradius-devel/radiusd.h>
31 #include <freeradius-devel/modules.h>
32 #include <freeradius-devel/token.h>
33 #include <freeradius-devel/rad_assert.h>
40 * So we can do pass2 xlat checks on the queries.
42 static const CONF_PARSER query_config[] = {
44 { "query", FR_CONF_OFFSET(PW_TYPE_STRING | PW_TYPE_XLAT | PW_TYPE_MULTI, rlm_sql_config_t, accounting.query), NULL },
46 {NULL, -1, 0, NULL, NULL}
50 * For now hard-code the subsections. This isn't perfect, but it
51 * helps the average case.
53 static const CONF_PARSER type_config[] = {
55 { "accounting-on", FR_CONF_POINTER(PW_TYPE_SUBSECTION, NULL), (void const *) query_config },
56 { "accounting-off", FR_CONF_POINTER(PW_TYPE_SUBSECTION, NULL), (void const *) query_config },
57 { "start", FR_CONF_POINTER(PW_TYPE_SUBSECTION, NULL), (void const *) query_config },
58 { "interim-update", FR_CONF_POINTER(PW_TYPE_SUBSECTION, NULL), (void const *) query_config },
59 { "stop", FR_CONF_POINTER(PW_TYPE_SUBSECTION, NULL), (void const *) query_config },
61 {NULL, -1, 0, NULL, NULL}
66 static const CONF_PARSER acct_config[] = {
67 { "reference", FR_CONF_OFFSET(PW_TYPE_STRING | PW_TYPE_XLAT, rlm_sql_config_t, accounting.reference), ".query" },
68 { "logfile", FR_CONF_OFFSET(PW_TYPE_STRING, rlm_sql_config_t, accounting.logfile), NULL },
70 { "type", FR_CONF_POINTER(PW_TYPE_SUBSECTION, NULL), (void const *) type_config },
72 {NULL, -1, 0, NULL, NULL}
75 static const CONF_PARSER postauth_config[] = {
76 { "reference", FR_CONF_OFFSET(PW_TYPE_STRING | PW_TYPE_XLAT, rlm_sql_config_t, postauth.reference), ".query" },
77 { "logfile", FR_CONF_OFFSET(PW_TYPE_STRING, rlm_sql_config_t, postauth.logfile), NULL },
79 { "query", FR_CONF_OFFSET(PW_TYPE_STRING | PW_TYPE_XLAT | PW_TYPE_MULTI, rlm_sql_config_t, postauth.query), NULL },
81 {NULL, -1, 0, NULL, NULL}
84 static const CONF_PARSER module_config[] = {
85 { "driver", FR_CONF_OFFSET(PW_TYPE_STRING, rlm_sql_config_t, sql_driver_name), "rlm_sql_null" },
86 { "server", FR_CONF_OFFSET(PW_TYPE_STRING, rlm_sql_config_t, sql_server), "localhost" },
87 { "port", FR_CONF_OFFSET(PW_TYPE_STRING, rlm_sql_config_t, sql_port), "" },
88 { "login", FR_CONF_OFFSET(PW_TYPE_STRING, rlm_sql_config_t, sql_login), "" },
89 { "password", FR_CONF_OFFSET(PW_TYPE_STRING | PW_TYPE_SECRET, rlm_sql_config_t, sql_password), "" },
90 { "radius_db", FR_CONF_OFFSET(PW_TYPE_STRING, rlm_sql_config_t, sql_db), "radius" },
91 { "read_groups", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, rlm_sql_config_t, read_groups), "yes" },
92 { "read_profiles", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, rlm_sql_config_t, read_profiles), "yes" },
93 { "readclients", FR_CONF_OFFSET(PW_TYPE_BOOLEAN | PW_TYPE_DEPRECATED, rlm_sql_config_t, do_clients), NULL },
94 { "read_clients", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, rlm_sql_config_t, do_clients), "no" },
95 { "deletestalesessions", FR_CONF_OFFSET(PW_TYPE_BOOLEAN | PW_TYPE_DEPRECATED, rlm_sql_config_t, deletestalesessions), NULL },
96 { "delete_stale_sessions", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, rlm_sql_config_t, deletestalesessions), "yes" },
97 { "sql_user_name", FR_CONF_OFFSET(PW_TYPE_STRING, rlm_sql_config_t, query_user), "" },
98 { "logfile", FR_CONF_OFFSET(PW_TYPE_STRING, rlm_sql_config_t, logfile), NULL },
99 { "default_user_profile", FR_CONF_OFFSET(PW_TYPE_STRING, rlm_sql_config_t, default_profile), "" },
100 { "nas_query", FR_CONF_OFFSET(PW_TYPE_STRING | PW_TYPE_DEPRECATED, rlm_sql_config_t, client_query), NULL },
101 { "client_query", FR_CONF_OFFSET(PW_TYPE_STRING, rlm_sql_config_t, client_query), "SELECT id,nasname,shortname,type,secret FROM nas" },
102 { "open_query", FR_CONF_OFFSET(PW_TYPE_STRING, rlm_sql_config_t, open_query), NULL },
104 { "authorize_check_query", FR_CONF_OFFSET(PW_TYPE_STRING | PW_TYPE_XLAT, rlm_sql_config_t, authorize_check_query), NULL },
105 { "authorize_reply_query", FR_CONF_OFFSET(PW_TYPE_STRING | PW_TYPE_XLAT, rlm_sql_config_t, authorize_reply_query), NULL },
107 { "authorize_group_check_query", FR_CONF_OFFSET(PW_TYPE_STRING | PW_TYPE_XLAT, rlm_sql_config_t, authorize_group_check_query), "" },
108 { "authorize_group_reply_query", FR_CONF_OFFSET(PW_TYPE_STRING | PW_TYPE_XLAT, rlm_sql_config_t, authorize_group_reply_query), "" },
109 { "group_membership_query", FR_CONF_OFFSET(PW_TYPE_STRING | PW_TYPE_XLAT, rlm_sql_config_t, groupmemb_query), NULL },
110 #ifdef WITH_SESSION_MGMT
111 { "simul_count_query", FR_CONF_OFFSET(PW_TYPE_STRING | PW_TYPE_XLAT, rlm_sql_config_t, simul_count_query), "" },
112 { "simul_verify_query", FR_CONF_OFFSET(PW_TYPE_STRING | PW_TYPE_XLAT, rlm_sql_config_t, simul_verify_query), "" },
114 { "safe-characters", FR_CONF_OFFSET(PW_TYPE_STRING | PW_TYPE_DEPRECATED, rlm_sql_config_t, allowed_chars), NULL },
115 { "safe_characters", FR_CONF_OFFSET(PW_TYPE_STRING, rlm_sql_config_t, allowed_chars), "@abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789.-_: /" },
118 * This only works for a few drivers.
120 { "query_timeout", FR_CONF_OFFSET(PW_TYPE_INTEGER, rlm_sql_config_t, query_timeout), NULL },
122 { "accounting", FR_CONF_POINTER(PW_TYPE_SUBSECTION, NULL), (void const *) acct_config },
124 { "post-auth", FR_CONF_POINTER(PW_TYPE_SUBSECTION, NULL), (void const *) postauth_config },
126 {NULL, -1, 0, NULL, NULL}
130 * Fall-Through checking function from rlm_files.c
132 static sql_fall_through_t fall_through(VALUE_PAIR *vp)
135 tmp = pairfind(vp, PW_FALL_THROUGH, 0, TAG_ANY);
137 return tmp ? tmp->vp_integer : FALL_THROUGH_DEFAULT;
143 static int generate_sql_clients(rlm_sql_t *inst);
144 static size_t sql_escape_func(REQUEST *, char *out, size_t outlen, char const *in, void *arg);
149 * For selects the first value of the first column will be returned,
150 * for inserts, updates and deletes the number of rows affected will be
153 static ssize_t sql_xlat(void *instance, REQUEST *request, char const *query, char *out, size_t freespace)
155 rlm_sql_handle_t *handle = NULL;
157 rlm_sql_t *inst = instance;
162 * Add SQL-User-Name attribute just in case it is needed
163 * We could search the string fmt for SQL-User-Name to see if this is
166 sql_set_user(inst, request, NULL);
168 handle = fr_connection_get(inst->pool);
173 rlm_sql_query_log(inst, request, NULL, query);
176 * If the query starts with any of the following prefixes,
177 * then return the number of rows affected
179 if ((strncasecmp(query, "insert", 6) == 0) ||
180 (strncasecmp(query, "update", 6) == 0) ||
181 (strncasecmp(query, "delete", 6) == 0)) {
183 char buffer[21]; /* 64bit max is 20 decimal chars + null byte */
185 if (rlm_sql_query(&handle, inst, query) != RLM_SQL_OK) {
186 char const *error = (inst->module->sql_error)(handle, inst->config);
187 REDEBUG("SQL query failed: %s", error);
193 numaffected = (inst->module->sql_affected_rows)(handle, inst->config);
194 if (numaffected < 1) {
195 RDEBUG("SQL query affected no rows");
201 * Don't chop the returned number if freespace is
202 * too small. This hack is necessary because
203 * some implementations of snprintf return the
204 * size of the written data, and others return
205 * the size of the data they *would* have written
206 * if the output buffer was large enough.
208 snprintf(buffer, sizeof(buffer), "%d", numaffected);
210 len = strlen(buffer);
211 if (len >= freespace){
212 RDEBUG("rlm_sql (%s): Can't write result, insufficient string space", inst->config->xlat_name);
214 (inst->module->sql_finish_query)(handle, inst->config);
220 memcpy(out, buffer, len + 1); /* we did bounds checking above */
223 (inst->module->sql_finish_query)(handle, inst->config);
226 } /* else it's a SELECT statement */
228 if (rlm_sql_select_query(&handle, inst, query) != RLM_SQL_OK) {
229 ret = -1; /* error handled by rlm_sql_select_query */
234 ret = rlm_sql_fetch_row(&handle, inst);
236 REDEBUG("SQL query failed");
237 (inst->module->sql_finish_select_query)(handle, inst->config);
245 RDEBUG("SQL query returned no results");
246 (inst->module->sql_finish_select_query)(handle, inst->config);
253 RDEBUG("NULL value in first column of result");
254 (inst->module->sql_finish_select_query)(handle, inst->config);
260 len = strlen(row[0]);
261 if (len >= freespace){
262 RDEBUG("Insufficient string space");
263 (inst->module->sql_finish_select_query)(handle, inst->config);
269 strlcpy(out, row[0], freespace);
272 (inst->module->sql_finish_select_query)(handle, inst->config);
275 fr_connection_release(inst->pool, handle);
280 static int generate_sql_clients(rlm_sql_t *inst)
282 rlm_sql_handle_t *handle;
287 DEBUG("rlm_sql (%s): Processing generate_sql_clients",
288 inst->config->xlat_name);
290 DEBUG("rlm_sql (%s) in generate_sql_clients: query is %s",
291 inst->config->xlat_name, inst->config->client_query);
293 handle = fr_connection_get(inst->pool);
298 if (rlm_sql_select_query(&handle, inst, inst->config->client_query) != RLM_SQL_OK) return -1;
300 while ((rlm_sql_fetch_row(&handle, inst) == 0) && (row = handle->row)) {
305 * The return data for each row MUST be in the following order:
307 * 0. Row ID (currently unused)
308 * 1. Name (or IP address)
312 * 5. Virtual Server (optional)
315 ERROR("rlm_sql (%s): No row id found on pass %d",inst->config->xlat_name,i);
319 ERROR("rlm_sql (%s): No nasname found for row %s",inst->config->xlat_name,row[0]);
323 ERROR("rlm_sql (%s): No short name found for row %s",inst->config->xlat_name,row[0]);
327 ERROR("rlm_sql (%s): No secret found for row %s",inst->config->xlat_name,row[0]);
331 if (((inst->module->sql_num_fields)(handle, inst->config) > 5) && (row[5] != NULL) && *row[5]) {
335 DEBUG("rlm_sql (%s): Adding client %s (%s) to %s clients list",
336 inst->config->xlat_name,
337 row[1], row[2], server ? server : "global");
339 /* FIXME: We should really pass a proper ctx */
340 c = client_afrom_query(NULL,
341 row[1], /* identifier */
343 row[2], /* shortname */
346 false); /* require message authenticator */
351 if (!client_add(NULL, c)) {
352 WARN("Failed to add client, possible duplicate?");
358 DEBUG("rlm_sql (%s): Client \"%s\" (%s) added", c->longname, c->shortname,
359 inst->config->xlat_name);
362 (inst->module->sql_finish_select_query)(handle, inst->config);
363 fr_connection_release(inst->pool, handle);
370 * Translate the SQL queries.
372 static size_t sql_escape_func(UNUSED REQUEST *request, char *out, size_t outlen,
373 char const *in, void *arg)
375 rlm_sql_t *inst = arg;
382 * Allow all multi-byte UTF8 characters.
384 utf8_len = fr_utf8_char((uint8_t const *) in);
386 if (outlen <= utf8_len) break;
388 memcpy(out, in, utf8_len);
398 * Because we register our own escape function
399 * we're now responsible for escaping all special
400 * chars in an xlat expansion or attribute value.
404 if (outlen <= 2) break;
415 if (outlen <= 2) break;
426 if (outlen <= 2) break;
438 * Non-printable characters get replaced with their
439 * mime-encoded equivalents.
442 strchr(inst->config->allowed_chars, *in) == NULL) {
444 * Only 3 or less bytes available.
450 snprintf(out, outlen, "=%02X", (unsigned char) in[0]);
459 * Only one byte left.
479 * Set the SQL user name.
481 * We don't call the escape function here. The resulting string
482 * will be escaped later in the queries xlat so we don't need to
483 * escape it twice. (it will make things wrong if we have an
484 * escape candidate character in the username)
486 int sql_set_user(rlm_sql_t *inst, REQUEST *request, char const *username)
488 char *expanded = NULL;
489 VALUE_PAIR *vp = NULL;
493 rad_assert(request->packet != NULL);
495 if (username != NULL) {
497 } else if (inst->config->query_user[0] != '\0') {
498 sqluser = inst->config->query_user;
503 len = radius_axlat(&expanded, request, sqluser, NULL, NULL);
508 vp = pairalloc(request->packet, inst->sql_user);
510 talloc_free(expanded);
514 pairstrsteal(vp, expanded);
515 RDEBUG2("SQL-User-Name set to '%s'", vp->vp_strvalue);
517 radius_pairmove(request, &request->packet->vps, vp, false); /* needs to be pair move else op is not respected */
523 * Do a set/unset user, so it's a bit clearer what's going on.
525 #define sql_unset_user(_i, _r) pairdelete(&_r->packet->vps, _i->sql_user->attr, _i->sql_user->vendor, TAG_ANY)
527 static int sql_get_grouplist(rlm_sql_t *inst, rlm_sql_handle_t **handle, REQUEST *request,
528 rlm_sql_grouplist_t **phead)
530 char *expanded = NULL;
533 rlm_sql_grouplist_t *entry;
536 /* NOTE: sql_set_user should have been run before calling this function */
538 entry = *phead = NULL;
540 if (!inst->config->groupmemb_query) return 0;
542 if (radius_axlat(&expanded, request, inst->config->groupmemb_query, sql_escape_func, inst) < 0) return -1;
544 ret = rlm_sql_select_query(handle, inst, expanded);
545 talloc_free(expanded);
546 if (ret != RLM_SQL_OK) return -1;
548 while (rlm_sql_fetch_row(handle, inst) == 0) {
549 row = (*handle)->row;
554 RDEBUG("row[0] returned NULL");
555 (inst->module->sql_finish_select_query)(*handle, inst->config);
561 *phead = talloc_zero(*handle, rlm_sql_grouplist_t);
564 entry->next = talloc_zero(*phead, rlm_sql_grouplist_t);
568 entry->name = talloc_typed_strdup(entry, row[0]);
573 (inst->module->sql_finish_select_query)(*handle, inst->config);
580 * sql groupcmp function. That way we can do group comparisons (in the users file for example)
581 * with the group memberships reciding in sql
582 * The group membership query should only return one element which is the username. The returned
583 * username will then be checked with the passed check string.
586 static int CC_HINT(nonnull (1, 2, 4)) sql_groupcmp(void *instance, REQUEST *request, UNUSED VALUE_PAIR *request_vp,
587 VALUE_PAIR *check, UNUSED VALUE_PAIR *check_pairs,
588 UNUSED VALUE_PAIR **reply_pairs)
590 rlm_sql_handle_t *handle;
591 rlm_sql_t *inst = instance;
592 rlm_sql_grouplist_t *head, *entry;
594 RDEBUG("sql_groupcmp");
596 if (check->length == 0){
597 RDEBUG("sql_groupcmp: Illegal group name");
602 * Set, escape, and check the user attr here
604 if (sql_set_user(inst, request, NULL) < 0)
608 * Get a socket for this lookup
610 handle = fr_connection_get(inst->pool);
616 * Get the list of groups this user is a member of
618 if (sql_get_grouplist(inst, &handle, request, &head) < 0) {
619 REDEBUG("Error getting group membership");
620 fr_connection_release(inst->pool, handle);
624 for (entry = head; entry != NULL; entry = entry->next) {
625 if (strcmp(entry->name, check->vp_strvalue) == 0){
626 RDEBUG("sql_groupcmp finished: User is a member of group %s",
629 fr_connection_release(inst->pool, handle);
634 /* Free the grouplist */
636 fr_connection_release(inst->pool, handle);
638 RDEBUG("sql_groupcmp finished: User is NOT a member of group %s", check->vp_strvalue);
643 static rlm_rcode_t rlm_sql_process_groups(rlm_sql_t *inst, REQUEST *request, rlm_sql_handle_t **handle,
644 sql_fall_through_t *do_fall_through)
646 rlm_rcode_t rcode = RLM_MODULE_NOOP;
647 VALUE_PAIR *check_tmp = NULL, *reply_tmp = NULL, *sql_group = NULL;
648 rlm_sql_grouplist_t *head = NULL, *entry = NULL;
650 char *expanded = NULL;
653 rad_assert(request->packet != NULL);
656 * Get the list of groups this user is a member of
658 rows = sql_get_grouplist(inst, handle, request, &head);
660 REDEBUG("Error retrieving group list");
662 return RLM_MODULE_FAIL;
665 RDEBUG2("User not found in any groups");
666 rcode = RLM_MODULE_NOTFOUND;
667 *do_fall_through = FALL_THROUGH_DEFAULT;
673 RDEBUG2("User found in the group table");
676 * Add the Sql-Group attribute to the request list so we know
677 * which group we're retrieving attributes for
679 sql_group = pairmake_packet("Sql-Group", NULL, T_OP_EQ);
681 REDEBUG("Error creating Sql-Group attribute");
682 rcode = RLM_MODULE_FAIL;
689 pairstrcpy(sql_group, entry->name);
691 if (inst->config->authorize_group_check_query && *inst->config->authorize_group_check_query) {
696 * Expand the group query
698 if (radius_axlat(&expanded, request, inst->config->authorize_group_check_query,
699 sql_escape_func, inst) < 0) {
700 REDEBUG("Error generating query");
701 rcode = RLM_MODULE_FAIL;
705 rows = sql_getvpdata(request, inst, request, handle, &check_tmp, expanded);
706 TALLOC_FREE(expanded);
708 REDEBUG("Error retrieving check pairs for group %s", entry->name);
709 rcode = RLM_MODULE_FAIL;
714 * If we got check rows we need to process them before we decide to
715 * process the reply rows
718 (paircompare(request, request->packet->vps, check_tmp, &request->reply->vps) != 0)) {
719 pairfree(&check_tmp);
722 goto next; /* != continue */
725 RDEBUG2("Group \"%s\": Conditional check items matched", entry->name);
726 rcode = RLM_MODULE_OK;
728 RDEBUG2("Group \"%s\": Merging assignment check items", entry->name);
730 for (vp = fr_cursor_init(&cursor, &check_tmp);
732 vp = fr_cursor_next(&cursor)) {
733 if (!fr_assignment_op[vp->op]) continue;
735 rdebug_pair(L_DBG_LVL_2, request, vp);
738 radius_pairmove(request, &request->config_items, check_tmp, true);
742 if (inst->config->authorize_group_reply_query && *inst->config->authorize_group_reply_query) {
744 * Now get the reply pairs since the paircompare matched
746 if (radius_axlat(&expanded, request, inst->config->authorize_group_reply_query,
747 sql_escape_func, inst) < 0) {
748 REDEBUG("Error generating query");
749 rcode = RLM_MODULE_FAIL;
753 rows = sql_getvpdata(request->reply, inst, request, handle, &reply_tmp, expanded);
754 TALLOC_FREE(expanded);
756 REDEBUG("Error retrieving reply pairs for group %s", entry->name);
757 rcode = RLM_MODULE_FAIL;
760 *do_fall_through = fall_through(reply_tmp);
762 RDEBUG2("Group \"%s\": Merging reply items", entry->name);
763 rcode = RLM_MODULE_OK;
765 rdebug_pair_list(L_DBG_LVL_2, request, reply_tmp, NULL);
767 radius_pairmove(request, &request->reply->vps, reply_tmp, true);
770 * If there's no reply query configured, then we assume
771 * FALL_THROUGH_NO, which is the same as the users file if you
772 * had no reply attributes.
775 *do_fall_through = FALL_THROUGH_DEFAULT;
779 } while (entry != NULL && (*do_fall_through == FALL_THROUGH_YES));
783 pairdelete(&request->packet->vps, PW_SQL_GROUP, 0, TAG_ANY);
789 static int mod_detach(void *instance)
791 rlm_sql_t *inst = instance;
793 if (inst->pool) fr_connection_pool_delete(inst->pool);
796 * We need to explicitly free all children, so if the driver
797 * parented any memory off the instance, their destructors
798 * run before we unload the bytecode for them.
800 * If we don't do this, we get a SEGV deep inside the talloc code
801 * when it tries to call a destructor that no longer exists.
803 talloc_free_children(inst);
806 * Decrements the reference count. The driver object won't be unloaded
807 * until all instances of rlm_sql that use it have been destroyed.
809 if (inst->handle) dlclose(inst->handle);
814 static int mod_instantiate(CONF_SECTION *conf, void *instance)
816 rlm_sql_t *inst = instance;
821 inst->config = &inst->myconfig;
824 inst->config->xlat_name = cf_section_name2(conf);
825 if (!inst->config->xlat_name) {
826 inst->config->xlat_name = cf_section_name1(conf);
833 * Allocate room for <instance>-SQL-Group
835 group_name = talloc_typed_asprintf(inst, "%s-SQL-Group", inst->config->xlat_name);
836 DEBUG("rlm_sql (%s): Creating new attribute %s",
837 inst->config->xlat_name, group_name);
839 memset(&flags, 0, sizeof(flags));
840 if (dict_addattr(group_name, -1, 0, PW_TYPE_STRING, flags) < 0) {
841 ERROR("rlm_sql (%s): Failed to create "
842 "attribute %s: %s", inst->config->xlat_name, group_name,
847 da = dict_attrbyname(group_name);
849 ERROR("rlm_sql (%s): Failed to create "
850 "attribute %s", inst->config->xlat_name, group_name);
854 if (inst->config->groupmemb_query &&
855 inst->config->groupmemb_query[0]) {
856 DEBUG("rlm_sql (%s): Registering sql_groupcmp for %s",
857 inst->config->xlat_name, group_name);
858 paircompare_register(da, dict_attrbyvalue(PW_USER_NAME, 0),
859 false, sql_groupcmp, inst);
863 rad_assert(inst->config->xlat_name);
866 * Complain if the strings exist, but are empty.
868 #define CHECK_STRING(_x) if (inst->config->_x && !inst->config->_x[0]) \
870 WARN("rlm_sql (%s): " STRINGIFY(_x) " is empty. Please delete it from the configuration", inst->config->xlat_name);\
871 inst->config->_x = NULL;\
874 CHECK_STRING(groupmemb_query);
875 CHECK_STRING(authorize_check_query);
876 CHECK_STRING(authorize_reply_query);
877 CHECK_STRING(authorize_group_check_query);
878 CHECK_STRING(authorize_group_reply_query);
881 * Sanity check for crazy people.
883 if (strncmp(inst->config->sql_driver_name, "rlm_sql_", 8) != 0) {
884 ERROR("rlm_sql (%s): \"%s\" is NOT an SQL driver!", inst->config->xlat_name, inst->config->sql_driver_name);
889 * We need authorize_group_check_query or authorize_group_reply_query
890 * if group_membership_query is set.
892 * Or we need group_membership_query if authorize_group_check_query or
893 * authorize_group_reply_query is set.
895 if (!inst->config->groupmemb_query) {
896 if (inst->config->authorize_group_check_query) {
897 WARN("rlm_sql (%s): Ignoring authorize_group_check_query as group_membership_query is not configured",
898 inst->config->xlat_name);
902 if (inst->config->authorize_group_reply_query) {
903 WARN("rlm_sql (%s): Ignoring authorize_group_reply_query as group_membership_query is not configured",
904 inst->config->xlat_name);
908 if (!inst->config->authorize_group_check_query) {
909 ERROR("rlm_sql (%s): authorize_group_check_query is required because group_membership_query is configured",
910 inst->config->xlat_name);
914 if (inst->config->authorize_group_reply_query) {
915 ERROR("rlm_sql (%s): authorize_group_reply_query is required because group_membership_query is configured",
916 inst->config->xlat_name);
922 * This will always exist, as cf_section_parse_init()
923 * will create it if it doesn't exist. However, the
924 * "reference" config item won't exist in an auto-created
925 * configuration. So if that doesn't exist, we ignore
926 * the whole subsection.
928 inst->config->accounting.cs = cf_section_sub_find(conf, "accounting");
929 inst->config->accounting.reference_cp = (cf_pair_find(inst->config->accounting.cs, "reference") != NULL);
931 inst->config->postauth.cs = cf_section_sub_find(conf, "post-auth");
932 inst->config->postauth.reference_cp = (cf_pair_find(inst->config->postauth.cs, "reference") != NULL);
935 * Cache the SQL-User-Name DICT_ATTR, so we can be slightly
936 * more efficient about creating SQL-User-Name attributes.
938 inst->sql_user = dict_attrbyname("SQL-User-Name");
939 if (!inst->sql_user) {
944 * Export these methods, too. This avoids RTDL_GLOBAL.
946 inst->sql_set_user = sql_set_user;
947 inst->sql_escape_func = sql_escape_func;
948 inst->sql_query = rlm_sql_query;
949 inst->sql_select_query = rlm_sql_select_query;
950 inst->sql_fetch_row = rlm_sql_fetch_row;
953 * Register the SQL xlat function
955 xlat_register(inst->config->xlat_name, sql_xlat, sql_escape_func, inst);
958 * Load the appropriate driver for our database
960 inst->handle = lt_dlopenext(inst->config->sql_driver_name);
962 ERROR("Could not link driver %s: %s", inst->config->sql_driver_name, dlerror());
963 ERROR("Make sure it (and all its dependent libraries!) are in the search path of your system's ld");
967 inst->module = (rlm_sql_module_t *) dlsym(inst->handle,
968 inst->config->sql_driver_name);
970 ERROR("Could not link symbol %s: %s", inst->config->sql_driver_name, dlerror());
974 if (inst->module->mod_instantiate) {
978 name = strrchr(inst->config->sql_driver_name, '_');
980 name = inst->config->sql_driver_name;
985 cs = cf_section_sub_find(conf, name);
987 cs = cf_section_alloc(conf, name, NULL);
994 * It's up to the driver to register a destructor
996 if (inst->module->mod_instantiate(cs, inst->config) < 0) {
1001 inst->lf = fr_logfile_init(inst);
1003 cf_log_err_cs(conf, "Failed creating log file context");
1007 INFO("rlm_sql (%s): Driver %s (module %s) loaded and linked", inst->config->xlat_name,
1008 inst->config->sql_driver_name, inst->module->name);
1011 * Initialise the connection pool for this instance
1013 INFO("rlm_sql (%s): Attempting to connect to database \"%s\"", inst->config->xlat_name, inst->config->sql_db);
1015 inst->pool = fr_connection_pool_module_init(inst->cs, inst, mod_conn_create, NULL, NULL);
1016 if (!inst->pool) return -1;
1018 if (inst->config->groupmemb_query &&
1019 inst->config->groupmemb_query[0]) {
1020 paircompare_register(dict_attrbyvalue(PW_SQL_GROUP, 0),
1021 dict_attrbyvalue(PW_USER_NAME, 0), false, sql_groupcmp, inst);
1024 if (inst->config->do_clients) {
1025 if (generate_sql_clients(inst) == -1){
1026 ERROR("Failed to load clients from SQL");
1031 return RLM_MODULE_OK;
1035 static rlm_rcode_t CC_HINT(nonnull) mod_authorize(void *instance, REQUEST *request)
1037 rlm_rcode_t rcode = RLM_MODULE_NOOP;
1039 rlm_sql_t *inst = instance;
1040 rlm_sql_handle_t *handle;
1042 VALUE_PAIR *check_tmp = NULL;
1043 VALUE_PAIR *reply_tmp = NULL;
1044 VALUE_PAIR *user_profile = NULL;
1046 bool user_found = false;
1048 sql_fall_through_t do_fall_through = FALL_THROUGH_DEFAULT;
1052 char *expanded = NULL;
1054 rad_assert(request->packet != NULL);
1055 rad_assert(request->reply != NULL);
1057 if (!inst->config->authorize_check_query && !inst->config->authorize_reply_query &&
1058 !inst->config->read_groups && !inst->config->read_profiles) {
1059 RWDEBUG("No authorization checks configured, returning noop");
1061 return RLM_MODULE_NOOP;
1065 * Set, escape, and check the user attr here
1067 if (sql_set_user(inst, request, NULL) < 0) {
1068 return RLM_MODULE_FAIL;
1074 * After this point use goto error or goto release to cleanup socket temporary pairlists and
1075 * temporary attributes.
1077 handle = fr_connection_get(inst->pool);
1079 rcode = RLM_MODULE_FAIL;
1084 * Query the check table to find any conditions associated with this user/realm/whatever...
1086 if (inst->config->authorize_check_query && *inst->config->authorize_check_query) {
1090 if (radius_axlat(&expanded, request, inst->config->authorize_check_query,
1091 sql_escape_func, inst) < 0) {
1092 REDEBUG("Error generating query");
1093 rcode = RLM_MODULE_FAIL;
1097 rows = sql_getvpdata(request, inst, request, &handle, &check_tmp, expanded);
1098 TALLOC_FREE(expanded);
1100 REDEBUG("SQL query error getting check attributes");
1101 rcode = RLM_MODULE_FAIL;
1105 if (rows == 0) goto skipreply; /* Don't need to free VPs we don't have */
1108 * Only do this if *some* check pairs were returned
1110 RDEBUG2("User found in radcheck table");
1112 if (paircompare(request, request->packet->vps, check_tmp, &request->reply->vps) != 0) {
1113 pairfree(&check_tmp);
1118 RDEBUG2("Conditional check items matched, merging assignment check items");
1120 for (vp = fr_cursor_init(&cursor, &check_tmp);
1122 vp = fr_cursor_next(&cursor)) {
1123 if (!fr_assignment_op[vp->op]) continue;
1125 rdebug_pair(2, request, vp);
1128 radius_pairmove(request, &request->config_items, check_tmp, true);
1130 rcode = RLM_MODULE_OK;
1134 if (inst->config->authorize_reply_query && *inst->config->authorize_reply_query) {
1136 * Now get the reply pairs since the paircompare matched
1138 if (radius_axlat(&expanded, request, inst->config->authorize_reply_query,
1139 sql_escape_func, inst) < 0) {
1140 REDEBUG("Error generating query");
1141 rcode = RLM_MODULE_FAIL;
1145 rows = sql_getvpdata(request->reply, inst, request, &handle, &reply_tmp, expanded);
1146 TALLOC_FREE(expanded);
1148 REDEBUG("SQL query error getting reply attributes");
1149 rcode = RLM_MODULE_FAIL;
1153 if (rows == 0) goto skipreply;
1155 do_fall_through = fall_through(reply_tmp);
1157 RDEBUG2("User found in radreply table, merging reply items");
1160 rdebug_pair_list(L_DBG_LVL_2, request, reply_tmp, NULL);
1162 radius_pairmove(request, &request->reply->vps, reply_tmp, true);
1164 rcode = RLM_MODULE_OK;
1169 if ((do_fall_through == FALL_THROUGH_YES) ||
1170 (inst->config->read_groups && (do_fall_through == FALL_THROUGH_DEFAULT))) {
1173 RDEBUG3("... falling-through to group processing");
1174 ret = rlm_sql_process_groups(inst, request, &handle, &do_fall_through);
1177 * Nothing bad happened, continue...
1179 case RLM_MODULE_UPDATED:
1180 rcode = RLM_MODULE_UPDATED;
1183 if (rcode != RLM_MODULE_UPDATED) {
1184 rcode = RLM_MODULE_OK;
1187 case RLM_MODULE_NOOP:
1191 case RLM_MODULE_NOTFOUND:
1201 * Repeat the above process with the default profile or User-Profile
1203 if ((do_fall_through == FALL_THROUGH_YES) ||
1204 (inst->config->read_profiles && (do_fall_through == FALL_THROUGH_DEFAULT))) {
1208 * Check for a default_profile or for a User-Profile.
1210 RDEBUG3("... falling-through to profile processing");
1211 user_profile = pairfind(request->config_items, PW_USER_PROFILE, 0, TAG_ANY);
1213 char const *profile = user_profile ?
1214 user_profile->vp_strvalue :
1215 inst->config->default_profile;
1217 if (!profile || !*profile) {
1221 RDEBUG2("Checking profile %s", profile);
1223 if (sql_set_user(inst, request, profile) < 0) {
1224 REDEBUG("Error setting profile");
1225 rcode = RLM_MODULE_FAIL;
1229 ret = rlm_sql_process_groups(inst, request, &handle, &do_fall_through);
1232 * Nothing bad happened, continue...
1234 case RLM_MODULE_UPDATED:
1235 rcode = RLM_MODULE_UPDATED;
1238 if (rcode != RLM_MODULE_UPDATED) {
1239 rcode = RLM_MODULE_OK;
1242 case RLM_MODULE_NOOP:
1246 case RLM_MODULE_NOTFOUND:
1256 * At this point the key (user) hasn't be found in the check table, the reply table
1257 * or the group mapping table, and there was no matching profile.
1261 rcode = RLM_MODULE_NOTFOUND;
1264 fr_connection_release(inst->pool, handle);
1265 sql_unset_user(inst, request);
1270 pairfree(&check_tmp);
1271 pairfree(&reply_tmp);
1272 sql_unset_user(inst, request);
1274 fr_connection_release(inst->pool, handle);
1280 * Generic function for failing between a bunch of queries.
1282 * Uses the same principle as rlm_linelog, expanding the 'reference' config
1283 * item using xlat to figure out what query it should execute.
1285 * If the reference matches multiple config items, and a query fails or
1286 * doesn't update any rows, the next matching config item is used.
1289 static int acct_redundant(rlm_sql_t *inst, REQUEST *request, sql_acct_section_t *section)
1291 rlm_rcode_t rcode = RLM_MODULE_OK;
1293 rlm_sql_handle_t *handle = NULL;
1295 int numaffected = 0;
1299 char const *attr = NULL;
1302 char path[MAX_STRING_LEN];
1304 char *expanded = NULL;
1306 rad_assert(section);
1308 if (section->reference[0] != '.') {
1312 if (radius_xlat(p, sizeof(path) - (p - path), request, section->reference, NULL, NULL) < 0) {
1313 rcode = RLM_MODULE_FAIL;
1318 item = cf_reference_item(NULL, section->cs, path);
1320 rcode = RLM_MODULE_FAIL;
1325 if (cf_item_is_section(item)){
1326 REDEBUG("Sections are not supported as references");
1327 rcode = RLM_MODULE_FAIL;
1332 pair = cf_itemtopair(item);
1333 attr = cf_pair_attr(pair);
1335 RDEBUG2("Using query template '%s'", attr);
1337 handle = fr_connection_get(inst->pool);
1339 rcode = RLM_MODULE_FAIL;
1344 sql_set_user(inst, request, NULL);
1347 value = cf_pair_value(pair);
1349 RDEBUG("Ignoring null query");
1350 rcode = RLM_MODULE_NOOP;
1355 if (radius_axlat(&expanded, request, value, sql_escape_func, inst) < 0) {
1356 rcode = RLM_MODULE_FAIL;
1362 RDEBUG("Ignoring null query");
1363 rcode = RLM_MODULE_NOOP;
1364 talloc_free(expanded);
1369 rlm_sql_query_log(inst, request, section, expanded);
1372 * If rlm_sql_query cannot use the socket it'll try and
1373 * reconnect. Reconnecting will automatically release
1374 * the current socket, and try to select a new one.
1376 * If we get RLM_SQL_RECONNECT it means all connections in the pool
1377 * were exhausted, and we couldn't create a new connection,
1378 * so we do not need to call fr_connection_release.
1380 sql_ret = rlm_sql_query(&handle, inst, expanded);
1381 TALLOC_FREE(expanded);
1382 if (sql_ret == RLM_SQL_RECONNECT) {
1383 rcode = RLM_MODULE_FAIL;
1389 * Assume all other errors are incidental, and just meant our
1390 * operation failed and its not a client or SQL syntax error.
1392 * @fixme We should actually be able to distinguish between key
1393 * constraint violations (which we expect) and other errors.
1395 if (sql_ret == RLM_SQL_OK) {
1396 numaffected = (inst->module->sql_affected_rows)(handle, inst->config);
1397 if (numaffected > 0) {
1398 break; /* A query succeeded, were done! */
1401 RDEBUG("No records updated");
1404 (inst->module->sql_finish_query)(handle, inst->config);
1407 * We assume all entries with the same name form a redundant
1410 pair = cf_pair_find_next(section->cs, pair, attr);
1413 RDEBUG("No additional queries configured");
1414 rcode = RLM_MODULE_NOOP;
1419 RDEBUG("Trying next query...");
1422 (inst->module->sql_finish_query)(handle, inst->config);
1425 talloc_free(expanded);
1426 fr_connection_release(inst->pool, handle);
1427 sql_unset_user(inst, request);
1432 #ifdef WITH_ACCOUNTING
1435 * Accounting: Insert or update session data in our sql table
1437 static rlm_rcode_t CC_HINT(nonnull) mod_accounting(void *instance, REQUEST * request) {
1438 rlm_sql_t *inst = instance;
1440 if (inst->config->accounting.reference_cp) {
1441 return acct_redundant(inst, request, &inst->config->accounting);
1444 return RLM_MODULE_NOOP;
1449 #ifdef WITH_SESSION_MGMT
1451 * See if a user is already logged in. Sets request->simul_count to the
1452 * current session count for this user.
1454 * Check twice. If on the first pass the user exceeds his
1455 * max. number of logins, do a second pass and validate all
1456 * logins by querying the terminal server (using eg. SNMP).
1459 static rlm_rcode_t CC_HINT(nonnull) mod_checksimul(void *instance, REQUEST * request) {
1460 rlm_rcode_t rcode = RLM_MODULE_OK;
1461 rlm_sql_handle_t *handle = NULL;
1462 rlm_sql_t *inst = instance;
1466 char const *call_num = NULL;
1469 uint32_t nas_addr = 0;
1470 uint32_t nas_port = 0;
1472 char *expanded = NULL;
1474 /* If simul_count_query is not defined, we don't do any checking */
1475 if (!inst->config->simul_count_query || (inst->config->simul_count_query[0] == '\0')) {
1476 return RLM_MODULE_NOOP;
1479 if((!request->username) || (request->username->length == '\0')) {
1480 REDEBUG("Zero Length username not permitted");
1482 return RLM_MODULE_INVALID;
1486 if(sql_set_user(inst, request, NULL) < 0) {
1487 return RLM_MODULE_FAIL;
1490 if (radius_axlat(&expanded, request, inst->config->simul_count_query, sql_escape_func, inst) < 0) {
1491 sql_unset_user(inst, request);
1492 return RLM_MODULE_FAIL;
1495 /* initialize the sql socket */
1496 handle = fr_connection_get(inst->pool);
1498 talloc_free(expanded);
1499 sql_unset_user(inst, request);
1500 return RLM_MODULE_FAIL;
1503 if (rlm_sql_select_query(&handle, inst, expanded) != RLM_SQL_OK) {
1504 rcode = RLM_MODULE_FAIL;
1508 ret = rlm_sql_fetch_row(&handle, inst);
1510 rcode = RLM_MODULE_FAIL;
1516 rcode = RLM_MODULE_FAIL;
1520 request->simul_count = atoi(row[0]);
1522 (inst->module->sql_finish_select_query)(handle, inst->config);
1523 TALLOC_FREE(expanded);
1525 if (request->simul_count < request->simul_max) {
1526 rcode = RLM_MODULE_OK;
1531 * Looks like too many sessions, so let's start verifying
1532 * them, unless told to rely on count query only.
1534 if (!inst->config->simul_verify_query || (inst->config->simul_verify_query[0] == '\0')) {
1535 rcode = RLM_MODULE_OK;
1540 if (radius_axlat(&expanded, request, inst->config->simul_verify_query, sql_escape_func, inst) < 0) {
1541 rcode = RLM_MODULE_FAIL;
1546 if (rlm_sql_select_query(&handle, inst, expanded) != RLM_SQL_OK) goto finish;
1549 * Setup some stuff, like for MPP detection.
1551 request->simul_count = 0;
1553 if ((vp = pairfind(request->packet->vps, PW_FRAMED_IP_ADDRESS, 0, TAG_ANY)) != NULL) {
1554 ipno = vp->vp_ipaddr;
1557 if ((vp = pairfind(request->packet->vps, PW_CALLING_STATION_ID, 0, TAG_ANY)) != NULL) {
1558 call_num = vp->vp_strvalue;
1561 while (rlm_sql_fetch_row(&handle, inst) == 0) {
1568 RDEBUG("Cannot zap stale entry. No username present in entry");
1569 rcode = RLM_MODULE_FAIL;
1575 RDEBUG("Cannot zap stale entry. No session id in entry");
1576 rcode = RLM_MODULE_FAIL;
1582 nas_addr = inet_addr(row[3]);
1586 nas_port = atoi(row[4]);
1589 check = rad_check_ts(nas_addr, nas_port, row[2], row[1]);
1592 * Stale record - zap it.
1594 if (inst->config->deletestalesessions == true) {
1595 uint32_t framed_addr = 0;
1600 framed_addr = inet_addr(row[5]);
1602 if (strcmp(row[7], "PPP") == 0)
1604 else if (strcmp(row[7], "SLIP") == 0)
1608 sess_time = atoi(row[8]);
1609 session_zap(request, nas_addr, nas_port,
1610 row[2], row[1], framed_addr,
1614 else if (check == 1) {
1616 * User is still logged in.
1618 ++request->simul_count;
1621 * Does it look like a MPP attempt?
1623 if (row[5] && ipno && inet_addr(row[5]) == ipno) {
1624 request->simul_mpp = 2;
1625 } else if (row[6] && call_num && !strncmp(row[6],call_num,16)) {
1626 request->simul_mpp = 2;
1630 * Failed to check the terminal server for
1631 * duplicate logins: return an error.
1633 REDEBUG("Failed to check the terminal server for user '%s'.", row[2]);
1635 rcode = RLM_MODULE_FAIL;
1642 (inst->module->sql_finish_select_query)(handle, inst->config);
1643 fr_connection_release(inst->pool, handle);
1644 talloc_free(expanded);
1645 sql_unset_user(inst, request);
1648 * The Auth module apparently looks at request->simul_count,
1649 * not the return value of this module when deciding to deny
1650 * a call for too many sessions.
1657 * Postauth: Write a record of the authentication attempt
1659 static rlm_rcode_t CC_HINT(nonnull) mod_post_auth(void *instance, REQUEST * request) {
1660 rlm_sql_t *inst = instance;
1662 if (inst->config->postauth.reference_cp) {
1663 return acct_redundant(inst, request, &inst->config->postauth);
1666 return RLM_MODULE_NOOP;
1670 * Execute postauth_query after authentication
1674 /* globally exported name */
1675 module_t rlm_sql = {
1678 RLM_TYPE_THREAD_SAFE, /* type: reserved */
1681 mod_instantiate, /* instantiation */
1682 mod_detach, /* detach */
1684 NULL, /* authentication */
1685 mod_authorize, /* authorization */
1686 NULL, /* preaccounting */
1687 #ifdef WITH_ACCOUNTING
1688 mod_accounting, /* accounting */
1692 #ifdef WITH_SESSION_MGMT
1693 mod_checksimul, /* checksimul */
1697 NULL, /* pre-proxy */
1698 NULL, /* post-proxy */
1699 mod_post_auth /* post-auth */