xref: /netbsd-src/crypto/external/bsd/heimdal/dist/lib/krb5/changepw.c (revision 241bea01a19bbb306af27777a870b86d41cb3fda)
1 /*	$NetBSD: changepw.c,v 1.3 2019/12/15 22:50:50 christos Exp $	*/
2 
3 /*
4  * Copyright (c) 1997 - 2005 Kungliga Tekniska Högskolan
5  * (Royal Institute of Technology, Stockholm, Sweden).
6  * All rights reserved.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  *
12  * 1. Redistributions of source code must retain the above copyright
13  *    notice, this list of conditions and the following disclaimer.
14  *
15  * 2. Redistributions in binary form must reproduce the above copyright
16  *    notice, this list of conditions and the following disclaimer in the
17  *    documentation and/or other materials provided with the distribution.
18  *
19  * 3. Neither the name of the Institute nor the names of its contributors
20  *    may be used to endorse or promote products derived from this software
21  *    without specific prior written permission.
22  *
23  * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
24  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26  * ARE DISCLAIMED.  IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
27  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33  * SUCH DAMAGE.
34  */
35 
36 #include "krb5_locl.h"
37 
38 #undef __attribute__
39 #define __attribute__(X)
40 
41 
42 static void
43 str2data (krb5_data *d,
44 	  const char *fmt,
45 	  ...) __attribute__ ((__format__ (__printf__, 2, 3)));
46 
47 static void
str2data(krb5_data * d,const char * fmt,...)48 str2data (krb5_data *d,
49 	  const char *fmt,
50 	  ...)
51 {
52     va_list args;
53     char *str;
54 
55     va_start(args, fmt);
56     d->length = vasprintf (&str, fmt, args);
57     va_end(args);
58     d->data = str;
59 }
60 
61 /*
62  * Change password protocol defined by
63  * draft-ietf-cat-kerb-chg-password-02.txt
64  *
65  * Share the response part of the protocol with MS set password
66  * (RFC3244)
67  */
68 
69 static krb5_error_code
chgpw_send_request(krb5_context context,krb5_auth_context * auth_context,krb5_creds * creds,krb5_principal targprinc,int is_stream,rk_socket_t sock,const char * passwd,const char * host)70 chgpw_send_request (krb5_context context,
71 		    krb5_auth_context *auth_context,
72 		    krb5_creds *creds,
73 		    krb5_principal targprinc,
74 		    int is_stream,
75 		    rk_socket_t sock,
76 		    const char *passwd,
77 		    const char *host)
78 {
79     krb5_error_code ret;
80     krb5_data ap_req_data;
81     krb5_data krb_priv_data;
82     krb5_data passwd_data;
83     size_t len;
84     u_char header[6];
85     struct iovec iov[3];
86     struct msghdr msghdr;
87 
88     if (is_stream)
89 	return KRB5_KPASSWD_MALFORMED;
90 
91     if (targprinc &&
92 	krb5_principal_compare(context, creds->client, targprinc) != TRUE)
93 	return KRB5_KPASSWD_MALFORMED;
94 
95     krb5_data_zero (&ap_req_data);
96 
97     ret = krb5_mk_req_extended (context,
98 				auth_context,
99 				AP_OPTS_MUTUAL_REQUIRED | AP_OPTS_USE_SUBKEY,
100 				NULL, /* in_data */
101 				creds,
102 				&ap_req_data);
103     if (ret)
104 	return ret;
105 
106     passwd_data.data   = rk_UNCONST(passwd);
107     passwd_data.length = strlen(passwd);
108 
109     krb5_data_zero (&krb_priv_data);
110 
111     ret = krb5_mk_priv (context,
112 			*auth_context,
113 			&passwd_data,
114 			&krb_priv_data,
115 			NULL);
116     if (ret)
117 	goto out2;
118 
119     len = 6 + ap_req_data.length + krb_priv_data.length;
120     header[0] = (len >> 8) & 0xFF;
121     header[1] = (len >> 0) & 0xFF;
122     header[2] = 0;
123     header[3] = 1;
124     header[4] = (ap_req_data.length >> 8) & 0xFF;
125     header[5] = (ap_req_data.length >> 0) & 0xFF;
126 
127     memset(&msghdr, 0, sizeof(msghdr));
128     msghdr.msg_name       = NULL;
129     msghdr.msg_namelen    = 0;
130     msghdr.msg_iov        = iov;
131     msghdr.msg_iovlen     = sizeof(iov)/sizeof(*iov);
132 #if 0
133     msghdr.msg_control    = NULL;
134     msghdr.msg_controllen = 0;
135 #endif
136 
137     iov[0].iov_base    = (void*)header;
138     iov[0].iov_len     = 6;
139     iov[1].iov_base    = ap_req_data.data;
140     iov[1].iov_len     = ap_req_data.length;
141     iov[2].iov_base    = krb_priv_data.data;
142     iov[2].iov_len     = krb_priv_data.length;
143 
144     if (rk_IS_SOCKET_ERROR( sendmsg (sock, &msghdr, 0) )) {
145 	ret = rk_SOCK_ERRNO;
146 	krb5_set_error_message(context, ret, "sendmsg %s: %s",
147 			       host, strerror(ret));
148     }
149 
150     krb5_data_free (&krb_priv_data);
151 out2:
152     krb5_data_free (&ap_req_data);
153     return ret;
154 }
155 
156 /*
157  * Set password protocol as defined by RFC3244 --
158  * Microsoft Windows 2000 Kerberos Change Password and Set Password Protocols
159  */
160 
161 static krb5_error_code
setpw_send_request(krb5_context context,krb5_auth_context * auth_context,krb5_creds * creds,krb5_principal targprinc,int is_stream,rk_socket_t sock,const char * passwd,const char * host)162 setpw_send_request (krb5_context context,
163 		    krb5_auth_context *auth_context,
164 		    krb5_creds *creds,
165 		    krb5_principal targprinc,
166 		    int is_stream,
167 		    rk_socket_t sock,
168 		    const char *passwd,
169 		    const char *host)
170 {
171     krb5_error_code ret;
172     krb5_data ap_req_data;
173     krb5_data krb_priv_data;
174     krb5_data pwd_data;
175     ChangePasswdDataMS chpw;
176     size_t len = 0;
177     u_char header[4 + 6];
178     u_char *p;
179     struct iovec iov[3];
180     struct msghdr msghdr;
181 
182     krb5_data_zero (&ap_req_data);
183 
184     ret = krb5_mk_req_extended (context,
185 				auth_context,
186 				AP_OPTS_MUTUAL_REQUIRED | AP_OPTS_USE_SUBKEY,
187 				NULL, /* in_data */
188 				creds,
189 				&ap_req_data);
190     if (ret)
191 	return ret;
192 
193     chpw.newpasswd.length = strlen(passwd);
194     chpw.newpasswd.data = rk_UNCONST(passwd);
195     if (targprinc) {
196 	chpw.targname = &targprinc->name;
197 	chpw.targrealm = &targprinc->realm;
198     } else {
199 	chpw.targname = NULL;
200 	chpw.targrealm = NULL;
201     }
202 
203     ASN1_MALLOC_ENCODE(ChangePasswdDataMS, pwd_data.data, pwd_data.length,
204 		       &chpw, &len, ret);
205     if (ret) {
206 	krb5_data_free (&ap_req_data);
207 	return ret;
208     }
209 
210     if(pwd_data.length != len)
211 	krb5_abortx(context, "internal error in ASN.1 encoder");
212 
213     ret = krb5_mk_priv (context,
214 			*auth_context,
215 			&pwd_data,
216 			&krb_priv_data,
217 			NULL);
218     if (ret)
219 	goto out2;
220 
221     len = 6 + ap_req_data.length + krb_priv_data.length;
222     p = header;
223     if (is_stream) {
224 	_krb5_put_int(p, len, 4);
225 	p += 4;
226     }
227     *p++ = (len >> 8) & 0xFF;
228     *p++ = (len >> 0) & 0xFF;
229     *p++ = 0xff;
230     *p++ = 0x80;
231     *p++ = (ap_req_data.length >> 8) & 0xFF;
232     *p   = (ap_req_data.length >> 0) & 0xFF;
233 
234     memset(&msghdr, 0, sizeof(msghdr));
235     msghdr.msg_name       = NULL;
236     msghdr.msg_namelen    = 0;
237     msghdr.msg_iov        = iov;
238     msghdr.msg_iovlen     = sizeof(iov)/sizeof(*iov);
239 #if 0
240     msghdr.msg_control    = NULL;
241     msghdr.msg_controllen = 0;
242 #endif
243 
244     iov[0].iov_base    = (void*)header;
245     if (is_stream)
246 	iov[0].iov_len     = 10;
247     else
248 	iov[0].iov_len     = 6;
249     iov[1].iov_base    = ap_req_data.data;
250     iov[1].iov_len     = ap_req_data.length;
251     iov[2].iov_base    = krb_priv_data.data;
252     iov[2].iov_len     = krb_priv_data.length;
253 
254     if (rk_IS_SOCKET_ERROR( sendmsg (sock, &msghdr, 0) )) {
255 	ret = rk_SOCK_ERRNO;
256 	krb5_set_error_message(context, ret, "sendmsg %s: %s",
257 			       host, strerror(ret));
258     }
259 
260     krb5_data_free (&krb_priv_data);
261 out2:
262     krb5_data_free (&ap_req_data);
263     krb5_data_free (&pwd_data);
264     return ret;
265 }
266 
267 static krb5_error_code
process_reply(krb5_context context,krb5_auth_context auth_context,int is_stream,rk_socket_t sock,int * result_code,krb5_data * result_code_string,krb5_data * result_string,const char * host)268 process_reply (krb5_context context,
269 	       krb5_auth_context auth_context,
270 	       int is_stream,
271 	       rk_socket_t sock,
272 	       int *result_code,
273 	       krb5_data *result_code_string,
274 	       krb5_data *result_string,
275 	       const char *host)
276 {
277     krb5_error_code ret;
278     u_char reply[1024 * 3];
279     size_t len;
280     uint16_t pkt_len, pkt_ver;
281     krb5_data ap_rep_data;
282     int save_errno;
283 
284     len = 0;
285     if (is_stream) {
286 	while (len < sizeof(reply)) {
287 	    unsigned long size;
288 
289 	    ret = recvfrom (sock, reply + len, sizeof(reply) - len,
290 			    0, NULL, NULL);
291 	    if (rk_IS_SOCKET_ERROR(ret)) {
292 		save_errno = rk_SOCK_ERRNO;
293 		krb5_set_error_message(context, save_errno,
294 				       "recvfrom %s: %s",
295 				       host, strerror(save_errno));
296 		return save_errno;
297 	    } else if (ret == 0) {
298 		krb5_set_error_message(context, 1,"recvfrom timeout %s", host);
299 		return 1;
300 	    }
301 	    len += ret;
302 	    if (len < 4)
303 		continue;
304 	    _krb5_get_int(reply, &size, 4);
305 	    if (size + 4 < len)
306 		continue;
307 	    if (sizeof(reply) - 4 < size) {
308 		krb5_set_error_message(context, ERANGE, "size from server too large %s", host);
309 		return ERANGE;
310 	    }
311 	    memmove(reply, reply + 4, size);
312 	    len = size;
313 	    break;
314 	}
315 	if (len == sizeof(reply)) {
316 	    krb5_set_error_message(context, ENOMEM,
317 				   N_("Message too large from %s", "host"),
318 				   host);
319 	    return ENOMEM;
320 	}
321     } else {
322 	ret = recvfrom (sock, reply, sizeof(reply), 0, NULL, NULL);
323 	if (rk_IS_SOCKET_ERROR(ret)) {
324 	    save_errno = rk_SOCK_ERRNO;
325 	    krb5_set_error_message(context, save_errno,
326 				   "recvfrom %s: %s",
327 				   host, strerror(save_errno));
328 	    return save_errno;
329 	}
330 	len = ret;
331     }
332 
333     if (len < 6) {
334 	str2data (result_string, "server %s sent to too short message "
335 		  "(%llu bytes)", host, (unsigned long long)len);
336 	*result_code = KRB5_KPASSWD_MALFORMED;
337 	return 0;
338     }
339 
340     pkt_len = (reply[0] << 8) | (reply[1]);
341     pkt_ver = (reply[2] << 8) | (reply[3]);
342 
343     if ((pkt_len != len) || (reply[1] == 0x7e || reply[1] == 0x5e)) {
344 	KRB_ERROR error;
345 	size_t size;
346 	u_char *p;
347 
348 	memset(&error, 0, sizeof(error));
349 
350 	ret = decode_KRB_ERROR(reply, len, &error, &size);
351 	if (ret)
352 	    return ret;
353 
354 	if (error.e_data->length < 2) {
355 	    str2data(result_string, "server %s sent too short "
356 		     "e_data to print anything usable", host);
357 	    free_KRB_ERROR(&error);
358 	    *result_code = KRB5_KPASSWD_MALFORMED;
359 	    return 0;
360 	}
361 
362 	p = error.e_data->data;
363 	*result_code = (p[0] << 8) | p[1];
364 	if (error.e_data->length == 2)
365 	    str2data(result_string, "server only sent error code");
366 	else
367 	    krb5_data_copy (result_string,
368 			    p + 2,
369 			    error.e_data->length - 2);
370 	free_KRB_ERROR(&error);
371 	return 0;
372     }
373 
374     if (pkt_len != len) {
375 	str2data (result_string, "client: wrong len in reply");
376 	*result_code = KRB5_KPASSWD_MALFORMED;
377 	return 0;
378     }
379     if (pkt_ver != KRB5_KPASSWD_VERS_CHANGEPW) {
380 	str2data (result_string,
381 		  "client: wrong version number (%d)", pkt_ver);
382 	*result_code = KRB5_KPASSWD_MALFORMED;
383 	return 0;
384     }
385 
386     ap_rep_data.data = reply + 6;
387     ap_rep_data.length  = (reply[4] << 8) | (reply[5]);
388 
389     if (reply + len < (u_char *)ap_rep_data.data + ap_rep_data.length) {
390 	str2data (result_string, "client: wrong AP len in reply");
391 	*result_code = KRB5_KPASSWD_MALFORMED;
392 	return 0;
393     }
394 
395     if (ap_rep_data.length) {
396 	krb5_ap_rep_enc_part *ap_rep;
397 	krb5_data priv_data;
398 	u_char *p;
399 
400 	priv_data.data   = (u_char*)ap_rep_data.data + ap_rep_data.length;
401 	priv_data.length = len - ap_rep_data.length - 6;
402 
403 	ret = krb5_rd_rep (context,
404 			   auth_context,
405 			   &ap_rep_data,
406 			   &ap_rep);
407 	if (ret)
408 	    return ret;
409 
410 	krb5_free_ap_rep_enc_part (context, ap_rep);
411 
412 	ret = krb5_rd_priv (context,
413 			    auth_context,
414 			    &priv_data,
415 			    result_code_string,
416 			    NULL);
417 	if (ret) {
418 	    krb5_data_free (result_code_string);
419 	    return ret;
420 	}
421 
422 	if (result_code_string->length < 2) {
423 	    *result_code = KRB5_KPASSWD_MALFORMED;
424 	    str2data (result_string,
425 		      "client: bad length in result");
426 	    return 0;
427 	}
428 
429         p = result_code_string->data;
430 
431         *result_code = (p[0] << 8) | p[1];
432         krb5_data_copy (result_string,
433                         (unsigned char*)result_code_string->data + 2,
434                         result_code_string->length - 2);
435         return 0;
436     } else {
437 	KRB_ERROR error;
438 	size_t size;
439 	u_char *p;
440 
441 	ret = decode_KRB_ERROR(reply + 6, len - 6, &error, &size);
442 	if (ret) {
443 	    return ret;
444 	}
445 	if (error.e_data->length < 2) {
446 	    krb5_warnx (context, "too short e_data to print anything usable");
447 	    return 1;		/* XXX */
448 	}
449 
450 	p = error.e_data->data;
451 	*result_code = (p[0] << 8) | p[1];
452 	krb5_data_copy (result_string,
453 			p + 2,
454 			error.e_data->length - 2);
455 	return 0;
456     }
457 }
458 
459 
460 /*
461  * change the password using the credentials in `creds' (for the
462  * principal indicated in them) to `newpw', storing the result of
463  * the operation in `result_*' and an error code or 0.
464  */
465 
466 typedef krb5_error_code (*kpwd_send_request) (krb5_context,
467 					      krb5_auth_context *,
468 					      krb5_creds *,
469 					      krb5_principal,
470 					      int,
471 					      rk_socket_t,
472 					      const char *,
473 					      const char *);
474 typedef krb5_error_code (*kpwd_process_reply) (krb5_context,
475 					       krb5_auth_context,
476 					       int,
477 					       rk_socket_t,
478 					       int *,
479 					       krb5_data *,
480 					       krb5_data *,
481 					       const char *);
482 
483 static struct kpwd_proc {
484     const char *name;
485     int flags;
486 #define SUPPORT_TCP	1
487 #define SUPPORT_UDP	2
488     kpwd_send_request send_req;
489     kpwd_process_reply process_rep;
490 } procs[] = {
491     {
492 	"MS set password",
493 	SUPPORT_TCP|SUPPORT_UDP,
494 	setpw_send_request,
495 	process_reply
496     },
497     {
498 	"change password",
499 	SUPPORT_UDP,
500 	chgpw_send_request,
501 	process_reply
502     },
503     { NULL, 0, NULL, NULL }
504 };
505 
506 /*
507  *
508  */
509 
510 static krb5_error_code
change_password_loop(krb5_context context,krb5_creds * creds,krb5_principal targprinc,const char * newpw,int * result_code,krb5_data * result_code_string,krb5_data * result_string,struct kpwd_proc * proc)511 change_password_loop (krb5_context	context,
512 		      krb5_creds	*creds,
513 		      krb5_principal	targprinc,
514 		      const char	*newpw,
515 		      int		*result_code,
516 		      krb5_data		*result_code_string,
517 		      krb5_data		*result_string,
518 		      struct kpwd_proc	*proc)
519 {
520     krb5_error_code ret;
521     krb5_auth_context auth_context = NULL;
522     krb5_krbhst_handle handle = NULL;
523     krb5_krbhst_info *hi;
524     rk_socket_t sock;
525     unsigned int i;
526     int done = 0;
527     krb5_realm realm;
528 
529     if (targprinc)
530 	realm = targprinc->realm;
531     else
532 	realm = creds->client->realm;
533 
534     ret = krb5_auth_con_init (context, &auth_context);
535     if (ret)
536 	return ret;
537 
538     krb5_auth_con_setflags (context, auth_context,
539 			    KRB5_AUTH_CONTEXT_DO_SEQUENCE);
540 
541     ret = krb5_krbhst_init (context, realm, KRB5_KRBHST_CHANGEPW, &handle);
542     if (ret)
543 	goto out;
544 
545     while (!done && (ret = krb5_krbhst_next(context, handle, &hi)) == 0) {
546 	struct addrinfo *ai, *a;
547 	int is_stream;
548 
549 	switch (hi->proto) {
550 	case KRB5_KRBHST_UDP:
551 	    if ((proc->flags & SUPPORT_UDP) == 0)
552 		continue;
553 	    is_stream = 0;
554 	    break;
555 	case KRB5_KRBHST_TCP:
556 	    if ((proc->flags & SUPPORT_TCP) == 0)
557 		continue;
558 	    is_stream = 1;
559 	    break;
560 	default:
561 	    continue;
562 	}
563 
564 	ret = krb5_krbhst_get_addrinfo(context, hi, &ai);
565 	if (ret)
566 	    continue;
567 
568 	for (a = ai; !done && a != NULL; a = a->ai_next) {
569 	    int replied = 0;
570 
571 	    sock = socket (a->ai_family, a->ai_socktype | SOCK_CLOEXEC, a->ai_protocol);
572 	    if (rk_IS_BAD_SOCKET(sock))
573 		continue;
574 	    rk_cloexec(sock);
575 
576 	    ret = connect(sock, a->ai_addr, a->ai_addrlen);
577 	    if (rk_IS_SOCKET_ERROR(ret)) {
578 		rk_closesocket (sock);
579 		goto out;
580 	    }
581 
582 	    ret = krb5_auth_con_genaddrs (context, auth_context, sock,
583 					  KRB5_AUTH_CONTEXT_GENERATE_LOCAL_ADDR);
584 	    if (ret) {
585 		rk_closesocket (sock);
586 		goto out;
587 	    }
588 
589 	    for (i = 0; !done && i < 5; ++i) {
590 		fd_set fdset;
591 		struct timeval tv;
592 
593 		if (!replied) {
594 		    replied = 0;
595 
596 		    ret = (*proc->send_req) (context,
597 					     &auth_context,
598 					     creds,
599 					     targprinc,
600 					     is_stream,
601 					     sock,
602 					     newpw,
603 					     hi->hostname);
604 		    if (ret) {
605 			rk_closesocket(sock);
606 			goto out;
607 		    }
608 		}
609 
610 #ifndef NO_LIMIT_FD_SETSIZE
611 		if (sock >= FD_SETSIZE) {
612 		    ret = ERANGE;
613 		    krb5_set_error_message(context, ret,
614 					   "fd %d too large", sock);
615 		    rk_closesocket (sock);
616 		    goto out;
617 		}
618 #endif
619 
620 		FD_ZERO(&fdset);
621 		FD_SET(sock, &fdset);
622 		tv.tv_usec = 0;
623 		tv.tv_sec  = 1 + (1 << i);
624 
625 		ret = select (sock + 1, &fdset, NULL, NULL, &tv);
626 		if (rk_IS_SOCKET_ERROR(ret) && rk_SOCK_ERRNO != EINTR) {
627 		    rk_closesocket(sock);
628 		    goto out;
629 		}
630 		if (ret == 1) {
631 		    ret = (*proc->process_rep) (context,
632 						auth_context,
633 						is_stream,
634 						sock,
635 						result_code,
636 						result_code_string,
637 						result_string,
638 						hi->hostname);
639 		    if (ret == 0)
640 			done = 1;
641 		    else if (i > 0 && ret == KRB5KRB_AP_ERR_MUT_FAIL)
642 			replied = 1;
643 		} else {
644 		    ret = KRB5_KDC_UNREACH;
645 		}
646 	    }
647 	    rk_closesocket (sock);
648 	}
649     }
650 
651  out:
652     krb5_krbhst_free (context, handle);
653     krb5_auth_con_free (context, auth_context);
654 
655     if (ret == KRB5_KDC_UNREACH) {
656 	krb5_set_error_message(context,
657 			       ret,
658 			       N_("Unable to reach any changepw server "
659 				 " in realm %s", "realm"), realm);
660 	*result_code = KRB5_KPASSWD_HARDERROR;
661     }
662     return ret;
663 }
664 
665 #ifndef HEIMDAL_SMALLER
666 
667 static struct kpwd_proc *
find_chpw_proto(const char * name)668 find_chpw_proto(const char *name)
669 {
670     struct kpwd_proc *p;
671     for (p = procs; p->name != NULL; p++) {
672 	if (strcmp(p->name, name) == 0)
673 	    return p;
674     }
675     return NULL;
676 }
677 
678 /**
679  * Deprecated: krb5_change_password() is deprecated, use krb5_set_password().
680  *
681  * @param context a Keberos context
682  * @param creds
683  * @param newpw
684  * @param result_code
685  * @param result_code_string
686  * @param result_string
687  *
688  * @return On sucess password is changed.
689 
690  * @ingroup @krb5_deprecated
691  */
692 
693 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
krb5_change_password(krb5_context context,krb5_creds * creds,const char * newpw,int * result_code,krb5_data * result_code_string,krb5_data * result_string)694 krb5_change_password (krb5_context	context,
695 		      krb5_creds	*creds,
696 		      const char	*newpw,
697 		      int		*result_code,
698 		      krb5_data		*result_code_string,
699 		      krb5_data		*result_string)
700     KRB5_DEPRECATED_FUNCTION("Use X instead")
701 {
702     struct kpwd_proc *p = find_chpw_proto("change password");
703 
704     *result_code = KRB5_KPASSWD_MALFORMED;
705     result_code_string->data = result_string->data = NULL;
706     result_code_string->length = result_string->length = 0;
707 
708     if (p == NULL)
709 	return KRB5_KPASSWD_MALFORMED;
710 
711     return change_password_loop(context, creds, NULL, newpw,
712 				result_code, result_code_string,
713 				result_string, p);
714 }
715 #endif /* HEIMDAL_SMALLER */
716 
717 /**
718  * Change password using creds.
719  *
720  * @param context a Keberos context
721  * @param creds The initial kadmin/passwd for the principal or an admin principal
722  * @param newpw The new password to set
723  * @param targprinc if unset, the default principal is used.
724  * @param result_code Result code, KRB5_KPASSWD_SUCCESS is when password is changed.
725  * @param result_code_string binary message from the server, contains
726  * at least the result_code.
727  * @param result_string A message from the kpasswd service or the
728  * library in human printable form. The string is NUL terminated.
729  *
730  * @return On sucess and *result_code is KRB5_KPASSWD_SUCCESS, the password is changed.
731 
732  * @ingroup @krb5
733  */
734 
735 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
krb5_set_password(krb5_context context,krb5_creds * creds,const char * newpw,krb5_principal targprinc,int * result_code,krb5_data * result_code_string,krb5_data * result_string)736 krb5_set_password(krb5_context context,
737 		  krb5_creds *creds,
738 		  const char *newpw,
739 		  krb5_principal targprinc,
740 		  int *result_code,
741 		  krb5_data *result_code_string,
742 		  krb5_data *result_string)
743 {
744     krb5_principal principal = NULL;
745     krb5_error_code ret = 0;
746     int i;
747 
748     *result_code = KRB5_KPASSWD_MALFORMED;
749     krb5_data_zero(result_code_string);
750     krb5_data_zero(result_string);
751 
752     if (targprinc == NULL) {
753 	ret = krb5_get_default_principal(context, &principal);
754 	if (ret)
755 	    return ret;
756     } else
757 	principal = targprinc;
758 
759     for (i = 0; procs[i].name != NULL; i++) {
760 	*result_code = 0;
761 	ret = change_password_loop(context, creds, principal, newpw,
762 				   result_code, result_code_string,
763 				   result_string,
764 				   &procs[i]);
765 	if (ret == 0 && *result_code == 0)
766 	    break;
767     }
768 
769     if (targprinc == NULL)
770 	krb5_free_principal(context, principal);
771     return ret;
772 }
773 
774 /*
775  *
776  */
777 
778 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
krb5_set_password_using_ccache(krb5_context context,krb5_ccache ccache,const char * newpw,krb5_principal targprinc,int * result_code,krb5_data * result_code_string,krb5_data * result_string)779 krb5_set_password_using_ccache(krb5_context context,
780 			       krb5_ccache ccache,
781 			       const char *newpw,
782 			       krb5_principal targprinc,
783 			       int *result_code,
784 			       krb5_data *result_code_string,
785 			       krb5_data *result_string)
786 {
787     krb5_creds creds, *credsp;
788     krb5_error_code ret;
789     krb5_principal principal = NULL;
790 
791     *result_code = KRB5_KPASSWD_MALFORMED;
792     result_code_string->data = result_string->data = NULL;
793     result_code_string->length = result_string->length = 0;
794 
795     memset(&creds, 0, sizeof(creds));
796 
797     if (targprinc == NULL) {
798 	ret = krb5_cc_get_principal(context, ccache, &principal);
799 	if (ret)
800 	    return ret;
801     } else
802 	principal = targprinc;
803 
804     ret = krb5_make_principal(context, &creds.server,
805 			      krb5_principal_get_realm(context, principal),
806 			      "kadmin", "changepw", NULL);
807     if (ret)
808 	goto out;
809 
810     ret = krb5_cc_get_principal(context, ccache, &creds.client);
811     if (ret) {
812         krb5_free_principal(context, creds.server);
813 	goto out;
814     }
815 
816     ret = krb5_get_credentials(context, 0, ccache, &creds, &credsp);
817     krb5_free_principal(context, creds.server);
818     krb5_free_principal(context, creds.client);
819     if (ret)
820 	goto out;
821 
822     ret = krb5_set_password(context,
823 			    credsp,
824 			    newpw,
825 			    principal,
826 			    result_code,
827 			    result_code_string,
828 			    result_string);
829 
830     krb5_free_creds(context, credsp);
831 
832     return ret;
833  out:
834     if (targprinc == NULL)
835 	krb5_free_principal(context, principal);
836     return ret;
837 }
838 
839 /*
840  *
841  */
842 
843 KRB5_LIB_FUNCTION const char* KRB5_LIB_CALL
krb5_passwd_result_to_string(krb5_context context,int result)844 krb5_passwd_result_to_string (krb5_context context,
845 			      int result)
846 {
847     static const char *strings[] = {
848 	"Success",
849 	"Malformed",
850 	"Hard error",
851 	"Auth error",
852 	"Soft error" ,
853 	"Access denied",
854 	"Bad version",
855 	"Initial flag needed"
856     };
857 
858     if (result < 0 || result > KRB5_KPASSWD_INITIAL_FLAG_NEEDED)
859 	return "unknown result code";
860     else
861 	return strings[result];
862 }
863