README

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: