2 Unix SMB/CIFS implementation.
3 krb5 set password implementation
4 Copyright (C) Andrew Tridgell 2001
5 Copyright (C) Remus Koos 2001 (remuskoos@yahoo.com)
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
26 #define DEFAULT_KPASSWD_PORT 464
28 #define KRB5_KPASSWD_VERS_CHANGEPW 1
30 #define KRB5_KPASSWD_VERS_SETPW 0xff80
31 #define KRB5_KPASSWD_VERS_SETPW_ALT 2
33 #define KRB5_KPASSWD_SUCCESS 0
34 #define KRB5_KPASSWD_MALFORMED 1
35 #define KRB5_KPASSWD_HARDERROR 2
36 #define KRB5_KPASSWD_AUTHERROR 3
37 #define KRB5_KPASSWD_SOFTERROR 4
38 #define KRB5_KPASSWD_ACCESSDENIED 5
39 #define KRB5_KPASSWD_BAD_VERSION 6
40 #define KRB5_KPASSWD_INITIAL_FLAG_NEEDED 7
42 /* Those are defined by kerberos-set-passwd-02.txt and are probably
43 * not supported by M$ implementation */
44 #define KRB5_KPASSWD_POLICY_REJECT 8
45 #define KRB5_KPASSWD_BAD_PRINCIPAL 9
46 #define KRB5_KPASSWD_ETYPE_NOSUPP 10
48 /* This implements kerberos password change protocol as specified in
49 * kerb-chg-password-02.txt and kerberos-set-passwd-02.txt
50 * as well as microsoft version of the protocol
51 * as specified in kerberos-set-passwd-00.txt
53 static DATA_BLOB
encode_krb5_setpw(const char *principal
, const char *password
)
55 char* princ_part1
= NULL
;
56 char* princ_part2
= NULL
;
65 princ
= SMB_STRDUP(principal
);
67 if ((c
= strchr_m(princ
, '/')) == NULL
) {
77 if ((c
= strchr_m(c
, '@')) != NULL
) {
82 /* We must have a realm component. */
83 return data_blob(NULL
, 0);
86 memset(&req
, 0, sizeof(req
));
88 asn1_push_tag(&req
, ASN1_SEQUENCE(0));
89 asn1_push_tag(&req
, ASN1_CONTEXT(0));
90 asn1_write_OctetString(&req
, password
, strlen(password
));
93 asn1_push_tag(&req
, ASN1_CONTEXT(1));
94 asn1_push_tag(&req
, ASN1_SEQUENCE(0));
96 asn1_push_tag(&req
, ASN1_CONTEXT(0));
97 asn1_write_Integer(&req
, 1);
100 asn1_push_tag(&req
, ASN1_CONTEXT(1));
101 asn1_push_tag(&req
, ASN1_SEQUENCE(0));
104 asn1_write_GeneralString(&req
, princ_part1
);
107 asn1_write_GeneralString(&req
, princ_part2
);
113 asn1_push_tag(&req
, ASN1_CONTEXT(2));
114 asn1_write_GeneralString(&req
, realm
);
118 ret
= data_blob(req
.data
, req
.length
);
126 static krb5_error_code
build_kpasswd_request(uint16 pversion
,
127 krb5_context context
,
128 krb5_auth_context auth_context
,
136 krb5_data encoded_setpw
;
137 krb5_replay_data replay
;
141 ret
= krb5_auth_con_setflags(context
,
142 auth_context
,KRB5_AUTH_CONTEXT_DO_SEQUENCE
);
144 DEBUG(1,("krb5_auth_con_setflags failed (%s)\n",
145 error_message(ret
)));
149 /* handle protocol differences in chpw and setpw */
150 if (pversion
== KRB5_KPASSWD_VERS_CHANGEPW
)
151 setpw
= data_blob(passwd
, strlen(passwd
));
152 else if (pversion
== KRB5_KPASSWD_VERS_SETPW
||
153 pversion
== KRB5_KPASSWD_VERS_SETPW_ALT
)
154 setpw
= encode_krb5_setpw(princ
, passwd
);
158 if (setpw
.data
== NULL
|| setpw
.length
== 0) {
162 encoded_setpw
.data
= (char *)setpw
.data
;
163 encoded_setpw
.length
= setpw
.length
;
165 ret
= krb5_mk_priv(context
, auth_context
,
166 &encoded_setpw
, &cipherpw
, &replay
);
168 data_blob_free(&setpw
); /*from 'encode_krb5_setpw(...)' */
171 DEBUG(1,("krb5_mk_priv failed (%s)\n", error_message(ret
)));
175 packet
->data
= (char *)SMB_MALLOC(ap_req
->length
+ cipherpw
.length
+ 6);
179 /* see the RFC for details */
180 p
= ((char *)packet
->data
) + 2;
181 RSSVAL(p
, 0, pversion
);
183 RSSVAL(p
, 0, ap_req
->length
);
185 memcpy(p
, ap_req
->data
, ap_req
->length
);
187 memcpy(p
, cipherpw
.data
, cipherpw
.length
);
188 p
+= cipherpw
.length
;
189 packet
->length
= PTR_DIFF(p
,packet
->data
);
190 RSSVAL(packet
->data
, 0, packet
->length
);
192 free(cipherpw
.data
); /* from 'krb5_mk_priv(...)' */
197 static const struct kpasswd_errors
{
199 const char *error_string
;
200 } kpasswd_errors
[] = {
201 {KRB5_KPASSWD_MALFORMED
, "Malformed request error"},
202 {KRB5_KPASSWD_HARDERROR
, "Server error"},
203 {KRB5_KPASSWD_AUTHERROR
, "Authentication error"},
204 {KRB5_KPASSWD_SOFTERROR
, "Password change rejected"},
205 {KRB5_KPASSWD_ACCESSDENIED
, "Client does not have proper authorization"},
206 {KRB5_KPASSWD_BAD_VERSION
, "Protocol version not supported"},
207 {KRB5_KPASSWD_INITIAL_FLAG_NEEDED
, "Authorization ticket must have initial flag set"},
208 {KRB5_KPASSWD_POLICY_REJECT
, "Password rejected due to policy requirements"},
209 {KRB5_KPASSWD_BAD_PRINCIPAL
, "Target principal does not exist"},
210 {KRB5_KPASSWD_ETYPE_NOSUPP
, "Unsupported encryption type"},
214 static krb5_error_code
setpw_result_code_string(krb5_context context
,
216 const char **code_string
)
218 unsigned int idx
= 0;
220 while (kpasswd_errors
[idx
].error_string
!= NULL
) {
221 if (kpasswd_errors
[idx
].result_code
==
223 *code_string
= kpasswd_errors
[idx
].error_string
;
228 *code_string
= "Password change failed";
232 krb5_error_code
kpasswd_err_to_krb5_err(krb5_error_code res_code
)
235 case KRB5_KPASSWD_ACCESSDENIED
:
236 return KRB5KDC_ERR_BADOPTION
;
237 case KRB5_KPASSWD_INITIAL_FLAG_NEEDED
:
238 return KRB5KDC_ERR_BADOPTION
;
239 /* return KV5M_ALT_METHOD; MIT-only define */
240 case KRB5_KPASSWD_ETYPE_NOSUPP
:
241 return KRB5KDC_ERR_ETYPE_NOSUPP
;
242 case KRB5_KPASSWD_BAD_PRINCIPAL
:
243 return KRB5KDC_ERR_C_PRINCIPAL_UNKNOWN
;
244 case KRB5_KPASSWD_POLICY_REJECT
:
245 case KRB5_KPASSWD_SOFTERROR
:
246 return KRB5KDC_ERR_POLICY
;
248 return KRB5KRB_ERR_GENERIC
;
251 static krb5_error_code
parse_setpw_reply(krb5_context context
,
252 krb5_auth_context auth_context
,
257 int vnum
, ret
, res_code
;
258 krb5_data cipherresult
;
259 krb5_data clearresult
;
260 krb5_ap_rep_enc_part
*ap_rep_enc
;
261 krb5_replay_data replay
;
263 if (packet
->length
< 4) {
264 return KRB5KRB_AP_ERR_MODIFIED
;
269 if (((char *)packet
->data
)[0] == 0x7e || ((char *)packet
->data
)[0] == 0x5e) {
270 /* it's an error packet. We should parse it ... */
271 DEBUG(1,("Got error packet 0x%x from kpasswd server\n",
272 ((char *)packet
->data
)[0]));
273 return KRB5KRB_AP_ERR_MODIFIED
;
276 if (RSVAL(p
, 0) != packet
->length
) {
277 DEBUG(1,("Bad packet length (%d/%d) from kpasswd server\n",
278 RSVAL(p
, 0), packet
->length
));
279 return KRB5KRB_AP_ERR_MODIFIED
;
284 vnum
= RSVAL(p
, 0); p
+= 2;
286 /* FIXME: According to standard there is only one type of reply */
287 if (vnum
!= KRB5_KPASSWD_VERS_SETPW
&&
288 vnum
!= KRB5_KPASSWD_VERS_SETPW_ALT
&&
289 vnum
!= KRB5_KPASSWD_VERS_CHANGEPW
) {
290 DEBUG(1,("Bad vnum (%d) from kpasswd server\n", vnum
));
291 return KRB5KDC_ERR_BAD_PVNO
;
294 ap_rep
.length
= RSVAL(p
, 0); p
+= 2;
296 if (p
+ ap_rep
.length
>= (char *)packet
->data
+ packet
->length
) {
297 DEBUG(1,("ptr beyond end of packet from kpasswd server\n"));
298 return KRB5KRB_AP_ERR_MODIFIED
;
301 if (ap_rep
.length
== 0) {
302 DEBUG(1,("got unencrypted setpw result?!\n"));
303 return KRB5KRB_AP_ERR_MODIFIED
;
310 ret
= krb5_rd_rep(context
, auth_context
, &ap_rep
, &ap_rep_enc
);
312 DEBUG(1,("failed to rd setpw reply (%s)\n", error_message(ret
)));
313 return KRB5KRB_AP_ERR_MODIFIED
;
316 krb5_free_ap_rep_enc_part(context
, ap_rep_enc
);
318 cipherresult
.data
= p
;
319 cipherresult
.length
= ((char *)packet
->data
+ packet
->length
) - p
;
321 ret
= krb5_rd_priv(context
, auth_context
, &cipherresult
, &clearresult
,
324 DEBUG(1,("failed to decrypt setpw reply (%s)\n", error_message(ret
)));
325 return KRB5KRB_AP_ERR_MODIFIED
;
328 if (clearresult
.length
< 2) {
329 free(clearresult
.data
);
330 ret
= KRB5KRB_AP_ERR_MODIFIED
;
331 return KRB5KRB_AP_ERR_MODIFIED
;
334 p
= clearresult
.data
;
336 res_code
= RSVAL(p
, 0);
338 free(clearresult
.data
);
340 if ((res_code
< KRB5_KPASSWD_SUCCESS
) ||
341 (res_code
> KRB5_KPASSWD_ETYPE_NOSUPP
)) {
342 return KRB5KRB_AP_ERR_MODIFIED
;
345 if(res_code
== KRB5_KPASSWD_SUCCESS
)
349 setpw_result_code_string(context
, res_code
, &errstr
);
350 DEBUG(1, ("Error changing password: %s (%d)\n", errstr
, res_code
));
352 return kpasswd_err_to_krb5_err(res_code
);
356 static ADS_STATUS
do_krb5_kpasswd_request(krb5_context context
,
357 const char *kdc_host
,
363 krb5_auth_context auth_context
= NULL
;
364 krb5_data ap_req
, chpw_req
, chpw_rep
;
367 struct sockaddr remote_addr
, local_addr
;
368 krb5_address local_kaddr
, remote_kaddr
;
370 ret
= krb5_mk_req_extended(context
, &auth_context
, AP_OPTS_USE_SUBKEY
,
371 NULL
, credsp
, &ap_req
);
373 DEBUG(1,("krb5_mk_req_extended failed (%s)\n", error_message(ret
)));
374 return ADS_ERROR_KRB5(ret
);
377 sock
= open_udp_socket(kdc_host
, DEFAULT_KPASSWD_PORT
);
381 krb5_auth_con_free(context
, auth_context
);
382 DEBUG(1,("failed to open kpasswd socket to %s (%s)\n",
383 kdc_host
, strerror(errno
)));
384 return ADS_ERROR_SYSTEM(rc
);
387 addr_len
= sizeof(remote_addr
);
388 getpeername(sock
, &remote_addr
, &addr_len
);
389 addr_len
= sizeof(local_addr
);
390 getsockname(sock
, &local_addr
, &addr_len
);
392 setup_kaddr(&remote_kaddr
, &remote_addr
);
393 setup_kaddr(&local_kaddr
, &local_addr
);
395 ret
= krb5_auth_con_setaddrs(context
, auth_context
, &local_kaddr
, NULL
);
399 krb5_auth_con_free(context
, auth_context
);
400 DEBUG(1,("krb5_auth_con_setaddrs failed (%s)\n", error_message(ret
)));
401 return ADS_ERROR_KRB5(ret
);
404 ret
= build_kpasswd_request(pversion
, context
, auth_context
, &ap_req
,
405 princ
, newpw
, &chpw_req
);
409 krb5_auth_con_free(context
, auth_context
);
410 DEBUG(1,("build_setpw_request failed (%s)\n", error_message(ret
)));
411 return ADS_ERROR_KRB5(ret
);
414 if (write(sock
, chpw_req
.data
, chpw_req
.length
) != chpw_req
.length
) {
418 krb5_auth_con_free(context
, auth_context
);
419 DEBUG(1,("send of chpw failed (%s)\n", strerror(errno
)));
420 return ADS_ERROR_SYSTEM(errno
);
425 chpw_rep
.length
= 1500;
426 chpw_rep
.data
= (char *) SMB_MALLOC(chpw_rep
.length
);
427 if (!chpw_rep
.data
) {
430 krb5_auth_con_free(context
, auth_context
);
431 DEBUG(1,("send of chpw failed (%s)\n", strerror(errno
)));
433 return ADS_ERROR_SYSTEM(errno
);
436 ret
= read(sock
, chpw_rep
.data
, chpw_rep
.length
);
441 krb5_auth_con_free(context
, auth_context
);
442 DEBUG(1,("recv of chpw reply failed (%s)\n", strerror(errno
)));
443 return ADS_ERROR_SYSTEM(errno
);
447 chpw_rep
.length
= ret
;
449 ret
= krb5_auth_con_setaddrs(context
, auth_context
, NULL
,&remote_kaddr
);
453 krb5_auth_con_free(context
, auth_context
);
454 DEBUG(1,("krb5_auth_con_setaddrs on reply failed (%s)\n",
455 error_message(ret
)));
456 return ADS_ERROR_KRB5(ret
);
459 ret
= parse_setpw_reply(context
, auth_context
, &chpw_rep
);
464 krb5_auth_con_free(context
, auth_context
);
465 DEBUG(1,("parse_setpw_reply failed (%s)\n",
466 error_message(ret
)));
467 return ADS_ERROR_KRB5(ret
);
471 krb5_auth_con_free(context
, auth_context
);
476 ADS_STATUS
ads_krb5_set_password(const char *kdc_host
, const char *princ
,
477 const char *newpw
, int time_offset
)
481 krb5_error_code ret
= 0;
482 krb5_context context
= NULL
;
483 krb5_principal principal
= NULL
;
484 char *princ_name
= NULL
;
486 krb5_creds creds
, *credsp
= NULL
;
487 #if KRB5_PRINC_REALM_RETURNS_REALM
488 krb5_realm orig_realm
;
490 krb5_data orig_realm
;
492 krb5_ccache ccache
= NULL
;
496 initialize_krb5_error_table();
497 ret
= krb5_init_context(&context
);
499 DEBUG(1,("Failed to init krb5 context (%s)\n", error_message(ret
)));
500 return ADS_ERROR_KRB5(ret
);
503 if (time_offset
!= 0) {
504 krb5_set_real_time(context
, time(NULL
) + time_offset
, 0);
507 ret
= krb5_cc_default(context
, &ccache
);
509 krb5_free_context(context
);
510 DEBUG(1,("Failed to get default creds (%s)\n", error_message(ret
)));
511 return ADS_ERROR_KRB5(ret
);
514 realm
= strchr_m(princ
, '@');
516 krb5_cc_close(context
, ccache
);
517 krb5_free_context(context
);
518 DEBUG(1,("Failed to get realm\n"));
519 return ADS_ERROR_KRB5(-1);
523 asprintf(&princ_name
, "kadmin/changepw@%s", realm
);
524 ret
= krb5_parse_name(context
, princ_name
, &creds
.server
);
526 krb5_cc_close(context
, ccache
);
527 krb5_free_context(context
);
528 DEBUG(1,("Failed to parse kadmin/changepw (%s)\n", error_message(ret
)));
529 return ADS_ERROR_KRB5(ret
);
533 /* parse the principal we got as a function argument */
534 ret
= krb5_parse_name(context
, princ
, &principal
);
536 krb5_cc_close(context
, ccache
);
537 krb5_free_principal(context
, creds
.server
);
538 krb5_free_context(context
);
539 DEBUG(1,("Failed to parse %s (%s)\n", princ_name
, error_message(ret
)));
540 return ADS_ERROR_KRB5(ret
);
543 /* The creds.server principal takes ownership of this memory.
544 Remember to set back to original value before freeing. */
545 orig_realm
= *krb5_princ_realm(context
, creds
.server
);
546 krb5_princ_set_realm(context
, creds
.server
, krb5_princ_realm(context
, principal
));
548 ret
= krb5_cc_get_principal(context
, ccache
, &creds
.client
);
550 krb5_cc_close(context
, ccache
);
551 krb5_princ_set_realm(context
, creds
.server
, &orig_realm
);
552 krb5_free_principal(context
, creds
.server
);
553 krb5_free_principal(context
, principal
);
554 krb5_free_context(context
);
555 DEBUG(1,("Failed to get principal from ccache (%s)\n",
556 error_message(ret
)));
557 return ADS_ERROR_KRB5(ret
);
560 ret
= krb5_get_credentials(context
, 0, ccache
, &creds
, &credsp
);
562 krb5_cc_close(context
, ccache
);
563 krb5_free_principal(context
, creds
.client
);
564 krb5_princ_set_realm(context
, creds
.server
, &orig_realm
);
565 krb5_free_principal(context
, creds
.server
);
566 krb5_free_principal(context
, principal
);
567 krb5_free_context(context
);
568 DEBUG(1,("krb5_get_credentials failed (%s)\n", error_message(ret
)));
569 return ADS_ERROR_KRB5(ret
);
572 /* we might have to call krb5_free_creds(...) from now on ... */
574 aret
= do_krb5_kpasswd_request(context
, kdc_host
,
575 KRB5_KPASSWD_VERS_SETPW
,
576 credsp
, princ
, newpw
);
578 krb5_free_creds(context
, credsp
);
579 krb5_free_principal(context
, creds
.client
);
580 krb5_princ_set_realm(context
, creds
.server
, &orig_realm
);
581 krb5_free_principal(context
, creds
.server
);
582 krb5_free_principal(context
, principal
);
583 krb5_cc_close(context
, ccache
);
584 krb5_free_context(context
);
590 we use a prompter to avoid a crash bug in the kerberos libs when
591 dealing with empty passwords
592 this prompter is just a string copy ...
594 static krb5_error_code
595 kerb_prompter(krb5_context ctx
, void *data
,
599 krb5_prompt prompts
[])
601 if (num_prompts
== 0) return 0;
603 memset(prompts
[0].reply
->data
, 0, prompts
[0].reply
->length
);
604 if (prompts
[0].reply
->length
> 0) {
606 strncpy(prompts
[0].reply
->data
, data
, prompts
[0].reply
->length
-1);
607 prompts
[0].reply
->length
= strlen(prompts
[0].reply
->data
);
609 prompts
[0].reply
->length
= 0;
615 static ADS_STATUS
ads_krb5_chg_password(const char *kdc_host
,
616 const char *principal
,
623 krb5_context context
= NULL
;
624 krb5_principal princ
;
625 krb5_get_init_creds_opt opts
;
627 char *chpw_princ
= NULL
, *password
;
629 initialize_krb5_error_table();
630 ret
= krb5_init_context(&context
);
632 DEBUG(1,("Failed to init krb5 context (%s)\n", error_message(ret
)));
633 return ADS_ERROR_KRB5(ret
);
636 if ((ret
= krb5_parse_name(context
, principal
,
638 krb5_free_context(context
);
639 DEBUG(1,("Failed to parse %s (%s)\n", principal
, error_message(ret
)));
640 return ADS_ERROR_KRB5(ret
);
643 krb5_get_init_creds_opt_init(&opts
);
644 krb5_get_init_creds_opt_set_tkt_life(&opts
, 5*60);
645 krb5_get_init_creds_opt_set_renew_life(&opts
, 0);
646 krb5_get_init_creds_opt_set_forwardable(&opts
, 0);
647 krb5_get_init_creds_opt_set_proxiable(&opts
, 0);
649 /* We have to obtain an INITIAL changepw ticket for changing password */
650 asprintf(&chpw_princ
, "kadmin/changepw@%s",
651 (char *) krb5_princ_realm(context
, princ
));
652 password
= SMB_STRDUP(oldpw
);
653 ret
= krb5_get_init_creds_password(context
, &creds
, princ
, password
,
655 0, chpw_princ
, &opts
);
656 SAFE_FREE(chpw_princ
);
660 if (ret
== KRB5KRB_AP_ERR_BAD_INTEGRITY
)
661 DEBUG(1,("Password incorrect while getting initial ticket"));
663 DEBUG(1,("krb5_get_init_creds_password failed (%s)\n", error_message(ret
)));
665 krb5_free_principal(context
, princ
);
666 krb5_free_context(context
);
667 return ADS_ERROR_KRB5(ret
);
670 aret
= do_krb5_kpasswd_request(context
, kdc_host
,
671 KRB5_KPASSWD_VERS_CHANGEPW
,
672 &creds
, principal
, newpw
);
674 krb5_free_principal(context
, princ
);
675 krb5_free_context(context
);
681 ADS_STATUS
kerberos_set_password(const char *kpasswd_server
,
682 const char *auth_principal
, const char *auth_password
,
683 const char *target_principal
, const char *new_password
,
688 if ((ret
= kerberos_kinit_password(auth_principal
, auth_password
, time_offset
, NULL
, NULL
, NULL
, False
, 0))) {
689 DEBUG(1,("Failed kinit for principal %s (%s)\n", auth_principal
, error_message(ret
)));
690 return ADS_ERROR_KRB5(ret
);
693 if (!strcmp(auth_principal
, target_principal
))
694 return ads_krb5_chg_password(kpasswd_server
, target_principal
,
695 auth_password
, new_password
, time_offset
);
697 return ads_krb5_set_password(kpasswd_server
, target_principal
,
698 new_password
, time_offset
);
703 * Set the machine account password
704 * @param ads connection to ads server
705 * @param hostname machine whose password is being set
706 * @param password new password
707 * @return status of password change
709 ADS_STATUS
ads_set_machine_password(ADS_STRUCT
*ads
,
710 const char *machine_account
,
711 const char *password
)
714 char *principal
= NULL
;
717 we need to use the '$' form of the name here (the machine account name),
718 as otherwise the server might end up setting the password for a user
721 asprintf(&principal
, "%s@%s", machine_account
, ads
->config
.realm
);
723 status
= ads_krb5_set_password(ads
->auth
.kdc_server
, principal
,
724 password
, ads
->auth
.time_offset
);