[thirdparty/hostap.git] / src / radius / radius_client.h

/*
 * hostapd / RADIUS client
 * Copyright (c) 2002-2005, Jouni Malinen <j@w1.fi>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 2 as
 * published by the Free Software Foundation.
 *
 * Alternatively, this software may be distributed under the terms of BSD
 * license.
 *
 * See README and COPYING for more details.
 */

#ifndef RADIUS_CLIENT_H
#define RADIUS_CLIENT_H

#include "ip_addr.h"

struct radius_msg;

struct hostapd_radius_server {
	/* MIB prefix for shared variables:
	 * @ = radiusAuth or radiusAcc depending on the type of the server */
	struct hostapd_ip_addr addr; /* @ServerAddress */
	int port; /* @ClientServerPortNumber */
	u8 *shared_secret;
	size_t shared_secret_len;

	/* Dynamic (not from configuration file) MIB data */
	int index; /* @ServerIndex */
	int round_trip_time; /* @ClientRoundTripTime; in hundredths of a
			      * second */
	u32 requests; /* @Client{Access,}Requests */
	u32 retransmissions; /* @Client{Access,}Retransmissions */
	u32 access_accepts; /* radiusAuthClientAccessAccepts */
	u32 access_rejects; /* radiusAuthClientAccessRejects */
	u32 access_challenges; /* radiusAuthClientAccessChallenges */
	u32 responses; /* radiusAccClientResponses */
	u32 malformed_responses; /* @ClientMalformed{Access,}Responses */
	u32 bad_authenticators; /* @ClientBadAuthenticators */
	u32 timeouts; /* @ClientTimeouts */
	u32 unknown_types; /* @ClientUnknownTypes */
	u32 packets_dropped; /* @ClientPacketsDropped */
	/* @ClientPendingRequests: length of hapd->radius->msgs for matching
	 * msg_type */
};

struct hostapd_radius_servers {
	/* RADIUS Authentication and Accounting servers in priority order */
	struct hostapd_radius_server *auth_servers, *auth_server;
	int num_auth_servers;
	struct hostapd_radius_server *acct_servers, *acct_server;
	int num_acct_servers;

	int retry_primary_interval;
	int acct_interim_interval;

	int msg_dumps;

	struct hostapd_ip_addr client_addr;
	int force_client_addr;
};


typedef enum {
	RADIUS_AUTH,
	RADIUS_ACCT,
	RADIUS_ACCT_INTERIM /* used only with radius_client_send(); just like
			     * RADIUS_ACCT, but removes any pending interim
			     * RADIUS Accounting packages for the same STA
			     * before sending the new interim update */
} 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,
			    u8 *shared_secret, size_t shared_secret_len,
			    void *data),
			   void *data);
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, u8 *addr);
int radius_client_get_mib(struct radius_client_data *radius, char *buf,
			  size_t buflen);
struct radius_client_data *
radius_client_reconfig(struct radius_client_data *old, void *ctx,
		       struct hostapd_radius_servers *oldconf,
		       struct hostapd_radius_servers *newconf);

