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