eap.h

Go to the documentation of this file.

/*
 * eap.h - Extensible Authentication Protocol for PPP (RFC 2284)
 *
 * Copyright (c) 2001 by Sun Microsystems, Inc.
 * All rights reserved.
 *
 * Non-exclusive rights to redistribute, modify, translate, and use
 * this software in source and binary forms, in whole or in part, is
 * hereby granted, provided that the above copyright notice is
 * duplicated in any source form, and that neither the name of the
 * copyright holder nor the author is used to endorse or promote
 * products derived from this software.
 *
 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
 * WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
 *
 * Original version by James Carlson
 *
 * $Id: eap.h,v 1.2 2003/06/11 23:56:26 paulus Exp $
 */

#include "lwip/opt.h"
#if PPP_SUPPORT && EAP_SUPPORT  /* don't build if not configured for use in lwipopts.h */

#ifndef PPP_EAP_H
#define PPP_EAP_H

#include "ppp.h"

#ifdef  __cplusplus
extern "C" {
#endif

/*
 * Packet header = Code, id, length.
 */
#define EAP_HEADERLEN   4


/* EAP message codes. */
#define EAP_REQUEST 1
#define EAP_RESPONSE    2
#define EAP_SUCCESS 3
#define EAP_FAILURE 4

/* EAP types */
#define EAPT_IDENTITY       1
#define EAPT_NOTIFICATION   2
#define EAPT_NAK        3   /* (response only) */
#define EAPT_MD5CHAP        4
#define EAPT_OTP        5   /* One-Time Password; RFC 1938 */
#define EAPT_TOKEN      6   /* Generic Token Card */
/* 7 and 8 are unassigned. */
#define EAPT_RSA        9   /* RSA Public Key Authentication */
#define EAPT_DSS        10  /* DSS Unilateral */
#define EAPT_KEA        11  /* KEA */
#define EAPT_KEA_VALIDATE   12  /* KEA-VALIDATE */
#define EAPT_TLS        13  /* EAP-TLS */
#define EAPT_DEFENDER       14  /* Defender Token (AXENT) */
#define EAPT_W2K        15  /* Windows 2000 EAP */
#define EAPT_ARCOT      16  /* Arcot Systems */
#define EAPT_CISCOWIRELESS  17  /* Cisco Wireless */
#define EAPT_NOKIACARD      18  /* Nokia IP smart card */
#define EAPT_SRP        19  /* Secure Remote Password */
/* 20 is deprecated */

/* EAP SRP-SHA1 Subtypes */
#define EAPSRP_CHALLENGE    1   /* Request 1 - Challenge */
#define EAPSRP_CKEY     1   /* Response 1 - Client Key */
#define EAPSRP_SKEY     2   /* Request 2 - Server Key */
#define EAPSRP_CVALIDATOR   2   /* Response 2 - Client Validator */
#define EAPSRP_SVALIDATOR   3   /* Request 3 - Server Validator */
#define EAPSRP_ACK      3   /* Response 3 - final ack */
#define EAPSRP_LWRECHALLENGE    4   /* Req/resp 4 - Lightweight rechal */

#define SRPVAL_EBIT 0x00000001  /* Use shared key for ECP */

#define SRP_PSEUDO_ID   "pseudo_"
#define SRP_PSEUDO_LEN  7

#define MD5_SIGNATURE_SIZE  16
#define EAP_MIN_CHALLENGE_LENGTH    17
#define EAP_MAX_CHALLENGE_LENGTH    24
#define EAP_MIN_MAX_POWER_OF_TWO_CHALLENGE_LENGTH     3   /* 2^3-1 = 7, 17+7 = 24 */

#define EAP_STATES  \
    "Initial", "Pending", "Closed", "Listen", "Identify", \
    "SRP1", "SRP2", "SRP3", "MD5Chall", "Open", "SRP4", "BadAuth"

#define eap_client_active(pcb)  ((pcb)->eap.es_client.ea_state == eapListen)
#if PPP_SERVER
#define eap_server_active(pcb)  \
    ((pcb)->eap.es_server.ea_state >= eapIdentify && \
     (pcb)->eap.es_server.ea_state <= eapMD5Chall)
#endif /* PPP_SERVER */

/*
 * Complete EAP state for one PPP session.
 */
enum eap_state_code {
    eapInitial = 0, /* No EAP authentication yet requested */
    eapPending, /* Waiting for LCP (no timer) */
    eapClosed,  /* Authentication not in use */
    eapListen,  /* Client ready (and timer running) */
    eapIdentify,    /* EAP Identify sent */
    eapSRP1,    /* Sent EAP SRP-SHA1 Subtype 1 */
    eapSRP2,    /* Sent EAP SRP-SHA1 Subtype 2 */
    eapSRP3,    /* Sent EAP SRP-SHA1 Subtype 3 */
    eapMD5Chall,    /* Sent MD5-Challenge */
    eapOpen,    /* Completed authentication */
    eapSRP4,    /* Sent EAP SRP-SHA1 Subtype 4 */
    eapBadAuth  /* Failed authentication */
};

struct eap_auth {
    const char *ea_name;    /* Our name */
    char ea_peer[MAXNAMELEN +1];    /* Peer's name */
    void *ea_session;   /* Authentication library linkage */
    u_char *ea_skey;    /* Shared encryption key */
    u_short ea_namelen; /* Length of our name */
    u_short ea_peerlen; /* Length of peer's name */
    enum eap_state_code ea_state;
    u_char ea_id;       /* Current id */
    u_char ea_requests; /* Number of Requests sent/received */
    u_char ea_responses;    /* Number of Responses */
    u_char ea_type;     /* One of EAPT_* */
    u32_t ea_keyflags;  /* SRP shared key usage flags */
};

#ifndef EAP_MAX_CHALLENGE_LENGTH
#define EAP_MAX_CHALLENGE_LENGTH    24
#endif
typedef struct eap_state {
    struct eap_auth es_client;  /* Client (authenticatee) data */
#if PPP_SERVER
    struct eap_auth es_server;  /* Server (authenticator) data */
#endif /* PPP_SERVER */
    int es_savedtime;       /* Saved timeout */
    int es_rechallenge;     /* EAP rechallenge interval */
    int es_lwrechallenge;       /* SRP lightweight rechallenge inter */
    u8_t es_usepseudo;      /* Use SRP Pseudonym if offered one */
    int es_usedpseudo;      /* Set if we already sent PN */
    int es_challen;         /* Length of challenge string */
    u_char es_challenge[EAP_MAX_CHALLENGE_LENGTH];
} eap_state;

/*
 * Timeouts.
 */
#if 0 /* moved to opt.h */
#define EAP_DEFTIMEOUT      3   /* Timeout (seconds) for rexmit */
#define EAP_DEFTRANSMITS    10  /* max # times to transmit */
#define EAP_DEFREQTIME      20  /* Time to wait for peer request */
#define EAP_DEFALLOWREQ     20  /* max # times to accept requests */
#endif /* moved to opt.h */

void eap_authwithpeer(ppp_pcb *pcb, const char *localname);
void eap_authpeer(ppp_pcb *pcb, const char *localname);

extern const struct protent eap_protent;

#ifdef  __cplusplus
}
#endif

#endif /* PPP_EAP_H */

#endif /* PPP_SUPPORT && EAP_SUPPORT */