2 * Copyright (c) 1997 - 2008 Kungliga Tekniska Högskolan
3 * (Royal Institute of Technology, Stockholm, Sweden).
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
13 * 2. Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in the
15 * documentation and/or other materials provided with the distribution.
17 * 3. Neither the name of the Institute nor the names of its contributors
18 * may be used to endorse or promote products derived from this software
19 * without specific prior written permission.
21 * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
22 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24 * ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
25 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
34 #include "krb5/gsskrb5_locl.h"
39 * copy the addresses from `input_chan_bindings' (if any) to
40 * the auth context `ac'
44 set_addresses (krb5_context context,
46 const gss_channel_bindings_t input_chan_bindings)
48 /* Port numbers are expected to be in application_data.value,
49 * initator's port first */
51 krb5_address initiator_addr, acceptor_addr;
54 if (input_chan_bindings == GSS_C_NO_CHANNEL_BINDINGS
55 || input_chan_bindings->application_data.length !=
56 2 * sizeof(ac->local_port))
59 memset(&initiator_addr, 0, sizeof(initiator_addr));
60 memset(&acceptor_addr, 0, sizeof(acceptor_addr));
63 *(int16_t *) input_chan_bindings->application_data.value;
66 *((int16_t *) input_chan_bindings->application_data.value + 1);
68 kret = _gsskrb5i_address_to_krb5addr(context,
69 input_chan_bindings->acceptor_addrtype,
70 &input_chan_bindings->acceptor_address,
76 kret = _gsskrb5i_address_to_krb5addr(context,
77 input_chan_bindings->initiator_addrtype,
78 &input_chan_bindings->initiator_address,
82 krb5_free_address (context, &acceptor_addr);
86 kret = krb5_auth_con_setaddrs(context,
88 &initiator_addr, /* local address */
89 &acceptor_addr); /* remote address */
91 krb5_free_address (context, &initiator_addr);
92 krb5_free_address (context, &acceptor_addr);
95 free(input_chan_bindings->application_data.value);
96 input_chan_bindings->application_data.value = NULL;
97 input_chan_bindings->application_data.length = 0;
105 OM_uint32 * minor_status,
106 gss_ctx_id_t * context_handle,
107 krb5_context context,
108 const gss_channel_bindings_t input_chan_bindings,
109 enum gss_ctx_id_t_state state)
111 krb5_error_code kret;
114 *context_handle = NULL;
116 ctx = malloc(sizeof(*ctx));
118 *minor_status = ENOMEM;
119 return GSS_S_FAILURE;
121 ctx->auth_context = NULL;
129 ctx->service_keyblock = NULL;
131 krb5_data_zero(&ctx->fwd_data);
132 ctx->lifetime = GSS_C_INDEFINITE;
134 HEIMDAL_MUTEX_init(&ctx->ctx_id_mutex);
136 kret = krb5_auth_con_init (context, &ctx->auth_context);
138 *minor_status = kret;
139 HEIMDAL_MUTEX_destroy(&ctx->ctx_id_mutex);
140 return GSS_S_FAILURE;
143 kret = set_addresses(context, ctx->auth_context, input_chan_bindings);
145 *minor_status = kret;
147 HEIMDAL_MUTEX_destroy(&ctx->ctx_id_mutex);
149 krb5_auth_con_free(context, ctx->auth_context);
151 return GSS_S_BAD_BINDINGS;
155 * We need a sequence number
158 krb5_auth_con_addflags(context,
160 KRB5_AUTH_CONTEXT_DO_SEQUENCE |
161 KRB5_AUTH_CONTEXT_CLEAR_FORWARDED_CRED,
164 *context_handle = (gss_ctx_id_t)ctx;
166 return GSS_S_COMPLETE;
172 OM_uint32 * minor_status,
173 krb5_context context,
176 const gss_name_t target_name,
179 OM_uint32 * time_rec,
183 krb5_error_code kret;
184 krb5_creds this_cred;
185 OM_uint32 lifetime_rec;
190 krb5_free_principal(context, ctx->target);
194 ret = _gsskrb5_canon_name(minor_status, context, use_dns,
195 target_name, &ctx->target);
199 memset(&this_cred, 0, sizeof(this_cred));
200 this_cred.client = ctx->source;
201 this_cred.server = ctx->target;
203 if (time_req && time_req != GSS_C_INDEFINITE) {
206 krb5_timeofday (context, &ts);
207 this_cred.times.endtime = ts + time_req;
209 this_cred.times.endtime = 0;
212 this_cred.session.keytype = KEYTYPE_NULL;
214 kret = krb5_get_credentials(context,
220 *minor_status = kret;
221 return GSS_S_FAILURE;
224 ctx->lifetime = (*cred)->times.endtime;
226 ret = _gsskrb5_lifetime_left(minor_status, context,
227 ctx->lifetime, &lifetime_rec);
230 if (lifetime_rec == 0) {
232 return GSS_S_CONTEXT_EXPIRED;
235 if (time_rec) *time_rec = lifetime_rec;
237 return GSS_S_COMPLETE;
241 gsskrb5_initiator_ready(
242 OM_uint32 * minor_status,
244 krb5_context context)
249 OM_uint32 flags = ctx->flags;
251 krb5_free_creds(context, ctx->kcred);
254 if (ctx->more_flags & CLOSE_CCACHE)
255 krb5_cc_close(context, ctx->ccache);
258 krb5_auth_getremoteseqnumber (context, ctx->auth_context, &seq_number);
260 _gsskrb5i_is_cfx(ctx, &is_cfx);
262 ret = _gssapi_msg_order_create(minor_status,
264 _gssapi_msg_order_f(flags),
265 seq_number, 0, is_cfx);
268 ctx->state = INITIATOR_READY;
269 ctx->more_flags |= OPEN;
271 return GSS_S_COMPLETE;
275 * handle delegated creds in init-sec-context
279 do_delegation (krb5_context context,
280 krb5_auth_context ac,
283 krb5_const_principal name,
289 KDCOptions fwd_flags;
290 krb5_error_code kret;
292 memset (&creds, 0, sizeof(creds));
293 krb5_data_zero (fwd_data);
295 kret = krb5_cc_get_principal(context, ccache, &creds.client);
299 kret = krb5_build_principal(context,
301 strlen(creds.client->realm),
309 creds.times.endtime = 0;
311 memset(&fwd_flags, 0, sizeof(fwd_flags));
312 fwd_flags.forwarded = 1;
313 fwd_flags.forwardable = 1;
315 if ( /*target_name->name.name_type != KRB5_NT_SRV_HST ||*/
316 name->name.name_string.len < 2)
319 kret = krb5_get_forwarded_creds(context,
322 KDCOptions2int(fwd_flags),
323 name->name.name_string.val[1],
334 krb5_free_principal(context, creds.client);
336 krb5_free_principal(context, creds.server);
340 * first stage of init-sec-context
345 (OM_uint32 * minor_status,
348 krb5_context context,
350 const gss_OID mech_type,
353 const gss_buffer_t input_token,
354 gss_OID * actual_mech_type,
355 gss_buffer_t output_token,
356 OM_uint32 * ret_flags,
360 OM_uint32 ret = GSS_S_FAILURE;
361 krb5_error_code kret;
364 OM_uint32 lifetime_rec;
367 krb5_data_zero(&outbuf);
368 krb5_data_zero(&fwd_data);
372 if (actual_mech_type)
373 *actual_mech_type = GSS_KRB5_MECHANISM;
376 kret = krb5_cc_default (context, &ctx->ccache);
378 *minor_status = kret;
382 ctx->more_flags |= CLOSE_CCACHE;
384 ctx->ccache = cred->ccache;
386 kret = krb5_cc_get_principal (context, ctx->ccache, &ctx->source);
388 *minor_status = kret;
393 ret = _gss_DES3_get_mic_compat(minor_status, ctx, context);
399 * This is hideous glue for (NFS) clients that wants to limit the
400 * available enctypes to what it can support (encryption in
401 * kernel). If there is no enctypes selected for this credential,
402 * reset it to the default set of enctypes.
405 krb5_enctype *enctypes = NULL;
407 if (cred && cred->enctypes)
408 enctypes = cred->enctypes;
409 krb5_set_default_in_tkt_etypes(context, enctypes);
412 /* canon name if needed for client + target realm */
413 kret = krb5_cc_get_config(context, ctx->ccache, NULL,
414 "realm-config", &outbuf);
416 /* XXX 2 is no server canon */
417 if (outbuf.length < 1 || ((((unsigned char *)outbuf.data)[0]) & 2))
419 krb5_data_free(&outbuf);
423 * First we try w/o dns, hope that the KDC have register alias
424 * (and referrals if cross realm) for this principal. If that
425 * fails and if we are allowed to using this realm try again with
426 * DNS canonicalizion.
428 ret = gsskrb5_get_creds(minor_status, context, ctx->ccache,
429 ctx, name, 0, time_req,
430 time_rec, &ctx->kcred);
431 if (ret && allow_dns)
432 ret = gsskrb5_get_creds(minor_status, context, ctx->ccache,
433 ctx, name, 1, time_req,
434 time_rec, &ctx->kcred);
438 ctx->lifetime = ctx->kcred->times.endtime;
440 ret = _gsskrb5_lifetime_left(minor_status,
447 if (lifetime_rec == 0) {
449 ret = GSS_S_CONTEXT_EXPIRED;
453 krb5_auth_con_setkey(context,
455 &ctx->kcred->session);
457 kret = krb5_auth_con_generatelocalsubkey(context,
459 &ctx->kcred->session);
461 *minor_status = kret;
466 return GSS_S_COMPLETE;
469 if (ctx->ccache && (ctx->more_flags & CLOSE_CCACHE))
470 krb5_cc_close(context, ctx->ccache);
479 (OM_uint32 * minor_status,
482 krb5_context context,
484 const gss_channel_bindings_t input_chan_bindings,
485 const gss_buffer_t input_token,
486 gss_OID * actual_mech_type,
487 gss_buffer_t output_token,
488 OM_uint32 * ret_flags,
492 OM_uint32 ret = GSS_S_FAILURE;
493 krb5_error_code kret;
494 krb5_flags ap_options;
497 krb5_data authenticator;
499 krb5_enctype enctype;
500 krb5_data fwd_data, timedata;
501 int32_t offset = 0, oldoffset;
504 krb5_data_zero(&outbuf);
505 krb5_data_zero(&fwd_data);
510 * If the credential doesn't have ok-as-delegate, check if there
511 * is a realm setting and use that.
513 if (!ctx->kcred->flags.b.ok_as_delegate) {
516 ret = krb5_cc_get_config(context, ctx->ccache, NULL,
517 "realm-config", &data);
519 /* XXX 1 is use ok-as-delegate */
520 if (data.length < 1 || ((((unsigned char *)data.data)[0]) & 1) == 0)
521 req_flags &= ~(GSS_C_DELEG_FLAG|GSS_C_DELEG_POLICY_FLAG);
522 krb5_data_free(&data);
528 /* if we used GSS_C_DELEG_POLICY_FLAG, trust KDC */
529 if ((req_flags & GSS_C_DELEG_POLICY_FLAG)
530 && ctx->kcred->flags.b.ok_as_delegate)
531 flagmask |= GSS_C_DELEG_FLAG | GSS_C_DELEG_POLICY_FLAG;
532 /* if there still is a GSS_C_DELEG_FLAG, use that */
533 if (req_flags & GSS_C_DELEG_FLAG)
534 flagmask |= GSS_C_DELEG_FLAG;
539 if (flagmask & GSS_C_DELEG_FLAG) {
540 do_delegation (context,
542 ctx->ccache, ctx->kcred, ctx->target,
543 &fwd_data, flagmask, &flags);
546 if (req_flags & GSS_C_MUTUAL_FLAG) {
547 flags |= GSS_C_MUTUAL_FLAG;
548 ap_options |= AP_OPTS_MUTUAL_REQUIRED;
551 if (req_flags & GSS_C_REPLAY_FLAG)
552 flags |= GSS_C_REPLAY_FLAG;
553 if (req_flags & GSS_C_SEQUENCE_FLAG)
554 flags |= GSS_C_SEQUENCE_FLAG;
555 if (req_flags & GSS_C_ANON_FLAG)
557 if (req_flags & GSS_C_DCE_STYLE) {
558 /* GSS_C_DCE_STYLE implies GSS_C_MUTUAL_FLAG */
559 flags |= GSS_C_DCE_STYLE | GSS_C_MUTUAL_FLAG;
560 ap_options |= AP_OPTS_MUTUAL_REQUIRED;
562 if (req_flags & GSS_C_IDENTIFY_FLAG)
563 flags |= GSS_C_IDENTIFY_FLAG;
564 if (req_flags & GSS_C_EXTENDED_ERROR_FLAG)
565 flags |= GSS_C_EXTENDED_ERROR_FLAG;
567 if (req_flags & GSS_C_CONF_FLAG) {
568 flags |= GSS_C_CONF_FLAG;
570 if (req_flags & GSS_C_INTEG_FLAG) {
571 flags |= GSS_C_INTEG_FLAG;
573 if (cred == NULL || !(cred->cred_flags & GSS_CF_NO_CI_FLAGS)) {
574 flags |= GSS_C_CONF_FLAG;
575 flags |= GSS_C_INTEG_FLAG;
577 flags |= GSS_C_TRANS_FLAG;
582 ctx->more_flags |= LOCAL;
584 ret = _gsskrb5_create_8003_checksum (minor_status,
589 krb5_data_free (&fwd_data);
593 enctype = ctx->auth_context->keyblock->keytype;
595 ret = krb5_cc_get_config(context, ctx->ccache, ctx->target,
596 "time-offset", &timedata);
598 if (timedata.length == 4) {
599 const u_char *p = timedata.data;
600 offset = (p[0] <<24) | (p[1] << 16) | (p[2] << 8) | (p[3] << 0);
602 krb5_data_free(&timedata);
606 krb5_get_kdc_sec_offset (context, &oldoffset, NULL);
607 krb5_set_kdc_sec_offset (context, offset, -1);
610 kret = krb5_build_authenticator (context,
617 KRB5_KU_AP_REQ_AUTH);
621 krb5_set_kdc_sec_offset (context, oldoffset, -1);
622 *minor_status = kret;
627 kret = krb5_build_ap_req (context,
634 krb5_set_kdc_sec_offset (context, oldoffset, -1);
636 *minor_status = kret;
641 if (flags & GSS_C_DCE_STYLE) {
642 output_token->value = outbuf.data;
643 output_token->length = outbuf.length;
645 ret = _gsskrb5_encapsulate (minor_status, &outbuf, output_token,
646 (u_char *)"\x01\x00", GSS_KRB5_MECHANISM);
647 krb5_data_free (&outbuf);
652 free_Checksum(&cksum);
654 if (flags & GSS_C_MUTUAL_FLAG) {
655 ctx->state = INITIATOR_WAIT_FOR_MUTAL;
656 return GSS_S_CONTINUE_NEEDED;
659 return gsskrb5_initiator_ready(minor_status, ctx, context);
661 if (ctx->ccache && (ctx->more_flags & CLOSE_CCACHE))
662 krb5_cc_close(context, ctx->ccache);
671 (OM_uint32 * minor_status,
673 krb5_context context,
674 const gss_OID mech_type,
677 const gss_channel_bindings_t input_chan_bindings,
678 const gss_buffer_t input_token,
679 gss_OID * actual_mech_type,
680 gss_buffer_t output_token,
681 OM_uint32 * ret_flags,
686 krb5_error_code kret;
688 krb5_ap_rep_enc_part *repl;
691 output_token->length = 0;
692 output_token->value = NULL;
694 if (actual_mech_type)
695 *actual_mech_type = GSS_KRB5_MECHANISM;
697 if (ctx->flags & GSS_C_DCE_STYLE) {
698 /* There is no OID wrapping. */
699 indata.length = input_token->length;
700 indata.data = input_token->value;
702 ret = _gsskrb5_decapsulate (minor_status,
707 if (ret == GSS_S_DEFECTIVE_TOKEN) {
708 /* check if there is an error token sent instead */
709 ret = _gsskrb5_decapsulate (minor_status,
714 if (ret == GSS_S_COMPLETE) {
717 kret = krb5_rd_error(context, &indata, &error);
719 kret = krb5_error_from_rd_error(context, &error, NULL);
721 /* save the time skrew for this host */
722 if (kret == KRB5KRB_AP_ERR_SKEW) {
725 int32_t t = error.stime - time(NULL);
727 p[0] = (t >> 24) & 0xFF;
728 p[1] = (t >> 16) & 0xFF;
729 p[2] = (t >> 8) & 0xFF;
730 p[3] = (t >> 0) & 0xFF;
733 timedata.length = sizeof(p);
735 krb5_cc_set_config(context, ctx->ccache, ctx->target,
736 "time-offset", &timedata);
738 if ((ctx->more_flags & RETRIED) == 0)
739 ctx->state = INITIATOR_RESTART;
740 ctx->more_flags |= RETRIED;
742 free_KRB_ERROR (&error);
744 *minor_status = kret;
745 return GSS_S_FAILURE;
751 kret = krb5_rd_rep (context,
756 *minor_status = kret;
757 return GSS_S_FAILURE;
759 krb5_free_ap_rep_enc_part (context,
762 _gsskrb5i_is_cfx(ctx, &is_cfx);
764 krb5_keyblock *key = NULL;
766 kret = krb5_auth_con_getremotesubkey(context,
769 if (kret == 0 && key != NULL) {
770 ctx->more_flags |= ACCEPTOR_SUBKEY;
771 krb5_free_keyblock (context, key);
778 ret = _gsskrb5_lifetime_left(minor_status,
783 ret = GSS_S_COMPLETE;
786 *ret_flags = ctx->flags;
788 if (req_flags & GSS_C_DCE_STYLE) {
789 int32_t local_seq, remote_seq;
793 * So DCE_STYLE is strange. The client echos the seq number
794 * that the server used in the server's mk_rep in its own
795 * mk_rep(). After when done, it resets to it's own seq number
796 * for the gss_wrap calls.
799 krb5_auth_getremoteseqnumber(context, ctx->auth_context, &remote_seq);
800 krb5_auth_con_getlocalseqnumber(context, ctx->auth_context, &local_seq);
801 krb5_auth_con_setlocalseqnumber(context, ctx->auth_context, remote_seq);
803 kret = krb5_mk_rep(context, ctx->auth_context, &outbuf);
805 *minor_status = kret;
806 return GSS_S_FAILURE;
809 /* reset local seq number */
810 krb5_auth_con_setlocalseqnumber(context, ctx->auth_context, local_seq);
812 output_token->length = outbuf.length;
813 output_token->value = outbuf.data;
816 return gsskrb5_initiator_ready(minor_status, ctx, context);
820 * gss_init_sec_context
823 OM_uint32 _gsskrb5_init_sec_context
824 (OM_uint32 * minor_status,
825 const gss_cred_id_t cred_handle,
826 gss_ctx_id_t * context_handle,
827 const gss_name_t target_name,
828 const gss_OID mech_type,
831 const gss_channel_bindings_t input_chan_bindings,
832 const gss_buffer_t input_token,
833 gss_OID * actual_mech_type,
834 gss_buffer_t output_token,
835 OM_uint32 * ret_flags,
839 krb5_context context;
840 gsskrb5_cred cred = (gsskrb5_cred)cred_handle;
844 GSSAPI_KRB5_INIT (&context);
846 output_token->length = 0;
847 output_token->value = NULL;
849 if (context_handle == NULL) {
851 return GSS_S_FAILURE | GSS_S_CALL_BAD_STRUCTURE;
859 if (target_name == GSS_C_NO_NAME) {
860 if (actual_mech_type)
861 *actual_mech_type = GSS_C_NO_OID;
863 return GSS_S_BAD_NAME;
866 if (mech_type != GSS_C_NO_OID &&
867 !gss_oid_equal(mech_type, GSS_KRB5_MECHANISM))
868 return GSS_S_BAD_MECH;
870 if (input_token == GSS_C_NO_BUFFER || input_token->length == 0) {
873 if (*context_handle != GSS_C_NO_CONTEXT) {
875 return GSS_S_FAILURE | GSS_S_CALL_BAD_STRUCTURE;
878 ret = _gsskrb5_create_ctx(minor_status,
887 if (*context_handle == GSS_C_NO_CONTEXT) {
889 return GSS_S_FAILURE | GSS_S_CALL_BAD_STRUCTURE;
892 ctx = (gsskrb5_ctx) *context_handle;
894 HEIMDAL_MUTEX_lock(&ctx->ctx_id_mutex);
897 switch (ctx->state) {
898 case INITIATOR_START:
899 ret = init_auth(minor_status,
912 if (ret != GSS_S_COMPLETE)
915 case INITIATOR_RESTART:
916 ret = init_auth_restart(minor_status,
928 case INITIATOR_WAIT_FOR_MUTAL:
929 ret = repl_mutual(minor_status,
941 if (ctx->state == INITIATOR_RESTART)
944 case INITIATOR_READY:
946 * If we get there, the caller have called
947 * gss_init_sec_context() one time too many.
949 _gsskrb5_set_status(EINVAL, "init_sec_context "
950 "called one time too many");
951 *minor_status = EINVAL;
952 ret = GSS_S_BAD_STATUS;
955 _gsskrb5_set_status(EINVAL, "init_sec_context "
956 "invalid state %d for client",
958 *minor_status = EINVAL;
959 ret = GSS_S_BAD_STATUS;
962 HEIMDAL_MUTEX_unlock(&ctx->ctx_id_mutex);
964 /* destroy context in case of error */
965 if (GSS_ERROR(ret)) {
967 _gsskrb5_delete_sec_context(&min2, context_handle, GSS_C_NO_BUFFER);