2 * Copyright (c) 2010, JANET(UK)
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
9 * 1. Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
16 * 3. Neither the name of JANET(UK) nor the names of its contributors
17 * may be used to endorse or promote products derived from this software
18 * without specific prior written permission.
20 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
21 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
24 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33 #include "gssapiP_eap.h"
35 #ifdef GSSEAP_ENABLE_REAUTH
37 eapGssSmAcceptGssReauth(OM_uint32 *minor,
40 gss_buffer_t inputToken,
41 gss_channel_bindings_t chanBindings,
42 gss_buffer_t outputToken);
46 * Mark an acceptor context as ready for cryptographic operations
49 acceptReadyEap(OM_uint32 *minor, gss_ctx_id_t ctx, gss_cred_id_t cred)
51 OM_uint32 major, tmpMinor;
53 gss_buffer_desc nameBuf = GSS_C_EMPTY_BUFFER;
55 /* Cache encryption type derived from selected mechanism OID */
56 major = gssEapOidToEnctype(minor, ctx->mechanismUsed,
57 &ctx->encryptionType);
61 gssEapReleaseName(&tmpMinor, &ctx->initiatorName);
63 major = gssEapRadiusGetRawAvp(minor, ctx->acceptorCtx.vps,
64 PW_USER_NAME, 0, &vp);
65 if (major == GSS_S_COMPLETE) {
66 nameBuf.length = vp->length;
67 nameBuf.value = vp->vp_strvalue;
69 ctx->gssFlags |= GSS_C_ANON_FLAG;
72 major = gssEapImportName(minor, &nameBuf, GSS_C_NT_USER_NAME,
77 major = gssEapRadiusGetRawAvp(minor, ctx->acceptorCtx.vps,
78 PW_MS_MPPE_SEND_KEY, VENDORPEC_MS, &vp);
79 if (GSS_ERROR(major)) {
80 *minor = GSSEAP_KEY_UNAVAILABLE;
81 return GSS_S_UNAVAILABLE;
84 major = gssEapDeriveRfc3961Key(minor,
92 major = rfc3961ChecksumTypeForKey(minor, &ctx->rfc3961Key,
97 major = sequenceInit(minor,
98 &ctx->seqState, ctx->recvSeq,
99 ((ctx->gssFlags & GSS_C_REPLAY_FLAG) != 0),
100 ((ctx->gssFlags & GSS_C_SEQUENCE_FLAG) != 0),
102 if (GSS_ERROR(major))
105 ctx->initiatorName->attrCtx = gssEapCreateAttrContext(cred, ctx);
107 return GSS_S_COMPLETE;
111 * Emit a identity EAP request to force the initiator (peer) to identify
115 eapGssSmAcceptIdentity(OM_uint32 *minor,
118 gss_buffer_t inputToken,
119 gss_channel_bindings_t chanBindings,
120 gss_buffer_t outputToken)
125 unsigned char data[5];
127 gss_buffer_desc pktBuffer;
129 if (inputToken != GSS_C_NO_BUFFER && inputToken->length != 0)
130 return GSS_S_DEFECTIVE_TOKEN;
132 assert(ctx->acceptorName == GSS_C_NO_NAME);
134 if (cred != GSS_C_NO_CREDENTIAL && cred->name != GSS_C_NO_NAME) {
135 major = gssEapDuplicateName(minor, cred->name, &ctx->acceptorName);
136 if (GSS_ERROR(major))
140 pkt.pdu.code = EAP_CODE_REQUEST;
141 pkt.pdu.identifier = 0;
142 pkt.pdu.length = htons(sizeof(pkt.data));
143 pkt.data[4] = EAP_TYPE_IDENTITY;
145 pktBuffer.length = sizeof(pkt.data);
146 pktBuffer.value = pkt.data;
148 major = duplicateBuffer(minor, &pktBuffer, outputToken);
149 if (GSS_ERROR(major))
152 ctx->state = EAP_STATE_AUTHENTICATE;
154 return GSS_S_CONTINUE_NEEDED;
158 * Pass the asserted acceptor identity to the authentication server.
161 setAcceptorIdentity(OM_uint32 *minor,
166 gss_buffer_desc nameBuf;
167 krb5_context krbContext = NULL;
168 krb5_principal krbPrinc;
169 struct rs_handle *rh = ctx->acceptorCtx.radHandle;
173 /* Awaits further specification */
174 if (ctx->acceptorName == GSS_C_NO_NAME)
175 return GSS_S_COMPLETE;
177 GSSEAP_KRB_INIT(&krbContext);
179 krbPrinc = ctx->acceptorName->krbPrincipal;
180 assert(krbPrinc != NULL);
182 if (krb5_princ_size(krbContext, krbPrinc) < 2)
183 return GSS_S_BAD_NAME;
185 /* Acceptor-Service-Name */
186 krbDataToGssBuffer(krb5_princ_component(krbContext, krbPrinc, 0), &nameBuf);
188 major = gssEapRadiusAddAvp(minor, vps,
189 PW_GSS_ACCEPTOR_SERVICE_NAME,
192 if (GSS_ERROR(major))
195 /* Acceptor-Host-Name */
196 krbDataToGssBuffer(krb5_princ_component(krbContext, krbPrinc, 1), &nameBuf);
198 major = gssEapRadiusAddAvp(minor, vps,
199 PW_GSS_ACCEPTOR_HOST_NAME,
202 if (GSS_ERROR(major))
205 if (krb5_princ_size(krbContext, krbPrinc) > 2) {
206 /* Acceptor-Service-Specific */
207 krb5_principal_data ssiPrinc = *krbPrinc;
210 krb5_princ_size(krbContext, &ssiPrinc) -= 2;
211 krb5_princ_name(krbContext, &ssiPrinc) += 2;
213 *minor = krb5_unparse_name_flags(krbContext, &ssiPrinc,
214 KRB5_PRINCIPAL_UNPARSE_NO_REALM, &ssi);
216 return GSS_S_FAILURE;
219 nameBuf.length = strlen(ssi);
221 major = gssEapRadiusAddAvp(minor, vps,
222 PW_GSS_ACCEPTOR_SERVICE_SPECIFIC,
226 if (GSS_ERROR(major)) {
227 krb5_free_unparsed_name(krbContext, ssi);
230 krb5_free_unparsed_name(krbContext, ssi);
233 krbDataToGssBuffer(krb5_princ_realm(krbContext, krbPrinc), &nameBuf);
234 if (nameBuf.length != 0) {
235 /* Acceptor-Realm-Name */
236 major = gssEapRadiusAddAvp(minor, vps,
237 PW_GSS_ACCEPTOR_REALM_NAME,
240 if (GSS_ERROR(major))
244 return GSS_S_COMPLETE;
248 * Allocate a RadSec handle
251 createRadiusHandle(OM_uint32 *minor,
255 struct gss_eap_acceptor_ctx *actx = &ctx->acceptorCtx;
256 const char *configFile = RS_CONFIG_FILE;
257 const char *configStanza = "gss-eap";
258 struct rs_alloc_scheme ralloc;
259 struct rs_error *err;
261 assert(actx->radHandle == NULL);
262 assert(actx->radConn == NULL);
264 if (rs_context_create(&actx->radHandle, RS_DICT_FILE) != 0) {
265 *minor = GSSEAP_RADSEC_INIT_FAILURE;
266 return GSS_S_FAILURE;
269 if (cred != GSS_C_NO_CREDENTIAL) {
270 if (cred->radiusConfigFile != NULL)
271 configFile = cred->radiusConfigFile;
272 if (cred->radiusConfigStanza != NULL)
273 configStanza = cred->radiusConfigStanza;
276 ralloc.calloc = GSSEAP_CALLOC;
277 ralloc.malloc = GSSEAP_MALLOC;
278 ralloc.free = GSSEAP_FREE;
279 ralloc.realloc = GSSEAP_REALLOC;
281 rs_context_set_alloc_scheme(actx->radHandle, &ralloc);
283 if (rs_context_read_config(actx->radHandle, configFile) != 0) {
284 err = rs_err_ctx_pop(actx->radHandle);
288 if (rs_conn_create(actx->radHandle, &actx->radConn, configStanza) != 0) {
289 err = rs_err_conn_pop(actx->radConn);
293 /* XXX TODO rs_conn_select_server does not exist yet */
295 if (actx->radServer != NULL) {
296 if (rs_conn_select_server(actx->radConn, actx->radServer) != 0) {
297 err = rs_err_conn_pop(actx->radConn);
304 return GSS_S_COMPLETE;
307 return gssEapRadiusMapError(minor, err);
311 * Process a EAP response from the initiator.
314 eapGssSmAcceptAuthenticate(OM_uint32 *minor,
317 gss_buffer_t inputToken,
318 gss_channel_bindings_t chanBindings,
319 gss_buffer_t outputToken)
321 OM_uint32 major, tmpMinor;
322 struct rs_handle *rh;
323 struct rs_connection *rconn;
324 struct rs_request *request = NULL;
325 struct rs_packet *req = NULL, *resp = NULL;
326 struct radius_packet *frreq, *frresp;
327 int sendAcceptorIdentity = 0;
329 if (ctx->acceptorCtx.radHandle == NULL) {
330 /* May be NULL from an imported partial context */
331 major = createRadiusHandle(minor, cred, ctx);
332 if (GSS_ERROR(major))
335 sendAcceptorIdentity = 1;
338 rh = ctx->acceptorCtx.radHandle;
339 rconn = ctx->acceptorCtx.radConn;
341 if (rs_packet_create_acc_request(rconn, &req, NULL, NULL) != 0) {
342 major = gssEapRadiusMapError(minor, rs_err_conn_pop(rconn));
345 frreq = rs_packet_frpkt(req);
347 if (sendAcceptorIdentity) {
348 major = setAcceptorIdentity(minor, ctx, &frreq->vps);
349 if (GSS_ERROR(major))
353 major = gssEapRadiusAddAvp(minor, &frreq->vps,
354 PW_EAP_MESSAGE, 0, inputToken);
355 if (GSS_ERROR(major))
358 if (ctx->acceptorCtx.state.length != 0) {
359 major = gssEapRadiusAddAvp(minor, &frreq->vps, PW_STATE, 0,
360 &ctx->acceptorCtx.state);
361 if (GSS_ERROR(major))
364 gss_release_buffer(&tmpMinor, &ctx->acceptorCtx.state);
367 if (rs_request_create(rconn, &request) != 0 ||
368 rs_request_send(request, req, &resp) != 0) {
369 major = gssEapRadiusMapError(minor, rs_err_conn_pop(rconn));
373 assert(resp != NULL);
375 frresp = rs_packet_frpkt(resp);
376 switch (frresp->code) {
377 case PW_AUTHENTICATION_ACK:
378 case PW_ACCESS_CHALLENGE:
379 major = GSS_S_CONTINUE_NEEDED;
381 case PW_AUTHENTICATION_REJECT:
382 *minor = GSSEAP_RADIUS_AUTH_FAILURE;
383 major = GSS_S_DEFECTIVE_CREDENTIAL;
387 *minor = GSSEAP_UNKNOWN_RADIUS_CODE;
388 major = GSS_S_FAILURE;
393 major = gssEapRadiusGetAvp(minor, frresp->vps, PW_EAP_MESSAGE, 0,
395 if (major == GSS_S_UNAVAILABLE && frresp->code == PW_ACCESS_CHALLENGE) {
396 *minor = GSSEAP_MISSING_EAP_REQUEST;
397 major = GSS_S_DEFECTIVE_TOKEN;
399 } else if (GSS_ERROR(major))
402 if (frresp->code == PW_ACCESS_CHALLENGE) {
403 major = gssEapRadiusGetAvp(minor, frresp->vps, PW_STATE, 0,
404 &ctx->acceptorCtx.state, TRUE);
405 if (GSS_ERROR(major) && *minor != GSSEAP_NO_SUCH_ATTR)
408 ctx->acceptorCtx.vps = frresp->vps;
411 rs_conn_destroy(ctx->acceptorCtx.radConn);
412 ctx->acceptorCtx.radConn = NULL;
414 major = acceptReadyEap(minor, ctx, cred);
415 if (GSS_ERROR(major))
418 ctx->state = EAP_STATE_EXTENSIONS_REQ;
421 major = GSS_S_CONTINUE_NEEDED;
424 rs_request_destroy(request);
430 eapGssSmAcceptExtensionsReq(OM_uint32 *minor,
433 gss_buffer_t inputToken,
434 gss_channel_bindings_t chanBindings,
435 gss_buffer_t outputToken)
439 major = gssEapVerifyExtensions(minor, cred, ctx, chanBindings, inputToken);
440 if (GSS_ERROR(major))
443 outputToken->length = 0;
444 outputToken->value = NULL;
446 ctx->state = EAP_STATE_EXTENSIONS_RESP;
448 return GSS_S_CONTINUE_NEEDED;
452 eapGssSmAcceptExtensionsResp(OM_uint32 *minor,
455 gss_buffer_t inputToken,
456 gss_channel_bindings_t chanBindings,
457 gss_buffer_t outputToken)
461 major = gssEapMakeExtensions(minor, cred, ctx, chanBindings, outputToken);
462 if (GSS_ERROR(major))
465 ctx->state = EAP_STATE_ESTABLISHED;
467 return GSS_S_COMPLETE;
471 eapGssSmAcceptEstablished(OM_uint32 *minor,
474 gss_buffer_t inputToken,
475 gss_channel_bindings_t chanBindings,
476 gss_buffer_t outputToken)
478 /* Called with already established context */
479 *minor = GSSEAP_CONTEXT_ESTABLISHED;
480 return GSS_S_BAD_STATUS;
484 makeErrorToken(OM_uint32 *minor,
485 OM_uint32 majorStatus,
486 OM_uint32 minorStatus,
487 gss_buffer_t outputToken)
489 unsigned char errorData[8];
490 gss_buffer_desc errorBuffer;
492 assert(GSS_ERROR(majorStatus));
495 * Only return error codes that the initiator could have caused,
496 * to avoid information leakage.
498 switch (minorStatus) {
499 case GSSEAP_WRONG_SIZE:
500 case GSSEAP_WRONG_MECH:
501 case GSSEAP_BAD_TOK_HEADER:
502 case GSSEAP_TOK_TRUNC:
503 case GSSEAP_BAD_DIRECTION:
504 case GSSEAP_WRONG_TOK_ID:
506 case GSSEAP_CRIT_EXT_UNAVAILABLE:
507 case GSSEAP_MISSING_REQUIRED_EXT:
508 case GSSEAP_KEY_UNAVAILABLE:
509 case GSSEAP_KEY_TOO_SHORT:
510 case GSSEAP_RADIUS_AUTH_FAILURE:
511 case GSSEAP_UNKNOWN_RADIUS_CODE:
512 case GSSEAP_MISSING_EAP_REQUEST:
515 if (IS_RADIUS_ERROR(minorStatus))
516 /* Squash RADIUS error codes */
517 minorStatus = GSSEAP_GENERIC_RADIUS_ERROR;
519 /* Don't return system error codes */
520 return GSS_S_COMPLETE;
523 minorStatus -= ERROR_TABLE_BASE_eapg;
525 store_uint32_be(majorStatus, &errorData[0]);
526 store_uint32_be(minorStatus, &errorData[4]);
528 errorBuffer.length = sizeof(errorData);
529 errorBuffer.value = errorData;
531 return duplicateBuffer(minor, &errorBuffer, outputToken);
534 static struct gss_eap_acceptor_sm {
535 enum gss_eap_token_type inputTokenType;
536 enum gss_eap_token_type outputTokenType;
537 OM_uint32 (*processToken)(OM_uint32 *,
541 gss_channel_bindings_t,
543 } eapGssAcceptorSm[] = {
544 { TOK_TYPE_EAP_RESP, TOK_TYPE_EAP_REQ, eapGssSmAcceptIdentity },
545 { TOK_TYPE_EAP_RESP, TOK_TYPE_EAP_REQ, eapGssSmAcceptAuthenticate },
546 { TOK_TYPE_EXT_REQ, TOK_TYPE_NONE, eapGssSmAcceptExtensionsReq },
547 { TOK_TYPE_NONE, TOK_TYPE_EXT_RESP, eapGssSmAcceptExtensionsResp },
548 { TOK_TYPE_NONE, TOK_TYPE_NONE, eapGssSmAcceptEstablished },
549 { TOK_TYPE_NONE, TOK_TYPE_CONTEXT_ERR, NULL },
550 #ifdef GSSEAP_ENABLE_REAUTH
551 { TOK_TYPE_GSS_REAUTH, TOK_TYPE_GSS_REAUTH, eapGssSmAcceptGssReauth },
556 gss_accept_sec_context(OM_uint32 *minor,
557 gss_ctx_id_t *context_handle,
559 gss_buffer_t input_token,
560 gss_channel_bindings_t input_chan_bindings,
561 gss_name_t *src_name,
563 gss_buffer_t output_token,
564 OM_uint32 *ret_flags,
566 gss_cred_id_t *delegated_cred_handle)
569 OM_uint32 tmpMajor, tmpMinor;
570 gss_ctx_id_t ctx = *context_handle;
571 struct gss_eap_acceptor_sm *sm = NULL;
572 gss_buffer_desc innerInputToken = GSS_C_EMPTY_BUFFER;
573 gss_buffer_desc innerOutputToken = GSS_C_EMPTY_BUFFER;
574 enum gss_eap_token_type tokType;
575 int initialContextToken = 0;
579 output_token->length = 0;
580 output_token->value = NULL;
582 if (input_token == GSS_C_NO_BUFFER || input_token->length == 0) {
583 return GSS_S_DEFECTIVE_TOKEN;
586 if (ctx == GSS_C_NO_CONTEXT) {
587 major = gssEapAllocContext(minor, &ctx);
588 if (GSS_ERROR(major))
591 initialContextToken = 1;
592 *context_handle = ctx;
595 GSSEAP_MUTEX_LOCK(&ctx->mutex);
597 /* Validate and lock credentials */
598 if (cred != GSS_C_NO_CREDENTIAL) {
599 GSSEAP_MUTEX_LOCK(&cred->mutex);
601 if ((cred->flags & CRED_FLAG_ACCEPT) == 0) {
602 *minor = GSSEAP_CRED_USAGE_MISMATCH;
603 major = GSS_S_NO_CRED;
608 sm = &eapGssAcceptorSm[ctx->state];
610 major = gssEapVerifyToken(minor, ctx, input_token,
611 &tokType, &innerInputToken);
612 if (GSS_ERROR(major))
615 if (!gssEapCredAvailable(cred, ctx->mechanismUsed)) {
616 *minor = GSSEAP_WRONG_MECH;
617 major = GSS_S_BAD_MECH;
621 #ifdef GSSEAP_ENABLE_REAUTH
623 * If we're built with fast reauthentication support, it's valid
624 * for an initiator to send a GSS reauthentication token as its
625 * initial context token, causing us to short-circuit the state
626 * machine and process Kerberos GSS messages instead.
628 if (tokType == TOK_TYPE_GSS_REAUTH && initialContextToken) {
629 ctx->state = EAP_STATE_KRB_REAUTH_GSS;
632 if (tokType != sm->inputTokenType) {
633 *minor = GSSEAP_WRONG_TOK_ID;
634 major = GSS_S_DEFECTIVE_TOKEN;
639 sm = &eapGssAcceptorSm[ctx->state];
641 major = (sm->processToken)(minor,
647 if (GSS_ERROR(major)) {
648 /* Possibly generate an error token */
649 tmpMajor = makeErrorToken(&tmpMinor, major, *minor, &innerOutputToken);
650 if (GSS_ERROR(tmpMajor)) {
655 sm = &eapGssAcceptorSm[EAP_STATE_ERROR];
658 } while (major == GSS_S_CONTINUE_NEEDED && innerOutputToken.length == 0);
660 if (mech_type != NULL) {
661 if (!gssEapInternalizeOid(ctx->mechanismUsed, mech_type))
662 duplicateOid(&tmpMinor, ctx->mechanismUsed, mech_type);
664 if (ret_flags != NULL)
665 *ret_flags = ctx->gssFlags;
666 if (delegated_cred_handle != NULL)
667 *delegated_cred_handle = GSS_C_NO_CREDENTIAL;
669 if (major == GSS_S_COMPLETE) {
670 if (src_name != NULL && ctx->initiatorName != GSS_C_NO_NAME) {
671 major = gssEapDuplicateName(&tmpMinor, ctx->initiatorName, src_name);
672 if (GSS_ERROR(major))
675 if (time_rec != NULL)
676 gssEapContextTime(&tmpMinor, ctx, time_rec);
679 assert(ctx->state == EAP_STATE_ESTABLISHED || major == GSS_S_CONTINUE_NEEDED);
682 if (innerOutputToken.value != NULL) {
683 tmpMajor = gssEapMakeToken(&tmpMinor, ctx, &innerOutputToken,
684 sm->outputTokenType, output_token);
685 if (GSS_ERROR(tmpMajor)) {
693 if (cred != GSS_C_NO_CREDENTIAL)
694 GSSEAP_MUTEX_UNLOCK(&cred->mutex);
695 GSSEAP_MUTEX_UNLOCK(&ctx->mutex);
697 if (GSS_ERROR(major))
698 gssEapReleaseContext(&tmpMinor, context_handle);
700 gss_release_buffer(&tmpMinor, &innerOutputToken);
705 #ifdef GSSEAP_ENABLE_REAUTH
707 acceptReadyKrb(OM_uint32 *minor,
710 const gss_name_t initiator,
716 major = gssEapGlueToMechName(minor, initiator, &ctx->initiatorName);
717 if (GSS_ERROR(major))
720 if (cred != GSS_C_NO_CREDENTIAL && cred->name != GSS_C_NO_NAME) {
721 major = gssEapDuplicateName(minor, cred->name, &ctx->acceptorName);
722 if (GSS_ERROR(major))
726 major = gssEapReauthComplete(minor, ctx, cred, mech, timeRec);
727 if (GSS_ERROR(major))
730 ctx->state = EAP_STATE_ESTABLISHED;
732 return GSS_S_COMPLETE;
736 eapGssSmAcceptGssReauth(OM_uint32 *minor,
739 gss_buffer_t inputToken,
740 gss_channel_bindings_t chanBindings,
741 gss_buffer_t outputToken)
743 OM_uint32 major, tmpMinor;
744 gss_cred_id_t krbCred = GSS_C_NO_CREDENTIAL;
745 gss_name_t krbInitiator = GSS_C_NO_NAME;
746 gss_OID mech = GSS_C_NO_OID;
747 OM_uint32 gssFlags, timeRec = GSS_C_INDEFINITE;
749 ctx->flags |= CTX_FLAG_KRB_REAUTH_GSS;
751 if (cred != GSS_C_NO_CREDENTIAL)
752 krbCred = cred->krbCred;
754 major = gssAcceptSecContext(minor,
765 if (major == GSS_S_COMPLETE) {
766 major = acceptReadyKrb(minor, ctx, cred,
767 krbInitiator, mech, timeRec);
770 ctx->gssFlags = gssFlags;
772 gssReleaseName(&tmpMinor, &krbInitiator);
776 #endif /* GSSEAP_ENABLE_REAUTH */