ace-radius/RadiusPacket.h

/*
 * This source file is part of the ace-radius library.  This code was
 * written by Alex Agranov in 2004-2009, and is covered by the BSD open source
 * license. Refer to the accompanying documentation for details on usage and
 * license.
 */

#ifndef _RADIUSPACKET_H__
#define _RADIUSPACKET_H__

#include "RadiusAttribute.h"


// Radius packet code values (from RFC2865)
#define D_PACKET_ACCESS_REQUEST         1
#define D_PACKET_ACCESS_ACCEPT          2
#define D_PACKET_ACCESS_REJECT          3
#define D_PACKET_ACCOUNTING_REQUEST     4
#define D_PACKET_ACCOUNTING_RESPONSE    5
#define D_PACKET_ACCESS_CHALLENGE       11
#define D_PACKET_STATUS_SERVER          12
#define D_PACKET_STATUS_CLIENT          13

#define D_PACKET_MAX_KNOWN_CODE         13



// Some global constants (following RFC definitions)
#define D_RADIUS_PACKET_HEADER_LENGTH 20
#define D_RADIUS_PACKET_MAX_LENGTH    4096
#define D_AUTHENTICATOR_LENGTH        16

// Raw data buffer is used for storing the whole RADIUS packet _AND_ secret key
// (hence it should be D_RADIUS_PACKET_MAX_LENGTH + D_SECRET_MAX_LENGTH)
#define D_RAW_DATA_LENGTH           4352


class RadiusSecret;
class RadiusClientStack;

class RadiusPacket
{
public:


    RadiusPacket(unsigned char p_code, RadiusClientStack & p_stack);


    RadiusPacket(unsigned char p_code, RadiusPacket & p_request);
    

    RadiusPacket(unsigned char p_code);


    RadiusPacket(const RadiusPacket & p_packet);

    ~RadiusPacket();



    unsigned char getCode(void);

    const char * getCodeDescription(void);

    

    uint16_t getLength(void);




    unsigned char getID(void);
    

    void setID(unsigned char p_id);

    void randomID();



    RadiusSecret * getSecret(void);
    

    void setSecret(RadiusSecret * p_secret);


    const unsigned char * getAuthenticator(void);
    
    void setAuthenticator(const unsigned char * p_auth);

    

    void dump();
    
    

    int getFirstAttribute(RadiusAttribute & p_attr);



    int getNextAttribute(RadiusAttribute & p_attr);



    int findAttribute(unsigned char p_attrType, RadiusAttribute & p_attr);



    int addAttribute(unsigned char p_attrType, RadiusAttribute & p_attr);

    
    unsigned char * getRawData(void);



    int adjustLength(uint16_t p_length);



    void responseAuthenticator(RadiusSecret * p_secret = NULL);


    // Encode User-Password attribute
    /*
     * When packet is retransmitted through new connection, there may be a need to reencode
     * User-Password attribute, since secret key of the new connection may be different.
     * That's exacly what this method does - reencodes User-Password attribute, if the
     * latter exists in this packet.
     *
     * RadiusClientConnection class uses this method. 
     * There seems to be no reason why user application would use this API.
     */
    void encodeUserPassword(void);



    void accountingRequestAuthenticator(RadiusSecret * p_secret = NULL);


    bool verifyResponse(RadiusPacket & p_packet);

private:

    friend class RadiusAttribute;

    void init(unsigned char p_code);

    void randomAuthenticator(void);

    

    void setCode(unsigned char p_code);

    

    void setLength(uint16_t p_length);



    unsigned char m_data[D_RAW_DATA_LENGTH];


    RadiusSecret * m_secret;


    // User-Password attribute in unencrypted format
    /*
     * We need this data in order to re-encode User-Password attribute prior to retransmitting it
     * through another connection (when more than one RadiusClientConnection is defined);
     */
    unsigned char m_password[D_USER_PASSWORD_MAX_LENGTH];
    uint16_t    m_passwordLength;
    uint16_t    m_passwordOffset;

    // Old-Password attribute in unencrypted format
    /*
     * We need this data in order to re-encode Old-Password attribute prior to retransmitting it
     * through another connection (when more than one RadiusClientConnection is defined);
     */
    unsigned char m_oldPassword[D_USER_PASSWORD_MAX_LENGTH];
    uint16_t    m_oldPasswordLength;
    uint16_t    m_oldPasswordOffset;
};

#endif // _RADIUSPACKET_H__

---