1 /* bind.c - decode an ldap bind operation and pass it to a backend db */
3 /* This work is part of OpenLDAP Software <http://www.openldap.org/>.
5 * Copyright 1998-2005 The OpenLDAP Foundation.
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted only as authorized by the OpenLDAP
12 * A copy of this license is available in the file LICENSE in the
13 * top-level directory of the distribution or, alternatively, at
14 * <http://www.OpenLDAP.org/license.html>.
16 /* Portions Copyright (c) 1995 Regents of the University of Michigan.
17 * All rights reserved.
19 * Redistribution and use in source and binary forms are permitted
20 * provided that this notice is preserved and that due credit is given
21 * to the University of Michigan at Ann Arbor. The name of the University
22 * may not be used to endorse or promote products derived from this
23 * software without specific prior written permission. This software
24 * is provided ``as is'' without express or implied warranty.
31 #include <ac/string.h>
32 #include <ac/socket.h>
41 BerElement *ber = op->o_ber;
44 struct berval mech = BER_BVNULL;
45 struct berval dn = BER_BVNULL;
49 Debug( LDAP_DEBUG_TRACE, "do_bind\n", 0, 0, 0 );
52 * Force to connection to "anonymous" until bind succeeds.
54 ldap_pvt_thread_mutex_lock( &op->o_conn->c_mutex );
55 if ( op->o_conn->c_sasl_bind_in_progress ) {
56 be = op->o_conn->c_authz_backend;
58 if ( !BER_BVISEMPTY( &op->o_conn->c_dn ) ) {
59 /* log authorization identity demotion */
60 Statslog( LDAP_DEBUG_STATS,
61 "%s BIND anonymous mech=implicit ssf=0\n",
62 op->o_log_prefix, 0, 0, 0, 0 );
64 connection2anonymous( op->o_conn );
65 if ( op->o_conn->c_sasl_bind_in_progress ) {
66 op->o_conn->c_authz_backend = be;
68 ldap_pvt_thread_mutex_unlock( &op->o_conn->c_mutex );
69 if ( !BER_BVISNULL( &op->o_dn ) ) {
70 /* NOTE: temporarily wasting few bytes
71 * (until bind is completed), but saving
72 * a couple of ch_free() and ch_strdup("") */
73 op->o_dn.bv_val[0] = '\0';
76 if ( !BER_BVISNULL( &op->o_ndn ) ) {
77 op->o_ndn.bv_val[0] = '\0';
82 * Parse the bind request. It looks like this:
84 * BindRequest ::= SEQUENCE {
85 * version INTEGER, -- version
86 * name DistinguishedName, -- dn
87 * authentication CHOICE {
88 * simple [0] OCTET STRING -- passwd
89 * krbv42ldap [1] OCTET STRING
90 * krbv42dsa [2] OCTET STRING
91 * SASL [3] SaslCredentials
95 * SaslCredentials ::= SEQUENCE {
96 * mechanism LDAPString,
97 * credentials OCTET STRING OPTIONAL
101 tag = ber_scanf( ber, "{imt" /*}*/, &version, &dn, &method );
103 if ( tag == LBER_ERROR ) {
104 Debug( LDAP_DEBUG_ANY, "bind: ber_scanf failed\n", 0, 0, 0 );
105 send_ldap_discon( op, rs, LDAP_PROTOCOL_ERROR, "decoding error" );
106 rs->sr_err = SLAPD_DISCONNECT;
110 op->o_protocol = version;
111 op->orb_method = method;
113 if( op->orb_method != LDAP_AUTH_SASL ) {
114 tag = ber_scanf( ber, /*{*/ "m}", &op->orb_cred );
117 tag = ber_scanf( ber, "{m" /*}*/, &mech );
119 if ( tag != LBER_ERROR ) {
121 tag = ber_peek_tag( ber, &len );
123 if ( tag == LDAP_TAG_LDAPCRED ) {
124 tag = ber_scanf( ber, "m", &op->orb_cred );
126 tag = LDAP_TAG_LDAPCRED;
127 BER_BVZERO( &op->orb_cred );
130 if ( tag != LBER_ERROR ) {
131 tag = ber_scanf( ber, /*{{*/ "}}" );
136 if ( tag == LBER_ERROR ) {
137 send_ldap_discon( op, rs, LDAP_PROTOCOL_ERROR, "decoding error" );
138 rs->sr_err = SLAPD_DISCONNECT;
142 if( get_ctrls( op, rs, 1 ) != LDAP_SUCCESS ) {
143 Debug( LDAP_DEBUG_ANY, "do_bind: get_ctrls failed\n", 0, 0, 0 );
147 /* We use the tmpmemctx here because it speeds up normalization.
148 * However, we must dup with regular malloc when storing any
149 * resulting DNs in the op or conn structures.
151 rs->sr_err = dnPrettyNormal( NULL, &dn, &op->o_req_dn, &op->o_req_ndn,
153 if ( rs->sr_err != LDAP_SUCCESS ) {
154 Debug( LDAP_DEBUG_ANY, "bind: invalid dn (%s)\n",
156 send_ldap_error( op, rs, LDAP_INVALID_DN_SYNTAX, "invalid DN" );
160 if( op->orb_method == LDAP_AUTH_SASL ) {
161 Debug( LDAP_DEBUG_TRACE, "do_sasl_bind: dn (%s) mech %s\n",
162 op->o_req_dn.bv_val, mech.bv_val, NULL );
165 Debug( LDAP_DEBUG_TRACE,
166 "do_bind: version=%ld dn=\"%s\" method=%ld\n",
167 (unsigned long) version, op->o_req_dn.bv_val,
168 (unsigned long) op->orb_method );
171 Statslog( LDAP_DEBUG_STATS, "%s BIND dn=\"%s\" method=%ld\n",
172 op->o_log_prefix, op->o_req_dn.bv_val,
173 (unsigned long) op->orb_method, 0, 0 );
175 if ( version < LDAP_VERSION_MIN || version > LDAP_VERSION_MAX ) {
176 Debug( LDAP_DEBUG_ANY, "do_bind: unknown version=%ld\n",
177 (unsigned long) version, 0, 0 );
178 send_ldap_error( op, rs, LDAP_PROTOCOL_ERROR,
179 "requested protocol version not supported" );
182 } else if (!( global_allows & SLAP_ALLOW_BIND_V2 ) &&
183 version < LDAP_VERSION3 )
185 send_ldap_error( op, rs, LDAP_PROTOCOL_ERROR,
186 "historical protocol version requested, use LDAPv3 instead" );
191 * we set connection version regardless of whether bind succeeds or not.
193 ldap_pvt_thread_mutex_lock( &op->o_conn->c_mutex );
194 op->o_conn->c_protocol = version;
195 ldap_pvt_thread_mutex_unlock( &op->o_conn->c_mutex );
197 op->orb_tmp_mech = mech;
199 op->o_bd = frontendDB;
200 rs->sr_err = frontendDB->be_bind( op, rs );
203 if ( rs->sr_err == LDAP_SUCCESS ) {
204 if ( op->orb_method != LDAP_AUTH_SASL ) {
205 ber_dupbv( &op->o_conn->c_authmech, &mech );
207 op->o_conn->c_authtype = op->orb_method;
210 op->o_conn->c_sasl_bindop = NULL;
212 if( !BER_BVISNULL( &op->o_req_dn ) ) {
213 slap_sl_free( op->o_req_dn.bv_val, op->o_tmpmemctx );
214 BER_BVZERO( &op->o_req_dn );
216 if( !BER_BVISNULL( &op->o_req_ndn ) ) {
217 slap_sl_free( op->o_req_ndn.bv_val, op->o_tmpmemctx );
218 BER_BVZERO( &op->o_req_ndn );
225 fe_op_bind( Operation *op, SlapReply *rs )
227 struct berval mech = op->orb_tmp_mech;
229 /* check for inappropriate controls */
230 if( get_manageDSAit( op ) == SLAP_CONTROL_CRITICAL ) {
231 send_ldap_error( op, rs,
232 LDAP_UNAVAILABLE_CRITICAL_EXTENSION,
233 "manageDSAit control inappropriate" );
237 /* Set the bindop for the benefit of in-directory SASL lookups */
238 op->o_conn->c_sasl_bindop = op;
240 if ( op->orb_method == LDAP_AUTH_SASL ) {
241 if ( op->o_protocol < LDAP_VERSION3 ) {
242 Debug( LDAP_DEBUG_ANY, "do_bind: sasl with LDAPv%ld\n",
243 (unsigned long)op->o_protocol, 0, 0 );
244 send_ldap_discon( op, rs,
245 LDAP_PROTOCOL_ERROR, "SASL bind requires LDAPv3" );
246 rs->sr_err = SLAPD_DISCONNECT;
250 if( BER_BVISNULL( &mech ) || BER_BVISEMPTY( &mech ) ) {
251 Debug( LDAP_DEBUG_ANY,
252 "do_bind: no sasl mechanism provided\n",
254 send_ldap_error( op, rs, LDAP_AUTH_METHOD_NOT_SUPPORTED,
255 "no SASL mechanism provided" );
259 /* check restrictions */
260 if( backend_check_restrictions( op, rs, &mech ) != LDAP_SUCCESS ) {
261 send_ldap_result( op, rs );
265 ldap_pvt_thread_mutex_lock( &op->o_conn->c_mutex );
266 if ( op->o_conn->c_sasl_bind_in_progress ) {
267 if( !bvmatch( &op->o_conn->c_sasl_bind_mech, &mech ) ) {
268 /* mechanism changed between bind steps */
269 slap_sasl_reset(op->o_conn);
272 ber_dupbv(&op->o_conn->c_sasl_bind_mech, &mech);
274 ldap_pvt_thread_mutex_unlock( &op->o_conn->c_mutex );
276 rs->sr_err = slap_sasl_bind( op, rs );
278 ldap_pvt_thread_mutex_lock( &op->o_conn->c_mutex );
279 if( rs->sr_err == LDAP_SUCCESS ) {
280 ber_dupbv(&op->o_conn->c_dn, &op->orb_edn);
281 if( !BER_BVISEMPTY( &op->orb_edn ) ) {
282 /* edn is always normalized already */
283 ber_dupbv( &op->o_conn->c_ndn, &op->o_conn->c_dn );
285 op->o_tmpfree( op->orb_edn.bv_val, op->o_tmpmemctx );
286 BER_BVZERO( &op->orb_edn );
287 op->o_conn->c_authmech = op->o_conn->c_sasl_bind_mech;
288 BER_BVZERO( &op->o_conn->c_sasl_bind_mech );
289 op->o_conn->c_sasl_bind_in_progress = 0;
291 op->o_conn->c_sasl_ssf = op->orb_ssf;
292 if( op->orb_ssf > op->o_conn->c_ssf ) {
293 op->o_conn->c_ssf = op->orb_ssf;
296 if( !BER_BVISEMPTY( &op->o_conn->c_dn ) ) {
297 ber_len_t max = sockbuf_max_incoming_auth;
298 ber_sockbuf_ctrl( op->o_conn->c_sb,
299 LBER_SB_OPT_SET_MAX_INCOMING, &max );
302 /* log authorization identity */
303 Statslog( LDAP_DEBUG_STATS,
304 "%s BIND dn=\"%s\" mech=%s ssf=%d\n",
306 BER_BVISNULL( &op->o_conn->c_dn ) ? "<empty>" : op->o_conn->c_dn.bv_val,
307 op->o_conn->c_authmech.bv_val, op->orb_ssf, 0 );
309 Debug( LDAP_DEBUG_TRACE,
310 "do_bind: SASL/%s bind: dn=\"%s\" ssf=%d\n",
311 op->o_conn->c_authmech.bv_val,
312 BER_BVISNULL( &op->o_conn->c_dn ) ? "<empty>" : op->o_conn->c_dn.bv_val,
315 } else if ( rs->sr_err == LDAP_SASL_BIND_IN_PROGRESS ) {
316 op->o_conn->c_sasl_bind_in_progress = 1;
319 if ( !BER_BVISNULL( &op->o_conn->c_sasl_bind_mech ) ) {
320 free( op->o_conn->c_sasl_bind_mech.bv_val );
321 BER_BVZERO( &op->o_conn->c_sasl_bind_mech );
323 op->o_conn->c_sasl_bind_in_progress = 0;
326 ldap_pvt_thread_mutex_unlock( &op->o_conn->c_mutex );
331 /* Not SASL, cancel any in-progress bind */
332 ldap_pvt_thread_mutex_lock( &op->o_conn->c_mutex );
334 if ( !BER_BVISNULL( &op->o_conn->c_sasl_bind_mech ) ) {
335 free( op->o_conn->c_sasl_bind_mech.bv_val );
336 BER_BVZERO( &op->o_conn->c_sasl_bind_mech );
338 op->o_conn->c_sasl_bind_in_progress = 0;
340 slap_sasl_reset( op->o_conn );
341 ldap_pvt_thread_mutex_unlock( &op->o_conn->c_mutex );
344 if ( op->orb_method == LDAP_AUTH_SIMPLE ) {
345 BER_BVSTR( &mech, "SIMPLE" );
346 /* accept "anonymous" binds */
347 if ( BER_BVISEMPTY( &op->orb_cred ) || BER_BVISEMPTY( &op->o_req_ndn ) ) {
348 rs->sr_err = LDAP_SUCCESS;
350 if( !BER_BVISEMPTY( &op->orb_cred ) &&
351 !( global_allows & SLAP_ALLOW_BIND_ANON_CRED ))
353 /* cred is not empty, disallow */
354 rs->sr_err = LDAP_INVALID_CREDENTIALS;
356 } else if ( !BER_BVISEMPTY( &op->o_req_ndn ) &&
357 !( global_allows & SLAP_ALLOW_BIND_ANON_DN ))
359 /* DN is not empty, disallow */
360 rs->sr_err = LDAP_UNWILLING_TO_PERFORM;
362 "unauthenticated bind (DN with no password) disallowed";
364 } else if ( global_disallows & SLAP_DISALLOW_BIND_ANON ) {
366 rs->sr_err = LDAP_INAPPROPRIATE_AUTH;
367 rs->sr_text = "anonymous bind disallowed";
370 backend_check_restrictions( op, rs, &mech );
374 * we already forced connection to "anonymous",
375 * just need to send success
377 send_ldap_result( op, rs );
378 Debug( LDAP_DEBUG_TRACE, "do_bind: v%d anonymous bind\n",
379 op->o_protocol, 0, 0 );
382 } else if ( global_disallows & SLAP_DISALLOW_BIND_SIMPLE ) {
383 /* disallow simple authentication */
384 rs->sr_err = LDAP_UNWILLING_TO_PERFORM;
385 rs->sr_text = "unwilling to perform simple authentication";
387 send_ldap_result( op, rs );
388 Debug( LDAP_DEBUG_TRACE,
389 "do_bind: v%d simple bind(%s) disallowed\n",
390 op->o_protocol, op->o_req_ndn.bv_val, 0 );
394 #ifdef LDAP_API_FEATURE_X_OPENLDAP_V2_KBIND
395 } else if ( op->orb_method == LDAP_AUTH_KRBV41 ) {
396 if ( global_disallows & SLAP_DISALLOW_BIND_KRBV4 ) {
397 /* disallow krbv4 authentication */
398 rs->sr_err = LDAP_UNWILLING_TO_PERFORM;
399 rs->sr_text = "unwilling to perform Kerberos V4 bind";
401 send_ldap_result( op, rs );
403 Debug( LDAP_DEBUG_TRACE,
404 "do_bind: v%d Kerberos V4 (step 1) bind refused\n",
405 op->o_protocol, 0, 0 );
408 BER_BVSTR( &mech, "KRBV4" );
410 } else if ( op->orb_method == LDAP_AUTH_KRBV42 ) {
411 rs->sr_err = LDAP_AUTH_METHOD_NOT_SUPPORTED;
412 rs->sr_text = "Kerberos V4 (step 2) bind not supported";
413 send_ldap_result( op, rs );
415 Debug( LDAP_DEBUG_TRACE,
416 "do_bind: v%d Kerberos V4 (step 2) bind refused\n",
417 op->o_protocol, 0, 0 );
422 rs->sr_err = LDAP_AUTH_METHOD_NOT_SUPPORTED;
423 rs->sr_text = "unknown authentication method";
425 send_ldap_result( op, rs );
426 Debug( LDAP_DEBUG_TRACE,
427 "do_bind: v%d unknown authentication method (%d)\n",
428 op->o_protocol, op->orb_method, 0 );
433 * We could be serving multiple database backends. Select the
434 * appropriate one, or send a referral to our "referral server"
435 * if we don't hold it.
438 if ( (op->o_bd = select_backend( &op->o_req_ndn, 0, 0 )) == NULL ) {
439 /* don't return referral for bind requests */
440 /* noSuchObject is not allowed to be returned by bind */
441 rs->sr_err = LDAP_INVALID_CREDENTIALS;
442 op->o_bd = frontendDB;
443 send_ldap_result( op, rs );
448 /* check restrictions */
449 if( backend_check_restrictions( op, rs, NULL ) != LDAP_SUCCESS ) {
450 send_ldap_result( op, rs );
454 if( op->o_bd->be_bind ) {
455 rs->sr_err = (op->o_bd->be_bind)( op, rs );
457 if ( rs->sr_err == 0 ) {
458 ldap_pvt_thread_mutex_lock( &op->o_conn->c_mutex );
460 if( op->o_conn->c_authz_backend == NULL ) {
461 op->o_conn->c_authz_backend = op->o_bd;
464 /* be_bind returns regular/global edn */
465 if( !BER_BVISEMPTY( &op->orb_edn ) ) {
466 op->o_conn->c_dn = op->orb_edn;
468 ber_dupbv(&op->o_conn->c_dn, &op->o_req_dn);
471 ber_dupbv( &op->o_conn->c_ndn, &op->o_req_ndn );
473 if( !BER_BVISEMPTY( &op->o_conn->c_dn ) ) {
474 ber_len_t max = sockbuf_max_incoming_auth;
475 ber_sockbuf_ctrl( op->o_conn->c_sb,
476 LBER_SB_OPT_SET_MAX_INCOMING, &max );
479 /* log authorization identity */
480 Statslog( LDAP_DEBUG_STATS,
481 "%s BIND dn=\"%s\" mech=%s ssf=0\n",
483 op->o_conn->c_dn.bv_val, mech.bv_val, 0, 0 );
485 Debug( LDAP_DEBUG_TRACE,
486 "do_bind: v%d bind: \"%s\" to \"%s\"\n",
487 op->o_protocol, op->o_req_dn.bv_val, op->o_conn->c_dn.bv_val );
489 ldap_pvt_thread_mutex_unlock( &op->o_conn->c_mutex );
491 /* send this here to avoid a race condition */
492 send_ldap_result( op, rs );
494 } else if ( !BER_BVISNULL( &op->orb_edn ) ) {
495 free( op->orb_edn.bv_val );
496 BER_BVZERO( &op->orb_edn );
500 send_ldap_error( op, rs, LDAP_UNWILLING_TO_PERFORM,
501 "operation not supported within naming context" );