Wireshark  4.3.0
The Wireshark network protocol analyzer
packet-radius.h
1 /*
2  * packet-radius.h
3  *
4  * Definitions for RADIUS packet disassembly
5  * Wireshark - Network traffic analyzer
6  * By Gerald Combs <gerald@wireshark.org>
7  * Copyright 1998 Gerald Combs
8  *
9  * SPDX-License-Identifier: GPL-2.0-or-later
10  */
11 
12 #include <epan/proto.h>
13 
14 /* radius packet-type codes */
15 /* 09/12/2011: Updated from IANA:
16  * http://www.iana.org/assignments/radius-types/radius-types.xml#radius-types-27
17  */
18 #define RADIUS_PKT_TYPE_ACCESS_REQUEST 1
19 #define RADIUS_PKT_TYPE_ACCESS_ACCEPT 2
20 #define RADIUS_PKT_TYPE_ACCESS_REJECT 3
21 #define RADIUS_PKT_TYPE_ACCOUNTING_REQUEST 4
22 #define RADIUS_PKT_TYPE_ACCOUNTING_RESPONSE 5
23 #define RADIUS_PKT_TYPE_ACCOUNTING_STATUS 6
24 #define RADIUS_PKT_TYPE_PASSWORD_REQUEST 7
25 #define RADIUS_PKT_TYPE_PASSWORD_ACK 8
26 #define RADIUS_PKT_TYPE_PASSWORD_REJECT 9
27 #define RADIUS_PKT_TYPE_ACCOUNTING_MESSAGE 10
28 #define RADIUS_PKT_TYPE_ACCESS_CHALLENGE 11
29 #define RADIUS_PKT_TYPE_STATUS_SERVER 12
30 #define RADIUS_PKT_TYPE_STATUS_CLIENT 13
31 
32 #define RADIUS_PKT_TYPE_RESOURCE_FREE_REQUEST 21
33 #define RADIUS_PKT_TYPE_RESOURCE_FREE_RESPONSE 22
34 #define RADIUS_PKT_TYPE_RESOURCE_QUERY_REQUEST 23
35 #define RADIUS_PKT_TYPE_RESOURCE_QUERY_RESPONSE 24
36 #define RADIUS_PKT_TYPE_ALTERNATE_RESOURCE_RECLAIM_REQUEST 25
37 #define RADIUS_PKT_TYPE_NAS_REBOOT_REQUEST 26
38 #define RADIUS_PKT_TYPE_NAS_REBOOT_RESPONSE 27
39 
40 #define RADIUS_PKT_TYPE_NEXT_PASSCODE 29
41 #define RADIUS_PKT_TYPE_NEW_PIN 30
42 #define RADIUS_PKT_TYPE_TERMINATE_SESSION 31
43 #define RADIUS_PKT_TYPE_PASSWORD_EXPIRED 32
44 #define RADIUS_PKT_TYPE_EVENT_REQUEST 33
45 #define RADIUS_PKT_TYPE_EVENT_RESPONSE 34
46 
47 #define RADIUS_PKT_TYPE_DISCONNECT_REQUEST 40
48 #define RADIUS_PKT_TYPE_DISCONNECT_ACK 41
49 #define RADIUS_PKT_TYPE_DISCONNECT_NAK 42
50 #define RADIUS_PKT_TYPE_COA_REQUEST 43
51 #define RADIUS_PKT_TYPE_COA_ACK 44
52 #define RADIUS_PKT_TYPE_COA_NAK 45
53 
54 #define RADIUS_PKT_TYPE_IP_ADDRESS_ALLOCATE 50
55 #define RADIUS_PKT_TYPE_IP_ADDRESS_RELEASE 51
56 
57 /* ALU proprietary packet type codes */
58 #define RADIUS_PKT_TYPE_ALU_STATE_REQUEST 129
59 #define RADIUS_PKT_TYPE_ALU_STATE_ACCEPT 130
60 #define RADIUS_PKT_TYPE_ALU_STATE_REJECT 131
61 #define RADIUS_PKT_TYPE_ALU_STATE_ERROR 132
62 
63 /* Radius Attribute Types*/
64 /* 09/12/2011: Updated from IANA:
65  * http://www.iana.org/assignments/radius-types/radius-types.xml#radius-types-1
66  */
67 #define RADIUS_ATTR_TYPE_VENDOR_SPECIFIC 26
68 #define RADIUS_ATTR_TYPE_EAP_MESSAGE 79
69 #define RADIUS_ATTR_TYPE_EXTENDED_1 241
70 #define RADIUS_ATTR_TYPE_EXTENDED_2 242
71 #define RADIUS_ATTR_TYPE_EXTENDED_3 243
72 #define RADIUS_ATTR_TYPE_EXTENDED_4 244
73 #define RADIUS_ATTR_TYPE_EXTENDED_5 245
74 #define RADIUS_ATTR_TYPE_EXTENDED_6 246
75 
76 #define RADIUS_ATTR_TYPE_IS_EXTENDED(avp_type) \
77  ((avp_type) == RADIUS_ATTR_TYPE_EXTENDED_1 || \
78  (avp_type) == RADIUS_ATTR_TYPE_EXTENDED_2 || \
79  (avp_type) == RADIUS_ATTR_TYPE_EXTENDED_3 || \
80  (avp_type) == RADIUS_ATTR_TYPE_EXTENDED_4 || \
81  (avp_type) == RADIUS_ATTR_TYPE_EXTENDED_5 || \
82  (avp_type) == RADIUS_ATTR_TYPE_EXTENDED_6)
83 
84 #define RADIUS_ATTR_TYPE_IS_EXTENDED_LONG(avp_type) \
85  ((avp_type) == RADIUS_ATTR_TYPE_EXTENDED_5 || \
86  (avp_type) == RADIUS_ATTR_TYPE_EXTENDED_6)
87 
88 
89 typedef struct _radius_vendor_info_t {
90  gchar *name;
91  guint code;
92  GHashTable* attrs_by_id;
93  gint ett;
94  guint type_octets;
95  guint length_octets;
96  gboolean has_flags;
98 
100 typedef void (radius_attr_dissector_t)(radius_attr_info_t*, proto_tree*, packet_info*, tvbuff_t*, int, int, proto_item* );
101 
102 typedef const gchar* (radius_avp_dissector_t)(proto_tree*,tvbuff_t*, packet_info*);
103 
104 typedef union _radius_attr_type_t {
105  guint8 u8_code[2];
106  guint value;
108 
110  gchar *name;
111  radius_attr_type_t code;
112  guint encrypt; /* 0 or value for "encrypt=" option */
113  gboolean tagged;
114  radius_attr_dissector_t* type;
115  radius_avp_dissector_t* dissector;
116  const value_string *vs;
117  gint ett;
118  int hf;
119  int hf_alt; /* 64-bit version for integers, encrypted version for strings, IPv6 for radius_combo_ip */
120  int hf_tag;
121  int hf_len;
122  GHashTable* tlvs_by_id;
123 };
124 
125 /*
126  * Attributes and Vendors are a mapping between IDs and names. Names
127  * are normally uniquely identified by a number. Identifiers for
128  * Vendor-Specific Attributes (VSA) are scoped within the vendor.
129  *
130  * The attribute/vendor structures are owned by the by_id tables,
131  * the by_name tables point to the same data.
132  */
133 typedef struct _radius_dictionary_t {
134  GHashTable* attrs_by_id;
135  GHashTable* attrs_by_name;
136  GHashTable* vendors_by_id;
137  GHashTable* vendors_by_name;
138  GHashTable* tlvs_by_name;
140 
141 radius_attr_dissector_t radius_integer;
142 radius_attr_dissector_t radius_string;
143 radius_attr_dissector_t radius_octets;
144 radius_attr_dissector_t radius_ipaddr;
145 radius_attr_dissector_t radius_ipv6addr;
146 radius_attr_dissector_t radius_ipv6prefix;
147 radius_attr_dissector_t radius_ipxnet;
148 radius_attr_dissector_t radius_date;
149 radius_attr_dissector_t radius_abinary;
150 radius_attr_dissector_t radius_ether;
151 radius_attr_dissector_t radius_ifid;
152 radius_attr_dissector_t radius_byte;
153 radius_attr_dissector_t radius_short;
154 radius_attr_dissector_t radius_signed;
155 radius_attr_dissector_t radius_combo_ip;
156 radius_attr_dissector_t radius_tlv;
157 
158 extern void radius_register_avp_dissector(guint32 vendor_id, guint32 attribute_id, radius_avp_dissector_t dissector);
159 void dissect_attribute_value_pairs(proto_tree *tree, packet_info *pinfo, tvbuff_t *tvb, int offset, guint length);
160 extern void free_radius_attr_info(gpointer data);
161 
162 /* from radius_dict.l */
163 gboolean radius_load_dictionary (radius_dictionary_t* dict, gchar* directory, const gchar* filename, gchar** err_str);
Definition: packet_info.h:44
Definition: proto.h:897
Definition: packet-radius.h:109
GHashTable * tlvs_by_id
Definition: packet-radius.h:122
Definition: packet-radius.h:133
GHashTable * tlvs_by_name
Definition: packet-radius.h:138
Definition: packet-radius.h:89
Definition: value_string.h:26
Definition: tvbuff-int.h:35
Definition: packet-radius.h:104