The FreeRADIUS server $Id: 15bac2a4c627c01d1aa2047687b3418955ac7f00 $
Loading...
Searching...
No Matches
rlm_pap.c
Go to the documentation of this file.
1/*
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 as published by
4 * the Free Software Foundation; either version 2 of the License, or (at
5 * your option) any later version.
6 *
7 * This program is distributed in the hope that it will be useful,
8 * but WITHOUT ANY WARRANTY; without even the implied warranty of
9 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
10 * GNU General Public License for more details.
11 *
12 * You should have received a copy of the GNU General Public License
13 * along with this program; if not, write to the Free Software
14 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
15 */
16
17/**
18 * $Id: 526ab5bef536226580e240a54f25ee2394286653 $
19 * @file rlm_pap.c
20 * @brief Hashes plaintext passwords to compare against a prehashed reference.
21 *
22 * @copyright 2001-2012 The FreeRADIUS server project.
23 * @copyright 2012 Matthew Newton (matthew@newtoncomputing.co.uk)
24 * @copyright 2001 Kostas Kalevras (kkalev@noc.ntua.gr)
25 */
26RCSID("$Id: 526ab5bef536226580e240a54f25ee2394286653 $")
28
29#include <freeradius-devel/server/base.h>
30#include <freeradius-devel/server/module_rlm.h>
31#include <freeradius-devel/server/password.h>
32#include <freeradius-devel/tls/base.h>
33#include <freeradius-devel/tls/log.h>
34
35#include <freeradius-devel/util/base64.h>
36#include <freeradius-devel/util/debug.h>
37#include <freeradius-devel/util/base16.h>
38#include <freeradius-devel/util/md5.h>
39#include <freeradius-devel/util/sha1.h>
40
41#include <freeradius-devel/unlang/call_env.h>
42
43#include <freeradius-devel/protocol/freeradius/freeradius.internal.password.h>
44
45#include <ctype.h>
46
47#ifdef HAVE_CRYPT_H
48# include <crypt.h>
49#endif
50#include <unistd.h> /* Contains crypt function declarations */
51
52#ifdef HAVE_OPENSSL_EVP_H
53# include <freeradius-devel/tls/openssl_user_macros.h>
54# include <openssl/evp.h>
55#endif
56
57/*
58 * We don't have threadsafe crypt, so we have to wrap
59 * calls in a mutex
60 */
61#ifndef HAVE_CRYPT_R
62# include <pthread.h>
63static pthread_mutex_t fr_crypt_mutex = PTHREAD_MUTEX_INITIALIZER;
64#endif
65
66/*
67 * Define a structure for our module configuration.
68 *
69 * These variables do not need to be in a structure, but it's
70 * a lot cleaner to do so, and a pointer to the structure can
71 * be used as the instance handle.
72 */
73typedef struct {
75 bool normify;
76} rlm_pap_t;
77
78typedef unlang_action_t (*pap_auth_func_t)(rlm_rcode_t *p_result, rlm_pap_t const *inst, request_t *request, fr_pair_t const *, fr_value_box_t const *);
79
80static const conf_parser_t module_config[] = {
81 { FR_CONF_OFFSET("normalise", rlm_pap_t, normify), .dflt = "yes" },
83};
84
89
91 .inst_size = sizeof(pap_call_env_t),
92 .inst_type = "pap_call_env_t",
93 .env = (call_env_parser_t[]) {
94 { FR_CALL_ENV_PARSE_OFFSET("password_attribute", FR_TYPE_STRING,
96 pap_call_env_t, password, password_tmpl), .pair.dflt = "User-Password", .pair.dflt_quote = T_BARE_WORD },
98 }
99};
100
102
104 { .out = &dict_freeradius, .proto = "freeradius" },
105 { NULL }
106};
107
110
112 { .out = &attr_auth_type, .name = "Auth-Type", .type = FR_TYPE_UINT32, .dict = &dict_freeradius },
113 { .out = &attr_root, .name = "Password", .type = FR_TYPE_TLV, .dict = &dict_freeradius },
114
115 { NULL }
116};
117
118#ifdef HAVE_OPENSSL_EVP_H
119static fr_table_num_sorted_t const pbkdf2_crypt_names[] = {
120 { L("HMACSHA1"), FR_SSHA1 },
121 { L("HMACSHA2+224"), FR_SSHA2_224 },
122 { L("HMACSHA2+256"), FR_SSHA2_256 },
123 { L("HMACSHA2+384"), FR_SSHA2_384 },
124 { L("HMACSHA2+512"), FR_SSHA2_512 },
125 { L("HMACSHA3+224"), FR_SSHA3_224 },
126 { L("HMACSHA3+256"), FR_SSHA3_256 },
127 { L("HMACSHA3+384"), FR_SSHA3_384 },
128 { L("HMACSHA3+512"), FR_SSHA3_512 },
129};
130static size_t pbkdf2_crypt_names_len = NUM_ELEMENTS(pbkdf2_crypt_names);
131
132static fr_table_num_sorted_t const pbkdf2_passlib_names[] = {
133 { L("sha1"), FR_SSHA1 },
134 { L("sha256"), FR_SSHA2_256 },
135 { L("sha512"), FR_SSHA2_512 }
136};
137static size_t pbkdf2_passlib_names_len = NUM_ELEMENTS(pbkdf2_passlib_names);
138#endif
139
141
142/*
143 * Authorize the user for PAP authentication.
144 *
145 * This isn't strictly necessary, but it does make the
146 * server simpler to configure.
147 */
148static unlang_action_t CC_HINT(nonnull) mod_authorize(rlm_rcode_t *p_result, module_ctx_t const *mctx, request_t *request)
149{
151 pap_call_env_t *env_data = talloc_get_type_abort(mctx->env_data, pap_call_env_t);
152
153 if (fr_pair_find_by_da(&request->control_pairs, NULL, attr_auth_type) != NULL) {
154 RDEBUG3("Auth-Type is already set. Not setting 'Auth-Type := %s'", mctx->mi->name);
156 }
157
158 if (env_data->password.type != FR_TYPE_STRING) {
159 RDEBUG2("No %s attribute in the request. Cannot do PAP", env_data->password_tmpl->name);
161 }
162
163 if (!inst->auth_type) {
164 WARN("No 'authenticate %s {...}' section or 'Auth-Type = %s' set. Cannot setup PAP authentication.",
165 mctx->mi->name, mctx->mi->name);
167 }
168
170
172}
173
174/*
175 * PAP authentication functions
176 */
177
179 UNUSED rlm_pap_t const *inst, request_t *request,
180 fr_pair_t const *known_good, fr_value_box_t const *password)
181{
182 if ((known_good->vp_length != password->vb_length) ||
183 (fr_digest_cmp(known_good->vp_octets, password->vb_octets, known_good->vp_length) != 0)) {
184 REDEBUG("Cleartext password does not match \"known good\" password");
185 REDEBUG3("Password : %pV", password);
186 REDEBUG3("Expected : %pV", &known_good->data);
188 }
190}
191
192#ifdef HAVE_CRYPT
193static unlang_action_t CC_HINT(nonnull) pap_auth_crypt(rlm_rcode_t *p_result,
194 UNUSED rlm_pap_t const *inst, request_t *request,
195 fr_pair_t const *known_good, fr_value_box_t const *password)
196{
197 char *crypt_out;
198 int cmp = 0;
199
200#ifdef HAVE_CRYPT_R
201 struct crypt_data crypt_data = { .initialized = 0 };
202
203 crypt_out = crypt_r(password->vb_strvalue, known_good->vp_strvalue, &crypt_data);
204 if (crypt_out) cmp = strcmp(known_good->vp_strvalue, crypt_out);
205#else
206 /*
207 * Ensure we're thread-safe, as crypt() isn't.
208 */
209 pthread_mutex_lock(&fr_crypt_mutex);
210 crypt_out = crypt(password->vb_strvalue, known_good->vp_strvalue);
211
212 /*
213 * Got something, check it within the lock. This is
214 * faster than copying it to a local buffer, and the
215 * time spent within the lock is critical.
216 */
217 if (crypt_out) cmp = strcmp(known_good->vp_strvalue, crypt_out);
218 pthread_mutex_unlock(&fr_crypt_mutex);
219#endif
220
221 /*
222 * Error.
223 */
224 if (!crypt_out || (cmp != 0)) {
225 REDEBUG("Crypt digest does not match \"known good\" digest");
227 }
228
230}
231#endif
232
234 UNUSED rlm_pap_t const *inst, request_t *request,
235 fr_pair_t const *known_good, fr_value_box_t const *password)
236{
238
239 if (known_good->vp_length != MD5_DIGEST_LENGTH) {
240 REDEBUG("\"known-good\" MD5 password has incorrect length, expected 16 got %zu", known_good->vp_length);
242 }
243
244 fr_md5_calc(digest, password->vb_octets, password->vb_length);
245
246 if (fr_digest_cmp(digest, known_good->vp_octets, known_good->vp_length) != 0) {
247 REDEBUG("MD5 digest does not match \"known good\" digest");
248 REDEBUG3("Password : %pV", password);
249 REDEBUG3("Calculated : %pH", fr_box_octets(digest, MD5_DIGEST_LENGTH));
250 REDEBUG3("Expected : %pH", fr_box_octets(known_good->vp_octets, MD5_DIGEST_LENGTH));
252 }
253
255}
256
257
259 UNUSED rlm_pap_t const *inst, request_t *request,
260 fr_pair_t const *known_good, fr_value_box_t const *password)
261{
262 fr_md5_ctx_t *md5_ctx;
264
265 if (known_good->vp_length <= MD5_DIGEST_LENGTH) {
266 REDEBUG("\"known-good\" Password.SMD5 has incorrect length, expected 16 got %zu", known_good->vp_length);
268 }
269
270 md5_ctx = fr_md5_ctx_alloc_from_list();
271 fr_md5_update(md5_ctx, password->vb_octets, password->vb_length);
272 fr_md5_update(md5_ctx, known_good->vp_octets + MD5_DIGEST_LENGTH, known_good->vp_length - MD5_DIGEST_LENGTH);
273 fr_md5_final(digest, md5_ctx);
275
276 /*
277 * Compare only the MD5 hash results, not the salt.
278 */
279 if (fr_digest_cmp(digest, known_good->vp_octets, MD5_DIGEST_LENGTH) != 0) {
280 REDEBUG("SMD5 digest does not match \"known good\" digest");
281 REDEBUG3("Password : %pV", password);
282 REDEBUG3("Calculated : %pH", fr_box_octets(digest, MD5_DIGEST_LENGTH));
283 REDEBUG3("Expected : %pH", fr_box_octets(known_good->vp_octets, MD5_DIGEST_LENGTH));
285 }
286
288}
289
291 UNUSED rlm_pap_t const *inst, request_t *request,
292 fr_pair_t const *known_good, fr_value_box_t const *password)
293{
294 fr_sha1_ctx sha1_context;
296
297 if (known_good->vp_length != SHA1_DIGEST_LENGTH) {
298 REDEBUG("\"known-good\" Password.SHA1 has incorrect length, expected 20 got %zu", known_good->vp_length);
300 }
301
302 fr_sha1_init(&sha1_context);
303 fr_sha1_update(&sha1_context, password->vb_octets, password->vb_length);
304 fr_sha1_final(digest,&sha1_context);
305
306 if (fr_digest_cmp(digest, known_good->vp_octets, known_good->vp_length) != 0) {
307 REDEBUG("SHA1 digest does not match \"known good\" digest");
308 REDEBUG3("Password : %pV", password);
309 REDEBUG3("Calculated : %pH", fr_box_octets(digest, SHA1_DIGEST_LENGTH));
310 REDEBUG3("Expected : %pH", fr_box_octets(known_good->vp_octets, SHA1_DIGEST_LENGTH));
312 }
313
315}
316
318 UNUSED rlm_pap_t const *inst, request_t *request,
319 fr_pair_t const *known_good, fr_value_box_t const *password)
320{
321 fr_sha1_ctx sha1_context;
323
324 if (known_good->vp_length <= SHA1_DIGEST_LENGTH) {
325 REDEBUG("\"known-good\" Password.SSHA has incorrect length, expected > 20 got %zu", known_good->vp_length);
327 }
328
329 fr_sha1_init(&sha1_context);
330 fr_sha1_update(&sha1_context, password->vb_octets, password->vb_length);
331
332 fr_sha1_update(&sha1_context, known_good->vp_octets + SHA1_DIGEST_LENGTH, known_good->vp_length - SHA1_DIGEST_LENGTH);
333 fr_sha1_final(digest, &sha1_context);
334
335 if (fr_digest_cmp(digest, known_good->vp_octets, SHA1_DIGEST_LENGTH) != 0) {
336 REDEBUG("SSHA digest does not match \"known good\" digest");
337 REDEBUG3("Password : %pV", password);
338 REDEBUG3("Salt : %pH", fr_box_octets(known_good->vp_octets + SHA1_DIGEST_LENGTH,
339 known_good->vp_length - SHA1_DIGEST_LENGTH));
340 REDEBUG3("Calculated : %pH", fr_box_octets(digest, SHA1_DIGEST_LENGTH));
341 REDEBUG3("Expected : %pH", fr_box_octets(known_good->vp_octets, SHA1_DIGEST_LENGTH));
343 }
344
346}
347
348#ifdef HAVE_OPENSSL_EVP_H
349static unlang_action_t CC_HINT(nonnull) pap_auth_evp_md(rlm_rcode_t *p_result,
350 UNUSED rlm_pap_t const *inst, request_t *request,
351 fr_pair_t const *known_good, fr_value_box_t const *password,
352 char const *name, EVP_MD const *md)
353{
354 EVP_MD_CTX *ctx;
355 uint8_t digest[EVP_MAX_MD_SIZE];
356 unsigned int digest_len;
357
358 ctx = EVP_MD_CTX_create();
359 EVP_DigestInit_ex(ctx, md, NULL);
360 EVP_DigestUpdate(ctx, password->vb_octets, password->vb_length);
361 EVP_DigestFinal_ex(ctx, digest, &digest_len);
362 EVP_MD_CTX_destroy(ctx);
363
364 fr_assert((size_t) digest_len == known_good->vp_length); /* This would be an OpenSSL bug... */
365
366 if (fr_digest_cmp(digest, known_good->vp_octets, known_good->vp_length) != 0) {
367 REDEBUG("%s digest does not match \"known good\" digest", name);
368 REDEBUG3("Password : %pV", password);
369 REDEBUG3("Calculated : %pH", fr_box_octets(digest, digest_len));
370 REDEBUG3("Expected : %pH", &known_good->data);
372 }
373
375}
376
377static unlang_action_t CC_HINT(nonnull) pap_auth_evp_md_salted(rlm_rcode_t *p_result,
378 UNUSED rlm_pap_t const *inst, request_t *request,
379 fr_pair_t const *known_good, fr_value_box_t const *password,
380 char const *name, EVP_MD const *md)
381{
382 EVP_MD_CTX *ctx;
383 uint8_t digest[EVP_MAX_MD_SIZE];
384 unsigned int digest_len, min_len;
385
386 min_len = EVP_MD_size(md);
387 ctx = EVP_MD_CTX_create();
388 EVP_DigestInit_ex(ctx, md, NULL);
389 EVP_DigestUpdate(ctx, password->vb_octets, password->vb_length);
390 EVP_DigestUpdate(ctx, known_good->vp_octets + min_len, known_good->vp_length - min_len);
391 EVP_DigestFinal_ex(ctx, digest, &digest_len);
392 EVP_MD_CTX_destroy(ctx);
393
394 fr_assert((size_t) digest_len == min_len); /* This would be an OpenSSL bug... */
395
396 /*
397 * Only compare digest_len bytes, the rest is salt.
398 */
399 if (fr_digest_cmp(digest, known_good->vp_octets, (size_t)digest_len) != 0) {
400 REDEBUG("%s digest does not match \"known good\" digest", name);
401 REDEBUG3("Password : %pV", password);
402 REDEBUG3("Salt : %pH",
403 fr_box_octets(known_good->vp_octets + digest_len, known_good->vp_length - digest_len));
404 REDEBUG3("Calculated : %pH", fr_box_octets(digest, digest_len));
405 REDEBUG3("Expected : %pH", fr_box_octets(known_good->vp_octets, digest_len));
407 }
408
410}
411
412/** Define a new OpenSSL EVP based password hashing function
413 *
414 */
415#define PAP_AUTH_EVP_MD(_func, _new_func, _name, _md) \
416static unlang_action_t CC_HINT(nonnull) _new_func(rlm_rcode_t *p_result, \
417 rlm_pap_t const *inst, request_t *request, \
418 fr_pair_t const *known_good, fr_value_box_t const *password) \
419{ \
420 return _func(p_result, inst, request, known_good, password, _name, _md); \
421}
422
423PAP_AUTH_EVP_MD(pap_auth_evp_md, pap_auth_sha2_224, "SHA2-224", EVP_sha224())
424PAP_AUTH_EVP_MD(pap_auth_evp_md, pap_auth_sha2_256, "SHA2-256", EVP_sha256())
425PAP_AUTH_EVP_MD(pap_auth_evp_md, pap_auth_sha2_384, "SHA2-384", EVP_sha384())
426PAP_AUTH_EVP_MD(pap_auth_evp_md, pap_auth_sha2_512, "SHA2-512", EVP_sha512())
427PAP_AUTH_EVP_MD(pap_auth_evp_md_salted, pap_auth_ssha2_224, "SSHA2-224", EVP_sha224())
428PAP_AUTH_EVP_MD(pap_auth_evp_md_salted, pap_auth_ssha2_256, "SSHA2-256", EVP_sha256())
429PAP_AUTH_EVP_MD(pap_auth_evp_md_salted, pap_auth_ssha2_384, "SSHA2-384", EVP_sha384())
430PAP_AUTH_EVP_MD(pap_auth_evp_md_salted, pap_auth_ssha2_512, "SSHA2-512", EVP_sha512())
431
432PAP_AUTH_EVP_MD(pap_auth_evp_md, pap_auth_sha3_224, "SHA3-224", EVP_sha3_224())
433PAP_AUTH_EVP_MD(pap_auth_evp_md, pap_auth_sha3_256, "SHA3-256", EVP_sha3_256())
434PAP_AUTH_EVP_MD(pap_auth_evp_md, pap_auth_sha3_384, "SHA3-384", EVP_sha3_384())
435PAP_AUTH_EVP_MD(pap_auth_evp_md, pap_auth_sha3_512, "SHA3-512", EVP_sha3_512())
436PAP_AUTH_EVP_MD(pap_auth_evp_md_salted, pap_auth_ssha3_224, "SSHA3-224", EVP_sha3_224())
437PAP_AUTH_EVP_MD(pap_auth_evp_md_salted, pap_auth_ssha3_256, "SSHA3-256", EVP_sha3_256())
438PAP_AUTH_EVP_MD(pap_auth_evp_md_salted, pap_auth_ssha3_384, "SSHA3-384", EVP_sha3_384())
439PAP_AUTH_EVP_MD(pap_auth_evp_md_salted, pap_auth_ssha3_512, "SSHA3-512", EVP_sha3_512())
440
441/** Validates Crypt::PBKDF2 LDAP format strings
442 *
443 * @param[out] p_result The result of comparing the pbkdf2 hash with the password.
444 * @param[in] request The current request.
445 * @param[in] str Raw PBKDF2 string.
446 * @param[in] len Length of string.
447 * @param[in] digest_type Digest type to use.
448 * @param[in] iter_sep Separation character between the iterations and the next component.
449 * @param[in] salt_sep Separation character between the salt and the next component.
450 * @param[in] iter_is_base64 Whether the iterations is are encoded as base64.
451 * @param[in] password to validate.
452 * @return
453 * - RLM_MODULE_REJECT
454 * - RLM_MODULE_OK
455 */
456static inline CC_HINT(nonnull) unlang_action_t pap_auth_pbkdf2_parse_digest(rlm_rcode_t *p_result,
457 request_t *request, const uint8_t *str, size_t len,
458 int digest_type, char iter_sep, char salt_sep,
459 bool iter_is_base64, fr_value_box_t const *password)
460{
462
463 uint8_t const *p, *q, *end;
464 ssize_t slen;
465
466 EVP_MD const *evp_md;
467 size_t digest_len;
468
469 uint32_t iterations = 1;
470
471 uint8_t *salt = NULL;
472 size_t salt_len;
473 uint8_t hash[EVP_MAX_MD_SIZE];
474 uint8_t digest[EVP_MAX_MD_SIZE];
475
476 /*
477 * Parse PBKDF string for given digest = <iterations><iter_sep>b64(<salt>)<salt_sep>b64(<hash>)
478 */
479 p = str;
480 end = p + len;
481
482 switch (digest_type) {
483 case FR_SSHA1:
484 evp_md = EVP_sha1();
485 digest_len = SHA1_DIGEST_LENGTH;
486 break;
487
488 case FR_SSHA2_224:
489 evp_md = EVP_sha224();
490 digest_len = SHA224_DIGEST_LENGTH;
491 break;
492
493 case FR_SSHA2_256:
494 evp_md = EVP_sha256();
495 digest_len = SHA256_DIGEST_LENGTH;
496 break;
497
498 case FR_SSHA2_384:
499 evp_md = EVP_sha384();
500 digest_len = SHA384_DIGEST_LENGTH;
501 break;
502
503 case FR_SSHA2_512:
504 evp_md = EVP_sha512();
505 digest_len = SHA512_DIGEST_LENGTH;
506 break;
507
508 case FR_SSHA3_224:
509 evp_md = EVP_sha3_224();
510 digest_len = SHA224_DIGEST_LENGTH;
511 break;
512
513 case FR_SSHA3_256:
514 evp_md = EVP_sha3_256();
515 digest_len = SHA256_DIGEST_LENGTH;
516 break;
517
518 case FR_SSHA3_384:
519 evp_md = EVP_sha3_384();
520 digest_len = SHA384_DIGEST_LENGTH;
521 break;
522
523 case FR_SSHA3_512:
524 evp_md = EVP_sha3_512();
525 digest_len = SHA512_DIGEST_LENGTH;
526 break;
527
528 default:
529 REDEBUG("Unknown PBKDF2 digest type \"%d\"", digest_type);
530 goto finish;
531 }
532
533 if (((end - p) < 1) || !(q = memchr(p, iter_sep, end - p))) {
534 REDEBUG("Password.PBKDF2 missing iterations component");
535 goto finish;
536 }
537
538 if ((q - p) == 0) {
539 REDEBUG("Password.PBKDF2 iterations component too short");
540 goto finish;
541 }
542
543 /*
544 * If it's not base64 encoded, assume it's ascii
545 */
546 if (!iter_is_base64) {
547 char iterations_buff[sizeof("4294967295") + 1];
548 char *qq;
549
550 /*
551 * While passwords come from "trusted" sources, we don't trust them too much!
552 */
553 if ((size_t) (q - p) >= sizeof(iterations_buff)) {
554 REMARKER((char const *) p, q - p,
555 "Password.PBKDF2 iterations field is too large");
556
557 goto finish;
558 }
559
560 strlcpy(iterations_buff, (char const *)p, (q - p) + 1);
561
562 iterations = strtoul(iterations_buff, &qq, 10);
563 if (*qq != '\0') {
564 REMARKER(iterations_buff, qq - iterations_buff,
565 "Password.PBKDF2 iterations field contains an invalid character");
566
567 goto finish;
568 }
569 p = q + 1;
570 /*
571 * base64 encoded and big endian
572 */
573 } else {
575 slen = fr_base64_decode(&FR_DBUFF_TMP((uint8_t *)&iterations, sizeof(iterations)),
576 &FR_SBUFF_IN((char const *)p, (char const *)q), false, false);
577 if (slen <= 0) {
578 RPEDEBUG("Failed decoding Password.PBKDF2 iterations component (%.*s)", (int)(q - p), p);
579 goto finish;
580 }
581 if (slen != sizeof(iterations)) {
582 REDEBUG("Decoded Password.PBKDF2 iterations component is wrong size");
583 }
584
585 iterations = ntohl(iterations);
586
587 p = q + 1;
588 }
589
590 /*
591 * 0 iterations is invalid (we need at least one)
592 */
593 if (iterations == 0) iterations = 1;
594
595 if (((end - p) < 1) || !(q = memchr(p, salt_sep, end - p))) {
596 REDEBUG("Password.PBKDF2 missing salt component");
597 goto finish;
598 }
599
600 if ((q - p) == 0) {
601 REDEBUG("Password.PBKDF2 salt component too short");
602 goto finish;
603 }
604
605 MEM(salt = talloc_array(request, uint8_t, FR_BASE64_DEC_LENGTH(q - p)));
606 slen = fr_base64_decode(&FR_DBUFF_TMP(salt, talloc_array_length(salt)),
607 &FR_SBUFF_IN((char const *) p, (char const *)q), false, false);
608 if (slen <= 0) {
609 RPEDEBUG("Failed decoding Password.PBKDF2 salt component");
610 goto finish;
611 }
612 salt_len = (size_t)slen;
613
614 p = q + 1;
615
616 if ((q - p) == 0) {
617 REDEBUG("Password.PBKDF2 hash component too short");
618 goto finish;
619 }
620
621 slen = fr_base64_decode(&FR_DBUFF_TMP(hash, sizeof(hash)),
622 &FR_SBUFF_IN((char const *)p, (char const *)end), false, false);
623 if (slen <= 0) {
624 RPEDEBUG("Failed decoding Password.PBKDF2 hash component");
625 goto finish;
626 }
627
628 if ((size_t)slen != digest_len) {
629 REDEBUG("Password.PBKDF2 hash component length is incorrect for hash type, expected %zu, got %zd",
630 digest_len, slen);
631
632 RHEXDUMP2(hash, slen, "hash component");
633
634 goto finish;
635 }
636
637 RDEBUG2("PBKDF2 %s: Iterations %u, salt length %zu, hash length %zd",
638 fr_table_str_by_value(pbkdf2_crypt_names, digest_type, "<UNKNOWN>"),
639 iterations, salt_len, slen);
640
641 /*
642 * Hash and compare
643 */
644 if (PKCS5_PBKDF2_HMAC((char const *)password->vb_octets, (int)password->vb_length,
645 (unsigned char const *)salt, (int)salt_len,
646 (int)iterations,
647 evp_md,
648 (int)digest_len, (unsigned char *)digest) == 0) {
649 fr_tls_log(request, "PBKDF2 digest failure");
650 goto finish;
651 }
652
653 if (fr_digest_cmp(digest, hash, (size_t)digest_len) != 0) {
654 REDEBUG("PBKDF2 digest does not match \"known good\" digest");
655 REDEBUG3("Salt : %pH", fr_box_octets(salt, salt_len));
656 REDEBUG3("Calculated : %pH", fr_box_octets(digest, digest_len));
657 REDEBUG3("Expected : %pH", fr_box_octets(hash, slen));
658 rcode = RLM_MODULE_REJECT;
659 } else {
660 rcode = RLM_MODULE_OK;
661 }
662
663finish:
664 talloc_free(salt);
665
666 RETURN_MODULE_RCODE(rcode);
667}
668
669/** Validates Crypt::PBKDF2 LDAP format strings
670 *
671 * @param[out] p_result The result of comparing the pbkdf2 hash with the password.
672 * @param[in] request The current request.
673 * @param[in] str Raw PBKDF2 string.
674 * @param[in] len Length of string.
675 * @param[in] hash_names Table containing valid hash names.
676 * @param[in] hash_names_len How long the table is.
677 * @param[in] scheme_sep Separation character between the scheme and the next component.
678 * @param[in] iter_sep Separation character between the iterations and the next component.
679 * @param[in] salt_sep Separation character between the salt and the next component.
680 * @param[in] iter_is_base64 Whether the iterations is are encoded as base64.
681 * @param[in] password to validate.
682 * @return
683 * - RLM_MODULE_REJECT
684 * - RLM_MODULE_OK
685 */
686static inline CC_HINT(nonnull) unlang_action_t pap_auth_pbkdf2_parse(rlm_rcode_t *p_result,
687 request_t *request, const uint8_t *str, size_t len,
688 fr_table_num_sorted_t const hash_names[], size_t hash_names_len,
689 char scheme_sep, char iter_sep, char salt_sep,
690 bool iter_is_base64, fr_value_box_t const *password)
691{
693
694 uint8_t const *p, *q, *end;
695 int digest_type;
696
697 RDEBUG2("Comparing with \"known-good\" Password.PBKDF2");
698
699 if (len <= 1) {
700 REDEBUG("Password.PBKDF2 is too short");
701 goto finish;
702 }
703
704 /*
705 * Parse PBKDF string = {hash_algorithm}<scheme_sep><iterations><iter_sep>b64(<salt>)<salt_sep>b64(<hash>)
706 */
707 p = str;
708 end = p + len;
709
710 q = memchr(p, scheme_sep, end - p);
711 if (!q) {
712 REDEBUG("Password.PBKDF2 has no component separators");
713 goto finish;
714 }
715
716 digest_type = fr_table_value_by_substr(hash_names, (char const *)p, q - p, -1);
717
718 p = q + 1;
719
720 return pap_auth_pbkdf2_parse_digest(p_result, request, p, end - p, digest_type, iter_sep, salt_sep, iter_is_base64, password);
721
722finish:
723 RETURN_MODULE_RCODE(rcode);
724}
725
726static inline unlang_action_t CC_HINT(nonnull) pap_auth_pbkdf2(rlm_rcode_t *p_result,
727 UNUSED rlm_pap_t const *inst,
728 request_t *request,
729 fr_pair_t const *known_good, fr_value_box_t const *password)
730{
731 uint8_t const *p = known_good->vp_octets, *q, *end = p + known_good->vp_length;
732
733 if ((end - p) < 2) {
734 REDEBUG("Password.PBKDF2 too short");
736 }
737
738 /*
739 * If it doesn't begin with a $ assume
740 * it's Crypt::PBKDF2 LDAP format
741 *
742 * {X-PBKDF2}<digest>:<b64 rounds>:<b64_salt>:<b64_hash>
743 *
744 * or 389ds LDAP format
745 *
746 * {PBKDF2-SHA512}<round>$<b64_salt>$<b64_hash>
747 */
748 if (*p != '$') {
749 if ((size_t)(end - p) >= sizeof("{PBKDF2-") && (memcmp(p, "{PBKDF2-", sizeof("{PBKDF2-") - 1) == 0)) {
750 p += sizeof("{PBKDF2-") - 1;
751 return pap_auth_pbkdf2_parse(p_result, request, p, end - p,
752 pbkdf2_passlib_names, pbkdf2_passlib_names_len,
753 '}', '$', '$', false, password);
754 } else {
755 /*
756 * Strip the header if it's present
757 */
758 if (*p == '{') {
759 q = memchr(p, '}', end - p);
760 p = q + 1;
761 }
762 return pap_auth_pbkdf2_parse(p_result, request, p, end - p,
763 pbkdf2_crypt_names, pbkdf2_crypt_names_len,
764 ':', ':', ':', true, password);
765 }
766 }
767
768 /*
769 * Crypt::PBKDF2 Crypt format
770 *
771 * $PBKDF2$<digest>:<rounds>:<b64_salt>$<b64_hash>
772 */
773 if ((size_t)(end - p) >= sizeof("$PBKDF2$") && (memcmp(p, "$PBKDF2$", sizeof("$PBKDF2$") - 1) == 0)) {
774 p += sizeof("$PBKDF2$") - 1;
775 return pap_auth_pbkdf2_parse(p_result, request, p, end - p,
776 pbkdf2_crypt_names, pbkdf2_crypt_names_len,
777 ':', ':', '$', false, password);
778 }
779
780 /*
781 * Python's passlib format
782 *
783 * $pbkdf2-<digest>$<rounds>$<alt_b64_salt>$<alt_b64_hash>
784 *
785 * Note: Our base64 functions also work with alt_b64
786 */
787 if ((size_t)(end - p) >= sizeof("$pbkdf2-") && (memcmp(p, "$pbkdf2-", sizeof("$pbkdf2-") - 1) == 0)) {
788 p += sizeof("$pbkdf2-") - 1;
789 return pap_auth_pbkdf2_parse(p_result, request, p, end - p,
790 pbkdf2_passlib_names, pbkdf2_passlib_names_len,
791 '$', '$', '$', false, password);
792 }
793
794 REDEBUG("Can't determine format of Password.PBKDF2");
795
797}
798
799/*
800 * 389ds pbkdf2 passwords
801 *
802 * {PBKDF2-<digest>}<rounds>$<b64_salt>$<b64_hash>
803 */
804static inline unlang_action_t CC_HINT(nonnull) pap_auth_pbkdf2_sha1(rlm_rcode_t *p_result,
805 UNUSED rlm_pap_t const *inst,
806 request_t *request,
807 fr_pair_t const *known_good, fr_value_box_t const *password)
808{
809 uint8_t const *p = known_good->vp_octets, *end = p + known_good->vp_length;
810
811 if ((end - p) < 2) {
812 REDEBUG("Password.With-Header {PBKDF2-SHA1} too short");
814 }
815
816 return pap_auth_pbkdf2_parse_digest(p_result, request, p, end - p, FR_SSHA1, '$', '$', false, password);
817}
818
819static inline unlang_action_t CC_HINT(nonnull) pap_auth_pbkdf2_sha256(rlm_rcode_t *p_result,
820 UNUSED rlm_pap_t const *inst,
821 request_t *request,
822 fr_pair_t const *known_good, fr_value_box_t const *password)
823{
824 uint8_t const *p = known_good->vp_octets, *end = p + known_good->vp_length;
825
826 if ((end - p) < 2) {
827 REDEBUG("Password.With-Header {PBKDF2-SHA256} too short");
829 }
830
831 return pap_auth_pbkdf2_parse_digest(p_result, request, p, end - p, FR_SSHA2_256, '$', '$', false, password);
832}
833
834static inline unlang_action_t CC_HINT(nonnull) pap_auth_pbkdf2_sha512(rlm_rcode_t *p_result,
835 UNUSED rlm_pap_t const *inst,
836 request_t *request,
837 fr_pair_t const *known_good, fr_value_box_t const *password)
838{
839 uint8_t const *p = known_good->vp_octets, *end = p + known_good->vp_length;
840
841 if ((end - p) < 2) {
842 REDEBUG("Password.With-Header {PBKDF2-SHA512} too short");
844 }
845
846 return pap_auth_pbkdf2_parse_digest(p_result, request, p, end - p, FR_SSHA2_512, '$', '$', false, password);
847}
848
849/*
850 * 389ds pbkdf2 legacy password with header {PBKDF2_SHA256}
851 *
852 * this was the first implementation in 389ds using a fixed length struct as base64.
853 * at some point it was the default scheme, although it's not recommened anymore.
854 *
855 * content struct is
856 * 4 bytes iterations (value 8192)
857 * 64 bytes salt
858 * 256 bytes hash
859 */
860static inline unlang_action_t CC_HINT(nonnull) pap_auth_pbkdf2_sha256_legacy(rlm_rcode_t *p_result,
861 UNUSED rlm_pap_t const *inst,
862 request_t *request,
863 fr_pair_t const *known_good, fr_value_box_t const *password)
864{
865#define PBKDF2_SHA256_LEGACY_SALT_LENGTH 64
866#define PBKDF2_SHA256_LEGACY_ITERATIONS_LENGTH 4
867#define PBKDF2_SHA256_LEGACY_HASH_LENGTH 256
868#define PBKDF2_SHA256_LEGACY_TOTAL_LENGTH (PBKDF2_SHA256_LEGACY_ITERATIONS_LENGTH + PBKDF2_SHA256_LEGACY_SALT_LENGTH + PBKDF2_SHA256_LEGACY_HASH_LENGTH)
869#define PBKDF2_SHA256_LEGACY_ITERATIONS 8192
870#define PBKDF2_SHA256_LEGACY_B64_LENGTH (PBKDF2_SHA256_LEGACY_TOTAL_LENGTH * 4 / 3)
871
872 struct pbkdf2_bufs {
873 uint32_t iterations;
874 uint8_t salt[PBKDF2_SHA256_LEGACY_SALT_LENGTH];
875 uint8_t hash[PBKDF2_SHA256_LEGACY_HASH_LENGTH];
876 };
877 struct pbkdf2_bufs pbkdf2_buf = { .iterations = PBKDF2_SHA256_LEGACY_ITERATIONS };
878
879 ssize_t slen;
880 uint8_t const *p = known_good->vp_octets, *end = p + known_good->vp_length;
881
882 EVP_MD const *evp_md = EVP_sha256();
883 size_t digest_len = SHA256_DIGEST_LENGTH;
884 uint8_t digest[SHA256_DIGEST_LENGTH];
885
886 if ((end - p) != PBKDF2_SHA256_LEGACY_B64_LENGTH) {
887 REDEBUG("Password.With-Header {PBKDF2_SHA256} has incorrect size %zd instead of %d.", known_good->vp_length, PBKDF2_SHA256_LEGACY_B64_LENGTH);
889 }
890
891 slen = fr_base64_decode(&FR_DBUFF_TMP((uint8_t *) &pbkdf2_buf, sizeof(pbkdf2_buf)),
892 &FR_SBUFF_IN((char const *) p, (char const *)end), false, false);
893
894 if (slen <= 0) {
895 RPEDEBUG("Failed decoding Password.With-Header {PBKDF2_SHA256}: \"%.*s\"", (int)(end -p), p);
897 }
898
899 if (slen != PBKDF2_SHA256_LEGACY_TOTAL_LENGTH) {
900 REDEBUG("Password.With-Header {PBKDF2_SHA256} has incorrect decoded size %zd instead of %d.", slen, PBKDF2_SHA256_LEGACY_TOTAL_LENGTH);
902 }
903
904 pbkdf2_buf.iterations = ntohl(pbkdf2_buf.iterations);
905
906 if (pbkdf2_buf.iterations != PBKDF2_SHA256_LEGACY_ITERATIONS) {
907 REDEBUG("Password.With-Header {PBKDF2_SHA256} has unexpected number of iterations %d instead of %d.", pbkdf2_buf.iterations, PBKDF2_SHA256_LEGACY_ITERATIONS);
909 }
910
911 if (PKCS5_PBKDF2_HMAC((char const *)password->vb_octets, (int)password->vb_length,
912 (unsigned char const *)pbkdf2_buf.salt, (int)PBKDF2_SHA256_LEGACY_SALT_LENGTH,
913 (int)pbkdf2_buf.iterations,
914 evp_md,
915 (int)digest_len, (unsigned char *)digest) == 0) {
916 fr_tls_log(request, "PBKDF2_SHA256 digest failure");
918 }
919
920 if (fr_digest_cmp(digest, pbkdf2_buf.hash, (size_t)digest_len) != 0) {
921 REDEBUG("PBKDF2_SHA256 digest does not match \"known good\" digest");
922 REDEBUG3("Salt : %pH", fr_box_octets(pbkdf2_buf.salt, PBKDF2_SHA256_LEGACY_SALT_LENGTH));
923 REDEBUG3("Calculated : %pH", fr_box_octets(digest, digest_len));
924 REDEBUG3("Expected : %pH", fr_box_octets(pbkdf2_buf.hash, PBKDF2_SHA256_LEGACY_HASH_LENGTH));
926 } else {
928 }
929}
930#endif
931
933 UNUSED rlm_pap_t const *inst, request_t *request,
934 fr_pair_t const *known_good, fr_value_box_t const *password)
935{
936 ssize_t len;
938 uint8_t ucs2[512];
939
940 RDEBUG2("Comparing with \"known-good\" Password.NT");
941
942 if (known_good->vp_length != MD4_DIGEST_LENGTH) {
943 REDEBUG("\"known good\" Password.NT has incorrect length, expected 16 got %zu", known_good->vp_length);
945 }
946
947 len = fr_utf8_to_ucs2(ucs2, sizeof(ucs2),
948 password->vb_strvalue, password->vb_length);
949 if (len < 0) {
950 REDEBUG("User-Password is not in UCS2 format");
952 }
953
954 fr_md4_calc(digest, (uint8_t *)ucs2, len);
955
956 if (fr_digest_cmp(digest, known_good->vp_octets, known_good->vp_length) != 0) {
957 REDEBUG("NT digest does not match \"known good\" digest");
958 REDEBUG3("Calculated : %pH", fr_box_octets(digest, sizeof(digest)));
959 REDEBUG3("Expected : %pH", &known_good->data);
961 }
962
964}
965
967 UNUSED rlm_pap_t const *inst, request_t *request,
968 fr_pair_t const *known_good, fr_value_box_t const *password)
969{
970 uint8_t digest[128];
972 uint8_t buff2[FR_MAX_STRING_LEN + 50];
973 fr_dbuff_t digest_dbuff = FR_DBUFF_TMP(digest, sizeof(digest));
974
975 RDEBUG2("Using Password.NT-MTA-MD5");
976
977 if (known_good->vp_length != 64) {
978 REDEBUG("\"known good\" Password.NS-MTA-MD5 has incorrect length, expected 64 got %zu",
979 known_good->vp_length);
981 }
982
983 /*
984 * Sanity check the value of Password.NS-MTA-MD5
985 */
986 if (fr_base16_decode(NULL, &digest_dbuff,
987 &FR_SBUFF_IN(known_good->vp_strvalue, known_good->vp_length), false) != 16) {
988 REDEBUG("\"known good\" Password.NS-MTA-MD5 has invalid value");
990 }
991
992 /*
993 * Ensure we don't have buffer overflows.
994 *
995 * This really: sizeof(buff) - 2 - 2*32 - strlen(passwd)
996 */
997 if (password->vb_length >= (sizeof(buff) - 2 - 2 * 32)) {
998 REDEBUG("\"known good\" Password.NS-MTA-MD5 is too long");
1000 }
1001
1002 /*
1003 * Set up the algorithm.
1004 */
1005 {
1006 uint8_t *p = buff2;
1007
1008 memcpy(p, &known_good->vp_octets[32], 32);
1009 p += 32;
1010 *(p++) = 89;
1011 memcpy(p, password->vb_strvalue, password->vb_length);
1012 p += password->vb_length;
1013 *(p++) = 247;
1014 memcpy(p, &known_good->vp_octets[32], 32);
1015 p += 32;
1016
1017 fr_md5_calc(buff, (uint8_t *) buff2, p - buff2);
1018 }
1019
1020 if (fr_digest_cmp(fr_dbuff_start(&digest_dbuff), buff, 16) != 0) {
1021 REDEBUG("NS-MTA-MD5 digest does not match \"known good\" digest");
1023 }
1024
1026}
1027
1028/** Auth func for password types that should have been normalised away
1029 *
1030 */
1032 UNUSED rlm_pap_t const *inst, UNUSED request_t *request,
1033 UNUSED fr_pair_t const *known_good, UNUSED fr_value_box_t const *password)
1034{
1036}
1037
1038/** Table of password types we can process
1039 *
1040 */
1042 [FR_CLEARTEXT] = pap_auth_clear,
1043 [FR_MD5] = pap_auth_md5,
1044 [FR_SMD5] = pap_auth_smd5,
1045
1046#ifdef HAVE_CRYPT
1047 [FR_CRYPT] = pap_auth_crypt,
1048#endif
1049 [FR_NS_MTA_MD5] = pap_auth_ns_mta_md5,
1050 [FR_NT] = pap_auth_nt,
1051 [FR_WITH_HEADER] = pap_auth_dummy,
1052 [FR_SHA1] = pap_auth_sha1,
1053 [FR_SSHA1] = pap_auth_ssha1,
1054
1055#ifdef HAVE_OPENSSL_EVP_H
1056 [FR_PBKDF2] = pap_auth_pbkdf2,
1057 [FR_PBKDF2_SHA1] = pap_auth_pbkdf2_sha1,
1058 [FR_PBKDF2_SHA256] = pap_auth_pbkdf2_sha256,
1059 [FR_PBKDF2_SHA512] = pap_auth_pbkdf2_sha512,
1060 [FR_PBKDF2_SHA256_LEGACY] = pap_auth_pbkdf2_sha256_legacy,
1061 [FR_SHA2] = pap_auth_dummy,
1062 [FR_SHA2_224] = pap_auth_sha2_224,
1063 [FR_SHA2_256] = pap_auth_sha2_256,
1064 [FR_SHA2_384] = pap_auth_sha2_384,
1065 [FR_SHA2_512] = pap_auth_sha2_512,
1066 [FR_SSHA2_224] = pap_auth_ssha2_224,
1067 [FR_SSHA2_256] = pap_auth_ssha2_256,
1068 [FR_SSHA2_384] = pap_auth_ssha2_384,
1069 [FR_SSHA2_512] = pap_auth_ssha2_512,
1070 [FR_SHA3] = pap_auth_dummy,
1071 [FR_SHA3_224] = pap_auth_sha3_224,
1072 [FR_SHA3_256] = pap_auth_sha3_256,
1073 [FR_SHA3_384] = pap_auth_sha3_384,
1074 [FR_SHA3_512] = pap_auth_sha3_512,
1075 [FR_SSHA3_224] = pap_auth_ssha3_224,
1076 [FR_SSHA3_256] = pap_auth_ssha3_256,
1077 [FR_SSHA3_384] = pap_auth_ssha3_384,
1078 [FR_SSHA3_512] = pap_auth_ssha3_512,
1079#endif /* HAVE_OPENSSL_EVP_H */
1080};
1081
1082/*
1083 * Authenticate the user via one of any well-known password.
1084 */
1085static unlang_action_t CC_HINT(nonnull) mod_authenticate(rlm_rcode_t *p_result, module_ctx_t const *mctx, request_t *request)
1086{
1088 fr_pair_t *known_good;
1090 pap_auth_func_t auth_func;
1091 bool ephemeral;
1092 pap_call_env_t *env_data = talloc_get_type_abort(mctx->env_data, pap_call_env_t);
1093
1094 if (env_data->password.type != FR_TYPE_STRING) {
1095 REDEBUG("You set 'Auth-Type = PAP' for a request that does not contain a %s attribute!",
1096 env_data->password_tmpl->name);
1098 }
1099
1100 /*
1101 * The user MUST supply a non-zero-length password.
1102 */
1103 if (env_data->password.vb_length == 0) {
1104 REDEBUG("Password must not be empty");
1106 }
1107
1108 if (RDEBUG_ENABLED3) {
1109 RDEBUG3("Login attempt with %s = %pV (%zd)", env_data->password_tmpl->name,
1110 &env_data->password, env_data->password.vb_length);
1111 } else {
1112 RDEBUG2("Login attempt with password");
1113 }
1114
1115 /*
1116 * Retrieve the normalised version of
1117 * the known_good password, without
1118 * mangling the current password attributes
1119 * in the request.
1120 */
1121 known_good = password_find(&ephemeral, request, request,
1122 pap_alloweds, talloc_array_length(pap_alloweds),
1123 inst->normify);
1124 if (!known_good) {
1125 REDEBUG("No \"known good\" password found for user");
1127 }
1128
1129 fr_assert(known_good->da->attr < NUM_ELEMENTS(auth_func_table));
1130
1131 auth_func = auth_func_table[known_good->da->attr];
1132 fr_assert(auth_func);
1133
1134 if (RDEBUG_ENABLED3) {
1135 RDEBUG3("Comparing with \"known good\" %pP (%zu)", known_good, known_good->vp_length);
1136 } else {
1137 RDEBUG2("Comparing with \"known-good\" %s (%zu)", known_good->da->name, known_good->vp_length);
1138 }
1139
1140 /*
1141 * Authenticate, and return.
1142 */
1143 auth_func(&rcode, inst, request, known_good, &env_data->password);
1144 if (ephemeral) TALLOC_FREE(known_good);
1145 switch (rcode) {
1146 case RLM_MODULE_REJECT:
1147 REDEBUG("Password incorrect");
1148 break;
1149
1150 case RLM_MODULE_OK:
1151 RDEBUG2("User authenticated successfully");
1152 break;
1153
1154 default:
1155 break;
1156 }
1157
1158 RETURN_MODULE_RCODE(rcode);
1159}
1160
1161static int mod_instantiate(module_inst_ctx_t const *mctx)
1162{
1163 rlm_pap_t *inst = talloc_get_type_abort(mctx->mi->data, rlm_pap_t);
1164
1165 inst->auth_type = fr_dict_enum_by_name(attr_auth_type, mctx->mi->name, -1);
1166 if (!inst->auth_type) {
1167 WARN("Failed to find 'authenticate %s {...}' section. PAP will likely not work",
1168 mctx->mi->name);
1169 }
1170
1171 return 0;
1172}
1173
1174static int mod_load(void)
1175{
1176 size_t i, j = 0;
1177 size_t allowed = 0;
1178
1179 /*
1180 * Load the dictionaries early
1181 */
1182 if (fr_dict_autoload(rlm_pap_dict) < 0) {
1183 PERROR("%s", __FUNCTION__);
1184 return -1;
1185 }
1187 PERROR("%s", __FUNCTION__);
1189 return -1;
1190 }
1191
1192 /*
1193 * Figure out how many password types we allow
1194 */
1195 for (i = 0; i < NUM_ELEMENTS(auth_func_table); i++) {
1196 if (auth_func_table[i] == NULL) continue;
1197
1198 allowed++;
1199 }
1200
1201 /*
1202 * Get a list of the DAs that match are allowed
1203 * functions.
1204 */
1205 pap_alloweds = talloc_array(NULL, fr_dict_attr_t const *, allowed);
1206 for (i = 0; i < NUM_ELEMENTS(auth_func_table); i++) {
1207 fr_dict_attr_t const *password_da;
1208
1209 if (auth_func_table[i] == NULL) continue;
1210
1211 password_da = fr_dict_attr_child_by_num(attr_root, i);
1212 if (!fr_cond_assert(password_da)) {
1213 ERROR("Could not resolve password attribute %zu", i);
1216 return -1;
1217 }
1218
1219 pap_alloweds[j++] = password_da;
1220 }
1221
1222 return 0;
1223}
1224
1225static void mod_unload(void)
1226{
1229}
1230
1231/*
1232 * The module name should be the only globally exported symbol.
1233 * That is, everything else should be 'static'.
1234 *
1235 * If the module needs to temporarily modify it's instantiation
1236 * data, the type should be changed to MODULE_TYPE_THREAD_UNSAFE.
1237 * The server will then take care of ensuring that the module
1238 * is single-threaded.
1239 */
1240extern module_rlm_t rlm_pap;
1242 .common = {
1243 .magic = MODULE_MAGIC_INIT,
1244 .name = "pap",
1245 .inst_size = sizeof(rlm_pap_t),
1246 .onload = mod_load,
1247 .unload = mod_unload,
1250 },
1251 .method_group = {
1252 .bindings = (module_method_binding_t[]){
1253 /*
1254 * Hack to support old configurations
1255 */
1256 { .section = SECTION_NAME("authenticate", CF_IDENT_ANY), .method = mod_authenticate, .method_env = &pap_method_env },
1257 { .section = SECTION_NAME("authorize", CF_IDENT_ANY), .method = mod_authorize, .method_env = &pap_method_env },
1258 { .section = SECTION_NAME(CF_IDENT_ANY, CF_IDENT_ANY), .method = mod_authorize, .method_env = &pap_method_env },
1259
1261 }
1262 }
1263};
unlang_action_t
Returned by unlang_op_t calls, determine the next action of the interpreter.
Definition action.h:35
#define fr_base16_decode(_err, _out, _in, _no_trailing)
Definition base16.h:95
#define fr_base64_decode(_out, _in, _expect_padding, _no_trailing)
Definition base64.h:81
#define FR_BASE64_DEC_LENGTH(_inlen)
Definition base64.h:44
#define USES_APPLE_DEPRECATED_API
Definition build.h:472
#define RCSID(id)
Definition build.h:485
#define L(_str)
Helper for initialising arrays of string literals.
Definition build.h:209
#define UNUSED
Definition build.h:317
#define NUM_ELEMENTS(_t)
Definition build.h:339
#define CALL_ENV_TERMINATOR
Definition call_env.h:236
#define FR_CALL_ENV_PARSE_OFFSET(_name, _cast_type, _flags, _struct, _field, _parse_field)
Specify a call_env_parser_t which writes out runtime results and the result of the parsing phase to t...
Definition call_env.h:365
size_t inst_size
Size of per call env.
Definition call_env.h:245
@ CALL_ENV_FLAG_ATTRIBUTE
Tmpl MUST contain an attribute reference.
Definition call_env.h:86
@ CALL_ENV_FLAG_REQUIRED
Associated conf pair or section is required.
Definition call_env.h:75
@ CALL_ENV_FLAG_NULLABLE
Tmpl expansions are allowed to produce no output.
Definition call_env.h:80
Per method call config.
Definition call_env.h:180
#define CONF_PARSER_TERMINATOR
Definition cf_parse.h:658
#define FR_CONF_OFFSET(_name, _struct, _field)
conf_parser_t which parses a single CONF_PAIR, writing the result to a field in a struct
Definition cf_parse.h:284
Defines a CONF_PAIR to C data type mapping.
Definition cf_parse.h:595
#define CF_IDENT_ANY
Definition cf_util.h:78
#define fr_dbuff_start(_dbuff_or_marker)
Return the 'start' position of a dbuff or marker.
Definition dbuff.h:898
#define FR_DBUFF_TMP(_start, _len_or_end)
Creates a compound literal to pass into functions which accept a dbuff.
Definition dbuff.h:514
#define fr_cond_assert(_x)
Calls panic_action ifndef NDEBUG, else logs error and evaluates to value of _x.
Definition debug.h:139
#define MEM(x)
Definition debug.h:36
#define ERROR(fmt,...)
Definition dhcpclient.c:41
#define fr_dict_autofree(_to_free)
Definition dict.h:869
fr_dict_attr_t const ** out
Where to write a pointer to the resolved fr_dict_attr_t.
Definition dict.h:273
fr_dict_t const ** out
Where to write a pointer to the loaded/resolved fr_dict_t.
Definition dict.h:286
int fr_dict_attr_autoload(fr_dict_attr_autoload_t const *to_load)
Process a dict_attr_autoload element to load/verify a dictionary attribute.
Definition dict_util.c:4134
#define fr_dict_autoload(_to_load)
Definition dict.h:866
fr_dict_attr_t const * fr_dict_attr_child_by_num(fr_dict_attr_t const *parent, unsigned int attr)
Check if a child attribute exists in a parent using an attribute number.
Definition dict_util.c:3331
fr_dict_enum_value_t const * fr_dict_enum_by_name(fr_dict_attr_t const *da, char const *name, ssize_t len)
Definition dict_util.c:3439
Specifies an attribute which must be present for the module to function.
Definition dict.h:272
Specifies a dictionary which must be loaded/loadable for the module to function.
Definition dict.h:285
Value of an enumerated attribute.
Definition dict.h:232
#define MODULE_MAGIC_INIT
Stop people using different module/library/server versions together.
Definition dl_module.h:63
#define PERROR(_fmt,...)
Definition log.h:228
#define RDEBUG_ENABLED3
True if request debug level 1-3 messages are enabled.
Definition log.h:335
#define RDEBUG3(fmt,...)
Definition log.h:343
#define REDEBUG3(fmt,...)
Definition log.h:373
#define REMARKER(_str, _marker_idx, _marker,...)
Output string with error marker, showing where format error occurred.
Definition log.h:498
#define RPEDEBUG(fmt,...)
Definition log.h:376
#define RHEXDUMP2(_data, _len, _fmt,...)
Definition log.h:704
talloc_free(reap)
void fr_md4_calc(uint8_t out[static MD4_DIGEST_LENGTH], uint8_t const *in, size_t inlen)
Calculate the MD4 hash of the contents of a buffer.
Definition md4.c:482
#define MD4_DIGEST_LENGTH
Definition md4.h:25
fr_md5_update_t fr_md5_update
Definition md5.c:442
fr_md5_final_t fr_md5_final
Definition md5.c:443
void fr_md5_ctx_free_from_list(fr_md5_ctx_t **ctx)
Definition md5.c:522
fr_md5_ctx_t * fr_md5_ctx_alloc_from_list(void)
Definition md5.c:477
void fr_md5_ctx_t
Definition md5.h:28
#define MD5_DIGEST_LENGTH
@ FR_TYPE_TLV
Contains nested attributes.
@ FR_TYPE_STRING
String of printable characters.
@ FR_TYPE_UINT32
32 Bit unsigned integer.
unsigned int uint32_t
long int ssize_t
void fr_md5_calc(uint8_t out[static MD5_DIGEST_LENGTH], uint8_t const *in, size_t inlen)
Perform a single digest operation on a single input buffer.
unsigned char uint8_t
unsigned long int size_t
ssize_t fr_utf8_to_ucs2(uint8_t *out, size_t outlen, char const *in, size_t inlen)
Convert UTF8 string to UCS2 encoding.
Definition misc.c:315
int fr_digest_cmp(uint8_t const *a, uint8_t const *b, size_t length)
Do a comparison of two authentication digests by comparing the FULL data.
Definition misc.c:472
void * env_data
Per call environment data.
Definition module_ctx.h:44
module_instance_t const * mi
Instance of the module being instantiated.
Definition module_ctx.h:42
module_instance_t * mi
Instance of the module being instantiated.
Definition module_ctx.h:51
Temporary structure to hold arguments for module calls.
Definition module_ctx.h:41
Temporary structure to hold arguments for instantiation calls.
Definition module_ctx.h:50
bool module_rlm_section_type_set(request_t *request, fr_dict_attr_t const *type_da, fr_dict_enum_value_t const *enumv)
Set the next section type if it's not already set.
Definition module_rlm.c:413
module_t common
Common fields presented by all modules.
Definition module_rlm.h:39
fr_pair_t * fr_pair_find_by_da(fr_pair_list_t const *list, fr_pair_t const *prev, fr_dict_attr_t const *da)
Find the first pair with a matching da.
Definition pair.c:697
static ssize_t normify(normalise_t *action, uint8_t *buffer, size_t bufflen, char const *known_good, size_t len, size_t min_len)
Definition password.c:429
fr_pair_t * password_find(bool *ephemeral, TALLOC_CTX *ctx, request_t *request, fr_dict_attr_t const *allowed_attrs[], size_t allowed_attrs_len, bool normify)
Find a "known good" password in the control list of a request.
Definition password.c:983
static const conf_parser_t config[]
Definition base.c:183
#define fr_assert(_expr)
Definition rad_assert.h:38
#define REDEBUG(fmt,...)
Definition radclient.h:52
#define RDEBUG2(fmt,...)
Definition radclient.h:54
#define WARN(fmt,...)
Definition radclient.h:47
#define RETURN_MODULE_REJECT
Definition rcode.h:56
#define RETURN_MODULE_NOOP
Definition rcode.h:63
#define RETURN_MODULE_RCODE(_rcode)
Definition rcode.h:66
#define RETURN_MODULE_INVALID
Definition rcode.h:60
#define RETURN_MODULE_OK
Definition rcode.h:58
#define RETURN_MODULE_FAIL
Definition rcode.h:57
#define RETURN_MODULE_UPDATED
Definition rcode.h:64
rlm_rcode_t
Return codes indicating the result of the module call.
Definition rcode.h:40
@ RLM_MODULE_INVALID
The module considers the request invalid.
Definition rcode.h:45
@ RLM_MODULE_OK
The module is OK, continue.
Definition rcode.h:43
@ RLM_MODULE_REJECT
Immediately reject the request.
Definition rcode.h:41
static const pap_auth_func_t auth_func_table[]
Table of password types we can process.
Definition rlm_pap.c:1041
static unlang_action_t pap_auth_dummy(rlm_rcode_t *p_result, UNUSED rlm_pap_t const *inst, UNUSED request_t *request, UNUSED fr_pair_t const *known_good, UNUSED fr_value_box_t const *password)
Auth func for password types that should have been normalised away.
Definition rlm_pap.c:1031
static int mod_load(void)
Definition rlm_pap.c:1174
static fr_dict_attr_autoload_t rlm_pap_dict_attr[]
Definition rlm_pap.c:111
static unlang_action_t pap_auth_md5(rlm_rcode_t *p_result, UNUSED rlm_pap_t const *inst, request_t *request, fr_pair_t const *known_good, fr_value_box_t const *password)
Definition rlm_pap.c:233
static unlang_action_t pap_auth_clear(rlm_rcode_t *p_result, UNUSED rlm_pap_t const *inst, request_t *request, fr_pair_t const *known_good, fr_value_box_t const *password)
Definition rlm_pap.c:178
static unlang_action_t pap_auth_smd5(rlm_rcode_t *p_result, UNUSED rlm_pap_t const *inst, request_t *request, fr_pair_t const *known_good, fr_value_box_t const *password)
Definition rlm_pap.c:258
static fr_dict_t const * dict_freeradius
Definition rlm_pap.c:101
module_rlm_t rlm_pap
Definition rlm_pap.c:1241
fr_value_box_t password
Definition rlm_pap.c:86
static const call_env_method_t pap_method_env
Definition rlm_pap.c:90
fr_dict_enum_value_t const * auth_type
Definition rlm_pap.c:74
static unlang_action_t pap_auth_nt(rlm_rcode_t *p_result, UNUSED rlm_pap_t const *inst, request_t *request, fr_pair_t const *known_good, fr_value_box_t const *password)
Definition rlm_pap.c:932
static fr_dict_autoload_t rlm_pap_dict[]
Definition rlm_pap.c:103
static unlang_action_t pap_auth_ns_mta_md5(rlm_rcode_t *p_result, UNUSED rlm_pap_t const *inst, request_t *request, fr_pair_t const *known_good, fr_value_box_t const *password)
Definition rlm_pap.c:966
static unlang_action_t mod_authenticate(rlm_rcode_t *p_result, module_ctx_t const *mctx, request_t *request)
Definition rlm_pap.c:1085
static fr_dict_attr_t const * attr_auth_type
Definition rlm_pap.c:108
static unlang_action_t pap_auth_sha1(rlm_rcode_t *p_result, UNUSED rlm_pap_t const *inst, request_t *request, fr_pair_t const *known_good, fr_value_box_t const *password)
Definition rlm_pap.c:290
static void mod_unload(void)
Definition rlm_pap.c:1225
static unlang_action_t pap_auth_ssha1(rlm_rcode_t *p_result, UNUSED rlm_pap_t const *inst, request_t *request, fr_pair_t const *known_good, fr_value_box_t const *password)
Definition rlm_pap.c:317
static unlang_action_t mod_authorize(rlm_rcode_t *p_result, module_ctx_t const *mctx, request_t *request)
Definition rlm_pap.c:148
static fr_dict_attr_t const * attr_root
Definition rlm_pap.c:109
static fr_dict_attr_t const ** pap_alloweds
Definition rlm_pap.c:140
static USES_APPLE_DEPRECATED_API pthread_mutex_t fr_crypt_mutex
Definition rlm_pap.c:63
static const conf_parser_t module_config[]
Definition rlm_pap.c:80
bool normify
Definition rlm_pap.c:75
unlang_action_t(* pap_auth_func_t)(rlm_rcode_t *p_result, rlm_pap_t const *inst, request_t *request, fr_pair_t const *, fr_value_box_t const *)
Definition rlm_pap.c:78
tmpl_t * password_tmpl
Definition rlm_pap.c:87
static int mod_instantiate(module_inst_ctx_t const *mctx)
Definition rlm_pap.c:1161
static unsigned int hash(char const *username, unsigned int tablesize)
Definition rlm_passwd.c:132
static char const * name
static int instantiate(module_inst_ctx_t const *mctx)
Definition rlm_rest.c:1313
#define FR_SBUFF_IN(_start, _len_or_end)
#define SECTION_NAME(_name1, _name2)
Define a section name consisting of a verb and a noun.
Definition section.h:40
char const * name
Instance name e.g. user_database.
Definition module.h:336
size_t inst_size
Size of the module's instance data.
Definition module.h:204
void * data
Module's instance data.
Definition module.h:272
#define MODULE_BINDING_TERMINATOR
Terminate a module binding list.
Definition module.h:151
Named methods exported by a module.
Definition module.h:173
void fr_sha1_init(fr_sha1_ctx *context)
Definition sha1.c:93
void fr_sha1_final(uint8_t digest[static SHA1_DIGEST_LENGTH], fr_sha1_ctx *context)
Definition sha1.c:141
void fr_sha1_update(fr_sha1_ctx *context, uint8_t const *in, size_t len)
Definition sha1.c:105
#define SHA1_DIGEST_LENGTH
Definition sha1.h:29
static char buff[sizeof("18446744073709551615")+3]
Definition size_tests.c:41
eap_aka_sim_process_conf_t * inst
size_t strlcpy(char *dst, char const *src, size_t siz)
Definition strlcpy.c:34
Stores an attribute, a value and various bits of other data.
Definition pair.h:68
fr_dict_attr_t const *_CONST da
Dictionary attribute defines the attribute number, vendor and type of the pair.
Definition pair.h:69
#define fr_table_str_by_value(_table, _number, _def)
Convert an integer to a string.
Definition table.h:772
#define fr_table_value_by_substr(_table, _name, _name_len, _def)
Convert a partial string to a value using an ordered or sorted table.
Definition table.h:693
An element in a lexicographically sorted array of name to num mappings.
Definition table.h:49
#define talloc_get_type_abort_const
Definition talloc.h:287
@ T_BARE_WORD
Definition token.h:120
void fr_strerror_clear(void)
Clears all pending messages from the talloc pools.
Definition strerror.c:576
#define FR_MAX_STRING_LEN
Definition value.h:30
int nonnull(2, 5))
#define fr_box_octets(_val, _len)
Definition value.h:307