contrib/wpa/src/eap_server/eap.c

   1 /*
   2  * hostapd / EAP Full Authenticator state machine (RFC 4137)
   3  * Copyright (c) 2004-2007, Jouni Malinen <j@w1.fi>
   4  *
   5  * This program is free software; you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License version 2 as
   7  * published by the Free Software Foundation.
   8  *
   9  * Alternatively, this software may be distributed under the terms of BSD
  10  * license.
  11  *
  12  * See README and COPYING for more details.
  13  *
  14  * This state machine is based on the full authenticator state machine defined
  15  * in RFC 4137. However, to support backend authentication in RADIUS
  16  * authentication server functionality, parts of backend authenticator (also
  17  * from RFC 4137) are mixed in. This functionality is enabled by setting
  18  * backend_auth configuration variable to TRUE.
  19  */
  20
  21 #include "includes.h"
  22
  23 #include "common.h"
  24 #include "eap_i.h"
  25 #include "state_machine.h"
  26
  27 #define STATE_MACHINE_DATA struct eap_sm
  28 #define STATE_MACHINE_DEBUG_PREFIX "EAP"
  29
  30 #define EAP_MAX_AUTH_ROUNDS 50
  31
  32 static void eap_user_free(struct eap_user *user);
  33
  34
  35 /* EAP state machines are described in RFC 4137 */
  36
  37 static int eap_sm_calculateTimeout(struct eap_sm *sm, int retransCount,
  38                                    int eapSRTT, int eapRTTVAR,
  39                                    int methodTimeout);
  40 static void eap_sm_parseEapResp(struct eap_sm *sm, const struct wpabuf *resp);
  41 static int eap_sm_getId(const struct wpabuf *data);
  42 static struct wpabuf * eap_sm_buildSuccess(struct eap_sm *sm, u8 id);
  43 static struct wpabuf * eap_sm_buildFailure(struct eap_sm *sm, u8 id);
  44 static int eap_sm_nextId(struct eap_sm *sm, int id);
  45 static void eap_sm_Policy_update(struct eap_sm *sm, const u8 *nak_list,
  46                                  size_t len);
  47 static EapType eap_sm_Policy_getNextMethod(struct eap_sm *sm, int *vendor);
  48 static int eap_sm_Policy_getDecision(struct eap_sm *sm);
  49 static Boolean eap_sm_Policy_doPickUp(struct eap_sm *sm, EapType method);
  50
  51
  52 static int eap_copy_buf(struct wpabuf **dst, const struct wpabuf *src)
  53 {
  54         if (src == NULL)
  55                 return -1;
  56
  57         wpabuf_free(*dst);
  58         *dst = wpabuf_dup(src);
  59         return *dst ? 0 : -1;
  60 }
  61
  62
  63 static int eap_copy_data(u8 **dst, size_t *dst_len,
  64                          const u8 *src, size_t src_len)
  65 {
  66         if (src == NULL)
  67                 return -1;
  68
  69         os_free(*dst);
  70         *dst = os_malloc(src_len);
  71         if (*dst) {
  72                 os_memcpy(*dst, src, src_len);
  73                 *dst_len = src_len;
  74                 return 0;
  75         } else {
  76                 *dst_len = 0;
  77                 return -1;
  78         }
  79 }
  80
  81 #define EAP_COPY(dst, src) \
  82         eap_copy_data((dst), (dst ## Len), (src), (src ## Len))
  83
  84
  85 /**
  86  * eap_user_get - Fetch user information from the database
  87  * @sm: Pointer to EAP state machine allocated with eap_server_sm_init()
  88  * @identity: Identity (User-Name) of the user
  89  * @identity_len: Length of identity in bytes
  90  * @phase2: 0 = EAP phase1 user, 1 = EAP phase2 (tunneled) user
  91  * Returns: 0 on success, or -1 on failure
  92  *
  93  * This function is used to fetch user information for EAP. The user will be
  94  * selected based on the specified identity. sm->user and
  95  * sm->user_eap_method_index are updated for the new user when a matching user
  96  * is found. sm->user can be used to get user information (e.g., password).
  97  */
  98 int eap_user_get(struct eap_sm *sm, const u8 *identity, size_t identity_len,
  99                  int phase2)
 100 {
 101         struct eap_user *user;
 102
 103         if (sm == NULL || sm->eapol_cb == NULL ||
 104             sm->eapol_cb->get_eap_user == NULL)
 105                 return -1;
 106
 107         eap_user_free(sm->user);
 108         sm->user = NULL;
 109
 110         user = os_zalloc(sizeof(*user));
 111         if (user == NULL)
 112             return -1;
 113
 114         if (sm->eapol_cb->get_eap_user(sm->eapol_ctx, identity,
 115                                        identity_len, phase2, user) != 0) {
 116                 eap_user_free(user);
 117                 return -1;
 118         }
 119
 120         sm->user = user;
 121         sm->user_eap_method_index = 0;
 122
 123         return 0;
 124 }
 125
 126
 127 SM_STATE(EAP, DISABLED)
 128 {
 129         SM_ENTRY(EAP, DISABLED);
 130         sm->num_rounds = 0;
 131 }
 132
 133
 134 SM_STATE(EAP, INITIALIZE)
 135 {
 136         SM_ENTRY(EAP, INITIALIZE);
 137
 138         sm->currentId = -1;
 139         sm->eap_if.eapSuccess = FALSE;
 140         sm->eap_if.eapFail = FALSE;
 141         sm->eap_if.eapTimeout = FALSE;
 142         os_free(sm->eap_if.eapKeyData);
 143         sm->eap_if.eapKeyData = NULL;
 144         sm->eap_if.eapKeyDataLen = 0;
 145         sm->eap_if.eapKeyAvailable = FALSE;
 146         sm->eap_if.eapRestart = FALSE;
 147
 148         /*
 149          * This is not defined in RFC 4137, but method state needs to be
 150          * reseted here so that it does not remain in success state when
 151          * re-authentication starts.
 152          */
 153         if (sm->m && sm->eap_method_priv) {
 154                 sm->m->reset(sm, sm->eap_method_priv);
 155                 sm->eap_method_priv = NULL;
 156         }
 157         sm->m = NULL;
 158         sm->user_eap_method_index = 0;
 159
 160         if (sm->backend_auth) {
 161                 sm->currentMethod = EAP_TYPE_NONE;
 162                 /* parse rxResp, respId, respMethod */
 163                 eap_sm_parseEapResp(sm, sm->eap_if.eapRespData);
 164                 if (sm->rxResp) {
 165                         sm->currentId = sm->respId;
 166                 }
 167         }
 168         sm->num_rounds = 0;
 169         sm->method_pending = METHOD_PENDING_NONE;
 170 }
 171
 172
 173 SM_STATE(EAP, PICK_UP_METHOD)
 174 {
 175         SM_ENTRY(EAP, PICK_UP_METHOD);
 176
 177         if (eap_sm_Policy_doPickUp(sm, sm->respMethod)) {
 178                 sm->currentMethod = sm->respMethod;
 179                 if (sm->m && sm->eap_method_priv) {
 180                         sm->m->reset(sm, sm->eap_method_priv);
 181                         sm->eap_method_priv = NULL;
 182                 }
 183                 sm->m = eap_server_get_eap_method(EAP_VENDOR_IETF,
 184                                                   sm->currentMethod);
 185                 if (sm->m && sm->m->initPickUp) {
 186                         sm->eap_method_priv = sm->m->initPickUp(sm);
 187                         if (sm->eap_method_priv == NULL) {
 188                                 wpa_printf(MSG_DEBUG, "EAP: Failed to "
 189                                            "initialize EAP method %d",
 190                                            sm->currentMethod);
 191                                 sm->m = NULL;
 192                                 sm->currentMethod = EAP_TYPE_NONE;
 193                         }
 194                 } else {
 195                         sm->m = NULL;
 196                         sm->currentMethod = EAP_TYPE_NONE;
 197                 }
 198         }
 199 }
 200
 201
 202 SM_STATE(EAP, IDLE)
 203 {
 204         SM_ENTRY(EAP, IDLE);
 205
 206         sm->eap_if.retransWhile = eap_sm_calculateTimeout(
 207                 sm, sm->retransCount, sm->eap_if.eapSRTT, sm->eap_if.eapRTTVAR,
 208                 sm->methodTimeout);
 209 }
 210
 211
 212 SM_STATE(EAP, RETRANSMIT)
 213 {
 214         SM_ENTRY(EAP, RETRANSMIT);
 215
 216         sm->retransCount++;
 217         if (sm->retransCount <= sm->MaxRetrans && sm->lastReqData) {
 218                 if (eap_copy_buf(&sm->eap_if.eapReqData, sm->lastReqData) == 0)
 219                         sm->eap_if.eapReq = TRUE;
 220         }
 221 }
 222
 223
 224 SM_STATE(EAP, RECEIVED)
 225 {
 226         SM_ENTRY(EAP, RECEIVED);
 227
 228         /* parse rxResp, respId, respMethod */
 229         eap_sm_parseEapResp(sm, sm->eap_if.eapRespData);
 230         sm->num_rounds++;
 231 }
 232
 233
 234 SM_STATE(EAP, DISCARD)
 235 {
 236         SM_ENTRY(EAP, DISCARD);
 237         sm->eap_if.eapResp = FALSE;
 238         sm->eap_if.eapNoReq = TRUE;
 239 }
 240
 241
 242 SM_STATE(EAP, SEND_REQUEST)
 243 {
 244         SM_ENTRY(EAP, SEND_REQUEST);
 245
 246         sm->retransCount = 0;
 247         if (sm->eap_if.eapReqData) {
 248                 if (eap_copy_buf(&sm->lastReqData, sm->eap_if.eapReqData) == 0)
 249                 {
 250                         sm->eap_if.eapResp = FALSE;
 251                         sm->eap_if.eapReq = TRUE;
 252                 } else {
 253                         sm->eap_if.eapResp = FALSE;
 254                         sm->eap_if.eapReq = FALSE;
 255                 }
 256         } else {
 257                 wpa_printf(MSG_INFO, "EAP: SEND_REQUEST - no eapReqData");
 258                 sm->eap_if.eapResp = FALSE;
 259                 sm->eap_if.eapReq = FALSE;
 260                 sm->eap_if.eapNoReq = TRUE;
 261         }
 262 }
 263
 264
 265 SM_STATE(EAP, INTEGRITY_CHECK)
 266 {
 267         SM_ENTRY(EAP, INTEGRITY_CHECK);
 268
 269         if (sm->m->check) {
 270                 sm->ignore = sm->m->check(sm, sm->eap_method_priv,
 271                                           sm->eap_if.eapRespData);
 272         }
 273 }
 274
 275
 276 SM_STATE(EAP, METHOD_REQUEST)
 277 {
 278         SM_ENTRY(EAP, METHOD_REQUEST);
 279
 280         if (sm->m == NULL) {
 281                 wpa_printf(MSG_DEBUG, "EAP: method not initialized");
 282                 return;
 283         }
 284
 285         sm->currentId = eap_sm_nextId(sm, sm->currentId);
 286         wpa_printf(MSG_DEBUG, "EAP: building EAP-Request: Identifier %d",
 287                    sm->currentId);
 288         sm->lastId = sm->currentId;
 289         wpabuf_free(sm->eap_if.eapReqData);
 290         sm->eap_if.eapReqData = sm->m->buildReq(sm, sm->eap_method_priv,
 291                                                 sm->currentId);
 292         if (sm->m->getTimeout)
 293                 sm->methodTimeout = sm->m->getTimeout(sm, sm->eap_method_priv);
 294         else
 295                 sm->methodTimeout = 0;
 296 }
 297
 298
 299 SM_STATE(EAP, METHOD_RESPONSE)
 300 {
 301         SM_ENTRY(EAP, METHOD_RESPONSE);
 302
 303         sm->m->process(sm, sm->eap_method_priv, sm->eap_if.eapRespData);
 304         if (sm->m->isDone(sm, sm->eap_method_priv)) {
 305                 eap_sm_Policy_update(sm, NULL, 0);
 306                 os_free(sm->eap_if.eapKeyData);
 307                 if (sm->m->getKey) {
 308                         sm->eap_if.eapKeyData = sm->m->getKey(
 309                                 sm, sm->eap_method_priv,
 310                                 &sm->eap_if.eapKeyDataLen);
 311                 } else {
 312                         sm->eap_if.eapKeyData = NULL;
 313                         sm->eap_if.eapKeyDataLen = 0;
 314                 }
 315                 sm->methodState = METHOD_END;
 316         } else {
 317                 sm->methodState = METHOD_CONTINUE;
 318         }
 319 }
 320
 321
 322 SM_STATE(EAP, PROPOSE_METHOD)
 323 {
 324         int vendor;
 325         EapType type;
 326
 327         SM_ENTRY(EAP, PROPOSE_METHOD);
 328
 329         type = eap_sm_Policy_getNextMethod(sm, &vendor);
 330         if (vendor == EAP_VENDOR_IETF)
 331                 sm->currentMethod = type;
 332         else
 333                 sm->currentMethod = EAP_TYPE_EXPANDED;
 334         if (sm->m && sm->eap_method_priv) {
 335                 sm->m->reset(sm, sm->eap_method_priv);
 336                 sm->eap_method_priv = NULL;
 337         }
 338         sm->m = eap_server_get_eap_method(vendor, type);
 339         if (sm->m) {
 340                 sm->eap_method_priv = sm->m->init(sm);
 341                 if (sm->eap_method_priv == NULL) {
 342                         wpa_printf(MSG_DEBUG, "EAP: Failed to initialize EAP "
 343                                    "method %d", sm->currentMethod);
 344                         sm->m = NULL;
 345                         sm->currentMethod = EAP_TYPE_NONE;
 346                 }
 347         }
 348         if (sm->currentMethod == EAP_TYPE_IDENTITY ||
 349             sm->currentMethod == EAP_TYPE_NOTIFICATION)
 350                 sm->methodState = METHOD_CONTINUE;
 351         else
 352                 sm->methodState = METHOD_PROPOSED;
 353 }
 354
 355
 356 SM_STATE(EAP, NAK)
 357 {
 358         const struct eap_hdr *nak;
 359         size_t len = 0;
 360         const u8 *pos;
 361         const u8 *nak_list = NULL;
 362
 363         SM_ENTRY(EAP, NAK);
 364
 365         if (sm->eap_method_priv) {
 366                 sm->m->reset(sm, sm->eap_method_priv);
 367                 sm->eap_method_priv = NULL;
 368         }
 369         sm->m = NULL;
 370
 371         nak = wpabuf_head(sm->eap_if.eapRespData);
 372         if (nak && wpabuf_len(sm->eap_if.eapRespData) > sizeof(*nak)) {
 373                 len = be_to_host16(nak->length);
 374                 if (len > wpabuf_len(sm->eap_if.eapRespData))
 375                         len = wpabuf_len(sm->eap_if.eapRespData);
 376                 pos = (const u8 *) (nak + 1);
 377                 len -= sizeof(*nak);
 378                 if (*pos == EAP_TYPE_NAK) {
 379                         pos++;
 380                         len--;
 381                         nak_list = pos;
 382                 }
 383         }
 384         eap_sm_Policy_update(sm, nak_list, len);
 385 }
 386
 387
 388 SM_STATE(EAP, SELECT_ACTION)
 389 {
 390         SM_ENTRY(EAP, SELECT_ACTION);
 391
 392         sm->decision = eap_sm_Policy_getDecision(sm);
 393 }
 394
 395
 396 SM_STATE(EAP, TIMEOUT_FAILURE)
 397 {
 398         SM_ENTRY(EAP, TIMEOUT_FAILURE);
 399
 400         sm->eap_if.eapTimeout = TRUE;
 401 }
 402
 403
 404 SM_STATE(EAP, FAILURE)
 405 {
 406         SM_ENTRY(EAP, FAILURE);
 407
 408         wpabuf_free(sm->eap_if.eapReqData);
 409         sm->eap_if.eapReqData = eap_sm_buildFailure(sm, sm->currentId);
 410         wpabuf_free(sm->lastReqData);
 411         sm->lastReqData = NULL;
 412         sm->eap_if.eapFail = TRUE;
 413 }
 414
 415
 416 SM_STATE(EAP, SUCCESS)
 417 {
 418         SM_ENTRY(EAP, SUCCESS);
 419
 420         wpabuf_free(sm->eap_if.eapReqData);
 421         sm->eap_if.eapReqData = eap_sm_buildSuccess(sm, sm->currentId);
 422         wpabuf_free(sm->lastReqData);
 423         sm->lastReqData = NULL;
 424         if (sm->eap_if.eapKeyData)
 425                 sm->eap_if.eapKeyAvailable = TRUE;
 426         sm->eap_if.eapSuccess = TRUE;
 427 }
 428
 429
 430 SM_STATE(EAP, INITIALIZE_PASSTHROUGH)
 431 {
 432         SM_ENTRY(EAP, INITIALIZE_PASSTHROUGH);
 433
 434         wpabuf_free(sm->eap_if.aaaEapRespData);
 435         sm->eap_if.aaaEapRespData = NULL;
 436 }
 437
 438
 439 SM_STATE(EAP, IDLE2)
 440 {
 441         SM_ENTRY(EAP, IDLE2);
 442
 443         sm->eap_if.retransWhile = eap_sm_calculateTimeout(
 444                 sm, sm->retransCount, sm->eap_if.eapSRTT, sm->eap_if.eapRTTVAR,
 445                 sm->methodTimeout);
 446 }
 447
 448
 449 SM_STATE(EAP, RETRANSMIT2)
 450 {
 451         SM_ENTRY(EAP, RETRANSMIT2);
 452
 453         sm->retransCount++;
 454         if (sm->retransCount <= sm->MaxRetrans && sm->lastReqData) {
 455                 if (eap_copy_buf(&sm->eap_if.eapReqData, sm->lastReqData) == 0)
 456                         sm->eap_if.eapReq = TRUE;
 457         }
 458 }
 459
 460
 461 SM_STATE(EAP, RECEIVED2)
 462 {
 463         SM_ENTRY(EAP, RECEIVED2);
 464
 465         /* parse rxResp, respId, respMethod */
 466         eap_sm_parseEapResp(sm, sm->eap_if.eapRespData);
 467 }
 468
 469
 470 SM_STATE(EAP, DISCARD2)
 471 {
 472         SM_ENTRY(EAP, DISCARD2);
 473         sm->eap_if.eapResp = FALSE;
 474         sm->eap_if.eapNoReq = TRUE;
 475 }
 476
 477
 478 SM_STATE(EAP, SEND_REQUEST2)
 479 {
 480         SM_ENTRY(EAP, SEND_REQUEST2);
 481
 482         sm->retransCount = 0;
 483         if (sm->eap_if.eapReqData) {
 484                 if (eap_copy_buf(&sm->lastReqData, sm->eap_if.eapReqData) == 0)
 485                 {
 486                         sm->eap_if.eapResp = FALSE;
 487                         sm->eap_if.eapReq = TRUE;
 488                 } else {
 489                         sm->eap_if.eapResp = FALSE;
 490                         sm->eap_if.eapReq = FALSE;
 491                 }
 492         } else {
 493                 wpa_printf(MSG_INFO, "EAP: SEND_REQUEST2 - no eapReqData");
 494                 sm->eap_if.eapResp = FALSE;
 495                 sm->eap_if.eapReq = FALSE;
 496                 sm->eap_if.eapNoReq = TRUE;
 497         }
 498 }
 499
 500
 501 SM_STATE(EAP, AAA_REQUEST)
 502 {
 503         SM_ENTRY(EAP, AAA_REQUEST);
 504
 505         if (sm->eap_if.eapRespData == NULL) {
 506                 wpa_printf(MSG_INFO, "EAP: AAA_REQUEST - no eapRespData");
 507                 return;
 508         }
 509
 510         /*
 511          * if (respMethod == IDENTITY)
 512          *      aaaIdentity = eapRespData
 513          * This is already taken care of by the EAP-Identity method which
 514          * stores the identity into sm->identity.
 515          */
 516
 517         eap_copy_buf(&sm->eap_if.aaaEapRespData, sm->eap_if.eapRespData);
 518 }
 519
 520
 521 SM_STATE(EAP, AAA_RESPONSE)
 522 {
 523         SM_ENTRY(EAP, AAA_RESPONSE);
 524
 525         eap_copy_buf(&sm->eap_if.eapReqData, sm->eap_if.aaaEapReqData);
 526         sm->currentId = eap_sm_getId(sm->eap_if.eapReqData);
 527         sm->methodTimeout = sm->eap_if.aaaMethodTimeout;
 528 }
 529
 530
 531 SM_STATE(EAP, AAA_IDLE)
 532 {
 533         SM_ENTRY(EAP, AAA_IDLE);
 534
 535         sm->eap_if.aaaFail = FALSE;
 536         sm->eap_if.aaaSuccess = FALSE;
 537         sm->eap_if.aaaEapReq = FALSE;
 538         sm->eap_if.aaaEapNoReq = FALSE;
 539         sm->eap_if.aaaEapResp = TRUE;
 540 }
 541
 542
 543 SM_STATE(EAP, TIMEOUT_FAILURE2)
 544 {
 545         SM_ENTRY(EAP, TIMEOUT_FAILURE2);
 546
 547         sm->eap_if.eapTimeout = TRUE;
 548 }
 549
 550
 551 SM_STATE(EAP, FAILURE2)
 552 {
 553         SM_ENTRY(EAP, FAILURE2);
 554
 555         eap_copy_buf(&sm->eap_if.eapReqData, sm->eap_if.aaaEapReqData);
 556         sm->eap_if.eapFail = TRUE;
 557 }
 558
 559
 560 SM_STATE(EAP, SUCCESS2)
 561 {
 562         SM_ENTRY(EAP, SUCCESS2);
 563
 564         eap_copy_buf(&sm->eap_if.eapReqData, sm->eap_if.aaaEapReqData);
 565
 566         sm->eap_if.eapKeyAvailable = sm->eap_if.aaaEapKeyAvailable;
 567         if (sm->eap_if.aaaEapKeyAvailable) {
 568                 EAP_COPY(&sm->eap_if.eapKeyData, sm->eap_if.aaaEapKeyData);
 569         } else {
 570                 os_free(sm->eap_if.eapKeyData);
 571                 sm->eap_if.eapKeyData = NULL;
 572                 sm->eap_if.eapKeyDataLen = 0;
 573         }
 574
 575         sm->eap_if.eapSuccess = TRUE;
 576 }
 577
 578
 579 SM_STEP(EAP)
 580 {
 581         if (sm->eap_if.eapRestart && sm->eap_if.portEnabled)
 582                 SM_ENTER_GLOBAL(EAP, INITIALIZE);
 583         else if (!sm->eap_if.portEnabled)
 584                 SM_ENTER_GLOBAL(EAP, DISABLED);
 585         else if (sm->num_rounds > EAP_MAX_AUTH_ROUNDS) {
 586                 if (sm->num_rounds == EAP_MAX_AUTH_ROUNDS + 1) {
 587                         wpa_printf(MSG_DEBUG, "EAP: more than %d "
 588                                    "authentication rounds - abort",
 589                                    EAP_MAX_AUTH_ROUNDS);
 590                         sm->num_rounds++;
 591                         SM_ENTER_GLOBAL(EAP, FAILURE);
 592                 }
 593         } else switch (sm->EAP_state) {
 594         case EAP_INITIALIZE:
 595                 if (sm->backend_auth) {
 596                         if (!sm->rxResp)
 597                                 SM_ENTER(EAP, SELECT_ACTION);
 598                         else if (sm->rxResp &&
 599                                  (sm->respMethod == EAP_TYPE_NAK ||
 600                                   (sm->respMethod == EAP_TYPE_EXPANDED &&
 601                                    sm->respVendor == EAP_VENDOR_IETF &&
 602                                    sm->respVendorMethod == EAP_TYPE_NAK)))
 603                                 SM_ENTER(EAP, NAK);
 604                         else
 605                                 SM_ENTER(EAP, PICK_UP_METHOD);
 606                 } else {
 607                         SM_ENTER(EAP, SELECT_ACTION);
 608                 }
 609                 break;
 610         case EAP_PICK_UP_METHOD:
 611                 if (sm->currentMethod == EAP_TYPE_NONE) {
 612                         SM_ENTER(EAP, SELECT_ACTION);
 613                 } else {
 614                         SM_ENTER(EAP, METHOD_RESPONSE);
 615                 }
 616                 break;
 617         case EAP_DISABLED:
 618                 if (sm->eap_if.portEnabled)
 619                         SM_ENTER(EAP, INITIALIZE);
 620                 break;
 621         case EAP_IDLE:
 622                 if (sm->eap_if.retransWhile == 0)
 623                         SM_ENTER(EAP, RETRANSMIT);
 624                 else if (sm->eap_if.eapResp)
 625                         SM_ENTER(EAP, RECEIVED);
 626                 break;
 627         case EAP_RETRANSMIT:
 628                 if (sm->retransCount > sm->MaxRetrans)
 629                         SM_ENTER(EAP, TIMEOUT_FAILURE);
 630                 else
 631                         SM_ENTER(EAP, IDLE);
 632                 break;
 633         case EAP_RECEIVED:
 634                 if (sm->rxResp && (sm->respId == sm->currentId) &&
 635                     (sm->respMethod == EAP_TYPE_NAK ||
 636                      (sm->respMethod == EAP_TYPE_EXPANDED &&
 637                       sm->respVendor == EAP_VENDOR_IETF &&
 638                       sm->respVendorMethod == EAP_TYPE_NAK))
 639                     && (sm->methodState == METHOD_PROPOSED))
 640                         SM_ENTER(EAP, NAK);
 641                 else if (sm->rxResp && (sm->respId == sm->currentId) &&
 642                          ((sm->respMethod == sm->currentMethod) ||
 643                           (sm->respMethod == EAP_TYPE_EXPANDED &&
 644                            sm->respVendor == EAP_VENDOR_IETF &&
 645                            sm->respVendorMethod == sm->currentMethod)))
 646                         SM_ENTER(EAP, INTEGRITY_CHECK);
 647                 else {
 648                         wpa_printf(MSG_DEBUG, "EAP: RECEIVED->DISCARD: "
 649                                    "rxResp=%d respId=%d currentId=%d "
 650                                    "respMethod=%d currentMethod=%d",
 651                                    sm->rxResp, sm->respId, sm->currentId,
 652                                    sm->respMethod, sm->currentMethod);
 653                         SM_ENTER(EAP, DISCARD);
 654                 }
 655                 break;
 656         case EAP_DISCARD:
 657                 SM_ENTER(EAP, IDLE);
 658                 break;
 659         case EAP_SEND_REQUEST:
 660                 SM_ENTER(EAP, IDLE);
 661                 break;
 662         case EAP_INTEGRITY_CHECK:
 663                 if (sm->ignore)
 664                         SM_ENTER(EAP, DISCARD);
 665                 else
 666                         SM_ENTER(EAP, METHOD_RESPONSE);
 667                 break;
 668         case EAP_METHOD_REQUEST:
 669                 SM_ENTER(EAP, SEND_REQUEST);
 670                 break;
 671         case EAP_METHOD_RESPONSE:
 672                 /*
 673                  * Note: Mechanism to allow EAP methods to wait while going
 674                  * through pending processing is an extension to RFC 4137
 675                  * which only defines the transits to SELECT_ACTION and
 676                  * METHOD_REQUEST from this METHOD_RESPONSE state.
 677                  */
 678                 if (sm->methodState == METHOD_END)
 679                         SM_ENTER(EAP, SELECT_ACTION);
 680                 else if (sm->method_pending == METHOD_PENDING_WAIT) {
 681                         wpa_printf(MSG_DEBUG, "EAP: Method has pending "
 682                                    "processing - wait before proceeding to "
 683                                    "METHOD_REQUEST state");
 684                 } else if (sm->method_pending == METHOD_PENDING_CONT) {
 685                         wpa_printf(MSG_DEBUG, "EAP: Method has completed "
 686                                    "pending processing - reprocess pending "
 687                                    "EAP message");
 688                         sm->method_pending = METHOD_PENDING_NONE;
 689                         SM_ENTER(EAP, METHOD_RESPONSE);
 690                 } else
 691                         SM_ENTER(EAP, METHOD_REQUEST);
 692                 break;
 693         case EAP_PROPOSE_METHOD:
 694                 /*
 695                  * Note: Mechanism to allow EAP methods to wait while going
 696                  * through pending processing is an extension to RFC 4137
 697                  * which only defines the transit to METHOD_REQUEST from this
 698                  * PROPOSE_METHOD state.
 699                  */
 700                 if (sm->method_pending == METHOD_PENDING_WAIT) {
 701                         wpa_printf(MSG_DEBUG, "EAP: Method has pending "
 702                                    "processing - wait before proceeding to "
 703                                    "METHOD_REQUEST state");
 704                         if (sm->user_eap_method_index > 0)
 705                                 sm->user_eap_method_index--;
 706                 } else if (sm->method_pending == METHOD_PENDING_CONT) {
 707                         wpa_printf(MSG_DEBUG, "EAP: Method has completed "
 708                                    "pending processing - reprocess pending "
 709                                    "EAP message");
 710                         sm->method_pending = METHOD_PENDING_NONE;
 711                         SM_ENTER(EAP, PROPOSE_METHOD);
 712                 } else
 713                         SM_ENTER(EAP, METHOD_REQUEST);
 714                 break;
 715         case EAP_NAK:
 716                 SM_ENTER(EAP, SELECT_ACTION);
 717                 break;
 718         case EAP_SELECT_ACTION:
 719                 if (sm->decision == DECISION_FAILURE)
 720                         SM_ENTER(EAP, FAILURE);
 721                 else if (sm->decision == DECISION_SUCCESS)
 722                         SM_ENTER(EAP, SUCCESS);
 723                 else if (sm->decision == DECISION_PASSTHROUGH)
 724                         SM_ENTER(EAP, INITIALIZE_PASSTHROUGH);
 725                 else
 726                         SM_ENTER(EAP, PROPOSE_METHOD);
 727                 break;
 728         case EAP_TIMEOUT_FAILURE:
 729                 break;
 730         case EAP_FAILURE:
 731                 break;
 732         case EAP_SUCCESS:
 733                 break;
 734
 735         case EAP_INITIALIZE_PASSTHROUGH:
 736                 if (sm->currentId == -1)
 737                         SM_ENTER(EAP, AAA_IDLE);
 738                 else
 739                         SM_ENTER(EAP, AAA_REQUEST);
 740                 break;
 741         case EAP_IDLE2:
 742                 if (sm->eap_if.eapResp)
 743                         SM_ENTER(EAP, RECEIVED2);
 744                 else if (sm->eap_if.retransWhile == 0)
 745                         SM_ENTER(EAP, RETRANSMIT2);
 746                 break;
 747         case EAP_RETRANSMIT2:
 748                 if (sm->retransCount > sm->MaxRetrans)
 749                         SM_ENTER(EAP, TIMEOUT_FAILURE2);
 750                 else
 751                         SM_ENTER(EAP, IDLE2);
 752                 break;
 753         case EAP_RECEIVED2:
 754                 if (sm->rxResp && (sm->respId == sm->currentId))
 755                         SM_ENTER(EAP, AAA_REQUEST);
 756                 else
 757                         SM_ENTER(EAP, DISCARD2);
 758                 break;
 759         case EAP_DISCARD2:
 760                 SM_ENTER(EAP, IDLE2);
 761                 break;
 762         case EAP_SEND_REQUEST2:
 763                 SM_ENTER(EAP, IDLE2);
 764                 break;
 765         case EAP_AAA_REQUEST:
 766                 SM_ENTER(EAP, AAA_IDLE);
 767                 break;
 768         case EAP_AAA_RESPONSE:
 769                 SM_ENTER(EAP, SEND_REQUEST2);
 770                 break;
 771         case EAP_AAA_IDLE:
 772                 if (sm->eap_if.aaaFail)
 773                         SM_ENTER(EAP, FAILURE2);
 774                 else if (sm->eap_if.aaaSuccess)
 775                         SM_ENTER(EAP, SUCCESS2);
 776                 else if (sm->eap_if.aaaEapReq)
 777                         SM_ENTER(EAP, AAA_RESPONSE);
 778                 else if (sm->eap_if.aaaTimeout)
 779                         SM_ENTER(EAP, TIMEOUT_FAILURE2);
 780                 break;
 781         case EAP_TIMEOUT_FAILURE2:
 782                 break;
 783         case EAP_FAILURE2:
 784                 break;
 785         case EAP_SUCCESS2:
 786                 break;
 787         }
 788 }
 789
 790
 791 static int eap_sm_calculateTimeout(struct eap_sm *sm, int retransCount,
 792                                    int eapSRTT, int eapRTTVAR,
 793                                    int methodTimeout)
 794 {
 795         int rto, i;
 796
 797         if (methodTimeout) {
 798                 /*
 799                  * EAP method (either internal or through AAA server, provided
 800                  * timeout hint. Use that as-is as a timeout for retransmitting
 801                  * the EAP request if no response is received.
 802                  */
 803                 wpa_printf(MSG_DEBUG, "EAP: retransmit timeout %d seconds "
 804                            "(from EAP method hint)", methodTimeout);
 805                 return methodTimeout;
 806         }
 807
 808         /*
 809          * RFC 3748 recommends algorithms described in RFC 2988 for estimation
 810          * of the retransmission timeout. This should be implemented once
 811          * round-trip time measurements are available. For nowm a simple
 812          * backoff mechanism is used instead if there are no EAP method
 813          * specific hints.
 814          *
 815          * SRTT = smoothed round-trip time
 816          * RTTVAR = round-trip time variation
 817          * RTO = retransmission timeout
 818          */
 819
 820         /*
 821          * RFC 2988, 2.1: before RTT measurement, set RTO to 3 seconds for
 822          * initial retransmission and then double the RTO to provide back off
 823          * per 5.5. Limit the maximum RTO to 20 seconds per RFC 3748, 4.3
 824          * modified RTOmax.
 825          */
 826         rto = 3;
 827         for (i = 0; i < retransCount; i++) {
 828                 rto *= 2;
 829                 if (rto >= 20) {
 830                         rto = 20;
 831                         break;
 832                 }
 833         }
 834
 835         wpa_printf(MSG_DEBUG, "EAP: retransmit timeout %d seconds "
 836                    "(from dynamic back off; retransCount=%d)",
 837                    rto, retransCount);
 838
 839         return rto;
 840 }
 841
 842
 843 static void eap_sm_parseEapResp(struct eap_sm *sm, const struct wpabuf *resp)
 844 {
 845         const struct eap_hdr *hdr;
 846         size_t plen;
 847
 848         /* parse rxResp, respId, respMethod */
 849         sm->rxResp = FALSE;
 850         sm->respId = -1;
 851         sm->respMethod = EAP_TYPE_NONE;
 852         sm->respVendor = EAP_VENDOR_IETF;
 853         sm->respVendorMethod = EAP_TYPE_NONE;
 854
 855         if (resp == NULL || wpabuf_len(resp) < sizeof(*hdr)) {
 856                 wpa_printf(MSG_DEBUG, "EAP: parseEapResp: invalid resp=%p "
 857                            "len=%lu", resp,
 858                            resp ? (unsigned long) wpabuf_len(resp) : 0);
 859                 return;
 860         }
 861
 862         hdr = wpabuf_head(resp);
 863         plen = be_to_host16(hdr->length);
 864         if (plen > wpabuf_len(resp)) {
 865                 wpa_printf(MSG_DEBUG, "EAP: Ignored truncated EAP-Packet "
 866                            "(len=%lu plen=%lu)",
 867                            (unsigned long) wpabuf_len(resp),
 868                            (unsigned long) plen);
 869                 return;
 870         }
 871
 872         sm->respId = hdr->identifier;
 873
 874         if (hdr->code == EAP_CODE_RESPONSE)
 875                 sm->rxResp = TRUE;
 876
 877         if (plen > sizeof(*hdr)) {
 878                 u8 *pos = (u8 *) (hdr + 1);
 879                 sm->respMethod = *pos++;
 880                 if (sm->respMethod == EAP_TYPE_EXPANDED) {
 881                         if (plen < sizeof(*hdr) + 8) {
 882                                 wpa_printf(MSG_DEBUG, "EAP: Ignored truncated "
 883                                            "expanded EAP-Packet (plen=%lu)",
 884                                            (unsigned long) plen);
 885                                 return;
 886                         }
 887                         sm->respVendor = WPA_GET_BE24(pos);
 888                         pos += 3;
 889                         sm->respVendorMethod = WPA_GET_BE32(pos);
 890                 }
 891         }
 892
 893         wpa_printf(MSG_DEBUG, "EAP: parseEapResp: rxResp=%d respId=%d "
 894                    "respMethod=%u respVendor=%u respVendorMethod=%u",
 895                    sm->rxResp, sm->respId, sm->respMethod, sm->respVendor,
 896                    sm->respVendorMethod);
 897 }
 898
 899
 900 static int eap_sm_getId(const struct wpabuf *data)
 901 {
 902         const struct eap_hdr *hdr;
 903
 904         if (data == NULL || wpabuf_len(data) < sizeof(*hdr))
 905                 return -1;
 906
 907         hdr = wpabuf_head(data);
 908         wpa_printf(MSG_DEBUG, "EAP: getId: id=%d", hdr->identifier);
 909         return hdr->identifier;
 910 }
 911
 912
 913 static struct wpabuf * eap_sm_buildSuccess(struct eap_sm *sm, u8 id)
 914 {
 915         struct wpabuf *msg;
 916         struct eap_hdr *resp;
 917         wpa_printf(MSG_DEBUG, "EAP: Building EAP-Success (id=%d)", id);
 918
 919         msg = wpabuf_alloc(sizeof(*resp));
 920         if (msg == NULL)
 921                 return NULL;
 922         resp = wpabuf_put(msg, sizeof(*resp));
 923         resp->code = EAP_CODE_SUCCESS;
 924         resp->identifier = id;
 925         resp->length = host_to_be16(sizeof(*resp));
 926
 927         return msg;
 928 }
 929
 930
 931 static struct wpabuf * eap_sm_buildFailure(struct eap_sm *sm, u8 id)
 932 {
 933         struct wpabuf *msg;
 934         struct eap_hdr *resp;
 935         wpa_printf(MSG_DEBUG, "EAP: Building EAP-Failure (id=%d)", id);
 936
 937         msg = wpabuf_alloc(sizeof(*resp));
 938         if (msg == NULL)
 939                 return NULL;
 940         resp = wpabuf_put(msg, sizeof(*resp));
 941         resp->code = EAP_CODE_FAILURE;
 942         resp->identifier = id;
 943         resp->length = host_to_be16(sizeof(*resp));
 944
 945         return msg;
 946 }
 947
 948
 949 static int eap_sm_nextId(struct eap_sm *sm, int id)
 950 {
 951         if (id < 0) {
 952                 /* RFC 3748 Ch 4.1: recommended to initialize Identifier with a
 953                  * random number */
 954                 id = rand() & 0xff;
 955                 if (id != sm->lastId)
 956                         return id;
 957         }
 958         return (id + 1) & 0xff;
 959 }
 960
 961
 962 /**
 963  * eap_sm_process_nak - Process EAP-Response/Nak
 964  * @sm: Pointer to EAP state machine allocated with eap_server_sm_init()
 965  * @nak_list: Nak list (allowed methods) from the supplicant
 966  * @len: Length of nak_list in bytes
 967  *
 968  * This function is called when EAP-Response/Nak is received from the
 969  * supplicant. This can happen for both phase 1 and phase 2 authentications.
 970  */
 971 void eap_sm_process_nak(struct eap_sm *sm, const u8 *nak_list, size_t len)
 972 {
 973         int i;
 974         size_t j;
 975
 976         if (sm->user == NULL)
 977                 return;
 978
 979         wpa_printf(MSG_MSGDUMP, "EAP: processing NAK (current EAP method "
 980                    "index %d)", sm->user_eap_method_index);
 981
 982         wpa_hexdump(MSG_MSGDUMP, "EAP: configured methods",
 983                     (u8 *) sm->user->methods,
 984                     EAP_MAX_METHODS * sizeof(sm->user->methods[0]));
 985         wpa_hexdump(MSG_MSGDUMP, "EAP: list of methods supported by the peer",
 986                     nak_list, len);
 987
 988         i = sm->user_eap_method_index;
 989         while (i < EAP_MAX_METHODS &&
 990                (sm->user->methods[i].vendor != EAP_VENDOR_IETF ||
 991                 sm->user->methods[i].method != EAP_TYPE_NONE)) {
 992                 if (sm->user->methods[i].vendor != EAP_VENDOR_IETF)
 993                         goto not_found;
 994                 for (j = 0; j < len; j++) {
 995                         if (nak_list[j] == sm->user->methods[i].method) {
 996                                 break;
 997                         }
 998                 }
 999
1000                 if (j < len) {
1001                         /* found */
1002                         i++;
1003                         continue;
1004                 }
1005
1006         not_found:
1007                 /* not found - remove from the list */
1008                 os_memmove(&sm->user->methods[i], &sm->user->methods[i + 1],
1009                            (EAP_MAX_METHODS - i - 1) *
1010                            sizeof(sm->user->methods[0]));
1011                 sm->user->methods[EAP_MAX_METHODS - 1].vendor =
1012                         EAP_VENDOR_IETF;
1013                 sm->user->methods[EAP_MAX_METHODS - 1].method = EAP_TYPE_NONE;
1014         }
1015
1016         wpa_hexdump(MSG_MSGDUMP, "EAP: new list of configured methods",
1017                     (u8 *) sm->user->methods, EAP_MAX_METHODS *
1018                     sizeof(sm->user->methods[0]));
1019 }
1020
1021
1022 static void eap_sm_Policy_update(struct eap_sm *sm, const u8 *nak_list,
1023                                  size_t len)
1024 {
1025         if (nak_list == NULL || sm == NULL || sm->user == NULL)
1026                 return;
1027
1028         if (sm->user->phase2) {
1029                 wpa_printf(MSG_DEBUG, "EAP: EAP-Nak received after Phase2 user"
1030                            " info was selected - reject");
1031                 sm->decision = DECISION_FAILURE;
1032                 return;
1033         }
1034
1035         eap_sm_process_nak(sm, nak_list, len);
1036 }
1037
1038
1039 static EapType eap_sm_Policy_getNextMethod(struct eap_sm *sm, int *vendor)
1040 {
1041         EapType next;
1042         int idx = sm->user_eap_method_index;
1043
1044         /* In theory, there should be no problems with starting
1045          * re-authentication with something else than EAP-Request/Identity and
1046          * this does indeed work with wpa_supplicant. However, at least Funk
1047          * Supplicant seemed to ignore re-auth if it skipped
1048          * EAP-Request/Identity.
1049          * Re-auth sets currentId == -1, so that can be used here to select
1050          * whether Identity needs to be requested again. */
1051         if (sm->identity == NULL || sm->currentId == -1) {
1052                 *vendor = EAP_VENDOR_IETF;
1053                 next = EAP_TYPE_IDENTITY;
1054                 sm->update_user = TRUE;
1055         } else if (sm->user && idx < EAP_MAX_METHODS &&
1056                    (sm->user->methods[idx].vendor != EAP_VENDOR_IETF ||
1057                     sm->user->methods[idx].method != EAP_TYPE_NONE)) {
1058                 *vendor = sm->user->methods[idx].vendor;
1059                 next = sm->user->methods[idx].method;
1060                 sm->user_eap_method_index++;
1061         } else {
1062                 *vendor = EAP_VENDOR_IETF;
1063                 next = EAP_TYPE_NONE;
1064         }
1065         wpa_printf(MSG_DEBUG, "EAP: getNextMethod: vendor %d type %d",
1066                    *vendor, next);
1067         return next;
1068 }
1069
1070
1071 static int eap_sm_Policy_getDecision(struct eap_sm *sm)
1072 {
1073         if (!sm->eap_server && sm->identity) {
1074                 wpa_printf(MSG_DEBUG, "EAP: getDecision: -> PASSTHROUGH");
1075                 return DECISION_PASSTHROUGH;
1076         }
1077
1078         if (sm->m && sm->currentMethod != EAP_TYPE_IDENTITY &&
1079             sm->m->isSuccess(sm, sm->eap_method_priv)) {
1080                 wpa_printf(MSG_DEBUG, "EAP: getDecision: method succeeded -> "
1081                            "SUCCESS");
1082                 sm->update_user = TRUE;
1083                 return DECISION_SUCCESS;
1084         }
1085
1086         if (sm->m && sm->m->isDone(sm, sm->eap_method_priv) &&
1087             !sm->m->isSuccess(sm, sm->eap_method_priv)) {
1088                 wpa_printf(MSG_DEBUG, "EAP: getDecision: method failed -> "
1089                            "FAILURE");
1090                 sm->update_user = TRUE;
1091                 return DECISION_FAILURE;
1092         }
1093
1094         if ((sm->user == NULL || sm->update_user) && sm->identity) {
1095                 /*
1096                  * Allow Identity method to be started once to allow identity
1097                  * selection hint to be sent from the authentication server,
1098                  * but prevent a loop of Identity requests by only allowing
1099                  * this to happen once.
1100                  */
1101                 int id_req = 0;
1102                 if (sm->user && sm->currentMethod == EAP_TYPE_IDENTITY &&
1103                     sm->user->methods[0].vendor == EAP_VENDOR_IETF &&
1104                     sm->user->methods[0].method == EAP_TYPE_IDENTITY)
1105                         id_req = 1;
1106                 if (eap_user_get(sm, sm->identity, sm->identity_len, 0) != 0) {
1107                         wpa_printf(MSG_DEBUG, "EAP: getDecision: user not "
1108                                    "found from database -> FAILURE");
1109                         return DECISION_FAILURE;
1110                 }
1111                 if (id_req && sm->user &&
1112                     sm->user->methods[0].vendor == EAP_VENDOR_IETF &&
1113                     sm->user->methods[0].method == EAP_TYPE_IDENTITY) {
1114                         wpa_printf(MSG_DEBUG, "EAP: getDecision: stop "
1115                                    "identity request loop -> FAILURE");
1116                         sm->update_user = TRUE;
1117                         return DECISION_FAILURE;
1118                 }
1119                 sm->update_user = FALSE;
1120         }
1121
1122         if (sm->user && sm->user_eap_method_index < EAP_MAX_METHODS &&
1123             (sm->user->methods[sm->user_eap_method_index].vendor !=
1124              EAP_VENDOR_IETF ||
1125              sm->user->methods[sm->user_eap_method_index].method !=
1126              EAP_TYPE_NONE)) {
1127                 wpa_printf(MSG_DEBUG, "EAP: getDecision: another method "
1128                            "available -> CONTINUE");
1129                 return DECISION_CONTINUE;
1130         }
1131
1132         if (sm->identity == NULL || sm->currentId == -1) {
1133                 wpa_printf(MSG_DEBUG, "EAP: getDecision: no identity known "
1134                            "yet -> CONTINUE");
1135                 return DECISION_CONTINUE;
1136         }
1137
1138         wpa_printf(MSG_DEBUG, "EAP: getDecision: no more methods available -> "
1139                    "FAILURE");
1140         return DECISION_FAILURE;
1141 }
1142
1143
1144 static Boolean eap_sm_Policy_doPickUp(struct eap_sm *sm, EapType method)
1145 {
1146         return method == EAP_TYPE_IDENTITY ? TRUE : FALSE;
1147 }
1148
1149
1150 /**
1151  * eap_server_sm_step - Step EAP server state machine
1152  * @sm: Pointer to EAP state machine allocated with eap_server_sm_init()
1153  * Returns: 1 if EAP state was changed or 0 if not
1154  *
1155  * This function advances EAP state machine to a new state to match with the
1156  * current variables. This should be called whenever variables used by the EAP
1157  * state machine have changed.
1158  */
1159 int eap_server_sm_step(struct eap_sm *sm)
1160 {
1161         int res = 0;
1162         do {
1163                 sm->changed = FALSE;
1164                 SM_STEP_RUN(EAP);
1165                 if (sm->changed)
1166                         res = 1;
1167         } while (sm->changed);
1168         return res;
1169 }
1170
1171
1172 static void eap_user_free(struct eap_user *user)
1173 {
1174         if (user == NULL)
1175                 return;
1176         os_free(user->password);
1177         user->password = NULL;
1178         os_free(user);
1179 }
1180
1181
1182 /**
1183  * eap_server_sm_init - Allocate and initialize EAP server state machine
1184  * @eapol_ctx: Context data to be used with eapol_cb calls
1185  * @eapol_cb: Pointer to EAPOL callback functions
1186  * @conf: EAP configuration
1187  * Returns: Pointer to the allocated EAP state machine or %NULL on failure
1188  *
1189  * This function allocates and initializes an EAP state machine.
1190  */
1191 struct eap_sm * eap_server_sm_init(void *eapol_ctx,
1192                                    struct eapol_callbacks *eapol_cb,
1193                                    struct eap_config *conf)
1194 {
1195         struct eap_sm *sm;
1196
1197         sm = os_zalloc(sizeof(*sm));
1198         if (sm == NULL)
1199                 return NULL;
1200         sm->eapol_ctx = eapol_ctx;
1201         sm->eapol_cb = eapol_cb;
1202         sm->MaxRetrans = 5; /* RFC 3748: max 3-5 retransmissions suggested */
1203         sm->ssl_ctx = conf->ssl_ctx;
1204         sm->eap_sim_db_priv = conf->eap_sim_db_priv;
1205         sm->backend_auth = conf->backend_auth;
1206         sm->eap_server = conf->eap_server;
1207         if (conf->pac_opaque_encr_key) {
1208                 sm->pac_opaque_encr_key = os_malloc(16);
1209                 if (sm->pac_opaque_encr_key) {
1210                         os_memcpy(sm->pac_opaque_encr_key,
1211                                   conf->pac_opaque_encr_key, 16);
1212                 }
1213         }
1214         if (conf->eap_fast_a_id) {
1215                 sm->eap_fast_a_id = os_malloc(conf->eap_fast_a_id_len);
1216                 if (sm->eap_fast_a_id) {
1217                         os_memcpy(sm->eap_fast_a_id, conf->eap_fast_a_id,
1218                                   conf->eap_fast_a_id_len);
1219                         sm->eap_fast_a_id_len = conf->eap_fast_a_id_len;
1220                 }
1221         }
1222         if (conf->eap_fast_a_id_info)
1223                 sm->eap_fast_a_id_info = os_strdup(conf->eap_fast_a_id_info);
1224         sm->eap_fast_prov = conf->eap_fast_prov;
1225         sm->pac_key_lifetime = conf->pac_key_lifetime;
1226         sm->pac_key_refresh_time = conf->pac_key_refresh_time;
1227         sm->eap_sim_aka_result_ind = conf->eap_sim_aka_result_ind;
1228         sm->tnc = conf->tnc;
1229         sm->wps = conf->wps;
1230         if (conf->assoc_wps_ie)
1231                 sm->assoc_wps_ie = wpabuf_dup(conf->assoc_wps_ie);
1232
1233         wpa_printf(MSG_DEBUG, "EAP: Server state machine created");
1234
1235         return sm;
1236 }
1237
1238
1239 /**
1240  * eap_server_sm_deinit - Deinitialize and free an EAP server state machine
1241  * @sm: Pointer to EAP state machine allocated with eap_server_sm_init()
1242  *
1243  * This function deinitializes EAP state machine and frees all allocated
1244  * resources.
1245  */
1246 void eap_server_sm_deinit(struct eap_sm *sm)
1247 {
1248         if (sm == NULL)
1249                 return;
1250         wpa_printf(MSG_DEBUG, "EAP: Server state machine removed");
1251         if (sm->m && sm->eap_method_priv)
1252                 sm->m->reset(sm, sm->eap_method_priv);
1253         wpabuf_free(sm->eap_if.eapReqData);
1254         os_free(sm->eap_if.eapKeyData);
1255         os_free(sm->lastReqData);
1256         wpabuf_free(sm->eap_if.eapRespData);
1257         os_free(sm->identity);
1258         os_free(sm->pac_opaque_encr_key);
1259         os_free(sm->eap_fast_a_id);
1260         os_free(sm->eap_fast_a_id_info);
1261         wpabuf_free(sm->eap_if.aaaEapReqData);
1262         wpabuf_free(sm->eap_if.aaaEapRespData);
1263         os_free(sm->eap_if.aaaEapKeyData);
1264         eap_user_free(sm->user);
1265         wpabuf_free(sm->assoc_wps_ie);
1266         os_free(sm);
1267 }
1268
1269
1270 /**
1271  * eap_sm_notify_cached - Notify EAP state machine of cached PMK
1272  * @sm: Pointer to EAP state machine allocated with eap_server_sm_init()
1273  *
1274  * This function is called when PMKSA caching is used to skip EAP
1275  * authentication.
1276  */
1277 void eap_sm_notify_cached(struct eap_sm *sm)
1278 {
1279         if (sm == NULL)
1280                 return;
1281
1282         sm->EAP_state = EAP_SUCCESS;
1283 }
1284
1285
1286 /**
1287  * eap_sm_pending_cb - EAP state machine callback for a pending EAP request
1288  * @sm: Pointer to EAP state machine allocated with eap_server_sm_init()
1289  *
1290  * This function is called when data for a pending EAP-Request is received.
1291  */
1292 void eap_sm_pending_cb(struct eap_sm *sm)
1293 {
1294         if (sm == NULL)
1295                 return;
1296         wpa_printf(MSG_DEBUG, "EAP: Callback for pending request received");
1297         if (sm->method_pending == METHOD_PENDING_WAIT)
1298                 sm->method_pending = METHOD_PENDING_CONT;
1299 }
1300
1301
1302 /**
1303  * eap_sm_method_pending - Query whether EAP method is waiting for pending data
1304  * @sm: Pointer to EAP state machine allocated with eap_server_sm_init()
1305  * Returns: 1 if method is waiting for pending data or 0 if not
1306  */
1307 int eap_sm_method_pending(struct eap_sm *sm)
1308 {
1309         if (sm == NULL)
1310                 return 0;
1311         return sm->method_pending == METHOD_PENDING_WAIT;
1312 }
1313
1314
1315 /**
1316  * eap_get_identity - Get the user identity (from EAP-Response/Identity)
1317  * @sm: Pointer to EAP state machine allocated with eap_server_sm_init()
1318  * @len: Buffer for returning identity length
1319  * Returns: Pointer to the user identity or %NULL if not available
1320  */
1321 const u8 * eap_get_identity(struct eap_sm *sm, size_t *len)
1322 {
1323         *len = sm->identity_len;
1324         return sm->identity;
1325 }
1326
1327
1328 /**
1329  * eap_get_interface - Get pointer to EAP-EAPOL interface data
1330  * @sm: Pointer to EAP state machine allocated with eap_server_sm_init()
1331  * Returns: Pointer to the EAP-EAPOL interface data
1332  */
1333 struct eap_eapol_interface * eap_get_interface(struct eap_sm *sm)
1334 {
1335         return &sm->eap_if;
1336 }