init_sec_context.c

   1 /*
   2  * Copyright (c) 2010, JANET(UK)
   3  * All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  *
   9  * 1. Redistributions of source code must retain the above copyright
  10  *    notice, this list of conditions and the following disclaimer.
  11  *
  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.
  15  *
  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.
  19  *
  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
  30  * SUCH DAMAGE.
  31  */
  32
  33 #include "gssapiP_eap.h"
  34
  35 static OM_uint32
  36 policyVariableToFlag(enum eapol_bool_var variable)
  37 {
  38     OM_uint32 flag = 0;
  39
  40     switch (variable) {
  41     case EAPOL_eapSuccess:
  42         flag = CTX_FLAG_EAP_SUCCESS;
  43         break;
  44     case EAPOL_eapRestart:
  45         flag = CTX_FLAG_EAP_RESTART;
  46         break;
  47     case EAPOL_eapFail:
  48         flag = CTX_FLAG_EAP_FAIL;
  49         break;
  50     case EAPOL_eapResp:
  51         flag = CTX_FLAG_EAP_RESP;
  52         break;
  53     case EAPOL_eapNoResp:
  54         flag = CTX_FLAG_EAP_NO_RESP;
  55         break;
  56     case EAPOL_eapReq:
  57         flag = CTX_FLAG_EAP_REQ;
  58         break;
  59     case EAPOL_portEnabled:
  60         flag = CTX_FLAG_EAP_PORT_ENABLED;
  61         break;
  62     case EAPOL_altAccept:
  63         flag = CTX_FLAG_EAP_ALT_ACCEPT;
  64         break;
  65     case EAPOL_altReject:
  66         flag = CTX_FLAG_EAP_ALT_REJECT;
  67         break;
  68     }
  69
  70     return flag;
  71 }
  72
  73 static struct eap_peer_config *
  74 peerGetConfig(void *ctx)
  75 {
  76     gss_ctx_id_t gssCtx = (gss_ctx_id_t)ctx;
  77
  78     return &gssCtx->initiatorCtx.eapPeerConfig;
  79 }
  80
  81 static Boolean
  82 peerGetBool(void *data, enum eapol_bool_var variable)
  83 {
  84     gss_ctx_id_t ctx = data;
  85     OM_uint32 flag;
  86
  87     if (ctx == GSS_C_NO_CONTEXT)
  88         return FALSE;
  89
  90     flag = policyVariableToFlag(variable);
  91
  92     return ((ctx->flags & flag) != 0);
  93 }
  94
  95 static void
  96 peerSetBool(void *data, enum eapol_bool_var variable,
  97             Boolean value)
  98 {
  99     gss_ctx_id_t ctx = data;
 100     OM_uint32 flag;
 101
 102     if (ctx == GSS_C_NO_CONTEXT)
 103         return;
 104
 105     flag = policyVariableToFlag(variable);
 106
 107     if (value)
 108         ctx->flags |= flag;
 109     else
 110         ctx->flags &= ~(flag);
 111 }
 112
 113 static unsigned int
 114 peerGetInt(void *data, enum eapol_int_var variable)
 115 {
 116     gss_ctx_id_t ctx = data;
 117
 118     if (ctx == GSS_C_NO_CONTEXT)
 119         return FALSE;
 120
 121     assert(CTX_IS_INITIATOR(ctx));
 122
 123     switch (variable) {
 124     case EAPOL_idleWhile:
 125         return ctx->initiatorCtx.idleWhile;
 126         break;
 127     }
 128
 129     return 0;
 130 }
 131
 132 static void
 133 peerSetInt(void *data, enum eapol_int_var variable,
 134            unsigned int value)
 135 {
 136     gss_ctx_id_t ctx = data;
 137
 138     if (ctx == GSS_C_NO_CONTEXT)
 139         return;
 140
 141     assert(CTX_IS_INITIATOR(ctx));
 142
 143     switch (variable) {
 144     case EAPOL_idleWhile:
 145         ctx->initiatorCtx.idleWhile = value;
 146         break;
 147     }
 148 }
 149
 150 static struct wpabuf *
 151 peerGetEapReqData(void *ctx)
 152 {
 153     gss_ctx_id_t gssCtx = (gss_ctx_id_t)ctx;
 154
 155     return &gssCtx->initiatorCtx.reqData;
 156 }
 157
 158 static void
 159 peerSetConfigBlob(void *ctx, struct wpa_config_blob *blob)
 160 {
 161 }
 162
 163 static const struct wpa_config_blob *
 164 peerGetConfigBlob(void *ctx, const char *name)
 165 {
 166     return NULL;
 167 }
 168
 169 static void
 170 peerNotifyPending(void *ctx)
 171 {
 172 }
 173
 174 static struct eapol_callbacks gssEapPolicyCallbacks = {
 175     peerGetConfig,
 176     peerGetBool,
 177     peerSetBool,
 178     peerGetInt,
 179     peerSetInt,
 180     peerGetEapReqData,
 181     peerSetConfigBlob,
 182     peerGetConfigBlob,
 183     peerNotifyPending,
 184 };
 185
 186 extern int wpa_debug_level;
 187
 188 static OM_uint32
 189 peerConfigInit(OM_uint32 *minor,
 190                gss_cred_id_t cred,
 191                gss_ctx_id_t ctx)
 192 {
 193     krb5_context krbContext;
 194     struct eap_peer_config *eapPeerConfig = &ctx->initiatorCtx.eapPeerConfig;
 195     krb5_error_code code;
 196     char *identity;
 197
 198     GSSEAP_KRB_INIT(&krbContext);
 199
 200     eapPeerConfig->fragment_size = 1024;
 201     wpa_debug_level = 0;
 202
 203     code = krb5_unparse_name(krbContext, cred->name->krbPrincipal, &identity);
 204     if (code != 0) {
 205         *minor = code;
 206         return GSS_S_FAILURE;
 207     }
 208
 209     eapPeerConfig->identity = (unsigned char *)identity;
 210     eapPeerConfig->identity_len = strlen(identity);
 211     eapPeerConfig->password = (unsigned char *)cred->password.value;
 212     eapPeerConfig->password_len = cred->password.length;
 213
 214     return GSS_S_COMPLETE;
 215 }
 216
 217 static OM_uint32
 218 peerConfigFree(OM_uint32 *minor,
 219                gss_ctx_id_t ctx)
 220 {
 221     krb5_context krbContext;
 222     struct eap_peer_config *eapPeerConfig = &ctx->initiatorCtx.eapPeerConfig;
 223
 224     GSSEAP_KRB_INIT(&krbContext);
 225
 226     krb5_free_unparsed_name(krbContext, (char *)eapPeerConfig->identity);
 227
 228     return GSS_S_COMPLETE;
 229 }
 230
 231 static OM_uint32
 232 initReady(OM_uint32 *minor, gss_ctx_id_t ctx)
 233 {
 234     OM_uint32 major;
 235     const unsigned char *key;
 236     size_t keyLength;
 237
 238     /* Cache encryption type derived from selected mechanism OID */
 239     major = gssEapOidToEnctype(minor, ctx->mechanismUsed, &ctx->encryptionType);
 240     if (GSS_ERROR(major))
 241         return major;
 242
 243     if (ctx->encryptionType != ENCTYPE_NULL &&
 244         eap_key_available(ctx->initiatorCtx.eap)) {
 245         key = eap_get_eapKeyData(ctx->initiatorCtx.eap, &keyLength);
 246
 247         major = gssEapDeriveRfc3961Key(minor, key, keyLength,
 248                                        ctx->encryptionType, &ctx->rfc3961Key);
 249         if (GSS_ERROR(major))
 250             return major;
 251
 252         major = rfc3961ChecksumTypeForKey(minor, &ctx->rfc3961Key,
 253                                            &ctx->checksumType);
 254         if (GSS_ERROR(major))
 255             return major;
 256     } else {
 257         /*
 258          * draft-howlett-eap-gss says that integrity/confidentialty should
 259          * always be advertised as available, but if we have no keying
 260          * material it seems confusing to the caller to advertise this.
 261          */
 262         ctx->gssFlags &= ~(GSS_C_INTEG_FLAG | GSS_C_CONF_FLAG);
 263         ctx->encryptionType = ENCTYPE_NULL;
 264     }
 265
 266     major = sequenceInit(minor,
 267                          &ctx->seqState,
 268                          ctx->recvSeq,
 269                          ((ctx->gssFlags & GSS_C_REPLAY_FLAG) != 0),
 270                          ((ctx->gssFlags & GSS_C_SEQUENCE_FLAG) != 0),
 271                          TRUE);
 272     if (GSS_ERROR(major))
 273         return major;
 274
 275     return GSS_S_COMPLETE;
 276 }
 277
 278 static OM_uint32
 279 eapGssSmInitIdentity(OM_uint32 *minor,
 280                      gss_cred_id_t cred,
 281                      gss_ctx_id_t ctx,
 282                      gss_name_t target,
 283                      gss_OID mech,
 284                      OM_uint32 reqFlags,
 285                      OM_uint32 timeReq,
 286                      gss_channel_bindings_t chanBindings,
 287                      gss_buffer_t inputToken,
 288                      gss_buffer_t outputToken)
 289 {
 290     time_t now;
 291     OM_uint32 major;
 292     int initialContextToken;
 293
 294     initialContextToken = (inputToken == GSS_C_NO_BUFFER ||
 295                            inputToken->length == 0);
 296     if (!initialContextToken)
 297         return GSS_S_DEFECTIVE_TOKEN;
 298
 299     time(&now);
 300     if (timeReq == 0 || timeReq == GSS_C_INDEFINITE)
 301         ctx->expiryTime = 0;
 302     else
 303         ctx->expiryTime = now + timeReq;
 304
 305     major = gss_duplicate_name(minor, cred->name, &ctx->initiatorName);
 306     if (GSS_ERROR(major))
 307         return major;
 308
 309     major = gss_duplicate_name(minor, target, &ctx->acceptorName);
 310     if (GSS_ERROR(major))
 311         return major;
 312
 313     if (mech == GSS_C_NULL_OID || oidEqual(mech, GSS_EAP_MECHANISM)) {
 314         major = gssEapDefaultMech(minor, &ctx->mechanismUsed);
 315     } else if (gssEapIsConcreteMechanismOid(mech)) {
 316         if (!gssEapInternalizeOid(mech, &ctx->mechanismUsed))
 317             major = duplicateOid(minor, mech, &ctx->mechanismUsed);
 318     } else {
 319         major = GSS_S_BAD_MECH;
 320     }
 321     if (GSS_ERROR(major))
 322         return major;
 323
 324     /* If credentials were provided, check they're usable with this mech */
 325     if (!gssEapCredAvailable(cred, ctx->mechanismUsed))
 326         return GSS_S_BAD_MECH;
 327
 328     ctx->state = EAP_STATE_AUTHENTICATE;
 329
 330     return GSS_S_CONTINUE_NEEDED;
 331 }
 332
 333 static struct wpabuf emptyWpaBuffer;
 334
 335 static OM_uint32
 336 eapGssSmInitAuthenticate(OM_uint32 *minor,
 337                          gss_cred_id_t cred,
 338                          gss_ctx_id_t ctx,
 339                          gss_name_t target,
 340                          gss_OID mech,
 341                          OM_uint32 reqFlags,
 342                          OM_uint32 timeReq,
 343                          gss_channel_bindings_t chanBindings,
 344                          gss_buffer_t inputToken,
 345                          gss_buffer_t outputToken)
 346 {
 347     OM_uint32 major;
 348     OM_uint32 tmpMinor;
 349     int code;
 350     struct wpabuf *resp = NULL;
 351     int initialContextToken;
 352
 353     initialContextToken = (inputToken == GSS_C_NO_BUFFER ||
 354                            inputToken->length == 0);
 355
 356     major = peerConfigInit(minor, cred, ctx);
 357     if (GSS_ERROR(major))
 358         goto cleanup;
 359
 360     if (ctx->initiatorCtx.eap == NULL) {
 361         struct eap_config eapConfig;
 362
 363         memset(&eapConfig, 0, sizeof(eapConfig));
 364
 365         ctx->initiatorCtx.eap = eap_peer_sm_init(ctx,
 366                                                  &gssEapPolicyCallbacks,
 367                                                  ctx,
 368                                                  &eapConfig);
 369         if (ctx->initiatorCtx.eap == NULL) {
 370             major = GSS_S_FAILURE;
 371             goto cleanup;
 372         }
 373
 374         ctx->flags |= CTX_FLAG_EAP_RESTART | CTX_FLAG_EAP_PORT_ENABLED;
 375     }
 376
 377     ctx->flags |= CTX_FLAG_EAP_REQ; /* we have a Request from the acceptor */
 378
 379     wpabuf_set(&ctx->initiatorCtx.reqData,
 380                inputToken->value, inputToken->length);
 381
 382     major = GSS_S_CONTINUE_NEEDED;
 383
 384     code = eap_peer_sm_step(ctx->initiatorCtx.eap);
 385     if (ctx->flags & CTX_FLAG_EAP_RESP) {
 386         ctx->flags &= ~(CTX_FLAG_EAP_RESP);
 387
 388         resp = eap_get_eapRespData(ctx->initiatorCtx.eap);
 389     } else if (ctx->flags & CTX_FLAG_EAP_SUCCESS) {
 390         major = initReady(minor, ctx);
 391         if (GSS_ERROR(major))
 392             goto cleanup;
 393
 394         ctx->flags &= ~(CTX_FLAG_EAP_SUCCESS);
 395         major = GSS_S_CONTINUE_NEEDED;
 396         ctx->state = EAP_STATE_GSS_CHANNEL_BINDINGS;
 397     } else if (ctx->flags & CTX_FLAG_EAP_FAIL) {
 398         major = GSS_S_DEFECTIVE_CREDENTIAL;
 399     } else if (code == 0 && initialContextToken) {
 400         resp = &emptyWpaBuffer;
 401         major = GSS_S_CONTINUE_NEEDED;
 402     } else {
 403         major = GSS_S_DEFECTIVE_TOKEN;
 404     }
 405
 406 cleanup:
 407     if (resp != NULL) {
 408         OM_uint32 tmpMajor;
 409         gss_buffer_desc respBuf;
 410
 411         assert(major == GSS_S_CONTINUE_NEEDED);
 412
 413         respBuf.length = wpabuf_len(resp);
 414         respBuf.value = (void *)wpabuf_head(resp);
 415
 416         tmpMajor = duplicateBuffer(&tmpMinor, &respBuf, outputToken);
 417         if (GSS_ERROR(tmpMajor)) {
 418             major = tmpMajor;
 419             *minor = tmpMinor;
 420         }
 421     }
 422
 423     wpabuf_set(&ctx->initiatorCtx.reqData, NULL, 0);
 424     peerConfigFree(&tmpMinor, ctx);
 425
 426     return major;
 427 }
 428
 429 static OM_uint32
 430 eapGssSmInitGssChannelBindings(OM_uint32 *minor,
 431                                gss_cred_id_t cred,
 432                                gss_ctx_id_t ctx,
 433                                gss_name_t target,
 434                                gss_OID mech,
 435                                OM_uint32 reqFlags,
 436                                OM_uint32 timeReq,
 437                                gss_channel_bindings_t chanBindings,
 438                                gss_buffer_t inputToken,
 439                                gss_buffer_t outputToken)
 440 {
 441     OM_uint32 major;
 442     gss_iov_buffer_desc iov[2];
 443     gss_buffer_desc buf;
 444
 445     iov[0].type = GSS_IOV_BUFFER_TYPE_DATA;
 446     iov[0].buffer.length = 0;
 447     iov[0].buffer.value = NULL;
 448
 449     iov[1].type = GSS_IOV_BUFFER_TYPE_HEADER | GSS_IOV_BUFFER_FLAG_ALLOCATE;
 450     iov[1].buffer.length = 0;
 451     iov[1].buffer.value = NULL;
 452
 453     if (chanBindings != GSS_C_NO_CHANNEL_BINDINGS)
 454         iov[0].buffer = chanBindings->application_data;
 455
 456     major = gssEapWrapOrGetMIC(minor, ctx, FALSE, FALSE, iov, 2,
 457                                TOK_TYPE_GSS_CB);
 458     if (GSS_ERROR(major))
 459         goto cleanup;
 460
 461     /* Skip past token ID */
 462     assert(iov[1].buffer.length > 2);
 463     assert(load_uint16_be(iov[1].buffer.value) == TOK_TYPE_GSS_CB);
 464
 465     buf.length = iov[1].buffer.length - 2;
 466     buf.value = (unsigned char *)iov[1].buffer.value + 2;
 467
 468     major = duplicateBuffer(minor, &buf, outputToken);
 469     if (GSS_ERROR(major))
 470         goto cleanup;
 471
 472     major = GSS_S_COMPLETE;
 473     ctx->state = EAP_STATE_ESTABLISHED;
 474
 475 cleanup:
 476     gssEapReleaseIov(iov, 2);
 477
 478     return major;
 479 }
 480
 481 static OM_uint32
 482 eapGssSmInitEstablished(OM_uint32 *minor,
 483                         gss_cred_id_t cred,
 484                         gss_ctx_id_t ctx,
 485                         gss_name_t target,
 486                         gss_OID mech,
 487                         OM_uint32 reqFlags,
 488                         OM_uint32 timeReq,
 489                         gss_channel_bindings_t chanBindings,
 490                         gss_buffer_t inputToken,
 491                         gss_buffer_t outputToken)
 492 {
 493     /* Called with already established context */
 494     *minor = EINVAL;
 495     return GSS_S_BAD_STATUS;
 496 }
 497
 498 static struct gss_eap_initiator_sm {
 499     enum gss_eap_token_type inputTokenType;
 500     enum gss_eap_token_type outputTokenType;
 501     OM_uint32 (*processToken)(OM_uint32 *,
 502                               gss_cred_id_t,
 503                               gss_ctx_id_t,
 504                               gss_name_t,
 505                               gss_OID,
 506                               OM_uint32,
 507                               OM_uint32,
 508                               gss_channel_bindings_t,
 509                               gss_buffer_t,
 510                               gss_buffer_t);
 511 } eapGssInitiatorSm[] = {
 512     { TOK_TYPE_NONE,    TOK_TYPE_EAP_RESP,  eapGssSmInitIdentity            },
 513     { TOK_TYPE_EAP_REQ, TOK_TYPE_EAP_RESP,  eapGssSmInitAuthenticate        },
 514     { TOK_TYPE_NONE,    TOK_TYPE_GSS_CB,    eapGssSmInitGssChannelBindings  },
 515     { TOK_TYPE_NONE,    TOK_TYPE_NONE,      eapGssSmInitEstablished         },
 516 };
 517
 518 OM_uint32
 519 gss_init_sec_context(OM_uint32 *minor,
 520                      gss_cred_id_t cred,
 521                      gss_ctx_id_t *context_handle,
 522                      gss_name_t target_name,
 523                      gss_OID mech_type,
 524                      OM_uint32 req_flags,
 525                      OM_uint32 time_req,
 526                      gss_channel_bindings_t input_chan_bindings,
 527                      gss_buffer_t input_token,
 528                      gss_OID *actual_mech_type,
 529                      gss_buffer_t output_token,
 530                      OM_uint32 *ret_flags,
 531                      OM_uint32 *time_rec)
 532 {
 533     OM_uint32 major;
 534     OM_uint32 tmpMajor, tmpMinor;
 535     gss_ctx_id_t ctx = *context_handle;
 536     struct gss_eap_initiator_sm *sm = NULL;
 537     gss_buffer_desc innerInputToken;
 538     gss_buffer_desc innerOutputToken = GSS_C_EMPTY_BUFFER;
 539
 540     *minor = 0;
 541
 542     output_token->length = 0;
 543     output_token->value = NULL;
 544
 545     if (cred != GSS_C_NO_CREDENTIAL && !(cred->flags & CRED_FLAG_INITIATE)) {
 546         return GSS_S_NO_CRED;
 547     }
 548
 549     if (ctx == GSS_C_NO_CONTEXT) {
 550         if (input_token != GSS_C_NO_BUFFER && input_token->length != 0) {
 551             return GSS_S_DEFECTIVE_TOKEN;
 552         }
 553
 554         major = gssEapAllocContext(minor, &ctx);
 555         if (GSS_ERROR(major))
 556             return major;
 557
 558         ctx->flags |= CTX_FLAG_INITIATOR;
 559
 560         *context_handle = ctx;
 561     }
 562
 563     GSSEAP_MUTEX_LOCK(&ctx->mutex);
 564
 565     sm = &eapGssInitiatorSm[ctx->state];
 566
 567     if (input_token != GSS_C_NO_BUFFER) {
 568         major = gssEapVerifyToken(minor, ctx, input_token,
 569                                   sm->inputTokenType, &innerInputToken);
 570         if (GSS_ERROR(major))
 571             goto cleanup;
 572     } else {
 573         innerInputToken.length = 0;
 574         innerInputToken.value = NULL;
 575     }
 576
 577     /*
 578      * Advance through state machine whilst empty tokens are emitted and
 579      * the status is not GSS_S_COMPLETE or an error status.
 580      */
 581     do {
 582         sm = &eapGssInitiatorSm[ctx->state];
 583
 584         major = (sm->processToken)(minor,
 585                                    cred,
 586                                    ctx,
 587                                    target_name,
 588                                    mech_type,
 589                                    req_flags,
 590                                    time_req,
 591                                    input_chan_bindings,
 592                                    &innerInputToken,
 593                                    &innerOutputToken);
 594         if (GSS_ERROR(major))
 595             goto cleanup;
 596     } while (major == GSS_S_CONTINUE_NEEDED && innerOutputToken.value == NULL);
 597
 598     if (actual_mech_type != NULL) {
 599         if (!gssEapInternalizeOid(ctx->mechanismUsed, actual_mech_type))
 600             duplicateOid(&tmpMinor, ctx->mechanismUsed, actual_mech_type);
 601     }
 602     if (innerOutputToken.value != NULL) {
 603         tmpMajor = gssEapMakeToken(&tmpMinor, ctx, &innerOutputToken,
 604                                    sm->outputTokenType, output_token);
 605         if (GSS_ERROR(tmpMajor)) {
 606             major = tmpMajor;
 607             *minor = tmpMinor;
 608             goto cleanup;
 609         }
 610     }
 611     if (ret_flags != NULL)
 612         *ret_flags = ctx->gssFlags;
 613     if (time_rec != NULL)
 614         gss_context_time(&tmpMinor, ctx, time_rec);
 615
 616     assert(ctx->state == EAP_STATE_ESTABLISHED || major == GSS_S_CONTINUE_NEEDED);
 617
 618 cleanup:
 619     GSSEAP_MUTEX_UNLOCK(&ctx->mutex);
 620
 621     if (GSS_ERROR(major))
 622         gssEapReleaseContext(&tmpMinor, context_handle);
 623
 624     gss_release_buffer(&tmpMinor, &innerOutputToken);
 625
 626     return major;
 627 }