2 * ext_ldap_group_acl: lookup group membership in LDAP
6 * (C)2002,2003 MARA Systems AB
8 * License: squid_ldap_group is free software; you can redistribute it
9 * and/or modify it under the terms of the GNU General Public License
10 * as published by the Free Software Foundation; either version 2,
11 * or (at your option) any later version.
14 * Flavio Pescuma <flavio@marasystems.com>
15 * Henrik Nordstrom <hno@marasystems.com>
16 * MARA Systems AB, Sweden <http://www.marasystems.com>
18 * With contributions from others mentioned in the ChangeLog file
20 * In part based on squid_ldap_auth by Glen Newton and Henrik Nordstrom.
22 * Latest version of this program can always be found from MARA Systems
23 * at http://marasystems.com/download/LDAP_Group/
25 * Dependencies: You need to get the OpenLDAP libraries
26 * from http://www.openldap.org or use another compatible
29 * If you want to make a TLS enabled connection you will also need the
30 * OpenSSL libraries linked into openldap. See http://www.openssl.org/
32 * License: squid_ldap_group is free software; you can redistribute it
33 * and/or modify it under the terms of the GNU General Public License
34 * as published by the Free Software Foundation; either version 2,
35 * or (at your option) any later version.
38 #include "helpers/defines.h"
42 #define LDAP_DEPRECATED 1
47 #if _SQUID_WINDOWS_ && !_SQUID_CYGWIN_
49 #define snprintf _snprintf
53 #define LDAPAPI __cdecl
56 #ifndef LDAP_OPT_X_TLS
57 #define LDAP_OPT_X_TLS 0x6000
59 /* Some tricks to allow dynamic bind with ldap_start_tls_s entry point at
62 #undef ldap_start_tls_s
64 #define LDAP_START_TLS_S "ldap_start_tls_sW"
65 typedef WINLDAPAPI
ULONG(LDAPAPI
* PFldap_start_tls_s
) (IN PLDAP
, OUT PULONG
, OUT LDAPMessage
**, IN PLDAPControlW
*, IN PLDAPControlW
*);
67 #define LDAP_START_TLS_S "ldap_start_tls_sA"
68 typedef WINLDAPAPI
ULONG(LDAPAPI
* PFldap_start_tls_s
) (IN PLDAP
, OUT PULONG
, OUT LDAPMessage
**, IN PLDAPControlA
*, IN PLDAPControlA
*);
69 #endif /* LDAP_UNICODE */
70 PFldap_start_tls_s Win32_ldap_start_tls_s
;
71 #define ldap_start_tls_s(l,s,c) Win32_ldap_start_tls_s(l,NULL,NULL,s,c)
72 #endif /* LDAP_VERSION3 */
85 #define PROGRAM_NAME "ext_ldap_group_acl"
86 #define PROGRAM_VERSION "2.17"
90 static const char *basedn
= NULL
;
91 static const char *searchfilter
= NULL
;
92 static const char *userbasedn
= NULL
;
93 static const char *userdnattr
= NULL
;
94 static const char *usersearchfilter
= NULL
;
95 static const char *binddn
= NULL
;
96 static const char *bindpasswd
= NULL
;
97 static int searchscope
= LDAP_SCOPE_SUBTREE
;
98 static int persistent
= 0;
99 static int noreferrals
= 0;
100 static int aliasderef
= LDAP_DEREF_NEVER
;
101 #if defined(NETSCAPE_SSL)
102 static char *sslpath
= NULL
;
103 static int sslinit
= 0;
105 static int connect_timeout
= 0;
106 static int timelimit
= LDAP_NO_LIMIT
;
109 /* Added for TLS support and version 3 */
110 static int use_tls
= 0;
111 static int version
= -1;
114 static int searchLDAP(LDAP
* ld
, char *group
, char *user
, char *extension_dn
);
116 static int readSecret(const char *filename
);
118 /* Yuck.. we need to glue to different versions of the API */
120 #ifndef LDAP_NO_ATTRS
121 #define LDAP_NO_ATTRS "1.1"
124 #if defined(LDAP_API_VERSION) && LDAP_API_VERSION > 1823
126 squid_ldap_errno(LDAP
* ld
)
129 ldap_get_option(ld
, LDAP_OPT_ERROR_NUMBER
, &err
);
133 squid_ldap_set_aliasderef(LDAP
* ld
, int deref
)
135 ldap_set_option(ld
, LDAP_OPT_DEREF
, &deref
);
138 squid_ldap_set_referrals(LDAP
* ld
, int referrals
)
140 int *value
= static_cast<int*>(referrals
? LDAP_OPT_ON
:LDAP_OPT_OFF
);
141 ldap_set_option(ld
, LDAP_OPT_REFERRALS
, value
);
144 squid_ldap_set_timelimit(LDAP
* ld
, int aTimeLimit
)
146 ldap_set_option(ld
, LDAP_OPT_TIMELIMIT
, &aTimeLimit
);
149 squid_ldap_set_connect_timeout(LDAP
* ld
, int aTimeLimit
)
151 #if defined(LDAP_OPT_NETWORK_TIMEOUT)
153 tv
.tv_sec
= aTimeLimit
;
155 ldap_set_option(ld
, LDAP_OPT_NETWORK_TIMEOUT
, &tv
);
156 #elif defined(LDAP_X_OPT_CONNECT_TIMEOUT)
158 ldap_set_option(ld
, LDAP_X_OPT_CONNECT_TIMEOUT
, &aTimeLimit
);
162 squid_ldap_memfree(char *p
)
169 squid_ldap_errno(LDAP
* ld
)
174 squid_ldap_set_aliasderef(LDAP
* ld
, int deref
)
176 ld
->ld_deref
= deref
;
179 squid_ldap_set_referrals(LDAP
* ld
, int referrals
)
182 ld
->ld_options
|= ~LDAP_OPT_REFERRALS
;
184 ld
->ld_options
&= ~LDAP_OPT_REFERRALS
;
187 squid_ldap_set_timelimit(LDAP
* ld
, int timelimit
)
189 ld
->ld_timelimit
= timelimit
;
192 squid_ldap_set_connect_timeout(LDAP
* ld
, int timelimit
)
194 fprintf(stderr
, "WARNING: Connect timeouts not supported in your LDAP library\n");
197 squid_ldap_memfree(char *p
)
204 #ifdef LDAP_API_FEATURE_X_OPENLDAP
205 #if LDAP_VENDOR_VERSION > 194
206 #define HAS_URI_SUPPORT 1
211 main(int argc
, char **argv
)
213 char buf
[HELPER_INPUT_BUFFER
];
214 char *user
, *group
, *extension_dn
= NULL
;
215 char *ldapServer
= NULL
;
217 int tryagain
= 0, rc
;
218 int port
= LDAP_PORT
;
219 int use_extension_dn
= 0;
220 int strip_nt_domain
= 0;
221 int strip_kerberos_realm
= 0;
223 setbuf(stdout
, NULL
);
225 while (argc
> 1 && argv
[1][0] == '-') {
226 const char *value
= "";
227 char option
= argv
[1][1];
239 if (strlen(argv
[1]) > 2) {
241 } else if (argc
> 2) {
254 fprintf(stderr
, "FATAL: Your LDAP library does not have URI support\n");
257 /* Fall thru to -h */
260 int len
= strlen(ldapServer
) + 1 + strlen(value
) + 1;
261 char *newhost
= (char*)malloc(len
);
262 snprintf(newhost
, len
, "%s %s", ldapServer
, value
);
264 ldapServer
= newhost
;
266 ldapServer
= xstrdup(value
);
273 searchfilter
= value
;
279 usersearchfilter
= value
;
285 if (strcmp(value
, "base") == 0)
286 searchscope
= LDAP_SCOPE_BASE
;
287 else if (strcmp(value
, "one") == 0)
288 searchscope
= LDAP_SCOPE_ONELEVEL
;
289 else if (strcmp(value
, "sub") == 0)
290 searchscope
= LDAP_SCOPE_SUBTREE
;
292 fprintf(stderr
, PROGRAM_NAME
": FATAL: Unknown search scope '%s'\n", value
);
297 #if defined(NETSCAPE_SSL)
299 if (port
== LDAP_PORT
)
302 fprintf(stderr
, PROGRAM_NAME
": FATAL: -E unsupported with this LDAP library\n");
307 connect_timeout
= atoi(value
);
310 timelimit
= atoi(value
);
313 if (strcmp(value
, "never") == 0)
314 aliasderef
= LDAP_DEREF_NEVER
;
315 else if (strcmp(value
, "always") == 0)
316 aliasderef
= LDAP_DEREF_ALWAYS
;
317 else if (strcmp(value
, "search") == 0)
318 aliasderef
= LDAP_DEREF_SEARCHING
;
319 else if (strcmp(value
, "find") == 0)
320 aliasderef
= LDAP_DEREF_FINDING
;
322 fprintf(stderr
, PROGRAM_NAME
": FATAL: Unknown alias dereference method '%s'\n", value
);
336 persistent
= !persistent
;
342 noreferrals
= !noreferrals
;
346 switch (atoi(value
)) {
348 version
= LDAP_VERSION2
;
351 version
= LDAP_VERSION3
;
354 fprintf(stderr
, "FATAL: Protocol version should be 2 or 3\n");
359 if (version
== LDAP_VERSION2
) {
360 fprintf(stderr
, "FATAL: TLS (-Z) is incompatible with version %d\n",
364 version
= LDAP_VERSION3
;
372 use_extension_dn
= 1;
378 strip_kerberos_realm
= 1;
381 fprintf(stderr
, PROGRAM_NAME
": FATAL: Unknown command line option '%c'\n", option
);
387 char *value
= argv
[1];
389 int len
= strlen(ldapServer
) + 1 + strlen(value
) + 1;
390 char *newhost
= (char*)malloc(len
);
391 snprintf(newhost
, len
, "%s %s", ldapServer
, value
);
393 ldapServer
= newhost
;
395 ldapServer
= xstrdup(value
);
402 ldapServer
= (char *) "localhost";
404 if (!basedn
|| !searchfilter
) {
405 fprintf(stderr
, "\n" PROGRAM_NAME
" version " PROGRAM_VERSION
"\n\n");
406 fprintf(stderr
, "Usage: " PROGRAM_NAME
" -b basedn -f filter [options] ldap_server_name\n\n");
407 fprintf(stderr
, "\t-b basedn (REQUIRED)\tbase dn under where to search for groups\n");
408 fprintf(stderr
, "\t-f filter (REQUIRED)\tgroup search filter pattern. %%u = user,\n\t\t\t\t%%v = group\n");
409 fprintf(stderr
, "\t-B basedn (REQUIRED)\tbase dn under where to search for users\n");
410 fprintf(stderr
, "\t-F filter (REQUIRED)\tuser search filter pattern. %%s = login\n");
411 fprintf(stderr
, "\t-s base|one|sub\t\tsearch scope\n");
412 fprintf(stderr
, "\t-D binddn\t\tDN to bind as to perform searches\n");
413 fprintf(stderr
, "\t-w bindpasswd\t\tpassword for binddn\n");
414 fprintf(stderr
, "\t-W secretfile\t\tread password for binddn from file secretfile\n");
416 fprintf(stderr
, "\t-H URI\t\t\tLDAPURI (defaults to ldap://localhost)\n");
418 fprintf(stderr
, "\t-h server\t\tLDAP server (defaults to localhost)\n");
419 fprintf(stderr
, "\t-p port\t\t\tLDAP server port (defaults to %d)\n", LDAP_PORT
);
420 fprintf(stderr
, "\t-P\t\t\tpersistent LDAP connection\n");
421 #if defined(NETSCAPE_SSL)
422 fprintf(stderr
, "\t-E sslcertpath\t\tenable LDAP over SSL\n");
424 fprintf(stderr
, "\t-c timeout\t\tconnect timeout\n");
425 fprintf(stderr
, "\t-t timelimit\t\tsearch time limit\n");
426 fprintf(stderr
, "\t-R\t\t\tdo not follow referrals\n");
427 fprintf(stderr
, "\t-a never|always|search|find\n\t\t\t\twhen to dereference aliases\n");
429 fprintf(stderr
, "\t-v 2|3\t\t\tLDAP version\n");
430 fprintf(stderr
, "\t-Z\t\t\tTLS encrypt the LDAP connection, requires\n\t\t\t\tLDAP version 3\n");
432 fprintf(stderr
, "\t-g\t\t\tfirst query parameter is base DN extension\n\t\t\t\tfor this query\n");
433 fprintf(stderr
, "\t-S\t\t\tStrip NT domain from usernames\n");
434 fprintf(stderr
, "\t-K\t\t\tStrip Kerberos realm from usernames\n");
435 fprintf(stderr
, "\t-d\t\t\tenable debug mode\n");
436 fprintf(stderr
, "\n");
437 fprintf(stderr
, "\tIf you need to bind as a user to perform searches then use the\n\t-D binddn -w bindpasswd or -D binddn -W secretfile options\n\n");
440 /* On Windows ldap_start_tls_s is available starting from Windows XP,
441 * so we need to bind at run-time with the function entry point
446 HMODULE WLDAP32Handle
;
448 WLDAP32Handle
= GetModuleHandle("wldap32");
449 if ((Win32_ldap_start_tls_s
= (PFldap_start_tls_s
) GetProcAddress(WLDAP32Handle
, LDAP_START_TLS_S
)) == NULL
) {
450 fprintf(stderr
, PROGRAM_NAME
": FATAL: TLS (-Z) not supported on this platform.\n");
456 while (fgets(buf
, HELPER_INPUT_BUFFER
, stdin
) != NULL
) {
458 if (!strchr(buf
, '\n')) {
459 /* too large message received.. skip and deny */
460 fprintf(stderr
, "%s: ERROR: Input Too large: %s\n", argv
[0], buf
);
461 while (fgets(buf
, sizeof(buf
), stdin
)) {
462 fprintf(stderr
, "%s: ERROR: Input Too large..: %s\n", argv
[0], buf
);
463 if (strchr(buf
, '\n') != NULL
)
469 user
= strtok(buf
, " \n");
471 debug("%s: Invalid request: No Username given\n", argv
[0]);
472 SEND_ERR("Invalid request. No Username");
475 rfc1738_unescape(user
);
476 if (strip_nt_domain
) {
477 char *u
= strrchr(user
, '\\');
479 u
= strrchr(user
, '/');
481 u
= strrchr(user
, '+');
485 if (strip_kerberos_realm
) {
486 char *u
= strchr(user
, '@');
491 if (use_extension_dn
) {
492 extension_dn
= strtok(NULL
, " \n");
494 debug("%s: Invalid request: Extension DN configured, but none sent.\n", argv
[0]);
495 SEND_ERR("Invalid Request. Extension DN required.");
498 rfc1738_unescape(extension_dn
);
500 while (!found
&& user
&& (group
= strtok(NULL
, " \n")) != NULL
) {
501 rfc1738_unescape(group
);
506 if (strstr(ldapServer
, "://") != NULL
) {
507 rc
= ldap_initialize(&ld
, ldapServer
);
508 if (rc
!= LDAP_SUCCESS
) {
509 fprintf(stderr
, "%s: ERROR: Unable to connect to LDAPURI:%s\n", argv
[0], ldapServer
);
516 if (!sslinit
&& (ldapssl_client_init(sslpath
, NULL
) != LDAP_SUCCESS
)) {
517 fprintf(stderr
, "FATAL: Unable to initialise SSL with cert path %s\n", sslpath
);
522 if ((ld
= ldapssl_init(ldapServer
, port
, 1)) == NULL
) {
523 fprintf(stderr
, "FATAL: Unable to connect to SSL LDAP server: %s port:%d\n",
529 if ((ld
= ldap_init(ldapServer
, port
)) == NULL
) {
530 fprintf(stderr
, "ERROR: Unable to connect to LDAP server:%s port:%d\n", ldapServer
, port
);
534 squid_ldap_set_connect_timeout(ld
, connect_timeout
);
538 version
= LDAP_VERSION3
;
540 if (ldap_set_option(ld
, LDAP_OPT_PROTOCOL_VERSION
, &version
) != LDAP_SUCCESS
) {
541 fprintf(stderr
, "ERROR: Could not set LDAP_OPT_PROTOCOL_VERSION %d\n",
548 #ifdef LDAP_OPT_X_TLS
549 if (version
!= LDAP_VERSION3
) {
550 fprintf(stderr
, "FATAL: TLS requires LDAP version 3\n");
552 } else if (ldap_start_tls_s(ld
, NULL
, NULL
) != LDAP_SUCCESS
) {
553 fprintf(stderr
, "ERROR: Could not Activate TLS connection\n");
559 fprintf(stderr
, "FATAL: TLS not supported with your LDAP library\n");
564 squid_ldap_set_timelimit(ld
, timelimit
);
565 squid_ldap_set_referrals(ld
, !noreferrals
);
566 squid_ldap_set_aliasderef(ld
, aliasderef
);
567 if (binddn
&& bindpasswd
&& *binddn
&& *bindpasswd
) {
568 rc
= ldap_simple_bind_s(ld
, binddn
, bindpasswd
);
569 if (rc
!= LDAP_SUCCESS
) {
570 fprintf(stderr
, PROGRAM_NAME
": WARNING: could not bind to binddn '%s'\n", ldap_err2string(rc
));
576 debug("Connected OK\n");
578 if (searchLDAP(ld
, group
, user
, extension_dn
) == 0) {
597 if (!persistent
|| (squid_ldap_errno(ld
) != LDAP_SUCCESS
&& squid_ldap_errno(ld
) != LDAP_INVALID_CREDENTIALS
)) {
611 ldap_escape_value(char *escaped
, int size
, const char *src
)
614 while (size
> 4 && *src
) {
625 snprintf(escaped
, 3, "%02x", (unsigned char) *src
);
643 build_filter(char *filter
, int size
, const char *templ
, const char *user
, const char *group
)
646 while (*templ
&& size
> 0) {
654 n
= ldap_escape_value(filter
, size
, user
);
661 n
= ldap_escape_value(filter
, size
, group
);
666 fprintf(stderr
, "ERROR: Unknown filter template string %%%c\n", *templ
);
689 fprintf(stderr
, "ERROR: Filter too large\n");
697 searchLDAPGroup(LDAP
* ld
, char *group
, char *member
, char *extension_dn
)
700 static char searchbase
[256];
701 LDAPMessage
*res
= NULL
;
704 char *searchattr
[] = {(char *) LDAP_NO_ATTRS
, NULL
};
706 if (extension_dn
&& *extension_dn
)
707 snprintf(searchbase
, sizeof(searchbase
), "%s,%s", extension_dn
, basedn
);
709 snprintf(searchbase
, sizeof(searchbase
), "%s", basedn
);
711 if (build_filter(filter
, sizeof(filter
), searchfilter
, member
, group
) != 0) {
712 fprintf(stderr
, PROGRAM_NAME
": ERROR: Failed to construct LDAP search filter. filter=\"%s\", user=\"%s\", group=\"%s\"\n", filter
, member
, group
);
715 debug("group filter '%s', searchbase '%s'\n", filter
, searchbase
);
717 rc
= ldap_search_s(ld
, searchbase
, searchscope
, filter
, searchattr
, 1, &res
);
718 if (rc
!= LDAP_SUCCESS
) {
719 if (noreferrals
&& rc
== LDAP_PARTIAL_RESULTS
) {
720 /* Everything is fine. This is expected when referrals
724 fprintf(stderr
, PROGRAM_NAME
": WARNING: LDAP search error '%s'\n", ldap_err2string(rc
));
725 #if defined(NETSCAPE_SSL)
726 if (sslpath
&& ((rc
== LDAP_SERVER_DOWN
) || (rc
== LDAP_CONNECT_ERROR
))) {
727 int sslerr
= PORT_GetError();
728 fprintf(stderr
, PROGRAM_NAME
": WARNING: SSL error %d (%s)\n", sslerr
, ldapssl_err2string(sslerr
));
735 entry
= ldap_first_entry(ld
, res
);
745 searchLDAP(LDAP
* ld
, char *group
, char *login
, char *extension_dn
)
748 if (usersearchfilter
) {
750 char searchbase
[8192];
751 char escaped_login
[1024];
752 LDAPMessage
*res
= NULL
;
756 char *searchattr
[] = {(char *) LDAP_NO_ATTRS
, NULL
};
757 if (extension_dn
&& *extension_dn
)
758 snprintf(searchbase
, sizeof(searchbase
), "%s,%s", extension_dn
, userbasedn
? userbasedn
: basedn
);
760 snprintf(searchbase
, sizeof(searchbase
), "%s", userbasedn
? userbasedn
: basedn
);
761 ldap_escape_value(escaped_login
, sizeof(escaped_login
), login
);
762 snprintf(filter
, sizeof(filter
), usersearchfilter
, escaped_login
, escaped_login
, escaped_login
, escaped_login
, escaped_login
, escaped_login
, escaped_login
, escaped_login
, escaped_login
, escaped_login
, escaped_login
, escaped_login
, escaped_login
, escaped_login
, escaped_login
, escaped_login
);
763 debug("user filter '%s', searchbase '%s'\n", filter
, searchbase
);
764 rc
= ldap_search_s(ld
, searchbase
, searchscope
, filter
, searchattr
, 1, &res
);
765 if (rc
!= LDAP_SUCCESS
) {
766 if (noreferrals
&& rc
== LDAP_PARTIAL_RESULTS
) {
767 /* Everything is fine. This is expected when referrals
771 fprintf(stderr
, PROGRAM_NAME
": WARNING: LDAP search error '%s'\n", ldap_err2string(rc
));
772 #if defined(NETSCAPE_SSL)
773 if (sslpath
&& ((rc
== LDAP_SERVER_DOWN
) || (rc
== LDAP_CONNECT_ERROR
))) {
774 int sslerr
= PORT_GetError();
775 fprintf(stderr
, PROGRAM_NAME
": WARNING: SSL error %d (%s)\n", sslerr
, ldapssl_err2string(sslerr
));
782 entry
= ldap_first_entry(ld
, res
);
784 fprintf(stderr
, PROGRAM_NAME
": WARNING: User '%s' not found in '%s'\n", login
, searchbase
);
788 userdn
= ldap_get_dn(ld
, entry
);
789 rc
= searchLDAPGroup(ld
, group
, userdn
, extension_dn
);
790 squid_ldap_memfree(userdn
);
793 } else if (userdnattr
) {
795 if (extension_dn
&& *extension_dn
)
796 snprintf(dn
, 8192, "%s=%s, %s, %s", userdnattr
, login
, extension_dn
, userbasedn
? userbasedn
: basedn
);
798 snprintf(dn
, 8192, "%s=%s, %s", userdnattr
, login
, userbasedn
? userbasedn
: basedn
);
799 return searchLDAPGroup(ld
, group
, dn
, extension_dn
);
801 return searchLDAPGroup(ld
, group
, login
, extension_dn
);
806 readSecret(const char *filename
)
812 if (!(f
= fopen(filename
, "r"))) {
813 fprintf(stderr
, PROGRAM_NAME
": ERROR: Can not read secret file %s\n", filename
);
816 if (!fgets(buf
, sizeof(buf
) - 1, f
)) {
817 fprintf(stderr
, PROGRAM_NAME
": ERROR: Secret file %s is empty\n", filename
);
821 /* strip whitespaces on end */
822 if ((e
= strrchr(buf
, '\n')))
824 if ((e
= strrchr(buf
, '\r')))
827 bindpasswd
= xstrdup(buf
);
829 fprintf(stderr
, PROGRAM_NAME
": ERROR: can not allocate memory\n");