Welcome to JRadius!

JRadius should eventually be able to work with multiple underlying RADIUS servers, however, currently only FreeRADIUS is supported.

How to get up and running with JRadius:

• First, you need to compile and configure FreeRADIUS such that it uses JRadius. See freeradius/README for further instructions.

• Next, copy the build.properties.template file to build.properties. You also probably want to edit this file to suite your environment. See the comments in the file.

• Next, you need to be sure you have the required dependencies in the java/lib directory. See the shell script java/lib/getJars which will download the required jar files (using wget).

• Next, compile the JRadius code. The following command will build everything (the base code, the FreeRADIUS dictionary, and some generic/sample JRadius Handlers:

  ant dist

• Now you should have both a jradius.jar and a jradius-dictionary.jar in the dist/ directory. If you already have FreeRADIUS running with rlm_jradius and want to see something work, you can run an example with:

  ant run-example

• JRadius also provides a Java RADIUS client API and a Java program called RadClient. A shell script is provided to run RadClient. To use the script, create a file containing your attributes, for example:

  echo "User-Name = test" > radius.pkt echo "User-Password = test" >> radius.pkt

Now, use the following script with arguments of server, shared secret, and attributes file:

bin/radclient localhost sharedsecret radius.pkt

For more information, see http://jradius.sourceforge.net/radclient.html

JRadius Development Team:

David Bird

Contributers: