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 krb5_const_principal target_name,
178 OM_uint32 * time_rec,
182 krb5_error_code kret;
183 krb5_creds this_cred;
184 OM_uint32 lifetime_rec;
188 memset(&this_cred, 0, sizeof(this_cred));
189 this_cred.client = ctx->source;
190 this_cred.server = ctx->target;
192 if (time_req && time_req != GSS_C_INDEFINITE) {
195 krb5_timeofday (context, &ts);
196 this_cred.times.endtime = ts + time_req;
198 this_cred.times.endtime = 0;
201 this_cred.session.keytype = KEYTYPE_NULL;
203 kret = krb5_get_credentials(context,
209 *minor_status = kret;
210 return GSS_S_FAILURE;
213 ctx->lifetime = (*cred)->times.endtime;
215 ret = _gsskrb5_lifetime_left(minor_status, context,
216 ctx->lifetime, &lifetime_rec);
219 if (lifetime_rec == 0) {
221 return GSS_S_CONTEXT_EXPIRED;
224 if (time_rec) *time_rec = lifetime_rec;
226 return GSS_S_COMPLETE;
230 gsskrb5_initiator_ready(
231 OM_uint32 * minor_status,
233 krb5_context context)
238 OM_uint32 flags = ctx->flags;
240 krb5_free_creds(context, ctx->kcred);
243 if (ctx->more_flags & CLOSE_CCACHE)
244 krb5_cc_close(context, ctx->ccache);
247 krb5_auth_getremoteseqnumber (context, ctx->auth_context, &seq_number);
249 _gsskrb5i_is_cfx(ctx, &is_cfx);
251 ret = _gssapi_msg_order_create(minor_status,
253 _gssapi_msg_order_f(flags),
254 seq_number, 0, is_cfx);
257 ctx->state = INITIATOR_READY;
258 ctx->more_flags |= OPEN;
260 return GSS_S_COMPLETE;
264 * handle delegated creds in init-sec-context
268 do_delegation (krb5_context context,
269 krb5_auth_context ac,
272 krb5_const_principal name,
278 KDCOptions fwd_flags;
279 krb5_error_code kret;
281 memset (&creds, 0, sizeof(creds));
282 krb5_data_zero (fwd_data);
284 kret = krb5_cc_get_principal(context, ccache, &creds.client);
288 kret = krb5_build_principal(context,
290 strlen(creds.client->realm),
298 creds.times.endtime = 0;
300 memset(&fwd_flags, 0, sizeof(fwd_flags));
301 fwd_flags.forwarded = 1;
302 fwd_flags.forwardable = 1;
304 if ( /*target_name->name.name_type != KRB5_NT_SRV_HST ||*/
305 name->name.name_string.len < 2)
308 kret = krb5_get_forwarded_creds(context,
311 KDCOptions2int(fwd_flags),
312 name->name.name_string.val[1],
323 krb5_free_principal(context, creds.client);
325 krb5_free_principal(context, creds.server);
329 * first stage of init-sec-context
334 (OM_uint32 * minor_status,
337 krb5_context context,
339 const gss_OID mech_type,
342 const gss_buffer_t input_token,
343 gss_OID * actual_mech_type,
344 gss_buffer_t output_token,
345 OM_uint32 * ret_flags,
349 OM_uint32 ret = GSS_S_FAILURE;
350 krb5_error_code kret;
353 OM_uint32 lifetime_rec;
356 krb5_data_zero(&outbuf);
357 krb5_data_zero(&fwd_data);
361 if (actual_mech_type)
362 *actual_mech_type = GSS_KRB5_MECHANISM;
365 kret = krb5_cc_default (context, &ctx->ccache);
367 *minor_status = kret;
371 ctx->more_flags |= CLOSE_CCACHE;
373 ctx->ccache = cred->ccache;
375 kret = krb5_cc_get_principal (context, ctx->ccache, &ctx->source);
377 *minor_status = kret;
382 /* canon name if needed for client + target realm */
383 kret = krb5_cc_get_config(context, ctx->ccache, NULL,
384 "realm-config", &outbuf);
386 /* XXX 2 is no server canon */
387 if (outbuf.length < 1 || ((((unsigned char *)outbuf.data)[0]) & 2))
389 krb5_data_free(&outbuf);
392 ret = _gsskrb5_canon_name(minor_status, context, use_dns,
397 ret = _gss_DES3_get_mic_compat(minor_status, ctx, context);
403 * This is hideous glue for (NFS) clients that wants to limit the
404 * available enctypes to what it can support (encryption in
405 * kernel). If there is no enctypes selected for this credential,
406 * reset it to the default set of enctypes.
409 krb5_enctype *enctypes = NULL;
411 if (cred && cred->enctypes)
412 enctypes = cred->enctypes;
413 krb5_set_default_in_tkt_etypes(context, enctypes);
416 ret = gsskrb5_get_creds(minor_status,
427 ctx->lifetime = ctx->kcred->times.endtime;
429 ret = _gsskrb5_lifetime_left(minor_status,
437 if (lifetime_rec == 0) {
439 ret = GSS_S_CONTEXT_EXPIRED;
443 krb5_auth_con_setkey(context,
445 &ctx->kcred->session);
447 kret = krb5_auth_con_generatelocalsubkey(context,
449 &ctx->kcred->session);
451 *minor_status = kret;
456 return GSS_S_COMPLETE;
459 if (ctx->ccache && (ctx->more_flags & CLOSE_CCACHE))
460 krb5_cc_close(context, ctx->ccache);
469 (OM_uint32 * minor_status,
472 krb5_context context,
474 const gss_channel_bindings_t input_chan_bindings,
475 const gss_buffer_t input_token,
476 gss_OID * actual_mech_type,
477 gss_buffer_t output_token,
478 OM_uint32 * ret_flags,
482 OM_uint32 ret = GSS_S_FAILURE;
483 krb5_error_code kret;
484 krb5_flags ap_options;
487 krb5_data authenticator;
489 krb5_enctype enctype;
490 krb5_data fwd_data, timedata;
491 int32_t offset = 0, oldoffset;
494 krb5_data_zero(&outbuf);
495 krb5_data_zero(&fwd_data);
500 * If the credential doesn't have ok-as-delegate, check if there
501 * is a realm setting and use that.
503 if (!ctx->kcred->flags.b.ok_as_delegate) {
506 ret = krb5_cc_get_config(context, ctx->ccache, NULL,
507 "realm-config", &data);
509 /* XXX 1 is use ok-as-delegate */
510 if (data.length < 1 || ((((unsigned char *)data.data)[0]) & 1) == 0)
511 req_flags &= ~(GSS_C_DELEG_FLAG|GSS_C_DELEG_POLICY_FLAG);
512 krb5_data_free(&data);
518 /* if we used GSS_C_DELEG_POLICY_FLAG, trust KDC */
519 if ((req_flags & GSS_C_DELEG_POLICY_FLAG)
520 && ctx->kcred->flags.b.ok_as_delegate)
521 flagmask |= GSS_C_DELEG_FLAG | GSS_C_DELEG_POLICY_FLAG;
522 /* if there still is a GSS_C_DELEG_FLAG, use that */
523 if (req_flags & GSS_C_DELEG_FLAG)
524 flagmask |= GSS_C_DELEG_FLAG;
529 if (flagmask & GSS_C_DELEG_FLAG) {
530 do_delegation (context,
532 ctx->ccache, ctx->kcred, ctx->target,
533 &fwd_data, flagmask, &flags);
536 if (req_flags & GSS_C_MUTUAL_FLAG) {
537 flags |= GSS_C_MUTUAL_FLAG;
538 ap_options |= AP_OPTS_MUTUAL_REQUIRED;
541 if (req_flags & GSS_C_REPLAY_FLAG)
542 flags |= GSS_C_REPLAY_FLAG;
543 if (req_flags & GSS_C_SEQUENCE_FLAG)
544 flags |= GSS_C_SEQUENCE_FLAG;
545 if (req_flags & GSS_C_ANON_FLAG)
547 if (req_flags & GSS_C_DCE_STYLE) {
548 /* GSS_C_DCE_STYLE implies GSS_C_MUTUAL_FLAG */
549 flags |= GSS_C_DCE_STYLE | GSS_C_MUTUAL_FLAG;
550 ap_options |= AP_OPTS_MUTUAL_REQUIRED;
552 if (req_flags & GSS_C_IDENTIFY_FLAG)
553 flags |= GSS_C_IDENTIFY_FLAG;
554 if (req_flags & GSS_C_EXTENDED_ERROR_FLAG)
555 flags |= GSS_C_EXTENDED_ERROR_FLAG;
557 if (req_flags & GSS_C_CONF_FLAG) {
558 flags |= GSS_C_CONF_FLAG;
560 if (req_flags & GSS_C_INTEG_FLAG) {
561 flags |= GSS_C_INTEG_FLAG;
563 if (cred == NULL || !(cred->cred_flags & GSS_CF_NO_CI_FLAGS)) {
564 flags |= GSS_C_CONF_FLAG;
565 flags |= GSS_C_INTEG_FLAG;
567 flags |= GSS_C_TRANS_FLAG;
572 ctx->more_flags |= LOCAL;
574 ret = _gsskrb5_create_8003_checksum (minor_status,
579 krb5_data_free (&fwd_data);
583 enctype = ctx->auth_context->keyblock->keytype;
585 ret = krb5_cc_get_config(context, ctx->ccache, ctx->target,
586 "time-offset", &timedata);
588 if (timedata.length == 4) {
589 const u_char *p = timedata.data;
590 offset = (p[0] <<24) | (p[1] << 16) | (p[2] << 8) | (p[3] << 0);
592 krb5_data_free(&timedata);
596 krb5_get_kdc_sec_offset (context, &oldoffset, NULL);
597 krb5_set_kdc_sec_offset (context, offset, -1);
600 kret = krb5_build_authenticator (context,
607 KRB5_KU_AP_REQ_AUTH);
611 krb5_set_kdc_sec_offset (context, oldoffset, -1);
612 *minor_status = kret;
617 kret = krb5_build_ap_req (context,
624 krb5_set_kdc_sec_offset (context, oldoffset, -1);
626 *minor_status = kret;
631 if (flags & GSS_C_DCE_STYLE) {
632 output_token->value = outbuf.data;
633 output_token->length = outbuf.length;
635 ret = _gsskrb5_encapsulate (minor_status, &outbuf, output_token,
636 (u_char *)"\x01\x00", GSS_KRB5_MECHANISM);
637 krb5_data_free (&outbuf);
642 free_Checksum(&cksum);
644 if (flags & GSS_C_MUTUAL_FLAG) {
645 ctx->state = INITIATOR_WAIT_FOR_MUTAL;
646 return GSS_S_CONTINUE_NEEDED;
649 return gsskrb5_initiator_ready(minor_status, ctx, context);
651 if (ctx->ccache && (ctx->more_flags & CLOSE_CCACHE))
652 krb5_cc_close(context, ctx->ccache);
661 (OM_uint32 * minor_status,
663 krb5_context context,
664 const gss_OID mech_type,
667 const gss_channel_bindings_t input_chan_bindings,
668 const gss_buffer_t input_token,
669 gss_OID * actual_mech_type,
670 gss_buffer_t output_token,
671 OM_uint32 * ret_flags,
676 krb5_error_code kret;
678 krb5_ap_rep_enc_part *repl;
681 output_token->length = 0;
682 output_token->value = NULL;
684 if (actual_mech_type)
685 *actual_mech_type = GSS_KRB5_MECHANISM;
687 if (ctx->flags & GSS_C_DCE_STYLE) {
688 /* There is no OID wrapping. */
689 indata.length = input_token->length;
690 indata.data = input_token->value;
692 ret = _gsskrb5_decapsulate (minor_status,
697 if (ret == GSS_S_DEFECTIVE_TOKEN) {
698 /* check if there is an error token sent instead */
699 ret = _gsskrb5_decapsulate (minor_status,
704 if (ret == GSS_S_COMPLETE) {
707 kret = krb5_rd_error(context, &indata, &error);
709 kret = krb5_error_from_rd_error(context, &error, NULL);
711 /* save the time skrew for this host */
712 if (kret == KRB5KRB_AP_ERR_SKEW) {
715 int32_t t = error.stime - time(NULL);
717 p[0] = (t >> 24) & 0xFF;
718 p[1] = (t >> 16) & 0xFF;
719 p[2] = (t >> 8) & 0xFF;
720 p[3] = (t >> 0) & 0xFF;
723 timedata.length = sizeof(p);
725 krb5_cc_set_config(context, ctx->ccache, ctx->target,
726 "time-offset", &timedata);
728 if ((ctx->more_flags & RETRIED) == 0)
729 ctx->state = INITIATOR_RESTART;
730 ctx->more_flags |= RETRIED;
732 free_KRB_ERROR (&error);
734 *minor_status = kret;
735 return GSS_S_FAILURE;
741 kret = krb5_rd_rep (context,
746 *minor_status = kret;
747 return GSS_S_FAILURE;
749 krb5_free_ap_rep_enc_part (context,
752 _gsskrb5i_is_cfx(ctx, &is_cfx);
754 krb5_keyblock *key = NULL;
756 kret = krb5_auth_con_getremotesubkey(context,
759 if (kret == 0 && key != NULL) {
760 ctx->more_flags |= ACCEPTOR_SUBKEY;
761 krb5_free_keyblock (context, key);
768 ret = _gsskrb5_lifetime_left(minor_status,
773 ret = GSS_S_COMPLETE;
776 *ret_flags = ctx->flags;
778 if (req_flags & GSS_C_DCE_STYLE) {
779 int32_t local_seq, remote_seq;
783 * So DCE_STYLE is strange. The client echos the seq number
784 * that the server used in the server's mk_rep in its own
785 * mk_rep(). After when done, it resets to it's own seq number
786 * for the gss_wrap calls.
789 krb5_auth_getremoteseqnumber(context, ctx->auth_context, &remote_seq);
790 krb5_auth_con_getlocalseqnumber(context, ctx->auth_context, &local_seq);
791 krb5_auth_con_setlocalseqnumber(context, ctx->auth_context, remote_seq);
793 kret = krb5_mk_rep(context, ctx->auth_context, &outbuf);
795 *minor_status = kret;
796 return GSS_S_FAILURE;
799 /* reset local seq number */
800 krb5_auth_con_setlocalseqnumber(context, ctx->auth_context, local_seq);
802 output_token->length = outbuf.length;
803 output_token->value = outbuf.data;
806 return gsskrb5_initiator_ready(minor_status, ctx, context);
810 * gss_init_sec_context
813 OM_uint32 _gsskrb5_init_sec_context
814 (OM_uint32 * minor_status,
815 const gss_cred_id_t cred_handle,
816 gss_ctx_id_t * context_handle,
817 const gss_name_t target_name,
818 const gss_OID mech_type,
821 const gss_channel_bindings_t input_chan_bindings,
822 const gss_buffer_t input_token,
823 gss_OID * actual_mech_type,
824 gss_buffer_t output_token,
825 OM_uint32 * ret_flags,
829 krb5_context context;
830 gsskrb5_cred cred = (gsskrb5_cred)cred_handle;
834 GSSAPI_KRB5_INIT (&context);
836 output_token->length = 0;
837 output_token->value = NULL;
839 if (context_handle == NULL) {
841 return GSS_S_FAILURE | GSS_S_CALL_BAD_STRUCTURE;
849 if (target_name == GSS_C_NO_NAME) {
850 if (actual_mech_type)
851 *actual_mech_type = GSS_C_NO_OID;
853 return GSS_S_BAD_NAME;
856 if (mech_type != GSS_C_NO_OID &&
857 !gss_oid_equal(mech_type, GSS_KRB5_MECHANISM))
858 return GSS_S_BAD_MECH;
860 if (input_token == GSS_C_NO_BUFFER || input_token->length == 0) {
863 if (*context_handle != GSS_C_NO_CONTEXT) {
865 return GSS_S_FAILURE | GSS_S_CALL_BAD_STRUCTURE;
868 ret = _gsskrb5_create_ctx(minor_status,
877 if (*context_handle == GSS_C_NO_CONTEXT) {
879 return GSS_S_FAILURE | GSS_S_CALL_BAD_STRUCTURE;
882 ctx = (gsskrb5_ctx) *context_handle;
884 HEIMDAL_MUTEX_lock(&ctx->ctx_id_mutex);
887 switch (ctx->state) {
888 case INITIATOR_START:
889 ret = init_auth(minor_status,
902 if (ret != GSS_S_COMPLETE)
905 case INITIATOR_RESTART:
906 ret = init_auth_restart(minor_status,
918 case INITIATOR_WAIT_FOR_MUTAL:
919 ret = repl_mutual(minor_status,
931 if (ctx->state == INITIATOR_RESTART)
934 case INITIATOR_READY:
936 * If we get there, the caller have called
937 * gss_init_sec_context() one time too many.
939 _gsskrb5_set_status(EINVAL, "init_sec_context "
940 "called one time too many");
941 *minor_status = EINVAL;
942 ret = GSS_S_BAD_STATUS;
945 _gsskrb5_set_status(EINVAL, "init_sec_context "
946 "invalid state %d for client",
948 *minor_status = EINVAL;
949 ret = GSS_S_BAD_STATUS;
952 HEIMDAL_MUTEX_unlock(&ctx->ctx_id_mutex);
954 /* destroy context in case of error */
955 if (GSS_ERROR(ret)) {
957 _gsskrb5_delete_sec_context(&min2, context_handle, GSS_C_NO_BUFFER);