wps.c revision de47be75037bccd4a11b62eedb3d4aed1b36fa67
1/* 2 * Wi-Fi Protected Setup 3 * Copyright (c) 2007-2009, Jouni Malinen <j@w1.fi> 4 * 5 * This software may be distributed under the terms of the BSD license. 6 * See README for more details. 7 */ 8 9#include "includes.h" 10 11#include "common.h" 12#include "crypto/dh_group5.h" 13#include "common/ieee802_11_defs.h" 14#include "wps_i.h" 15#include "wps_dev_attr.h" 16 17 18#ifdef CONFIG_WPS_TESTING 19int wps_version_number = 0x20; 20int wps_testing_dummy_cred = 0; 21int wps_corrupt_pkhash = 0; 22int wps_force_auth_types_in_use = 0; 23u16 wps_force_auth_types = 0; 24int wps_force_encr_types_in_use = 0; 25u16 wps_force_encr_types = 0; 26#endif /* CONFIG_WPS_TESTING */ 27 28 29/** 30 * wps_init - Initialize WPS Registration protocol data 31 * @cfg: WPS configuration 32 * Returns: Pointer to allocated data or %NULL on failure 33 * 34 * This function is used to initialize WPS data for a registration protocol 35 * instance (i.e., each run of registration protocol as a Registrar of 36 * Enrollee. The caller is responsible for freeing this data after the 37 * registration run has been completed by calling wps_deinit(). 38 */ 39struct wps_data * wps_init(const struct wps_config *cfg) 40{ 41 struct wps_data *data = os_zalloc(sizeof(*data)); 42 if (data == NULL) 43 return NULL; 44 data->wps = cfg->wps; 45 data->registrar = cfg->registrar; 46 if (cfg->registrar) { 47 os_memcpy(data->uuid_r, cfg->wps->uuid, WPS_UUID_LEN); 48 } else { 49 os_memcpy(data->mac_addr_e, cfg->wps->dev.mac_addr, ETH_ALEN); 50 os_memcpy(data->uuid_e, cfg->wps->uuid, WPS_UUID_LEN); 51 } 52 if (cfg->pin) { 53 data->dev_pw_id = cfg->dev_pw_id; 54 data->dev_password = os_malloc(cfg->pin_len); 55 if (data->dev_password == NULL) { 56 os_free(data); 57 return NULL; 58 } 59 os_memcpy(data->dev_password, cfg->pin, cfg->pin_len); 60 data->dev_password_len = cfg->pin_len; 61 wpa_hexdump_key(MSG_DEBUG, "WPS: AP PIN dev_password", 62 data->dev_password, data->dev_password_len); 63 } 64 65#ifdef CONFIG_WPS_NFC 66 if (cfg->pin == NULL && 67 cfg->dev_pw_id == DEV_PW_NFC_CONNECTION_HANDOVER) 68 data->dev_pw_id = cfg->dev_pw_id; 69 70 if (cfg->wps->ap && !cfg->registrar && cfg->wps->ap_nfc_dev_pw_id) { 71 /* Keep AP PIN as alternative Device Password */ 72 data->alt_dev_pw_id = data->dev_pw_id; 73 data->alt_dev_password = data->dev_password; 74 data->alt_dev_password_len = data->dev_password_len; 75 76 data->dev_pw_id = cfg->wps->ap_nfc_dev_pw_id; 77 data->dev_password = 78 os_malloc(wpabuf_len(cfg->wps->ap_nfc_dev_pw)); 79 if (data->dev_password == NULL) { 80 os_free(data); 81 return NULL; 82 } 83 os_memcpy(data->dev_password, 84 wpabuf_head(cfg->wps->ap_nfc_dev_pw), 85 wpabuf_len(cfg->wps->ap_nfc_dev_pw)); 86 data->dev_password_len = wpabuf_len(cfg->wps->ap_nfc_dev_pw); 87 wpa_hexdump_key(MSG_DEBUG, "WPS: NFC dev_password", 88 data->dev_password, data->dev_password_len); 89 } 90#endif /* CONFIG_WPS_NFC */ 91 92 data->pbc = cfg->pbc; 93 if (cfg->pbc) { 94 /* Use special PIN '00000000' for PBC */ 95 data->dev_pw_id = DEV_PW_PUSHBUTTON; 96 bin_clear_free(data->dev_password, data->dev_password_len); 97 data->dev_password = (u8 *) os_strdup("00000000"); 98 if (data->dev_password == NULL) { 99 os_free(data); 100 return NULL; 101 } 102 data->dev_password_len = 8; 103 } 104 105 data->state = data->registrar ? RECV_M1 : SEND_M1; 106 107 if (cfg->assoc_wps_ie) { 108 struct wps_parse_attr attr; 109 wpa_hexdump_buf(MSG_DEBUG, "WPS: WPS IE from (Re)AssocReq", 110 cfg->assoc_wps_ie); 111 if (wps_parse_msg(cfg->assoc_wps_ie, &attr) < 0) { 112 wpa_printf(MSG_DEBUG, "WPS: Failed to parse WPS IE " 113 "from (Re)AssocReq"); 114 } else if (attr.request_type == NULL) { 115 wpa_printf(MSG_DEBUG, "WPS: No Request Type attribute " 116 "in (Re)AssocReq WPS IE"); 117 } else { 118 wpa_printf(MSG_DEBUG, "WPS: Request Type (from WPS IE " 119 "in (Re)AssocReq WPS IE): %d", 120 *attr.request_type); 121 data->request_type = *attr.request_type; 122 } 123 } 124 125 if (cfg->new_ap_settings) { 126 data->new_ap_settings = 127 os_malloc(sizeof(*data->new_ap_settings)); 128 if (data->new_ap_settings == NULL) { 129 bin_clear_free(data->dev_password, 130 data->dev_password_len); 131 os_free(data); 132 return NULL; 133 } 134 os_memcpy(data->new_ap_settings, cfg->new_ap_settings, 135 sizeof(*data->new_ap_settings)); 136 } 137 138 if (cfg->peer_addr) 139 os_memcpy(data->peer_dev.mac_addr, cfg->peer_addr, ETH_ALEN); 140 if (cfg->p2p_dev_addr) 141 os_memcpy(data->p2p_dev_addr, cfg->p2p_dev_addr, ETH_ALEN); 142 143 data->use_psk_key = cfg->use_psk_key; 144 data->pbc_in_m1 = cfg->pbc_in_m1; 145 146 if (cfg->peer_pubkey_hash) { 147 os_memcpy(data->peer_pubkey_hash, cfg->peer_pubkey_hash, 148 WPS_OOB_PUBKEY_HASH_LEN); 149 data->peer_pubkey_hash_set = 1; 150 } 151 152 return data; 153} 154 155 156/** 157 * wps_deinit - Deinitialize WPS Registration protocol data 158 * @data: WPS Registration protocol data from wps_init() 159 */ 160void wps_deinit(struct wps_data *data) 161{ 162#ifdef CONFIG_WPS_NFC 163 if (data->registrar && data->nfc_pw_token) 164 wps_registrar_remove_nfc_pw_token(data->wps->registrar, 165 data->nfc_pw_token); 166#endif /* CONFIG_WPS_NFC */ 167 168 if (data->wps_pin_revealed) { 169 wpa_printf(MSG_DEBUG, "WPS: Full PIN information revealed and " 170 "negotiation failed"); 171 if (data->registrar) 172 wps_registrar_invalidate_pin(data->wps->registrar, 173 data->uuid_e); 174 } else if (data->registrar) 175 wps_registrar_unlock_pin(data->wps->registrar, data->uuid_e); 176 177 wpabuf_free(data->dh_privkey); 178 wpabuf_free(data->dh_pubkey_e); 179 wpabuf_free(data->dh_pubkey_r); 180 wpabuf_free(data->last_msg); 181 bin_clear_free(data->dev_password, data->dev_password_len); 182 bin_clear_free(data->alt_dev_password, data->alt_dev_password_len); 183 bin_clear_free(data->new_psk, data->new_psk_len); 184 wps_device_data_free(&data->peer_dev); 185 bin_clear_free(data->new_ap_settings, sizeof(*data->new_ap_settings)); 186 dh5_free(data->dh_ctx); 187 os_free(data); 188} 189 190 191/** 192 * wps_process_msg - Process a WPS message 193 * @wps: WPS Registration protocol data from wps_init() 194 * @op_code: Message OP Code 195 * @msg: Message data 196 * Returns: Processing result 197 * 198 * This function is used to process WPS messages with OP Codes WSC_ACK, 199 * WSC_NACK, WSC_MSG, and WSC_Done. The caller (e.g., EAP server/peer) is 200 * responsible for reassembling the messages before calling this function. 201 * Response to this message is built by calling wps_get_msg(). 202 */ 203enum wps_process_res wps_process_msg(struct wps_data *wps, 204 enum wsc_op_code op_code, 205 const struct wpabuf *msg) 206{ 207 if (wps->registrar) 208 return wps_registrar_process_msg(wps, op_code, msg); 209 else 210 return wps_enrollee_process_msg(wps, op_code, msg); 211} 212 213 214/** 215 * wps_get_msg - Build a WPS message 216 * @wps: WPS Registration protocol data from wps_init() 217 * @op_code: Buffer for returning message OP Code 218 * Returns: The generated WPS message or %NULL on failure 219 * 220 * This function is used to build a response to a message processed by calling 221 * wps_process_msg(). The caller is responsible for freeing the buffer. 222 */ 223struct wpabuf * wps_get_msg(struct wps_data *wps, enum wsc_op_code *op_code) 224{ 225 if (wps->registrar) 226 return wps_registrar_get_msg(wps, op_code); 227 else 228 return wps_enrollee_get_msg(wps, op_code); 229} 230 231 232/** 233 * wps_is_selected_pbc_registrar - Check whether WPS IE indicates active PBC 234 * @msg: WPS IE contents from Beacon or Probe Response frame 235 * Returns: 1 if PBC Registrar is active, 0 if not 236 */ 237int wps_is_selected_pbc_registrar(const struct wpabuf *msg) 238{ 239 struct wps_parse_attr attr; 240 241 /* 242 * In theory, this could also verify that attr.sel_reg_config_methods 243 * includes WPS_CONFIG_PUSHBUTTON, but some deployed AP implementations 244 * do not set Selected Registrar Config Methods attribute properly, so 245 * it is safer to just use Device Password ID here. 246 */ 247 248 if (wps_parse_msg(msg, &attr) < 0 || 249 !attr.selected_registrar || *attr.selected_registrar == 0 || 250 !attr.dev_password_id || 251 WPA_GET_BE16(attr.dev_password_id) != DEV_PW_PUSHBUTTON) 252 return 0; 253 254#ifdef CONFIG_WPS_STRICT 255 if (!attr.sel_reg_config_methods || 256 !(WPA_GET_BE16(attr.sel_reg_config_methods) & 257 WPS_CONFIG_PUSHBUTTON)) 258 return 0; 259#endif /* CONFIG_WPS_STRICT */ 260 261 return 1; 262} 263 264 265static int is_selected_pin_registrar(struct wps_parse_attr *attr) 266{ 267 /* 268 * In theory, this could also verify that attr.sel_reg_config_methods 269 * includes WPS_CONFIG_LABEL, WPS_CONFIG_DISPLAY, or WPS_CONFIG_KEYPAD, 270 * but some deployed AP implementations do not set Selected Registrar 271 * Config Methods attribute properly, so it is safer to just use 272 * Device Password ID here. 273 */ 274 275 if (!attr->selected_registrar || *attr->selected_registrar == 0) 276 return 0; 277 278 if (attr->dev_password_id != NULL && 279 WPA_GET_BE16(attr->dev_password_id) == DEV_PW_PUSHBUTTON) 280 return 0; 281 282#ifdef CONFIG_WPS_STRICT 283 if (!attr->sel_reg_config_methods || 284 !(WPA_GET_BE16(attr->sel_reg_config_methods) & 285 (WPS_CONFIG_LABEL | WPS_CONFIG_DISPLAY | WPS_CONFIG_KEYPAD))) 286 return 0; 287#endif /* CONFIG_WPS_STRICT */ 288 289 return 1; 290} 291 292 293/** 294 * wps_is_selected_pin_registrar - Check whether WPS IE indicates active PIN 295 * @msg: WPS IE contents from Beacon or Probe Response frame 296 * Returns: 1 if PIN Registrar is active, 0 if not 297 */ 298int wps_is_selected_pin_registrar(const struct wpabuf *msg) 299{ 300 struct wps_parse_attr attr; 301 302 if (wps_parse_msg(msg, &attr) < 0) 303 return 0; 304 305 return is_selected_pin_registrar(&attr); 306} 307 308 309/** 310 * wps_is_addr_authorized - Check whether WPS IE authorizes MAC address 311 * @msg: WPS IE contents from Beacon or Probe Response frame 312 * @addr: MAC address to search for 313 * @ver1_compat: Whether to use version 1 compatibility mode 314 * Returns: 2 if the specified address is explicit authorized, 1 if address is 315 * authorized (broadcast), 0 if not 316 */ 317int wps_is_addr_authorized(const struct wpabuf *msg, const u8 *addr, 318 int ver1_compat) 319{ 320 struct wps_parse_attr attr; 321 unsigned int i; 322 const u8 *pos; 323 const u8 bcast[ETH_ALEN] = { 0xff, 0xff, 0xff, 0xff, 0xff, 0xff }; 324 325 if (wps_parse_msg(msg, &attr) < 0) 326 return 0; 327 328 if (!attr.version2 && ver1_compat) { 329 /* 330 * Version 1.0 AP - AuthorizedMACs not used, so revert back to 331 * old mechanism of using SelectedRegistrar. 332 */ 333 return is_selected_pin_registrar(&attr); 334 } 335 336 if (!attr.authorized_macs) 337 return 0; 338 339 pos = attr.authorized_macs; 340 for (i = 0; i < attr.authorized_macs_len / ETH_ALEN; i++) { 341 if (os_memcmp(pos, addr, ETH_ALEN) == 0) 342 return 2; 343 if (os_memcmp(pos, bcast, ETH_ALEN) == 0) 344 return 1; 345 pos += ETH_ALEN; 346 } 347 348 return 0; 349} 350 351 352/** 353 * wps_ap_priority_compar - Prioritize WPS IE from two APs 354 * @wps_a: WPS IE contents from Beacon or Probe Response frame 355 * @wps_b: WPS IE contents from Beacon or Probe Response frame 356 * Returns: 1 if wps_b is considered more likely selection for WPS 357 * provisioning, -1 if wps_a is considered more like, or 0 if no preference 358 */ 359int wps_ap_priority_compar(const struct wpabuf *wps_a, 360 const struct wpabuf *wps_b) 361{ 362 struct wps_parse_attr attr; 363 int sel_a, sel_b; 364 365 if (wps_a == NULL || wps_parse_msg(wps_a, &attr) < 0) 366 return 1; 367 sel_a = attr.selected_registrar && *attr.selected_registrar != 0; 368 369 if (wps_b == NULL || wps_parse_msg(wps_b, &attr) < 0) 370 return -1; 371 sel_b = attr.selected_registrar && *attr.selected_registrar != 0; 372 373 if (sel_a && !sel_b) 374 return -1; 375 if (!sel_a && sel_b) 376 return 1; 377 378 return 0; 379} 380 381 382/** 383 * wps_get_uuid_e - Get UUID-E from WPS IE 384 * @msg: WPS IE contents from Beacon or Probe Response frame 385 * Returns: Pointer to UUID-E or %NULL if not included 386 * 387 * The returned pointer is to the msg contents and it remains valid only as 388 * long as the msg buffer is valid. 389 */ 390const u8 * wps_get_uuid_e(const struct wpabuf *msg) 391{ 392 struct wps_parse_attr attr; 393 394 if (wps_parse_msg(msg, &attr) < 0) 395 return NULL; 396 return attr.uuid_e; 397} 398 399 400/** 401 * wps_is_20 - Check whether WPS attributes claim support for WPS 2.0 402 */ 403int wps_is_20(const struct wpabuf *msg) 404{ 405 struct wps_parse_attr attr; 406 407 if (msg == NULL || wps_parse_msg(msg, &attr) < 0) 408 return 0; 409 return attr.version2 != NULL; 410} 411 412 413/** 414 * wps_build_assoc_req_ie - Build WPS IE for (Re)Association Request 415 * @req_type: Value for Request Type attribute 416 * Returns: WPS IE or %NULL on failure 417 * 418 * The caller is responsible for freeing the buffer. 419 */ 420struct wpabuf * wps_build_assoc_req_ie(enum wps_request_type req_type) 421{ 422 struct wpabuf *ie; 423 u8 *len; 424 425 wpa_printf(MSG_DEBUG, "WPS: Building WPS IE for (Re)Association " 426 "Request"); 427 ie = wpabuf_alloc(100); 428 if (ie == NULL) 429 return NULL; 430 431 wpabuf_put_u8(ie, WLAN_EID_VENDOR_SPECIFIC); 432 len = wpabuf_put(ie, 1); 433 wpabuf_put_be32(ie, WPS_DEV_OUI_WFA); 434 435 if (wps_build_version(ie) || 436 wps_build_req_type(ie, req_type) || 437 wps_build_wfa_ext(ie, 0, NULL, 0)) { 438 wpabuf_free(ie); 439 return NULL; 440 } 441 442 *len = wpabuf_len(ie) - 2; 443 444 return ie; 445} 446 447 448/** 449 * wps_build_assoc_resp_ie - Build WPS IE for (Re)Association Response 450 * Returns: WPS IE or %NULL on failure 451 * 452 * The caller is responsible for freeing the buffer. 453 */ 454struct wpabuf * wps_build_assoc_resp_ie(void) 455{ 456 struct wpabuf *ie; 457 u8 *len; 458 459 wpa_printf(MSG_DEBUG, "WPS: Building WPS IE for (Re)Association " 460 "Response"); 461 ie = wpabuf_alloc(100); 462 if (ie == NULL) 463 return NULL; 464 465 wpabuf_put_u8(ie, WLAN_EID_VENDOR_SPECIFIC); 466 len = wpabuf_put(ie, 1); 467 wpabuf_put_be32(ie, WPS_DEV_OUI_WFA); 468 469 if (wps_build_version(ie) || 470 wps_build_resp_type(ie, WPS_RESP_AP) || 471 wps_build_wfa_ext(ie, 0, NULL, 0)) { 472 wpabuf_free(ie); 473 return NULL; 474 } 475 476 *len = wpabuf_len(ie) - 2; 477 478 return ie; 479} 480 481 482/** 483 * wps_build_probe_req_ie - Build WPS IE for Probe Request 484 * @pw_id: Password ID (DEV_PW_PUSHBUTTON for active PBC and DEV_PW_DEFAULT for 485 * most other use cases) 486 * @dev: Device attributes 487 * @uuid: Own UUID 488 * @req_type: Value for Request Type attribute 489 * @num_req_dev_types: Number of requested device types 490 * @req_dev_types: Requested device types (8 * num_req_dev_types octets) or 491 * %NULL if none 492 * Returns: WPS IE or %NULL on failure 493 * 494 * The caller is responsible for freeing the buffer. 495 */ 496struct wpabuf * wps_build_probe_req_ie(u16 pw_id, struct wps_device_data *dev, 497 const u8 *uuid, 498 enum wps_request_type req_type, 499 unsigned int num_req_dev_types, 500 const u8 *req_dev_types) 501{ 502 struct wpabuf *ie; 503 504 wpa_printf(MSG_DEBUG, "WPS: Building WPS IE for Probe Request"); 505 506 ie = wpabuf_alloc(500); 507 if (ie == NULL) 508 return NULL; 509 510 if (wps_build_version(ie) || 511 wps_build_req_type(ie, req_type) || 512 wps_build_config_methods(ie, dev->config_methods) || 513 wps_build_uuid_e(ie, uuid) || 514 wps_build_primary_dev_type(dev, ie) || 515 wps_build_rf_bands(dev, ie, 0) || 516 wps_build_assoc_state(NULL, ie) || 517 wps_build_config_error(ie, WPS_CFG_NO_ERROR) || 518 wps_build_dev_password_id(ie, pw_id) || 519 wps_build_manufacturer(dev, ie) || 520 wps_build_model_name(dev, ie) || 521 wps_build_model_number(dev, ie) || 522 wps_build_dev_name(dev, ie) || 523 wps_build_wfa_ext(ie, req_type == WPS_REQ_ENROLLEE, NULL, 0) || 524 wps_build_req_dev_type(dev, ie, num_req_dev_types, req_dev_types) 525 || 526 wps_build_secondary_dev_type(dev, ie) 527 ) { 528 wpabuf_free(ie); 529 return NULL; 530 } 531 532 return wps_ie_encapsulate(ie); 533} 534 535 536void wps_free_pending_msgs(struct upnp_pending_message *msgs) 537{ 538 struct upnp_pending_message *p, *prev; 539 p = msgs; 540 while (p) { 541 prev = p; 542 p = p->next; 543 wpabuf_free(prev->msg); 544 os_free(prev); 545 } 546} 547 548 549int wps_attr_text(struct wpabuf *data, char *buf, char *end) 550{ 551 struct wps_parse_attr attr; 552 char *pos = buf; 553 int ret; 554 555 if (wps_parse_msg(data, &attr) < 0) 556 return -1; 557 558 if (attr.wps_state) { 559 if (*attr.wps_state == WPS_STATE_NOT_CONFIGURED) 560 ret = os_snprintf(pos, end - pos, 561 "wps_state=unconfigured\n"); 562 else if (*attr.wps_state == WPS_STATE_CONFIGURED) 563 ret = os_snprintf(pos, end - pos, 564 "wps_state=configured\n"); 565 else 566 ret = 0; 567 if (os_snprintf_error(end - pos, ret)) 568 return pos - buf; 569 pos += ret; 570 } 571 572 if (attr.ap_setup_locked && *attr.ap_setup_locked) { 573 ret = os_snprintf(pos, end - pos, 574 "wps_ap_setup_locked=1\n"); 575 if (os_snprintf_error(end - pos, ret)) 576 return pos - buf; 577 pos += ret; 578 } 579 580 if (attr.selected_registrar && *attr.selected_registrar) { 581 ret = os_snprintf(pos, end - pos, 582 "wps_selected_registrar=1\n"); 583 if (os_snprintf_error(end - pos, ret)) 584 return pos - buf; 585 pos += ret; 586 } 587 588 if (attr.dev_password_id) { 589 ret = os_snprintf(pos, end - pos, 590 "wps_device_password_id=%u\n", 591 WPA_GET_BE16(attr.dev_password_id)); 592 if (os_snprintf_error(end - pos, ret)) 593 return pos - buf; 594 pos += ret; 595 } 596 597 if (attr.sel_reg_config_methods) { 598 ret = os_snprintf(pos, end - pos, 599 "wps_selected_registrar_config_methods=" 600 "0x%04x\n", 601 WPA_GET_BE16(attr.sel_reg_config_methods)); 602 if (os_snprintf_error(end - pos, ret)) 603 return pos - buf; 604 pos += ret; 605 } 606 607 if (attr.primary_dev_type) { 608 char devtype[WPS_DEV_TYPE_BUFSIZE]; 609 ret = os_snprintf(pos, end - pos, 610 "wps_primary_device_type=%s\n", 611 wps_dev_type_bin2str(attr.primary_dev_type, 612 devtype, 613 sizeof(devtype))); 614 if (os_snprintf_error(end - pos, ret)) 615 return pos - buf; 616 pos += ret; 617 } 618 619 if (attr.dev_name) { 620 char *str = os_malloc(attr.dev_name_len + 1); 621 size_t i; 622 if (str == NULL) 623 return pos - buf; 624 for (i = 0; i < attr.dev_name_len; i++) { 625 if (attr.dev_name[i] == 0 || 626 is_ctrl_char(attr.dev_name[i])) 627 str[i] = '_'; 628 else 629 str[i] = attr.dev_name[i]; 630 } 631 str[i] = '\0'; 632 ret = os_snprintf(pos, end - pos, "wps_device_name=%s\n", str); 633 os_free(str); 634 if (os_snprintf_error(end - pos, ret)) 635 return pos - buf; 636 pos += ret; 637 } 638 639 if (attr.config_methods) { 640 ret = os_snprintf(pos, end - pos, 641 "wps_config_methods=0x%04x\n", 642 WPA_GET_BE16(attr.config_methods)); 643 if (os_snprintf_error(end - pos, ret)) 644 return pos - buf; 645 pos += ret; 646 } 647 648 return pos - buf; 649} 650 651 652const char * wps_ei_str(enum wps_error_indication ei) 653{ 654 switch (ei) { 655 case WPS_EI_NO_ERROR: 656 return "No Error"; 657 case WPS_EI_SECURITY_TKIP_ONLY_PROHIBITED: 658 return "TKIP Only Prohibited"; 659 case WPS_EI_SECURITY_WEP_PROHIBITED: 660 return "WEP Prohibited"; 661 case WPS_EI_AUTH_FAILURE: 662 return "Authentication Failure"; 663 default: 664 return "Unknown"; 665 } 666} 667