eap_ttls.h

Go to the documentation of this file.

/*
 * eap_ttls.h
 *
 * EAP TTLS Helper Functions
 *
 * Copyright 2019-2024 DigiCert, Inc. All Rights Reserved.
 * Proprietary and Confidential Material.
 *
 */

#ifndef __EAP_TTLS_H__
#define __EAP_TTLS_H__

#ifdef __cplusplus
extern "C" {
#endif

#if (defined(__ENABLE_MOCANA_EAP_PEER__) || defined(__ENABLE_MOCANA_EAP_AUTH__))
#if (defined(__ENABLE_MOCANA_EAP_TTLS__))

typedef enum eapTTLSMethodType_e
{
    EAP_METHOD_TYPE_PAP,
    EAP_METHOD_TYPE_CHAP,
    EAP_METHOD_TYPE_MSCHAP,
    EAP_METHOD_TYPE_MSCHAPV2,
    EAP_METHOD_TYPE_EAP

} eapTTLSMethodType;


/*------------------------------------------------------------------*/

typedef struct eap_ttls_params
{
    MSTATUS (*ulTransmit)(ubyte * appSessionCB,ubyte * eapPkt,ubyte4 eapPktLen,
            intBoolean encrypted);

    MSTATUS (*ul2ndStageReceive)(ubyte * app_session_handle, eapMethodType type,
                                 eapCode code, ubyte id, ubyte * eap_data,
                                 ubyte4 eap_data_len, ubyte * opaque_data);

    MSTATUS (*ulAuthTransmit)(ubyte *appSessionCB,
                                ubyte *eapTTLSCb, ubyte *pkt, ubyte4 pktLen);

    MSTATUS (*ulAuthResultTransmit)(ubyte * appSessionCB, eapAuthStatus authStatus);

    ubyte               UserName[EAP_MAX_USER_LEN];
    ubyte2              UserNameLen;

    ubyte               Password[EAP_MAX_PASS_LEN];
    ubyte2              PasswordLen;

    ubyte               radiusSecret[EAP_MAX_PASS_LEN];
    ubyte2              radiusSecretLen;

    ubyte4              instanceId;             /* Phase 1 Instance Id */

    eapSessionType      sessionType;            /* (PEER/AUTH) */

    eapTTLSMethodType   methodType;             /* (PAP/CHAP/MSCHAP/MSCHAPv2/EAP) */

    sbyte4              connectionInstance;     /* TLS COnnection INstance */

    ubyte*              tls_con;                /* TLS Connection INstance */

    ubyte4              authServerId;           /* Radius Server Id */

    MOC_IP_ADDRESS      myaddr;                 /* For Radius Request */

    ubyte               version;                /* ttls Version 0,1 */
    ubyte               pad2[3];

} EAP_TTLS_params;


/*------------------------------------------------------------------*/

MOC_EXTERN MSTATUS EAP_TTLSinitSession(ubyte *appSessionCB,ubyte **eapTTLSSession, EAP_TTLS_params *eapTTLSparams);

MOC_EXTERN MSTATUS EAP_TTLSdeleteSession(void *eapTTLSSession);

#if (defined(__ENABLE_MOCANA_EAP_AUTH__))

MOC_EXTERN MSTATUS EAP_TTLSProcessRadiusAuthResponse(void *eapCb,RADIUS_RqstRecord *pRadiusResp);
#endif

MOC_EXTERN MSTATUS EAP_TTLSFormSendPacket(void *eapTTLSCb, ubyte *pkt, ubyte4 pktLen, ubyte **eapResponse, ubyte4 *eapRespLen);

MOC_EXTERN MSTATUS EAP_TTLSreceiveLLPacket(void * eapTTLSCb,ubyte *pkt,ubyte4 pktLen);

MOC_EXTERN MSTATUS EAP_TTLSgetSessionStatus(void * eapTTLSCb,ubyte *eapSessionStatus);

MOC_EXTERN MSTATUS EAP_TTLSgetKey(void *eapCb,ubyte *key,ubyte2 keyLen);

MOC_EXTERN MSTATUS EAP_TTLSulPeerTransmit(ubyte * eapSessionHdl, ubyte4 instanceId, eapMethodType  methodType, eapCode code, eapMethodDecision  methodDecision, eapMethodState methodState, ubyte * eap_data, ubyte4  eap_data_len);

#if (defined(__ENABLE_MOCANA_INNER_APP__))

MOC_EXTERN MSTATUS EAP_TTLSsendAlert(ubyte * eapSessionHdl,sbyte4 alertClass,sbyte4 alertId);

MOC_EXTERN MSTATUS EAP_TTLSSendData(ubyte *ttls_connection,
                ubyte *data, ubyte4 len,
                InnerAppType innerApp,ubyte **eapRespData, ubyte4 *eapRespLen);
#endif /*(defined(__ENABLE_MOCANA_INNER_APP__)) */

#endif /* ((defined(__ENABLE_MOCANA_EAP_TTLS__) */
#endif /* ((defined(__ENABLE_MOCANA_EAP_PEER__) || defined(__ENABLE_MOCANA_EAP_AUTH__)) */

#ifdef __cplusplus
}
#endif

#endif /* __EAP_TTLS_H__  */