NAME

probes::Radius - a RADIUS authentication probe for SmokePing


OVERVIEW

Measures RADIUS authentication latency for SmokePing


SYNOPSYS

 *** Probes ***
 + Radius
 passwordfile = /usr/share/smokeping/etc/password
 secretfile = /etc/raddb/secret
 sleeptime = 0.5 # optional, 1 second by default
 *** Targets ***
 probe = Radius
 + PROBE_CONF
 username = testuser
 secret = myRadiusSecret # if not present in <secretfile>
 password = testuserPass # if not present in <passwordfile>
 port = 1645 # optional
 nas_ip_address = 1.2.3.4 # optional


DESCRIPTION

This probe measures RADIUS (RFC 2865) authentication latency for SmokePing. The username to be tested is specified in the target-specific variable `username'. The password can be specified either in the target-specific variable `password' or in an external file. The location of this file is given in the probe-specific variable `passwordfile'. See probes::passwordchecker(3pm) for the format of this file (summary: colon-separated triplets of the form `<host>:<username>:<password>')

The RADIUS protocol requires a shared secret between the server and the client. This secret can be specified in the target-specific variable `secret' or in an external file. This external file is located by the probe-specific variable `secretfile', and it should contain whitespace-separated pairs of the form `<host> <secret>'. Comments and blank lines are OK.

If the optional probe-specific variable `nas_ip_address' is specified, its value is inserted into the authentication requests as the `NAS-IP-Address' RADIUS attribute.

The probe tries to be nice to the server and sleeps for the probe-specific variable `sleeptime' (one second by default) between each authentication request.


AUTHOR

Niko Tyni <ntyni@iki.fi>


BUGS

There should be a more general way of specifying RADIUS attributes.