#endif /* RADIUS_CLIENT_H */
Commit	Line	Data
6fc6879b JM	1	/*
	2	* hostapd / RADIUS client
	3	* Copyright (c) 2002-2005, Jouni Malinen <j@w1.fi>
	4	*
	5	* This program is free software; you can redistribute it and/or modify
	6	* it under the terms of the GNU General Public License version 2 as
	7	* published by the Free Software Foundation.
	8	*
	9	* Alternatively, this software may be distributed under the terms of BSD
	10	* license.
	11	*
	12	* See README and COPYING for more details.
	13	*/
	14
	15	#ifndef RADIUS_CLIENT_H
	16	#define RADIUS_CLIENT_H
	17
	18	#include "ip_addr.h"
	19
	20	struct radius_msg;
	21
	22	struct hostapd_radius_server {
	23	/* MIB prefix for shared variables:
	24	* @ = radiusAuth or radiusAcc depending on the type of the server */
	25	struct hostapd_ip_addr addr; /* @ServerAddress */
	26	int port; /* @ClientServerPortNumber */
	27	u8 *shared_secret;
	28	size_t shared_secret_len;
	29
	30	/* Dynamic (not from configuration file) MIB data */
	31	int index; /* @ServerIndex */
	32	int round_trip_time; /* @ClientRoundTripTime; in hundredths of a
	33	* second */
	34	u32 requests; /* @Client{Access,}Requests */
	35	u32 retransmissions; /* @Client{Access,}Retransmissions */
	36	u32 access_accepts; /* radiusAuthClientAccessAccepts */
	37	u32 access_rejects; /* radiusAuthClientAccessRejects */
	38	u32 access_challenges; /* radiusAuthClientAccessChallenges */
	39	u32 responses; /* radiusAccClientResponses */
	40	u32 malformed_responses; /* @ClientMalformed{Access,}Responses */
	41	u32 bad_authenticators; /* @ClientBadAuthenticators */
	42	u32 timeouts; /* @ClientTimeouts */
	43	u32 unknown_types; /* @ClientUnknownTypes */
	44	u32 packets_dropped; /* @ClientPacketsDropped */
	45	/* @ClientPendingRequests: length of hapd->radius->msgs for matching
	46	* msg_type */
	47	};
	48
	49	struct hostapd_radius_servers {
	50	/* RADIUS Authentication and Accounting servers in priority order */
	51	struct hostapd_radius_server auth_servers, auth_server;
	52	int num_auth_servers;
	53	struct hostapd_radius_server acct_servers, acct_server;
	54	int num_acct_servers;
	55
	56	int retry_primary_interval;
	57	int acct_interim_interval;
	58
	59	int msg_dumps;
c454f573 TW	60
	61	struct hostapd_ip_addr client_addr;
	62	int force_client_addr;
6fc6879b JM	63	};
	64
	65
	66	typedef enum {
	67	RADIUS_AUTH,
	68	RADIUS_ACCT,
	69	RADIUS_ACCT_INTERIM /* used only with radius_client_send(); just like
	70	* RADIUS_ACCT, but removes any pending interim
	71	* RADIUS Accounting packages for the same STA
	72	* before sending the new interim update */
	73	} RadiusType;
	74
	75	typedef enum {
	76	RADIUS_RX_PROCESSED,
	77	RADIUS_RX_QUEUED,
	78	RADIUS_RX_UNKNOWN,
	79	RADIUS_RX_INVALID_AUTHENTICATOR
	80	} RadiusRxResult;
	81
	82	struct radius_client_data;
	83
	84	int radius_client_register(struct radius_client_data *radius,
	85	RadiusType msg_type,
	86	RadiusRxResult (*handler)
	87	(struct radius_msg msg, struct radius_msg req,
	88	u8 *shared_secret, size_t shared_secret_len,
	89	void *data),
	90	void *data);
	91	int radius_client_send(struct radius_client_data *radius,
	92	struct radius_msg *msg,
	93	RadiusType msg_type, const u8 *addr);
	94	u8 radius_client_get_id(struct radius_client_data *radius);
	95
	96	void radius_client_flush(struct radius_client_data *radius, int only_auth);
	97	struct radius_client_data *
	98	radius_client_init(void ctx, struct hostapd_radius_servers conf);
	99	void radius_client_deinit(struct radius_client_data *radius);
	100	void radius_client_flush_auth(struct radius_client_data radius, u8 addr);
	101	int radius_client_get_mib(struct radius_client_data radius, char buf,
	102	size_t buflen);
	103	struct radius_client_data *
	104	radius_client_reconfig(struct radius_client_data old, void ctx,
	105	struct hostapd_radius_servers *oldconf,
	106	struct hostapd_radius_servers *newconf);
	107
	108	#endif /* RADIUS_CLIENT_H */