radius_client.h

/*
 * RADIUS client
 * Copyright (c) 2002-2009, Jouni Malinen <j@w1.fi>
 *
 * This software may be distributed under the terms of the BSD license.
 * See README for more details.
 */

#ifndef RADIUS_CLIENT_H
#define RADIUS_CLIENT_H

#include "ip_addr.h"

struct radius_msg;

struct hostapd_radius_server {
    struct hostapd_ip_addr addr;

    int port;

    u8 *shared_secret;

    size_t shared_secret_len;

    /* Dynamic (not from configuration file) MIB data */

    int index;

    int round_trip_time;

    u32 requests;

    u32 retransmissions;

    u32 access_accepts;

    u32 access_rejects;

    u32 access_challenges;

    u32 responses;

    u32 malformed_responses;

    u32 bad_authenticators;

    u32 timeouts;

    u32 unknown_types;

    u32 packets_dropped;
};

struct hostapd_radius_servers {
    struct hostapd_radius_server *auth_servers;

    int num_auth_servers;

    struct hostapd_radius_server *auth_server;

    struct hostapd_radius_server *acct_servers;

    int num_acct_servers;

    struct hostapd_radius_server *acct_server;

    int retry_primary_interval;

    int msg_dumps;

    struct hostapd_ip_addr client_addr;

    int force_client_addr;
};


typedef enum {
    RADIUS_AUTH,

    RADIUS_ACCT,

    RADIUS_ACCT_INTERIM
} RadiusType;

typedef enum {
    RADIUS_RX_PROCESSED,

    RADIUS_RX_QUEUED,

    RADIUS_RX_UNKNOWN,

    RADIUS_RX_INVALID_AUTHENTICATOR
} RadiusRxResult;

struct radius_client_data;

int radius_client_register(struct radius_client_data *radius,
               RadiusType msg_type,
               RadiusRxResult (*handler)
               (struct radius_msg *msg, struct radius_msg *req,
                const u8 *shared_secret, size_t shared_secret_len,
                void *data),
               void *data);
void radius_client_set_interim_error_cb(struct radius_client_data *radius,
                    void (*cb)(const u8 *addr, void *ctx),
                    void *ctx);
int radius_client_send(struct radius_client_data *radius,
               struct radius_msg *msg,
               RadiusType msg_type, const u8 *addr);
u8 radius_client_get_id(struct radius_client_data *radius);
void radius_client_flush(struct radius_client_data *radius, int only_auth);
struct radius_client_data *
radius_client_init(void *ctx, struct hostapd_radius_servers *conf);
void radius_client_deinit(struct radius_client_data *radius);
void radius_client_flush_auth(struct radius_client_data *radius,
                  const u8 *addr);
int radius_client_get_mib(struct radius_client_data *radius, char *buf,
              size_t buflen);
void radius_client_reconfig(struct radius_client_data *radius,
                struct hostapd_radius_servers *conf);

#endif /* RADIUS_CLIENT_H */