Radius.pm

# 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.