Annotation of embedaddon/strongswan/src/libcharon/sa/eap/eap_method.h, revision 1.1
1.1 ! misho 1: /*
! 2: * Copyright (C) 2006 Martin Willi
! 3: * HSR Hochschule fuer Technik Rapperswil
! 4: *
! 5: * This program is free software; you can redistribute it and/or modify it
! 6: * under the terms of the GNU General Public License as published by the
! 7: * Free Software Foundation; either version 2 of the License, or (at your
! 8: * option) any later version. See <http://www.fsf.org/copyleft/gpl.txt>.
! 9: *
! 10: * This program is distributed in the hope that it will be useful, but
! 11: * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
! 12: * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
! 13: * for more details.
! 14: */
! 15:
! 16: /**
! 17: * @defgroup eap_method eap_method
! 18: * @{ @ingroup eap
! 19: */
! 20:
! 21: #ifndef EAP_METHOD_H_
! 22: #define EAP_METHOD_H_
! 23:
! 24: typedef struct eap_method_t eap_method_t;
! 25: typedef enum eap_role_t eap_role_t;
! 26:
! 27: #include <library.h>
! 28: #include <plugins/plugin.h>
! 29: #include <utils/identification.h>
! 30: #include <eap/eap.h>
! 31: #include <encoding/payloads/eap_payload.h>
! 32:
! 33: /**
! 34: * Role of an eap_method, SERVER or PEER (client)
! 35: */
! 36: enum eap_role_t {
! 37: EAP_SERVER,
! 38: EAP_PEER,
! 39: };
! 40: /**
! 41: * enum names for eap_role_t.
! 42: */
! 43: extern enum_name_t *eap_role_names;
! 44:
! 45: /**
! 46: * Interface of an EAP method for server and client side.
! 47: *
! 48: * An EAP method initiates an EAP exchange and processes requests and
! 49: * responses. An EAP method may need multiple exchanges before succeeding, and
! 50: * the eap_authentication may use multiple EAP methods to authenticate a peer.
! 51: * To accomplish these requirements, all EAP methods have their own
! 52: * implementation while the eap_authenticator uses one or more of these
! 53: * EAP methods. Sending of EAP(SUCCESS/FAILURE) message is not the job
! 54: * of the method, the eap_authenticator does this.
! 55: * An EAP method may establish a MSK, this is used the complete the
! 56: * authentication. Even if a mutual EAP method is used, the traditional
! 57: * AUTH payloads are required. Only these include the nonces and messages from
! 58: * ike_sa_init and therefore prevent man in the middle attacks.
! 59: * The EAP method must use an initial EAP identifier value != 0, as a preceding
! 60: * EAP-Identity exchange always uses identifier 0.
! 61: */
! 62: struct eap_method_t {
! 63:
! 64: /**
! 65: * Initiate the EAP exchange.
! 66: *
! 67: * initiate() is only usable for server implementations, as clients only
! 68: * reply to server requests.
! 69: * A eap_payload is created in "out" if result is NEED_MORE.
! 70: *
! 71: * @param out eap_payload to send to the client
! 72: * @return
! 73: * - NEED_MORE, if an other exchange is required
! 74: * - FAILED, if unable to create eap request payload
! 75: */
! 76: status_t (*initiate) (eap_method_t *this, eap_payload_t **out);
! 77:
! 78: /**
! 79: * Process a received EAP message.
! 80: *
! 81: * A eap_payload is created in "out" if result is NEED_MORE.
! 82: *
! 83: * @param in eap_payload response received
! 84: * @param out created eap_payload to send
! 85: * @return
! 86: * - NEED_MORE, if an other exchange is required
! 87: * - FAILED, if EAP method failed
! 88: * - SUCCESS, if EAP method succeeded
! 89: */
! 90: status_t (*process) (eap_method_t *this, eap_payload_t *in,
! 91: eap_payload_t **out);
! 92:
! 93: /**
! 94: * Get the EAP type implemented in this method.
! 95: *
! 96: * @param vendor pointer receiving vendor identifier for type, 0 for none
! 97: * @return type of the EAP method
! 98: */
! 99: eap_type_t (*get_type) (eap_method_t *this, uint32_t *vendor);
! 100:
! 101: /**
! 102: * Check if this EAP method authenticates the server.
! 103: *
! 104: * Some EAP methods provide mutual authentication and
! 105: * allow authentication using only EAP, if the peer supports it.
! 106: *
! 107: * @return TRUE if methods provides mutual authentication
! 108: */
! 109: bool (*is_mutual) (eap_method_t *this);
! 110:
! 111: /**
! 112: * Get the MSK established by this EAP method.
! 113: *
! 114: * Not all EAP methods establish a shared secret. For implementations of
! 115: * the EAP-Identity method, get_msk() returns the received identity.
! 116: *
! 117: * @param msk chunk receiving internal stored MSK
! 118: * @return
! 119: * - SUCCESS, or
! 120: * - FAILED, if MSK not established (yet)
! 121: */
! 122: status_t (*get_msk) (eap_method_t *this, chunk_t *msk);
! 123:
! 124: /**
! 125: * Get the current EAP identifier.
! 126: *
! 127: * @return current EAP identifier
! 128: */
! 129: uint8_t (*get_identifier) (eap_method_t *this);
! 130:
! 131: /**
! 132: * Set the EAP identifier to a deterministic value, overwriting
! 133: * the randomly initialized default value.
! 134: *
! 135: * @param identifier current EAP identifier
! 136: */
! 137: void (*set_identifier) (eap_method_t *this, uint8_t identifier);
! 138:
! 139: /**
! 140: * Get authentication details performed by this EAP method.
! 141: *
! 142: * After EAP completion, the auth data contains additional information
! 143: * of the authentication process, used certificates etc.
! 144: * This method is optional to implement, but if it is, it must return
! 145: * a valid auth_cfg.
! 146: *
! 147: * @return auth method, internal data
! 148: */
! 149: auth_cfg_t* (*get_auth)(eap_method_t *this);
! 150:
! 151: /**
! 152: * Destroys a eap_method_t object.
! 153: */
! 154: void (*destroy) (eap_method_t *this);
! 155: };
! 156:
! 157: /**
! 158: * Constructor definition for a pluggable EAP method.
! 159: *
! 160: * Each EAP module must define a constructor function which will return
! 161: * an initialized object with the methods defined in eap_method_t.
! 162: * Constructors for server and peers are identical, to support both roles
! 163: * of a EAP method, a plugin needs register two constructors in the
! 164: * eap_manager_t.
! 165: * The passed identities are of type ID_EAP and valid only during the
! 166: * constructor invocation.
! 167: *
! 168: * @param server ID of the server to use for credential lookup
! 169: * @param peer ID of the peer to use for credential lookup
! 170: * @return implementation of the eap_method_t interface
! 171: */
! 172: typedef eap_method_t *(*eap_constructor_t)(identification_t *server,
! 173: identification_t *peer);
! 174:
! 175: /**
! 176: * Helper function to (un-)register EAP methods from plugin features.
! 177: *
! 178: * This function is a plugin_feature_callback_t and can be used with the
! 179: * PLUGIN_CALLBACK macro to register a EAP method constructor.
! 180: *
! 181: * @param plugin plugin registering the EAP method constructor
! 182: * @param feature associated plugin feature
! 183: * @param reg TRUE to register, FALSE to unregister.
! 184: * @param data data passed to callback, an eap_constructor_t
! 185: */
! 186: bool eap_method_register(plugin_t *plugin, plugin_feature_t *feature,
! 187: bool reg, void *data);
! 188:
! 189: #endif /** EAP_METHOD_H_ @}*/
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>