Home | History | Annotate | Line # | Download | only in eapol_auth 
      1 /*
      2  * IEEE 802.1X-2004 Authenticator - EAPOL state machine
      3  * Copyright (c) 2002-2015, Jouni Malinen <j (at) 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 #ifndef EAPOL_AUTH_SM_H
     10 #define EAPOL_AUTH_SM_H
     11 
     12 #define EAPOL_SM_PREAUTH BIT(0)
     13 #define EAPOL_SM_WAIT_START BIT(1)
     14 #define EAPOL_SM_USES_WPA BIT(2)
     15 #define EAPOL_SM_FROM_PMKSA_CACHE BIT(3)
     16 
     17 struct eapol_auth_config {
     18 	const struct eap_config *eap_cfg;
     19 	int eap_reauth_period;
     20 	int wpa;
     21 	int individual_wep_key_len;
     22 	char *eap_req_id_text; /* a copy of this will be allocated */
     23 	size_t eap_req_id_text_len;
     24 	int erp_send_reauth_start;
     25 	char *erp_domain; /* a copy of this will be allocated */
     26 	bool eap_skip_prot_success;
     27 
     28 	/* Opaque context pointer to owner data for callback functions */
     29 	void *ctx;
     30 };
     31 
     32 struct eap_user;
     33 struct eap_server_erp_key;
     34 
     35 typedef enum {
     36 	EAPOL_LOGGER_DEBUG, EAPOL_LOGGER_INFO, EAPOL_LOGGER_WARNING
     37 } eapol_logger_level;
     38 
     39 enum eapol_event {
     40 	EAPOL_AUTH_SM_CHANGE,
     41 	EAPOL_AUTH_REAUTHENTICATE
     42 };
     43 
     44 struct eapol_auth_cb {
     45 	void (*eapol_send)(void *ctx, void *sta_ctx, u8 type, const u8 *data,
     46 			   size_t datalen);
     47 	void (*aaa_send)(void *ctx, void *sta_ctx, const u8 *data,
     48 			 size_t datalen);
     49 	bool (*finished)(void *ctx, void *sta_ctx, int success, int preauth,
     50 			 int remediation, bool logoff);
     51 	int (*get_eap_user)(void *ctx, const u8 *identity, size_t identity_len,
     52 			    int phase2, struct eap_user *user);
     53 	int (*sta_entry_alive)(void *ctx, const u8 *addr);
     54 	void (*logger)(void *ctx, const u8 *addr, eapol_logger_level level,
     55 		       const char *txt);
     56 	void (*set_port_authorized)(void *ctx, void *sta_ctx, int authorized);
     57 	void (*abort_auth)(void *ctx, void *sta_ctx);
     58 	void (*tx_key)(void *ctx, void *sta_ctx);
     59 	void (*eapol_event)(void *ctx, void *sta_ctx, enum eapol_event type);
     60 	struct eap_server_erp_key * (*erp_get_key)(void *ctx,
     61 						   const char *keyname);
     62 	int (*erp_add_key)(void *ctx, struct eap_server_erp_key *erp);
     63 };
     64 
     65 
     66 struct eapol_authenticator * eapol_auth_init(struct eapol_auth_config *conf,
     67 					     struct eapol_auth_cb *cb);
     68 void eapol_auth_deinit(struct eapol_authenticator *eapol);
     69 struct eapol_state_machine *
     70 eapol_auth_alloc(struct eapol_authenticator *eapol, const u8 *addr,
     71 		 int flags, const struct wpabuf *assoc_wps_ie,
     72 		 const struct wpabuf *assoc_p2p_ie, void *sta_ctx,
     73 		 const char *identity, const char *radius_cui);
     74 void eapol_auth_free(struct eapol_state_machine *sm);
     75 void eapol_auth_step(struct eapol_state_machine *sm);
     76 int eapol_auth_dump_state(struct eapol_state_machine *sm, char *buf,
     77 			  size_t buflen);
     78 int eapol_auth_eap_pending_cb(struct eapol_state_machine *sm, void *ctx);
     79 void eapol_auth_reauthenticate(struct eapol_state_machine *sm);
     80 int eapol_auth_set_conf(struct eapol_state_machine *sm, const char *param,
     81 			const char *value);
     82 
     83 #endif /* EAPOL_AUTH_SM_H */
     84